Aggiorna i tipi di ambiente con pagamento a consumo

Questa pagina si applica ad Apigee, ma non ad 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 che colleghi alla tua istanza Apigee. Puoi scegliere di aggiungere in qualsiasi momento ambienti di base, intermedie o completi alla tua organizzazione con pagamento a consumo, personalizzando uno schema dei 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à delle funzionalità e gestire la fatturazione con pagamento a consumo e l'utilizzo delle risorse di Apigee.

Autorizzazioni e ruoli 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 sul progetto:

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

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

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Aggiorna il tipo di ambiente utilizzando l'API

Per aggiornare il tipo di un ambiente con pagamento a consumo esistente, 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 a Complete di un ambiente Base denominato test-env, utilizza il comando seguente:

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 comando seguente 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 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 andrà a buon fine se l'ambiente esistente contiene risorse incompatibili con il tipo di ambiente appena selezionato. Per saperne di più sulle funzionalità disponibili e sulle limitazioni per tipo di ambiente, consulta la pagina Confronto dei tipi di ambiente.

Se l'operazione non va a buon fine, verrà visualizzato un errore con il 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 intraprendere per risolvere il problema ed eseguire l'upgrade o il downgrade del tipo di ambiente:

Condizione di errore Messaggio di errore Procedura per la risoluzione
È stato superato il numero massimo di ambienti per organizzazione 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 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 i flussi condivisi o i proxy dall'ambiente.
Componenti aggiuntivi abilitati nell'ambiente Existing environment has an addon enabled Disabilita 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.