:CreateChangeSet

Opération à effectuer. Définissez la valeur sur CreateChangeSet.

ID de la pile pour laquelle vous souhaitez créer l'ensemble de modifications. ROS compare les informations de la pile avec les informations que vous spécifiez, telles qu'un modèle modifié ou une valeur de paramètre modifiée, afin de générer l'ensemble de modifications.

URL du fichier contenant la stratégie de pile. L'URL doit pointer vers une stratégie située sur un serveur web HTTP ou HTTPS ou dans un compartiment Object Storage Service (OSS), par exemple oss://ros/stack-policy/demo ou oss://ros/stack-policy/demo?RegionId=cn-hangzhou. Le fichier de stratégie peut atteindre 16 384 octets.

Spécifiez le paramètre StackPolicyBody ou StackPolicyURL.

L'URL peut atteindre 1 350 octets.

Si vous définissez le paramètre ChangeSetType sur CREATE, vous pouvez spécifier le paramètre StackPolicyBody ou StackPolicyURL. Si vous définissez le paramètre ChangeSetType sur UPDATE, vous ne pouvez spécifier qu'un seul des paramètres suivants :

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Structure contenant le corps de la stratégie de pile. Le corps de la stratégie doit compter entre 1 et 16 384 octets. Si vous définissez le paramètre ChangeSetType sur CREATE, vous pouvez spécifier le paramètre StackPolicyBody ou StackPolicyURL. Si vous définissez le paramètre ChangeSetType sur UPDATE, vous ne pouvez spécifier qu'un seul des paramètres suivants :

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Nom de la pile pour laquelle vous souhaitez créer l'ensemble de modifications.

Le nom peut comporter jusqu'à 255 caractères et contenir des chiffres, des lettres, des traits d'union (-) et des underscores (_). Il doit commencer par un chiffre ou une lettre.

Indique s'il faut utiliser les valeurs spécifiées dans la requête précédente pour les paramètres non spécifiés dans la requête actuelle. Valeur par défaut : false. Valeurs possibles :

• true
• false

Type d'ensemble de modifications. Valeur par défaut : UPDATE. Valeurs possibles :

• CREATE : crée un ensemble de modifications pour une nouvelle pile.
• UPDATE : crée un ensemble de modifications pour une pile existante.
• IMPORT : crée un ensemble de modifications pour une pile nouvelle ou existante afin d'importer des ressources non gérées par ROS.

Si vous créez un ensemble de modifications pour une nouvelle pile, ROS génère un ID de pile unique. La pile reste dans l'état REVIEW_IN_PROGRESS jusqu'à ce que vous exécutiez l'ensemble de modifications.

Vous ne pouvez pas utiliser le type UPDATE pour créer un ensemble de modifications pour une nouvelle pile, ni le type CREATE pour une pile existante.

Description de l'ensemble de modifications. Elle peut atteindre 1 024 octets.

ID de région de l'ensemble de modifications. Appelez l'opération DescribeRegions pour consulter la liste des régions les plus récentes.

Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez générer cette valeur à l'aide du client, mais vous devez vous assurer qu'elle est unique pour chaque requête.

Le jeton peut comporter jusqu'à 64 caractères et contenir des lettres, des chiffres, des traits d'union (-) et des underscores (_).

Pour plus d'informations, consultez la rubrique Garantir l'idempotence.

URL du fichier contenant 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 OSS, par exemple oss://ros/template/demo ou oss://ros/template/demo?RegionId=cn-hangzhou. Le corps du modèle peut atteindre 524 288 octets.

Vous ne pouvez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId.

L'URL peut atteindre 1 024 octets.

URL du fichier contenant la stratégie de pile de substitution temporaire. L'URL doit pointer vers une stratégie située sur un serveur web HTTP ou HTTPS ou dans un compartiment OSS, par exemple oss://ros/stack-policy/demo ou oss://ros/stack-policy/demo?RegionId=cn-hangzhou. Le fichier de stratégie peut atteindre 16 384 octets.

L'URL peut atteindre 1 350 octets.

Si vous souhaitez mettre à jour des ressources protégées, spécifiez une stratégie de pile de substitution temporaire pendant la mise à jour. À défaut, la stratégie existante associée à la pile est utilisée. Ce paramètre prend effet uniquement lorsque le paramètre ChangeSetType est défini sur UPDATE. Vous ne pouvez spécifier qu'un seul des paramètres suivants :

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Structure contenant le corps du modèle. Le corps du modèle doit compter entre 1 et 524 288 octets.

Si la taille du corps du modèle dépasse la limite supérieure, nous vous recommandons d'ajouter des paramètres au corps de la requête HTTP POST pour éviter les échecs liés à des URL trop longues.

Vous ne pouvez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId.

Délai maximal avant que la pile n'entre dans l'état CREATE_FAILED ou UPDATE_FAILED.

Si vous définissez le paramètre ChangeSetType sur CREATE, ce paramètre est obligatoire. Si vous le définissez sur UPDATE, il est facultatif.

• Unité : minutes.
• Valeurs possibles : 10 à 1440.
• Valeur par défaut : 60.

Indique s'il faut désactiver le rollback en cas d'échec de la création de la pile.

Valeur par défaut : false. Valeurs possibles :

• true
• false

Nom de l'ensemble de modifications.

Le nom peut comporter jusqu'à 255 caractères et contenir des chiffres, des lettres, des traits d'union (-) et des underscores (_). Il doit commencer par un chiffre ou une lettre.

Structure contenant le corps de la stratégie de pile de substitution temporaire. Le corps de la stratégie doit compter entre 1 et 16 384 octets.

Si vous souhaitez mettre à jour des ressources protégées, spécifiez une stratégie de pile de substitution temporaire pendant la mise à jour. À défaut, la stratégie de pile existante associée à la pile est utilisée.

