Actualiza los tipos de entorno de pago por uso

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Los atributos de los precios de pago por uso de Apigee se basan en parte en los tipos de entorno que conectas a tu instancia de Apigee. Puedes elegir agregar los tipos de entorno Base, Intermedio o Integral a tu organización de pago por uso en cualquier momento; para ello, adopta un esquema de precios según tus necesidades de función y capacidad. En este tema, se explica cómo actualizar o cambiar a una versión inferior el tipo de entorno existente para agregar o quitar capacidades de funciones y administrar tu facturación de pago por uso de Apigee y el uso de recursos.

Roles y permisos requeridos

Para obtener los permisos que necesitas para actualizar un tipo de entorno de pago por uso, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Administrador de la organización de Apigee (apigee.organization.admin)
Administrador del entorno de Apigee (apigee.environment.admin)

Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.

También puedes obtener los permisos necesarios a través de funciones personalizadas o cualquier otro rol predefinido.

Actualiza tu tipo de entorno con la API

Para actualizar el tipo de un entorno de pago por uso existente, usa el siguiente 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"}'

Aquí:

ORG_NAME es el nombre de tu organización de pago por uso de Apigee.
ENV_NAME es el nombre del entorno de Apigee que se actualizará.
ENV_TYPE es el tipo de entorno actualizado. Las opciones son BASE, INTERMEDIATE o COMPREHENSIVE.

Por ejemplo, para actualizar un entorno Base llamado test-env a Integral, usa el siguiente 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"}'

Una vez completada la operación, usa el siguiente comando para confirmar el cambio en el tipo de entorno:

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

Este comando muestra el objeto de recursos del entorno, que incluye el tipo de entorno seleccionado.

Referencia de errores

Cuando se actualiza o se cambia a una versión inferior del tipo de entorno, la operación fallará si el entorno existente contiene recursos que son incompatibles con el tipo de entorno recién seleccionado. Para obtener más información sobre las funciones y limitaciones disponibles por tipo de entorno, consulta Comparación de tipos de entornos.

Si la operación falla, verás un error con el siguiente formato:

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

En la siguiente tabla, se resumen los posibles mensajes de error y los posibles pasos que puedes seguir para resolver el problema y actualizar o cambiar a una versión inferior el tipo de entorno:

Condición de falla	Mensaje de error	Pasos para resolver
Se superó la cantidad máxima de entornos por organización	`cannot transfer active environments to INTERMEDIATE, will exceed limit` `cannot transfer active environments to BASE, will exceed limit`	Borra uno o más entornos de tu organización.
Proxy extensible implementado en el entorno	`existing environment has an extensible API`	Anula la implementación del proxy extensible del entorno.
Flujo compartido implementado en el entorno	`existing environment has a shared flow`	Anula la implementación del flujo compartido en el entorno.
Cantidad máxima de unidades de implementación del proxy por entorno y por región	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	Anula la implementación y borra los flujos compartidos o los proxies del entorno.
Complementos habilitados en el entorno	`Existing environment has an addon enabled`	Inhabilita los complementos en el entorno.
Compatibilidad multirregional habilitada en el entorno	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	Borra el segundo adjunto de instancia para el entorno.