Esta página foi traduzida pela API Cloud Translation.

Atualize os tipos de ambientes de pagamento conforme o uso

Esta página aplica-se ao Apigee, mas não ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Os atributos de preços de pagamento mediante utilização do Apigee baseiam-se, em parte, nos tipos de ambiente que associa à sua instância do Apigee. Pode optar por adicionar ambientes Base, Intermédio ou Abrangente à sua organização de pagamento conforme o uso em qualquer altura, personalizando um esquema de preços com base nas suas necessidades de funcionalidades e capacidade. Este tópico explica como atualizar ou fazer downgrade do tipo de um ambiente existente para adicionar ou remover capacidades de funcionalidades e gerir a faturação e a utilização de recursos do Apigee de pagamento conforme a utilização.

Funções e autorizações necessárias

Para receber as autorizações de que precisa para atualizar um tipo de ambiente de pagamento conforme o uso, peça ao seu administrador para lhe conceder as seguintes funções de IAM no projeto:

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

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Atualize o tipo de ambiente

Pode atualizar o tipo de um ambiente de pagamento conforme o uso existente através da IU do Apigee na Google Cloud consola ou através da API, conforme descrito nas secções seguintes.

Apigee na Cloud Console

Para atualizar o tipo de um ambiente de pagamento conforme o uso existente através da IU do Apigee na Google Cloud consola:

Abra a página Apigee na consola.
Aceder ao Apigee
Selecione o projeto com a organização e os ambientes de pagamento conforme o uso que quer atualizar.
Selecione Gestão > Ambientes para abrir a página da lista Ambientes.
Na linha do ambiente que quer editar, clique em Ações e selecione Editar.
Na caixa de diálogo Editar ambiente, escolha uma opção em Selecionar tipo de ambiente.
Clique em Atualizar para guardar as alterações.
Para confirmar a alteração no tipo de ambiente, atualize a página da lista Ambientes.

API Apigee

Para atualizar o tipo de um ambiente de pagamento conforme o uso existente através da 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"}'

Onde:

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

Por exemplo, para atualizar um ambiente Base denominado test-env para Comprehensive, 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"}'

Após a conclusão da operação, use o seguinte comando 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"

Este comando devolve o objeto de recurso environment, que inclui o tipo de ambiente selecionado.

Referência de erro

Quando atualiza ou reverte o tipo de ambiente, a operação falha se o ambiente existente contiver recursos incompatíveis com o tipo de ambiente selecionado recentemente. Para mais informações sobre as funcionalidades e as limitações disponíveis por tipo de ambiente, consulte o artigo Comparação de tipos de ambientes.

Se a operação falhar, é apresentado um erro no seguinte formato:

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

A tabela seguinte resume as possíveis mensagens de erro e os potenciais passos que pode seguir para resolver o problema e atualizar ou reverter o tipo de ambiente:

Condição de falha	Mensagem de erro	Passos para resolver
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`	Elimine um ou mais ambientes da sua organização.
Proxy extensível implementado no ambiente	`existing environment has an extensible API`	Anule a implementação do proxy extensível no ambiente.
Fluxo partilhado implementado no ambiente	`existing environment has a shared flow`	Anule a implementação do fluxo partilhado no ambiente.
Número máximo de unidades de implementação de proxy por ambiente por região	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	Anule a implementação e elimine fluxos partilhados ou proxies do ambiente.
Suplementos ativados no ambiente	`Existing environment has an addon enabled`	Desative os suplementos 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`	Elimine o anexo da segunda instância para o ambiente.

Atualize os tipos de ambientes de pagamento conforme o uso Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.