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 page Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Vous pouvez modifier le type d'un environnement existant avec paiement à l'usage à l'aide de l'interface utilisateur Apigee dans la console Google Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console Cloud

Pour mettre à jour le type d'un environnement existant avec paiement à l'usage à l'aide de l'interface utilisateur Apigee dans la console Google Cloud, procédez comme suit :

Ouvrez la page Apigee dans la console.
Accéder à Apigee
Sélectionnez le projet contenant l'organisation avec paiement à l'usage et les environnements que vous souhaitez mettre à jour.
Sélectionnez Gestion > Environnements pour ouvrir la page de liste Environnements.
Sur la ligne correspondant à l'environnement que vous souhaitez modifier, cliquez sur Actions et sélectionnez Modifier.
Dans la boîte de dialogue Modifier l'environnement, sélectionnez une option sous Sélectionner le type d'environnement.
Cliquez sur Mettre à jour pour enregistrer vos modifications.
Pour confirmer le changement de type d'environnement, actualisez la page de liste Environnements.

API Apigee

Pour mettre à jour le type d'un environnement existant avec paiement à l'usage à l'aide de l'API Apigee, 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

Lorsque vous passez à un type d'environnement supérieur ou inférieur, l'opération échoue 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 dans l'environnement.
Flux partagé déployé dans l'environnement	`existing environment has a shared flow`	Annulez 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`	Déployez 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 activée dans 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.