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)
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:
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
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis guide explains how to modify the type of an existing environment within Apigee's Pay-as-you-go pricing model to adjust features, capabilities, and resource usage.\u003c/p\u003e\n"],["\u003cp\u003eUpdating an environment type to Base, Intermediate, or Comprehensive can be done via the Apigee UI in the Google Cloud console or using the Apigee API.\u003c/p\u003e\n"],["\u003cp\u003eThe roles Apigee Organization Admin and Apigee Environment Admin are required to update environment types.\u003c/p\u003e\n"],["\u003cp\u003eErrors can occur during environment type changes if the environment has incompatible resources, such as extensible proxies, shared flows, or add-ons, which must be addressed prior to the environment type change.\u003c/p\u003e\n"],["\u003cp\u003eThis page applies to Apigee and not Apigee hybrid.\u003c/p\u003e\n"]]],[],null,["# Update Pay-as-you-go environment types\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nApigee's Pay-as-you-go pricing attributes are based in part upon the\n[environment types](/apigee/docs/api-platform/reference/pay-as-you-go-environment-types)\nyou attach to your [Apigee instance](/apigee/docs/api-platform/fundamentals/environments-working-with#environments-and-instances). You can choose to add [Base,](/apigee/docs/api-platform/reference/pay-as-you-go-environment-types#base-env) [Intermediate](/apigee/docs/api-platform/reference/pay-as-you-go-environment-types#int-env),\nor [Comprehensive](/apigee/docs/api-platform/reference/pay-as-you-go-environment-types#comp-env)\nenvironments to your Pay-as-you-go organization at any time, tailoring a pricing scheme based\non your feature and capacity needs. This topic explains how to upgrade or downgrade the *type* of an *existing* environment\nto add or remove feature capabilities and manage your Apigee Pay-as-you-go billing and resource usage.\n\nRequired roles and permissions\n------------------------------\n\n\nTo get the permissions that\nyou need to update a Pay-as-you-go environment type,\n\nask your administrator to grant you the\nfollowing IAM roles on the project:\n\n- Apigee Organization Admin (`apigee.organization.admin`)\n- Apigee Environment Admin (`apigee.environment.admin`)\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nUpdate your environment type\n----------------------------\n\nYou can update the type of an existing Pay-as-you-go environment using the Apigee UI in the Google Cloud console\nor using the API, as described in the following sections. \n\n### Apigee in Cloud console\n\nTo update the type of an existing Pay-as-you-go environment using the Apigee UI in the Google Cloud console:\n\n1. Open the **Apigee** page in the console.\n\n [Go to Apigee](https://cloud.google.com/console/apigee)\n2. Select the project with the Pay-as-you-go organization and environments you want to update.\n3. Select **Management \\\u003e Environments** to open the **Environments** list page.\n4. In the row for the environment you want to edit, click **Actions** more_vert and select **Edit**.\n5. In the **Edit environment** dialog, choose an option under **Select environment type**.\n6. Click **Update** to save your changes.\n7. To confirm the change in environment type, refresh the **Environments** list page.\n\n### Apigee API\n\nTo update the type of an existing Pay-as-you-go environment using the Apigee API,\nuse the following command: \n\n```\ncurl \"https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type\" \\\n -H \"Authorization: Bearer $token\" \\\n -X PATCH \\\n -H 'Content-Type: application/json' \\\n -d '{\"type\":\"ENV_TYPE\"}'\n \n```\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003eORG_NAME\u003c/var\u003e is the name of your Apigee Pay-as-you-go organization.\n- \u003cvar translate=\"no\"\u003eENV_NAME\u003c/var\u003e is the name of the Apigee environment to update.\n- \u003cvar translate=\"no\"\u003eENV_TYPE\u003c/var\u003e is the updated environment type. Options are `BASE`, `INTERMEDIATE`, or `COMPREHENSIVE`.\n\nFor example, to upgrade a *Base* environment named `test-env` to *Comprehensive*,\nuse the following command: \n\n```\ncurl \"https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type\" \\\n -H \"Authorization: Bearer $token\" \\\n -X PATCH \\\n -H 'Content-Type: application/json' \\\n -d '{\"type\":\"COMPREHENSIVE\"}'\n \n```\n\nAfter the operation completes, use the following command to confirm the change in environment type: \n\n```\ncurl \"https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME\" -H \"Authorization: Bearer $token\"\n```\n\nThis command returns the [environment\nresource object](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments#resource:-environment), which includes the selected environment type.\n\nError reference\n---------------\n\nWhen upgrading or downgrading environment type, the operation will fail if the existing environment\ncontains resources that are incompatible with the newly selected environment type. For more information\non available features and limitations by environment type, see [Comparison of environment types](/apigee/docs/api-platform/reference/pay-as-you-go-environment-types#compare-env-table).\n\nIf the operation fails, you will see an error with the following format: \n\n```\n {\n \"error\": {\n \"code\": \"FAILED_PRECONDITION\",\n \"message\": \"environment type update invalid: ...\u003cdetailed message here \u003e... :failed precondition\",\n \"status\": \"FAILED_PRECONDITION\"\n }\n }\n```\n\nThe following table summarizes possible error messages and potential steps you can take to resolve the issue\nand upgrade or downgrade the environment type:"]]
