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 mediante roles personalizados o cualquier otro rol predefinido.

Actualiza el tipo de entorno

Puedes actualizar el tipo de un entorno de pago por uso existente con la IU de Apigee en la consola de Google Cloud o con la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para actualizar el tipo de un entorno de pago por uso existente con la IU de Apigee en la consola de Google Cloud, sigue estos pasos:

Abre la página Apigee en la consola.
Ir a Apigee
Selecciona el proyecto con la organización de pago por uso y los entornos que deseas actualizar.
Selecciona Administración > Entornos para abrir la página de lista Entornos.
En la fila del entorno que deseas editar, haz clic en Acciones y selecciona Editar.
En el cuadro de diálogo Editar entorno, elige una opción en Seleccionar tipo de entorno.
Haz clic en Actualizar para guardar los cambios.
Para confirmar el cambio en el tipo de entorno, actualiza la página de lista Entornos.

API de Apigee

Para actualizar el tipo de un entorno de pago por uso existente con la API de Apigee, sigue estos pasos: 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.