Controllare lo stato di deployment del proxy API utilizzando l'API

Questa sezione descrive come controllare lo stato di deployment di un proxy API utilizzando le API Apigee.

  1. Esegui il deployment di un proxy API di test come spiegato in Creare e implementare un nuovo proxy API.
  2. Individua il file JSON con la chiave dell'account di servizio dell'amministratore dell'organizzazione Apigee. Questo account di servizio e questa chiave sono stati creati in Attivare l'accesso al sincronizzatore.
  3. Esegui questi due comandi per ottenere un token:
    export GOOGLE_APPLICATION_CREDENTIALS=org-admin-service-account-file
    export TOKEN=$(gcloud auth application-default print-access-token)

    dove org-admin-service-account-file è il percorso sul sistema della chiave dell'account di servizio che hai scaricato con il ruolo Amministratore dell'organizzazione Apigee.

  4. Chiama l'API Revisioni, con le parti seguenti:
    • URL di base: https://apigee.googleapis.com/v1
    • URL endpoint: /organizations/my-organization/environments/test/apis/myproxy/revisions/1/deployments
    • Protocollo: HTTPS
    • Metodo: GET
    • Intestazioni: "Authorization: Bearer $TOKEN"

    Il seguente esempio chiama l'API delle revisioni di deployment con queste impostazioni utilizzando curl:

    curl "https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/apis/myproxy/revisions/1/deployments" \
    -X GET -H "Authorization: Bearer $TOKEN"

    Dovresti ricevere una risposta simile alla seguente:

    {
      "deployments": [
        {
          "environment": "test",
          "apiProxy": "myproxy",
          "revision": "1",
          "deployStartTime": "1560782439002",
          "pods": [
            {
              "podName": "apigee-runtime-my-organization-test-blue-56b642fv429v",
              "appVersion": "self",
              "deploymentStatusTime": "1560787671389",
              "deploymentStatus": "deployed",
              "statusCode": "200",
              "statusCodeDetails": "Deployment Success",
              "deploymentTime": "1560782471370",
              "podStatus": "active",
              "podStatusTime": "1560787671389"
            },
            {
              "podName": "apigee-runtime-my-organization-test-blue-564422f7dmwj",
              "appVersion": "self",
              "deploymentStatusTime": "1560787670121",
              "deploymentStatus": "deployed",
              "statusCode": "200",
              "statusCodeDetails": "Deployment Success",
              "deploymentTime": "1560782485204",
              "podStatus": "active",
              "podStatusTime": "1560787670121"
            }
          ],
          "basePath": "/"
        }
      ]
    }

    Questa risposta di esempio mostra lo stato del proxy API su 2 pod. Lo stato del deployment è deployed su entrambi i pod.

    La tua risposta potrebbe mostrare lo stato di deployment del proxy API su meno o più pod, a seconda la configurazione del tuo cluster.

    Se ricevi una risposta vuota o un errore, verifica quanto segue:

    • Hai utilizzato l'URL di base corretto. Tieni presente che l'URL di base ibrido non è uguale all'URL URL di base dell'API Edge. Utilizza https://apigee.googleapis.com/v1.
    • Hai utilizzato l'URL dell'endpoint corretto. Tieni presente che la revisione è "1" e l'endpoint /organizations/my_organization/environments/test/apis/myproxy/revisions/1/deployments. Se specifichi una revisione inesistente, la richiesta genera una risposta vuota come la seguente:
      { }
    • Disponi delle autorizzazioni per accedere all'organizzazione specificata nella richiesta.
    • Il token non è scaduto. In caso contrario, rigenera un nuovo token come descritto in Ottenere un token di accesso OAuth 2.0.
    • Hai inserito l'intestazione "Authorization: Bearer $TOKEN" tra virgolette.