Mettre à jour les types d'environnement avec paiement à l'usage

Cette page s'applique à Apigee, mais pas à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Les attributs de tarification du paiement à l'usage d'Apigee sont basés en partie sur les types d'environnement que vous associez à votre instance Apigee. Vous pouvez choisir d'ajouter des environnements de base, intermédiaires ou complets à votre organisation avec paiement à l'usage à tout moment. Cela permet d'adapter un système de tarification en fonction de vos besoins en termes de fonctionnalités et de capacité. Cette rubrique explique comment mettre à niveau ou rétrograder le type d'un environnement existant pour ajouter ou supprimer des fonctionnalités, et gérer votre facturation à l'usage Apigee et l'utilisation de vos ressources.

Rôles et autorisations requis

Pour obtenir les autorisations nécessaires pour mettre à jour un type d'environnement avec paiement à l'usage, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Administrateur d'organisation Apigee (apigee.organization.admin)
Administrateur de l'environnement Apigee (apigee.environment.admin)

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Mettre à jour votre type d'environnement à l'aide de l'API

Pour mettre à jour le type d'un environnement avec paiement à l'usage existant, utilisez la commande suivante :

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"}'

Où :

ORG_NAME est le nom de l'organisation Apigee avec paiement à l'usage.
ENV_NAME est le nom de l'environnement Apigee à mettre à jour.
ENV_TYPE est le type d'environnement mis à jour. Les options sont BASE, INTERMEDIATE ou COMPREHENSIVE.

Par exemple, pour mettre à niveau un environnement de base nommé test-env vers le niveau Complet, utilisez la commande suivante :

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"}'

Une fois l'opération terminée, exécutez la commande suivante pour confirmer la modification du type d'environnement :

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

Cette commande renvoie l'objet de ressource d'environnement, qui inclut le type d'environnement sélectionné.

Informations de référence sur les erreurs

Lors de la mise à niveau ou de la rétrogradation du type d'environnement, l'opération échouera si l'environnement existant contient des ressources incompatibles avec le type d'environnement nouvellement sélectionné. Pour en savoir plus sur les fonctionnalités disponibles et les limites par type d'environnement, consultez la section Comparaison des types d'environnement.

Si l'opération échoue, un message d'erreur s'affiche au format suivant :

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

Le tableau suivant récapitule les messages d'erreur possibles et les étapes que vous pouvez suivre pour résoudre le problème et mettre à niveau ou rétrograder le type d'environnement :

Condition de fin "échec"	Message d'erreur	Procédure de résolution
Nombre maximal d'environnements par organisation dépassé	`cannot transfer active environments to INTERMEDIATE, will exceed limit` `cannot transfer active environments to BASE, will exceed limit`	Supprimez un ou plusieurs environnements de votre organisation.
Proxy extensible déployé dans l'environnement	`existing environment has an extensible API`	Annulez le déploiement du proxy extensible de l'environnement.
Flux partagé déployé dans l'environnement	`existing environment has a shared flow`	Annuler le déploiement du flux partagé dans l'environnement.
Nombre maximal d'unités de déploiement de proxy par environnement et par région	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	Annulez le déploiement et supprimez les flux partagés ou les proxys de l'environnement.
Modules complémentaires activés dans l'environnement	`Existing environment has an addon enabled`	Désactivez les modules complémentaires dans l'environnement.
Compatibilité multirégionale avec l'environnement	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	Supprimez le deuxième rattachement d'instance pour l'environnement.