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 a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

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

Atualizar o tipo de ambiente

É possível atualizar o tipo de um ambiente de pagamento por uso atual usando a IU da Apigee no console do Google Cloud ou a API, conforme descrito nas seções a seguir.

Apigee no console do Cloud

Para atualizar o tipo de um ambiente de pagamento por uso atual usando a IU da Apigee no console do Google Cloud:

  1. Abra a página Apigee no console.

    Acessar a Apigee

  2. Selecione o projeto com a organização de pagamento por uso e os ambientes que você quer atualizar.
  3. Selecione Gerenciamento > Ambientes para abrir a página da lista Ambientes.
  4. Na linha do ambiente que você quer editar, clique em Ações e selecione Editar.
  5. Na caixa de diálogo Editar ambiente, escolha uma opção em Selecionar tipo de ambiente.
  6. Clique em Update to save your changes.
  7. Para confirmar a mudança no tipo de ambiente, atualize a página da lista Ambientes.

API Apigee

Para atualizar o tipo de um ambiente de pagamento por uso atual usando a API Apigee, use o seguinte 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"}'

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 "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"}'

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

curl "https://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.