CreateStackInstances - - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, assurez-vous qu'un groupe de piles est créé. Pour plus d'informations, consultez la rubrique CreateStackGroup.

Cette rubrique présente un exemple de création de piles au sein d'un groupe de piles. Dans cet exemple, les piles sont créées dans un groupe nommé MyStackGroup. Les déploiements s'effectuent sur les comptes Alibaba Cloud 151266687691**** et 141261387191****, dans les régions Chine (Hangzhou) et Chine (Pékin). Le groupe de piles utilise le modèle d'autorisations gérées par l'utilisateur et est créé dans la région Chine (Hangzhou).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateStackInstances	L'action à effectuer. Définissez la valeur sur CreateStackInstances.
RegionId	String	Oui	cn-hangzhou	ID de la région à laquelle appartient le groupe de piles. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
StackGroupName	String	Oui	MyStackGroup	Nom du groupe de piles. Ce nom doit être unique au sein d'une région. Le nom peut comporter jusqu'à 255 caractères, incluant des chiffres, des lettres, des traits d'union (-) et des underscores (_). Il doit commencer par un chiffre ou une lettre.
AccountIds	Array of String	Non	["151266687691**", "141261387191**"]	ID des comptes dans lesquels vous souhaitez déployer des piles en utilisant le modèle d'autorisations gérées par l'utilisateur. Vous pouvez spécifier jusqu'à 20 ID de compte. Remarque Vous devez spécifier uniquement l'un des paramètres `AccountIds` ou `DeploymentTargets`.
RegionIds	Array of String	Oui	["cn-hangzhou","cn-beijing"]	ID des régions dans lesquelles vous souhaitez créer les piles. Vous pouvez spécifier jusqu'à 20 ID de région.
ClientToken	String	Non	123e4567-e89b-12d3-a456-42665544****	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez générer cette valeur via le client, mais vous devez vous assurer qu'elle reste unique entre différentes requêtes. Le jeton peut contenir jusqu'à 64 caractères, y compris des lettres, des chiffres, des traits d'union (-) et des underscores (_). Pour plus d'informations, consultez la rubrique Garantir l'idempotence.
OperationDescription	String	Non	Create stack instances in hangzhou and beijing	Description de l'opération de création de pile. La description doit comporter entre 1 et 256 caractères.
OperationPreferences	Map	Non	{"FailureToleranceCount": 1, "MaxConcurrentCount": 2}	Préférences personnalisées définissant la manière dont Resource Orchestration Service (ROS) crée les piles. Les paramètres suivants sont inclus : {"FailureToleranceCount": N} Nombre de comptes pour lesquels des échecs d'opération de pile peuvent se produire dans chaque région. Si cette valeur est dépassée dans une région, ROS arrête l'opération dans celle-ci. L'arrêt dans une région entraîne l'annulation de l'opération dans les autres régions. Valeurs valides pour N : 0 à 20. Si vous ne spécifiez pas le paramètre FailureToleranceCount, la valeur par défaut 0 est utilisée. {"FailureTolerancePercentage": N} Pourcentage du nombre de comptes pouvant rencontrer des échecs d'opération de pile par rapport au nombre total de comptes dans chaque région. Si cette valeur est dépassée dans une région, ROS arrête l'opération dans celle-ci. Valeurs valides pour N : 0 à 100. Si la valeur numérique du pourcentage n'est pas un entier, ROS l'arrondit à l'entier inférieur le plus proche. Si vous ne spécifiez pas le paramètre FailureTolerancePercentage, la valeur par défaut 0 est utilisée. {"MaxConcurrentCount": N} Nombre maximal de comptes dans lesquels les piles sont déployées simultanément dans chaque région. Valeurs valides pour N : 1 à 20. Si vous ne spécifiez pas le paramètre MaxConcurrentCount, la valeur par défaut 1 est utilisée. {"MaxConcurrentPercentage": N} Pourcentage du nombre maximal de comptes dans lesquels les piles sont déployées simultanément par rapport au nombre total de comptes dans chaque région. Valeurs valides : 1 à 100. Si la valeur numérique du pourcentage n'est pas un entier, ROS l'arrondit à l'entier inférieur le plus proche. Si vous ne spécifiez pas le paramètre MaxConcurrentPercentage, la valeur par défaut 1 est utilisée. {"RegionConcurrencyType": N} Mode de déploiement des piles entre les régions. Valeur par défaut : SEQUENTIAL. Valeurs valides : SEQUENTIAL : déploie les piles dans chaque région spécifiée selon la séquence indiquée. ROS déploie les piles région par région. PARALLEL : déploie les piles en parallèle dans toutes les régions spécifiées. Séparez plusieurs paramètres par des virgules (,). Remarque Vous pouvez spécifier soit MaxConcurrentCount, soit MaxConcurrentPercentage. Vous pouvez spécifier soit FailureToleranceCount, soit FailureTolerancePercentage.
TimeoutInMinutes	Long	Non	10	Délai d'attente autorisé pour la création de la pile. Valeur par défaut : 60. Unité : minutes.
DisableRollback	Boolean	Non	false	Indique si la restauration automatique doit être désactivée en cas d'échec de la création des piles. Valeur par défaut : false. Valeurs valides : true false
ParameterOverrides.N.ParameterKey	String	Oui	Amount	Nom du paramètre N utilisé pour remplacer un paramètre spécifique. Si vous ne spécifiez pas le nom du paramètre N, ROS utilise celui défini lors de la création du groupe de piles. Valeur maximale de N : 200. Remarque Le paramètre ParameterOverrides est facultatif. Si vous spécifiez le paramètre ParameterOverrides, vous devez également indiquer les paramètres ParameterOverrides.N.ParameterKey et ParameterOverrides.N.ParameterValue.
ParameterOverrides.N.ParameterValue	String	Oui	1	Valeur du paramètre N utilisé pour remplacer un paramètre spécifique. Si vous ne spécifiez ni le nom ni la valeur du paramètre N, ROS utilise ceux définis lors de la création du groupe de piles. Valeur maximale de N : 200. Remarque Le paramètre ParameterOverrides est facultatif. Si vous spécifiez le paramètre ParameterOverrides, vous devez également indiquer les paramètres ParameterOverrides.N.ParameterKey et ParameterOverrides.N.ParameterValue.
DeploymentTargets	Object	Non		Dossiers dans lesquels vous souhaitez déployer des piles en utilisant le modèle d'autorisations gérées par le service. Remarque Vous devez spécifier uniquement l'un des paramètres `AccountIds` ou `DeploymentTargets`.
RdFolderIds	Array of String	Oui	["fd-4PvlVLOL8v"]	ID des dossiers dans l'arborescence des ressources. Vous pouvez ajouter jusqu'à cinq ID de dossier. Vous pouvez créer des piles pour tous les membres des dossiers spécifiés. Si vous créez des piles dans le dossier Root, elles seront déployées pour tous les membres de l'arborescence des ressources. Remarque Pour afficher les ID des dossiers, accédez à la page Overview de la console Resource Management. Pour plus d'informations, consultez la rubrique View the basic information of a folder.

