Tous les produits
Search

Ce produit

    :CreateStack

    Centre de documentation

    :CreateStack

    Dernière mise à jour :Aug 05, 2026

    Crée une pile à partir d'un modèle ROS pour déployer un groupe de ressources.

    Description de l'opération

    Une pile est l'unité de gestion des ressources ROS (Vue d'ensemble). Limites :

    • Chaque compte Alibaba Cloud peut créer jusqu'à 200 piles.

    • Chaque pile peut contenir jusqu'à 200 ressources.

    L'exemple suivant crée une pile nommée MyStack dans la région de Chine (Hangzhou) avec TemplateBody défini sur {"ROSTemplateFormatVersion":"2015-09-01"}.

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    ros:CreateStack

    create

    *Stack

    acs:ros:{#regionId}:{#accountId}:stack/*

    Template

    acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    DisableRollback

    boolean

    Non

    Indique si le retour arrière doit être désactivé en cas d'échec de la création de la pile.

    Valeurs valides :

    • true : désactive le retour arrière.

    • false (par défaut) : active le retour arrière.

    false
    TemplateBody

    string

    Non

    Le corps du modèle. Longueur : 1 à 524 288 octets. Utilisez HTTP POST avec les paramètres du corps pour les contenus volumineux afin d'éviter les limites de longueur d'URL.

    Remarque

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

    {"ROSTemplateFormatVersion":"2015-09-01"}
    StackPolicyURL

    string

    Non

    L'URL du fichier de stratégie de pile. Prend en charge les URL HTTP, HTTPS et OSS (par exemple, oss://ros/stack-policy/demo ou oss://ros/stack-policy/demo?RegionId=cn-hangzhou). Taille maximale du fichier : 16 384 octets. Si aucune région OSS n'est spécifiée, la valeur RegionId est utilisée.

    Remarque

    Vous ne pouvez spécifier qu'un seul des paramètres suivants : StackPolicyBody ou StackPolicyURL.

    Longueur maximale de l'URL : 1 350 octets.

    oss://ros-stack-policy/demo
    TimeoutInMinutes

    integer

    Non

    Le délai d'expiration de la création de la pile. Unité : minutes.

    • Valeur par défaut : 60.

    • Valeurs valides : 10 à 1440.

    10
    StackPolicyBody

    string

    Non

    Le corps de la stratégie de pile. Longueur : 1 à 16 384 octets.

    Remarque

    Vous ne pouvez spécifier qu'un seul des paramètres suivants : StackPolicyBody ou StackPolicyURL.

    {"Statement": [{"Action": "Update:*", "Resource": "*", "Effect": "Allow", "Principal": "*"}]}
    StackName

    string

    Oui

    Le nom de la pile. Longueur maximale : 255 caractères. Doit commencer par une lettre et peut contenir des lettres, des chiffres, des tirets (-) et des traits de soulignement (_).

    MyStack
    RegionId

    string

    Oui

    L'identifiant de la région de la pile. Appelez DescribeRegions pour interroger les régions disponibles.

    cn-hangzhou
    ClientToken

    string

    Non

    Garantit l'idempotence de la requête. Doit être généré par le client et globalement unique. Longueur maximale : 64 caractères. Peut contenir des lettres, des chiffres, des tirets (-) et des traits de soulignement (_).

    Comment garantir l'idempotence

    123e4567-e89b-12d3-a456-42665544****
    TemplateURL

    string

    Non

    L'URL du fichier de modèle. Prend en charge les URL HTTP, HTTPS et OSS (par exemple, oss://ros/stack-policy/demo ou oss://ros/stack-policy/demo?RegionId=cn-hangzhou). Taille maximale du modèle : 524 288 octets. Si aucune région OSS n'est spécifiée, la valeur RegionId est utilisée.

    Remarque

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

    oss://ros-template/demo
    RamRoleName

    string

    Non

    Le nom du rôle RAM. ROS endosse ce rôle pour tous les appels d'API de pile, même lorsque l'utilisateur dispose d'autorisations directes, garantissant ainsi un accès à privilège minimum. Utiliser un rôle de pile.

    Si non spécifié, ROS utilise le rôle associé à la pile, ou un justificatif temporaire de votre compte si aucun rôle n'existe.

    Longueur maximale : 64 caractères.

    test-role
    DeletionProtection

    string

    Non

    Indique si la protection contre la suppression doit être activée sur la pile. Valeurs valides :

    • Enabled : active la protection contre la suppression.

    • Disabled (par défaut) : autorise la suppression de la pile via la console ROS ou l'API DeleteStack.

    Remarque

    La protection contre la suppression d'une pile imbriquée est identique à celle de sa pile racine.

    Enabled
    CreateOption

    string

    Non

    Le comportement post-création pour la pile. Valeurs valides :

    • KeepStackOnCreationComplete (par défaut) : conserve la pile et les ressources après la création. Compte dans le quota de piles.

    • AbandonStackOnCreationComplete : supprime la pile mais conserve les ressources après la création. Ne compte pas dans le quota de piles. La pile est conservée en cas d'échec de la création.

    • AbandonStackOnCreationRollbackComplete : supprime la pile après un retour arrière de création. Ne compte pas dans le quota de piles. La pile est conservée dans les autres scénarios de retour arrière.

    • ManuallyPay : nécessite un paiement manuel pour les ressources par abonnement lors de la création de la pile. Types de ressources pris en charge : ALIYUN::ECS::InstanceGroup, ALIYUN::RDS::DBInstance, ALIYUN::SLB::LoadBalancer, ALIYUN::VPC::EIP et ALIYUN::VPC::VpnGateway.

    • RetryOnNoStock : réessaie automatiquement la création de ressources en cas de stock insuffisant. Type de ressource pris en charge : ALIYUN::RDS::DBInstance.

    Remarque

    Vous ne pouvez spécifier qu'un seul des paramètres suivants : CreateOption ou CreateOptions.

    KeepStackOnCreationComplete
    CreateOptions

    array

    Non

    Les options de création pour la pile.

    string

    Non

    Option de création N. Valeurs valides :

    • KeepStackOnCreationComplete (par défaut) : conserve la pile et les ressources après la création. Compte dans le quota de piles.

    • AbandonStackOnCreationComplete : supprime la pile mais conserve les ressources après la création. Ne compte pas dans le quota de piles. La pile est conservée en cas d'échec de la création.

    • AbandonStackOnCreationRollbackComplete : supprime la pile après un retour arrière de création. Ne compte pas dans le quota de piles. La pile est conservée dans les autres scénarios de retour arrière.

    • ManuallyPay : nécessite un paiement manuel pour les ressources par abonnement lors de la création de la pile. Types de ressources pris en charge : ALIYUN::ECS::InstanceGroup, ALIYUN::RDS::DBInstance, ALIYUN::SLB::LoadBalancer, ALIYUN::VPC::EIP et ALIYUN::VPC::VpnGateway.

    • RetryOnNoStock : réessaie automatiquement la création de ressources en cas de stock insuffisant. Type de ressource pris en charge : ALIYUN::RDS::DBInstance.

    Remarque

    • Vous ne pouvez spécifier qu'un seul des paramètres suivants : CreateOption ou CreateOptions.

    • Les options de création ne peuvent pas être répétées. L'option KeepStackOnCreationComplete est mutuellement exclusive avec les options AbandonStackOnCreationComplete et AbandonStackOnCreationRollbackComplete.

    • La valeur maximale de N est 4.

    KeepStackOnCreationComplete
    TemplateId

    string

    Non

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

    Remarque

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

    5ecd1e10-b0e9-4389-a565-e4c15efc****
    TemplateVersion

    string

    Non

    La version du modèle. Ce paramètre prend effet uniquement lorsque vous spécifiez TemplateId.

    v1
    Parameters

    array<object>

    Non

    Les paramètres définis dans le modèle.

    object

    Non

    ParameterKey

    string

    Oui

    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 la valeur par défaut dans le modèle.

    La valeur maximale de N est 200. Le nom doit comporter de 1 à 128 caractères et ne peut pas commencer par aliyun ou acs:. Le nom ne peut pas contenir http:// ou https://.

    Remarque

    Parameters est un paramètre facultatif. Pour spécifier Parameters, vous devez spécifier à la fois Parameters.N.ParameterKey et Parameters.N.ParameterValue.

    InstanceId
    ParameterValue

    string

    Oui

    La valeur du paramètre N défini dans le modèle.

    La valeur maximale de N est 200. La valeur doit comporter de 0 à 128 caractères et ne peut pas commencer par aliyun ou acs:. La valeur ne peut pas contenir http:// ou https://.

    Remarque

    Parameters est un paramètre facultatif. Pour spécifier Parameters, vous devez spécifier à la fois Parameters.N.ParameterKey et Parameters.N.ParameterValue.

    i-xxxxxx
    NotificationURLs

    array

    Non

    L'URL de rappel pour les événements de pile. Valeurs valides :

    • URL HTTP POST. Longueur maximale : 1 024 octets.

    • EventBridge reçoit les notifications de changement d'état de la pile. Consultez les événements dans la console EventBridge.

    Remarque

    Régions prises en charge : Chine (Hangzhou), Chine (Shanghai), Chine (Pékin), Chine (Hong Kong) et Chine (Zhangjiakou).

    Valeur maximale de N : 5. ROS envoie des notifications sur les changements d'état de la pile, à l'exception des événements IN_PROGRESS. Avec le retour arrière activé, les événements CREATE_ROLLBACK et ROLLBACK remplacent les notifications CREATE_FAILED et UPDATE_FAILED. Les notifications incluent toujours les sorties (Outputs). Exemple de notification :

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

    http://my-site.com/ros-event

    string

    Non

    L'URL de rappel pour l'événement de pile N. Valeurs valides :

    • URL HTTP POST. Longueur maximale : 1 024 octets.

    • EventBridge reçoit les notifications de changement d'état de la pile. Consultez les événements dans la console EventBridge.

    Remarque

    Régions prises en charge : Chine (Hangzhou), Chine (Shanghai), Chine (Pékin), Chine (Hong Kong) et Chine (Zhangjiakou).

    Valeur maximale de N : 5. ROS envoie des notifications sur les changements d'état de la pile, à l'exception des événements IN_PROGRESS. Avec le retour arrière activé, les événements CREATE_ROLLBACK et ROLLBACK remplacent les notifications CREATE_FAILED et UPDATE_FAILED. Les notifications incluent toujours les sorties (Outputs). Exemple de notification :

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

    http://example.com/ros-event
    Tags

    array<object>

    Non

    Les balises de la pile.

    object

    Non

    Key

    string

    Oui

    La clé de la balise N de la pile.

    Valeurs valides : 1 à 20.

    Remarque

    • Tags est un paramètre facultatif. Pour spécifier Tags, vous devez spécifier Tags.N.Key.

    • Les balises de pile se propagent à chaque ressource qui prend en charge le balisage. Propagation des balises.

    usage
    Value

    string

    Non

    La valeur de la balise N de la pile.

    Valeurs valides : 1 à 20.

    Remarque

    Les balises de pile se propagent aux ressources pouvant être balisées. Propagation des balises.

    test
    ResourceGroupId

    string

    Non

    L'identifiant du groupe de ressources. Si non spécifié, la pile est ajoutée au groupe de ressources par défaut.

    Qu'est-ce qu'un groupe de ressources

    rg-acfmxazb4ph6aiy****
    Parallelism

    integer

    Non

    Le nombre maximal d'opérations simultanées sur les ressources.

    Valeur par défaut : vide. Accepte les entiers supérieurs ou égaux à 0.

    Remarque

    • Si supérieur à 0, la valeur spécifiée est utilisée. Si 0 ou vide, aucune limite ne s'applique aux piles ROS ; les piles Terraform utilisent la valeur par défaut de Terraform (généralement 10).

    • La valeur spécifiée persiste avec la pile et affecte les opérations ultérieures telles que les mises à jour.

    1
    TemplateScratchId

    string

    Non

    L'identifiant du scénario de ressource.

    Appelez ListTemplateScratches pour interroger les identifiants de scénarios de ressources.

    Remarque

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

    ts-aa9c62feab844a6b****
    TemplateScratchRegionId

    string

    Non

    L'identifiant de la région du scénario de ressource. Valeur par défaut : la valeur de RegionId.

    Appelez DescribeRegions pour interroger les régions disponibles.

    cn-hangzhou

    Cette opération utilise les paramètres communs.

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    RequestId

    string

    L'identifiant de la requête.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    StackId

    string

    L'identifiant de la pile.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****

    Exemples

    JSON format

    {
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
}

    Codes d'erreur

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.