Questa pagina riguarda Apigee, ma non Apigee ibrido.
Visualizza la documentazione di
Apigee Edge.
Gli attributi dei prezzi con pagamento a consumo di Apigee si basano in parte sui tipi di ambiente che colleghi alla tua istanza Apigee. Puoi scegliere in qualsiasi momento di aggiungere ambienti di base, intermedi 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 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) -
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 i ruoli personalizzati o altri ruoli predefiniti.
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'API, come descritto nelle sezioni seguenti.
Apigee nella console Cloud
Per aggiornare il tipo di un ambiente di pagamento a consumo esistente utilizzando la UI di Apigee nella console Google Cloud:
- Apri la pagina Apigee nella console.
- Seleziona il progetto con l'organizzazione e gli ambienti con pagamento a consumo 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 con pagamento a consumo esistente utilizzando l'API Apigee, utilizza il comando seguente:
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,INTERMEDIATEoCOMPREHENSIVE.
Ad esempio, per eseguire l'upgrade di un ambiente Base denominato test-env a Complete,
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 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'oggetto risorsa 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 saperne di più sulle funzionalità e sulle limitazioni disponibili in base al tipo di ambiente, consulta Confronto dei tipi di ambiente.
Se l'operazione non riesce, 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 seguente tabella riassume i possibili messaggi di errore e i potenziali passaggi che puoi eseguire 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 |
|---|---|---|
| Numero massimo di ambienti per organizzazione superato | cannot transfer active environments to INTERMEDIATE, 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
|
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
|
Elimina il collegamento della seconda istanza per l'ambiente. |