Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiornamento dei tipi di ambiente con pagamento a consumo

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

Visualizza la documentazione di Apigee Edge.

Gli attributi dei prezzi di pagamento a consumo di Apigee si basano in parte sui tipi di ambiente associati all' istanza Apigee. Puoi scegliere di aggiungere in qualsiasi momento ambienti Base, Intermedi o Completi alla tua organizzazione con pagamento a consumo, personalizzando un piano tariffario 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 dell'ambiente Apigee (apigee.environment.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestire 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 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 Pay-as-you-go esistente utilizzando l'interfaccia utente di Apigee nella console Google Cloud:

Apri la pagina Apigee nella console.
Vai ad Apigee
Seleziona il progetto con l'organizzazione e gli ambienti Pay-as-you-go che vuoi aggiornare.
Seleziona Gestione > Ambienti per aprire la pagina di elenco Ambienti.
Nella riga relativa all'ambiente da modificare, fai clic su Azioni e seleziona Modifica.
Nella finestra di dialogo Modifica ambiente, scegli un'opzione in Seleziona il tipo di ambiente.
Fai clic su Update (Aggiorna) per salvare le modifiche.
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 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 della risorsa dell'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 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 svolgere per risolvere il problema e eseguire 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`	Esegui il ritiro 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`	Esegui il rollback 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 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 l'allegato della seconda istanza per l'ambiente.