Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiornare i tipi di ambienti di pagamento a consumo

Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Gli attributi dei prezzi di pagamento a consumo di Apigee si basano in parte sui tipi di ambiente che colleghi alla tua istanza Apigee. Puoi scegliere di aggiungere ambienti Base, Intermedio o Completo alla tua organizzazione con pagamento a consumo in qualsiasi momento, personalizzando uno schema di prezzi 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 con pagamento a consumo.

Ruoli e autorizzazioni richiesti

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

Amministratore organizzazione Apigee (apigee.organization.admin)
Apigee Environment Admin (apigee.environment.admin)

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

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

Aggiornare il tipo di ambiente

Puoi aggiornare il tipo di un ambiente Pay as you go esistente utilizzando la UI di Apigee nella console Google Cloud o utilizzando l'API, come descritto nelle sezioni seguenti.

Apigee nella console Cloud

Per aggiornare il tipo di un ambiente Pay as you go esistente utilizzando l'interfaccia utente Apigee nella console Google Cloud :

Apri la pagina Apigee nella console.
Vai ad Apigee
Seleziona il progetto con l'organizzazione e gli ambienti con pagamento a consumo che vuoi aggiornare.
Seleziona Gestione > Ambienti per aprire la pagina dell'elenco Ambienti.
Nella riga dell'ambiente da modificare, fai clic su Azioni e seleziona Modifica.
Nella finestra di dialogo Modifica ambiente, scegli un'opzione in Seleziona tipo di ambiente.
Fai clic su Update (Aggiorna) per salvare le modifiche.
Per confermare la modifica del tipo di ambiente, aggiorna la pagina dell'elenco Ambienti.

API Apigee

Per aggiornare il tipo di un ambiente Pay as you go esistente utilizzando l'API Apigee, utilizza il seguente 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 Comprehensive, utilizza il seguente 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 questo comando per confermare la modifica del tipo di ambiente:

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

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

Messaggi di errore

Quando esegui l'upgrade o il downgrade del tipo di ambiente, l'operazione non verrà completata se l'ambiente esistente contiene risorse incompatibili con il tipo di ambiente appena selezionato. Per saperne di più sulle funzionalità disponibili e sulle limitazioni in base al tipo di ambiente, consulta Confronto tra i tipi di ambiente.

Se l'operazione non va a buon fine, viene visualizzato un errore nel seguente formato:

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

La seguente tabella riassume i possibili messaggi di errore e i potenziali passaggi che puoi eseguire per risolvere il problema e aggiornare o eseguire 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 dalla tua organizzazione.
Proxy estensibile di cui è stato eseguito il deployment nell'ambiente	`existing environment has an extensible API`	Esegui il deployment inverso 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 del proxy per ambiente per regione	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	Annulla il deployment ed elimina i flussi condivisi o i proxy dall'ambiente.
Componenti aggiuntivi abilitati nell'ambiente	`Existing environment has an addon enabled`	Disattiva i componenti aggiuntivi nell'ambiente.
Supporto multiregionale attivato nell'ambiente	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	Elimina il secondo allegato dell'istanza per l'ambiente.

Aggiornare i tipi di ambienti di pagamento a consumo Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.