Ce paramètre prend effet uniquement lorsque le paramètre ChangeSetType est défini sur UPDATE. Vous ne pouvez spécifier qu'un seul des paramètres suivants :

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

Nom du rôle RAM. ROS assume le rôle RAM pour créer la pile et utilise les identifiants du rôle pour appeler les API des services Alibaba Cloud.

ROS assume le rôle RAM pour effectuer des opérations sur la pile. Si vous disposez des autorisations nécessaires pour agir sur la pile mais pas pour utiliser le rôle RAM, ROS assume tout de même le rôle. Assurez-vous d'accorder les privilèges minimaux au rôle RAM.

Si vous ne spécifiez pas ce paramètre, ROS assume le rôle RAM existant associé à la pile. Si aucun rôle RAM n'est disponible, ROS utilise un identifiant temporaire généré à partir des identifiants de votre compte.

Le nom du rôle RAM peut atteindre 64 octets.

Indique s'il faut activer la mise à jour par remplacement si une propriété de ressource change alors que vous ne pouvez pas la modifier directement. Pour un changement simple, l'ID physique de la ressource reste inchangé. Pour une mise à jour par remplacement, la ressource existante est supprimée, une nouvelle ressource est créée et l'ID physique de la ressource change. Valeur par défaut : Disabled. Valeurs possibles :

• Enabled
• Disabled

ID du modèle. Ce paramètre s'applique aux modèles partagés et privés.

Vous ne pouvez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId.

Version du modèle.

Nom du paramètre N défini dans le modèle. Si vous ne spécifiez pas le nom et la valeur d'un paramètre, ROS utilise les valeurs par défaut définies dans le modèle. Valeur maximale de N : 200.

Valeur du paramètre N défini dans le modèle. Valeur maximale de N : 200.

URL de rappel utilisée pour recevoir l'événement de pile N. Valeurs possibles :

• URL HTTP POST

  Chaque URL peut atteindre 1 024 octets.

• eventbridge

  Lorsque le statut d'une pile change, ROS envoie une notification d'événement au service EventBridge. Pour consulter les informations sur l'événement, procédez comme suit : Connectez-vous à la console EventBridge. Dans le volet de navigation de gauche, cliquez sur Event Buses.

  Remarque ROS prend en charge le service EventBridge dans les régions suivantes : China (Hangzhou), China (Shanghai), China (Beijing), China (Hong Kong) et China (Zhangjiakou).

Valeur maximale de N : 5. Lorsque le statut d'une pile change, ROS envoie une notification d'événement à l'URL spécifiée. Lorsque le rollback est activé pour la pile, des notifications sont envoyées si la pile est dans l'état CREATE_ROLLBACK ou ROLLBACK, mais pas si elle est dans l'état CREATE_FAILED, UPDATE_FAILED ou IN_PROGRESS.

ROS envoie des notifications d'événement, que vous ayez ou non configuré la section Outputs. L'exemple suivant illustre le contenu d'une notification d'événement :

{
    "Outputs": [
        {
            "Description": "No description given",
            "OutputKey": "InstanceId",
            "OutputValue": "i-xxx"
        }
    ],
    "StackId": "80bd6b6c-e888-4573-ae3b-93d29113****",
    "StackName": "test-notification-url",
    "Status": "CREATE_COMPLETE"
}
                                    

Mappage clé-valeur sous forme de chaînes. La valeur est une chaîne JSON qui identifie la ressource N à importer.

Une clé est un identifiant pour une ressource et une valeur est une attribution de données à la clé. Par exemple, VpcId est une clé qui spécifie l'ID d'un Virtual Private Cloud (VPC), et vpc-2zevx9ios**** est la valeur attribuée à VpcId. Appelez l'opération GetTemplateSummary pour obtenir la clé d'une ressource.

ID logique de la ressource N que vous souhaitez importer. L'ID logique spécifie le nom d'une ressource définie dans le modèle.

Type de la ressource N que vous souhaitez importer. Le type de ressource doit correspondre à celui défini dans le modèle.

ID du modèle de scénario.

Nombre maximal d'opérations simultanées pouvant être effectuées sur les ressources. Par défaut, ce paramètre est vide. Vous pouvez le définir sur un entier supérieur ou égal à 0. Si vous spécifiez une valeur, ROS l'associe à la pile. Cette valeur peut affecter les opérations ultérieures sur la pile.

Ce paramètre prend effet uniquement lorsque le paramètre ChangeSetType est défini sur CREATE ou UPDATE. Valeurs possibles :

• Valeurs valides pour les ensembles de modifications de type CREATE :
  • Si vous définissez ce paramètre sur un entier supérieur à 0, cet entier est utilisé.
  • Si vous définissez ce paramètre sur 0 ou le laissez vide, aucune limite n'est imposée aux piles ROS. Toutefois, la valeur par défaut de Terraform est utilisée pour les piles Terraform. Dans la plupart des cas, la valeur par défaut de Terraform est 10.
• Valeurs valides pour les ensembles de modifications de type UPDATE :
  • Si vous définissez ce paramètre sur un entier supérieur à 0, cet entier est utilisé.
  • Si vous définissez ce paramètre sur 0, aucune limite n'est imposée aux piles ROS. Toutefois, la valeur par défaut de Terraform est utilisée pour les piles Terraform. Dans la plupart des cas, la valeur par défaut de Terraform est 10.
  • Si vous laissez ce paramètre vide, la valeur spécifiée dans la requête précédente est utilisée. Si ce paramètre était vide dans la requête précédente, aucune limite n'est imposée aux piles ROS. Toutefois, la valeur par défaut de Terraform est utilisée pour les piles Terraform. Dans la plupart des cas, la valeur par défaut de Terraform est 10.