Aggiornamento dei tipi di ambiente con pagamento a consumo

Questa pagina si applica a Apigee, ma non a Apigee ibrido.

Visualizza documentazione di Apigee Edge.

Gli attributi dei prezzi di pagamento a consumo di Apigee si basano in parte sul tipi di ambiente che alleghi al tuo di Compute Engine. Puoi scegliere di aggiungere Base, Intermedio, o Completo di pagamento a consumo in qualsiasi momento, personalizzando uno schema di prezzi in base in base alle tue esigenze di funzionalità e capacità. Questo argomento spiega come eseguire l'upgrade o il downgrade del tipo di un ambiente esistente. per aggiungere o rimuovere funzionalità e gestire la fatturazione e l'utilizzo delle risorse di Apigee.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per aggiornare un tipo di ambiente con pagamento a consumo, chiedi all'amministratore di concederti seguenti ruoli IAM sul progetto:

  • Amministratore organizzazione Apigee (apigee.organization.admin)
  • Amministratore ambienti Apigee (apigee.environment.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Aggiorna il tipo di ambiente

Puoi aggiornare il tipo di un ambiente con pagamento a consumo esistente utilizzando la UI di Apigee nella console Google Cloud o l'utilizzo dell'API, come descritto nelle sezioni seguenti.

Apigee nella console Cloud

Per aggiornare il tipo di un ambiente con pagamento a consumo esistente utilizzando la UI di Apigee nella console Google Cloud:

  1. Apri la pagina Apigee nella console.

    Vai ad Apigee

  2. Seleziona il progetto con l'organizzazione e gli ambienti con pagamento a consumo che vuoi aggiornare.
  3. Seleziona Gestione > Ambienti per aprire la pagina di elenco Ambienti.
  4. Nella riga relativa all'ambiente da modificare, fai clic su Azioni e seleziona Modifica.
  5. Nella finestra di dialogo Modifica ambiente, scegli un'opzione in Seleziona il tipo di ambiente.
  6. Fai clic su Update (Aggiorna) per salvare le modifiche.
  7. Per confermare la modifica nel tipo di ambiente, aggiorna la pagina dell'elenco Ambienti.

API Apigee

Per aggiornare il tipo di un ambiente esistente con pagamento a consumo utilizzando l'API Apigee, utilizza questo comando:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"ENV_TYPE"}'
        

Dove:

  • ORG_NAME è il nome della tua organizzazione Apigee con pagamento a consumo.
  • ENV_NAME è il nome dell'ambiente Apigee da aggiornare.
  • ENV_TYPE è il tipo di ambiente aggiornato. Le opzioni sono BASE, INTERMEDIATE o COMPREHENSIVE.

Ad esempio, per eseguire l'upgrade di un ambiente Base denominato test-env a Complete, utilizza questo comando:

curl "https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"COMPREHENSIVE"}'
        

Al termine dell'operazione, utilizza il seguente comando per confermare la modifica al tipo di ambiente:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME" -H "Authorization: Bearer $token"

Questo comando restituisce l'ambiente , che include il tipo di ambiente selezionato.

Messaggi di errore

Durante l'upgrade o il downgrade del tipo di ambiente, l'operazione non riuscirà se l'ambiente esistente contiene risorse incompatibili con il tipo di ambiente appena selezionato. Per ulteriori informazioni sulle funzionalità e sulle limitazioni disponibili in base al tipo di ambiente, vedi Confronto dei tipi di ambiente.

Se l'operazione non riesce, verrà visualizzato un errore nel seguente formato:

  {
    "error": {
      "code": "FAILED_PRECONDITION",
      "message": "environment type update invalid: ...<detailed message here >... :failed precondition",
      "status": "FAILED_PRECONDITION"
      }
  }

La tabella seguente riassume i possibili messaggi di errore e i potenziali passaggi che puoi eseguire per risolvere il problema ed esegui l'upgrade o il downgrade del tipo di ambiente:

Condizione di errore Messaggio di errore Procedura per la risoluzione
Numero massimo di ambienti per organizzazione superato cannot transfer active environments to INTERMEDIATE, will exceed limit

cannot transfer active environments to BASE, will exceed limit

Elimina uno o più ambienti dall'organizzazione.
Proxy estensibile di cui è stato eseguito il deployment nell'ambiente existing environment has an extensible API Annulla il deployment del proxy estensibile dall'ambiente.
Flusso condiviso di cui è stato eseguito il deployment nell'ambiente existing environment has a shared flow Annulla il deployment del flusso condiviso dall'ambiente.
Numero massimo di unità di deployment proxy per ambiente per regione pdu count, 50, cannot exceed 20

pdu count, 425, cannot exceed 50

Annulla il deployment ed elimina flussi condivisi o proxy dall'ambiente.
Componenti aggiuntivi abilitati nell'ambiente Existing environment has an addon enabled Disattiva i componenti aggiuntivi nell'ambiente.
Supporto di più regioni abilitato nell'ambiente instance attachment count, 2, cannot exceed 1 for BASE environment

instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment

Elimina il collegamento della seconda istanza per l'ambiente.