Actualizar 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 precios de pago por uso de Apigee se basan en parte en los tipos de entorno que asocies a tu instancia de Apigee. Puedes añadir entornos Básico, Intermedio o Completo a tu organización de pago por uso en cualquier momento y adaptar un plan de precios en función de tus necesidades de funciones y capacidad. En este tema se explica cómo cambiar a una versión superior o inferior del tipo de un entorno actual para añadir o quitar funciones y gestionar la facturación por uso y el uso de recursos de Apigee.

Roles y permisos necesarios

Para obtener los permisos que necesitas para actualizar un tipo de entorno de pago por uso, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

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

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Actualizar el tipo de entorno

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

Apigee en la consola de Cloud

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

  1. Abre la página Apigee en la consola.

    Ir a Apigee

  2. Selecciona el proyecto con la organización de pago por uso y los entornos que quieras actualizar.
  3. Selecciona Gestión > Entornos para abrir la página de lista Entornos.
  4. En la fila del entorno que quieras editar, haz clic en Acciones y selecciona Editar.
  5. En el cuadro de diálogo Editar entorno, elija una opción en Seleccionar tipo de entorno.
  6. Haz clic en Update (Actualizar) para guardar los cambios.
  7. Para confirmar el cambio en el tipo de entorno, actualiza la página de la lista Entornos.

API de Apigee

Para actualizar el tipo de un entorno de pago por uso con la API de Apigee, utiliza 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"}'

Donde:

  • ORG_NAME es el nombre de tu organización de Apigee de pago por uso.
  • ENV_NAME es el nombre del entorno de Apigee que se va a 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 Comprehensive, 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 devuelve el objeto de recurso de entorno, que incluye el tipo de entorno seleccionado.

Referencia de errores

Al cambiar el tipo de entorno a una versión superior o inferior, la operación fallará si el entorno contiene recursos que no son compatibles con el tipo de entorno seleccionado. Para obtener más información sobre las funciones disponibles y las limitaciones por tipo de entorno, consulta la 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 pasos que puede seguir para resolver el problema y cambiar el tipo de entorno:

Condición de error Mensaje de error Pasos para resolver el problema
Se ha superado el número máximo de entornos por organización cannot transfer active environments to INTERMEDIATE, will exceed limit

cannot transfer active environments to BASE, will exceed limit

 Elimina uno o varios entornos de tu organización.
Proxy extensible desplegado en el entorno existing environment has an extensible API Retira el proxy extensible del entorno.
Flujo compartido desplegado en el entorno existing environment has a shared flow Despliega el flujo compartido del entorno.
Número máximo de unidades de despliegue de proxy por entorno y por región pdu count, 50, cannot exceed 20

pdu count, 425, cannot exceed 50

 Despliega y elimina flujos compartidos o proxies del entorno.
Complementos habilitados en el entorno Existing environment has an addon enabled Inhabilita los complementos en el entorno.
Asistencia 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

 Elimina la segunda vinculación de instancia del entorno.