Pour plus d'informations sur les paramètres de requête communs, consultez la rubrique Common parameters.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	14A07460-EBE7-47CA-9757-12CC4761D47A	ID de la requête.
OperationId	String	6da106ca-1784-4a6f-a7e1-e723863d****	ID de l'opération.

Exemples

Exemple de requête

http(s)://ros.aliyuncs.com/?Action=CreateStackInstances
&AccountIds=["151266687691****","141261387191****"]
&RegionId=cn-hangzhou
&RegionIds=["cn-hangzhou","cn-beijing"]
&StackGroupName=MyStackGroup
&<Common request parameters>

Exemple de réponse réussie

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateStackInstancesResponse>
        <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
        <OperationId>6da106ca-1784-4a6f-a7e1-e723863d****</OperationId>
</CreateStackInstancesResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "OperationId" : "6da106ca-1784-4a6f-a7e1-e723863d****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la rubrique Service error codes.

Code d'erreur	Message d'erreur	Code d'état HTTP	Description
StackInstanceExists	The StackInstance ({instance}) already exists.	409	L'erreur indique que la pile existe déjà pour le compte spécifié dans la région indiquée. {instance} représente le nom de la pile.
StackGroupOperationInProgress	Another Operation on StackGroup ({name}) is in progress.	409	L'erreur indique qu'une autre opération est en cours sur le groupe de piles. {name} représente le nom du groupe de piles.