:UpdateStackGroup

L'identifiant de la région du groupe de piles. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

Le nom du groupe de piles. Le nom doit être unique dans une région. Le nom peut comporter jusqu'à 255 caractères et doit commencer par un chiffre ou une lettre. Il peut contenir des chiffres, des lettres, des traits d'union (-) et des traits de soulignement (_).

La description du groupe de piles. La description doit comporter de 1 à 256 caractères.

La structure du corps du modèle. Le corps du modèle doit comporter de 1 à 524 288 octets. Si le corps du modèle est volumineux, utilisez la méthode HTTP POST et incluez le paramètre dans le corps de la requête pour éviter les échecs de requête dus à une URL excessivement longue.\n> Vous ne devez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId.

L'URL du fichier qui contient le corps du modèle. L'URL doit pointer vers un modèle situé sur un serveur web HTTP ou HTTPS, ou dans un compartiment Object Storage Service (OSS). Le modèle doit comporter de 1 à 524 288 octets. Exemple d'URL de compartiment OSS : oss://ros/template/demo ou oss://ros/template/demo?RegionId=cn-hangzhou. Si la région du compartiment OSS n'est pas spécifiée, la région du compartiment OSS est identique à la valeur du paramètre RegionId.\n\n> Vous ne devez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId.

Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton peut comporter jusqu'à 64 caractères et peut contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).\nPour plus d'informations, consultez Garantir l'idempotence.

La description de l'opération de mise à jour du groupe de piles.

Les paramètres d'opération pour la mise à jour du groupe de piles.

Ce paramètre comprend les champs suivants :

• {"FailureToleranceCount": N}

  Le nombre maximal de comptes simultanés dans lesquels les échecs de pile sont tolérés dans chaque région. Si le nombre de piles en échec dépasse cette valeur, l'opération dans la région s'arrête. Si l'opération dans une région s'arrête, l'opération ne se poursuit pas dans les autres régions.

  Valeurs valides de N : 0 à 20.

  Valeur par défaut : 0.

• {"FailureTolerancePercentage": N}

  Le pourcentage maximal de comptes simultanés dans lesquels les échecs de pile sont tolérés dans chaque région. Si le pourcentage de piles en échec dépasse cette valeur, l'opération dans la région s'arrête.

  Valeurs valides de N : 0 à 100. Si le pourcentage calculé n'est pas un nombre entier, Resource Orchestration Service (ROS) arrondit le pourcentage à l'entier inférieur.

  Valeur par défaut : 0.

• {"MaxConcurrentCount": N}

  Le nombre maximal de comptes simultanés dans lesquels des piles peuvent être déployées en même temps dans chaque région.

  Valeurs valides de N : 1 à 20.

  Valeur par défaut : 1.

• {"MaxConcurrentPercentage": N}

  Le pourcentage maximal de comptes simultanés dans lesquels des piles peuvent être déployées en même temps dans chaque région.

  Valeurs valides de N : 1 à 100. Si le pourcentage calculé n'est pas un nombre entier, ROS arrondit le pourcentage à l'entier inférieur.

  Valeur par défaut : 1.

• {"RegionConcurrencyType": N}

  Le type de simultanéité au niveau de la région pour le déploiement des instances de pile. Valeurs valides :

  • SEQUENTIAL (par défaut) : déploie les instances de pile dans les régions spécifiées une par une. Une seule région est déployée à la fois.

  • PARALLEL : déploie les instances de pile dans toutes les régions spécifiées en parallèle.

Séparez plusieurs paramètres par des virgules (,).

Le nom du rôle d'administrateur Resource Access Management (RAM) endossé par ROS lorsque vous créez un groupe de piles avec des autorisations auto-gérées. Si vous ne spécifiez pas ce paramètre, AliyunROSStackGroupAdministrationRole est utilisé par défaut. ROS endosse ce rôle pour endosser ensuite le rôle d'exécution (AliyunROSStackGroupExecutionRole) et gérer les piles qui correspondent aux instances de pile dans le groupe de piles.\n\nLe nom doit comporter de 1 à 64 caractères et peut contenir des lettres, des chiffres et des traits d'union (-).

Le nom du rôle d'exécution RAM endossé par le rôle d'administrateur (AliyunROSStackGroupAdministrationRole) lorsque vous créez un groupe de piles avec des autorisations auto-gérées. Si vous ne spécifiez pas ce paramètre, AliyunROSStackGroupExecutionRole est utilisé par défaut. ROS endosse ce rôle pour gérer les piles qui correspondent aux instances de pile dans le groupe de piles.\n\nLe nom doit comporter de 1 à 64 caractères et peut contenir des lettres, des chiffres et des traits d'union (-).

L'identifiant du modèle. Les modèles partagés et les modèles privés sont pris en charge.\n\n> Vous ne devez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId.

La version du modèle. Si vous ne spécifiez pas ce paramètre, la version la plus récente est utilisée par défaut.\n\n> TemplateVersion ne prend effet que lorsque TemplateId est spécifié.

Le modèle d'autorisation.

Valeurs valides :

• SELF_MANAGED (par défaut) : le modèle d'autorisations auto-géré. Si vous utilisez ce modèle, vous devez créer manuellement des rôles RAM dans le compte administrateur et les comptes d'exécution afin d'établir une relation de confiance entre eux, puis effectuer le déploiement de pile dans les comptes d'exécution.

• SERVICE_MANAGED : le modèle d'autorisations géré par le service. Si vous utilisez ce modèle, ROS crée automatiquement des rôles liés au service (associés) pour le compte administrateur et les comptes d'exécution. Le compte administrateur effectue le déploiement de pile dans les comptes d'exécution en utilisant les rôles liés au service.