Atualizar tipos de ambiente de pagamento por uso

Esta página se aplica à Apigee, mas não à Apigee híbrida.

Confira a documentação da Apigee Edge.

Os atributos de preços do modelo de pagamento por uso da Apigee são baseados, em parte, nos tipos de ambiente que você anexa à instância da Apigee. É possível adicionar a qualquer momento ambientes básicos, intermediários ou abrangentes à sua organização de pagamento por uso, adaptando um esquema de preços com base nas suas necessidades de recursos e capacidade. Neste tópico, explicamos como fazer upgrade ou downgrade do tipo de um ambiente que já existe para adicionar ou remover capabilities de recursos e gerenciar o faturamento e o uso de recursos do pagamento por uso.

Papéis e permissões necessárias

Para ter as permissões necessárias para atualizar um tipo de ambiente de pagamento por uso, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Administrador da organização da Apigee (apigee.organization.admin)
Administrador do ambiente Apigee (apigee.environment.admin)

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Atualizar o tipo de ambiente usando a API

Para atualizar o tipo de um ambiente de pagamento por uso que já existe, use o seguinte comando:

curl "http://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"}'

Em que:

ORG_NAME é o nome da organização de pagamento por uso da Apigee.
ENV_NAME é o nome do ambiente da Apigee a ser atualizado.
ENV_TYPE é o tipo de ambiente atualizado. As opções são BASE, INTERMEDIATE ou COMPREHENSIVE.

Por exemplo, para fazer upgrade de um ambiente básico chamado test-env para abrangente, use o seguinte comando:

curl "http://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"}'

Depois que a operação for concluída, use o comando a seguir para confirmar a alteração no tipo de ambiente:

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

Esse comando retorna o objeto de recurso do ambiente, que inclui o tipo de ambiente selecionado.

Referência de erros

Ao fazer upgrade ou downgrade do tipo de ambiente, a operação falhará se o ambiente que já existe tiver recursos incompatíveis com o tipo de ambiente recém-selecionado. Para mais informações sobre recursos e limitações disponíveis por tipo de ambiente, consulte Comparação de tipos de ambiente.

Se a operação falhar, você verá um erro com o seguinte formato:

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

A tabela a seguir resume as possíveis mensagens de erro e etapas que você pode seguir para resolver o problema e fazer upgrade ou downgrade do tipo de ambiente:

Condição de falha	Mensagem de erro	Etapas de resolução
Número máximo de ambientes por organização excedido	`cannot transfer active environments to INTERMEDIATE, will exceed limit` `cannot transfer active environments to BASE, will exceed limit`	Exclua um ou mais ambientes da sua organização.
Proxy extensível implantado no ambiente	`existing environment has an extensible API`	Cancele a implantação do proxy extensível do ambiente.
Fluxo compartilhado implantado no ambiente	`existing environment has a shared flow`	Cancele a implantação do fluxo compartilhado do ambiente.
Número máximo de unidades de implantação de proxy por ambiente por região	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	Cancele a implantação e exclua fluxos compartilhados ou proxies do ambiente.
Complementos ativados no ambiente	`Existing environment has an addon enabled`	Desative os complementos no ambiente.
Suporte multirregional ativado no ambiente	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	Exclua o segundo anexo de instância do ambiente.