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

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

  1. Esegui il deployment di un proxy API di test come spiegato in Creazione e deployment di un nuovo proxy API.
  2. Individua il file JSON con la chiave dell'account di servizio Amministratore dell'organizzazione Apigee. Questo account di servizio e la relativa chiave sono stati creati in Attivazione dell'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 tuo sistema della chiave del service account che hai scaricato con il ruolo Amministratore dell'organizzazione Apigee.

  4. Chiama l'API Revisions con le seguenti parti:
    • 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 revisioni dei 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 due pod. Lo stato del deployment è deployed su entrambi i pod.

    La tua risposta potrebbe mostrare lo stato del deployment del proxy API su un numero maggiore o minore di pod, a seconda della configurazione del cluster.

    Se ricevi una risposta vuota o un errore, controlla che:

    • Hai utilizzato l'URL di base corretto. Tieni presente che l'URL di base ibrido non corrisponde all'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 affermativo, generane uno nuovo come descritto in Ottieni un token di accesso OAuth 2.0.
    • Hai racchiuso l'intestazione "Authorization: Bearer $TOKEN" tra virgolette.