Aggiornare i tipi di ambienti di pagamento a consumo

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

Visualizza Apigee Edge documentazione.

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 di aggiungere ambienti 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 saperne di più 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.

Aggiorna il tipo di ambiente

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

Apigee nella console Google Cloud

Per aggiornare il tipo di ambiente con pagamento a consumo esistente utilizzando l'interfaccia utente di Apigee nella Google Cloud console:

  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 dell'elenco Ambienti.
  4. Nella riga dell'ambiente che vuoi modificare, fai clic su Azioni e seleziona Modifica.
  5. Nella finestra di dialogo Modifica ambiente, scegli un'opzione in Seleziona tipo di ambiente.
  6. Fai clic su Aggiorna per salvare le modifiche.
  7. Per confermare la modifica del tipo di ambiente, aggiorna la pagina dell'elenco Ambienti.

API Apigee

Per aggiornare il tipo di ambiente con pagamento a consumo 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 Completo, 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 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 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à e sulle limitazioni disponibili per tipo di ambiente, vedere Confronto tra i tipi di ambiente.

Se l'operazione non riesce, 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 intraprendere per risolvere il problema ed eseguire l'upgrade o il downgrade del tipo di ambiente:

Condizione di errore Messaggio di errore Passaggi per risolvere i problemi
È 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 dei 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 secondo collegamento dell'istanza per l'ambiente.