Tous les produits
Search
Centre de documentation

Resource Orchestration Service:ALIYUN::ROS::StackGroup

Dernière mise à jour :Aug 10, 2026

Créez un groupe de piles.

Syntaxe

{
  "Type": "ALIYUN::ROS::StackGroup",
  "Properties": {
    "Description": String,
    "Parameters": Map,
    "ResourceGroupId": String,
    "DynamicTemplateBody": Map,
    "StackGroupName": String,
    "TemplateVersion": String,
    "AdministrationRoleName": String,
    "TemplateBody": Map,
    "TemplateURL": String,
    "AutoDeployment": Map,
    "PermissionModel": String,
    "ExecutionRoleName": String,
    "TemplateId": String
  }
}

Paramètres

Paramètre Type Obligatoire Modifiable Description Contrainte
Description String Non Non Description du groupe de piles. Longueur comprise entre 1 et 256 caractères.
Parameters Map Non Non Détails des paramètres. Aucune
ResourceGroupId String Non Non ID du groupe de ressources. Valeur par défaut : groupe de ressources par défaut.
DynamicTemplateBody Map Non Non Structure contenant le corps du modèle. Utilisez les expressions de fonction ROS pour obtenir le contenu du modèle.
StackGroupName String Oui Non Nom du groupe de piles. Doit être unique au sein d'une région.

Maximum de 255 caractères. Peut contenir des chiffres, des lettres, des traits d'union (-) et des traits de soulignement (_). Doit commencer par un chiffre ou une lettre.

TemplateVersion String Non Non Version du modèle. Valeur par défaut : dernière version.
AdministrationRoleName String Non Non Nom du rôle RAM pour le compte administrateur lors de la création d'un groupe de piles autogéré. Obligatoire pour les groupes de piles autogérés.

Valeur par défaut : AliyunROSStackGroupAdministrationRole. Ce rôle assume AliyunROSStackGroupExecutionRole pour gérer les piles des instances de pile dans le groupe de piles.

Entre 1 et 64 caractères. Peut contenir des lettres, des chiffres et des traits d'union (-).

TemplateBody Map Non Non Structure contenant le corps du modèle. Longueur comprise entre 1 et 524 288 octets.

Si le corps du modèle dépasse cette limite, ajoutez des paramètres au corps de la requête HTTP POST afin d'éviter les échecs de requête dus à des URL excessivement longues.

Remarque Vous devez spécifier un seul des paramètres TemplateBody, TemplateURL et TemplateId.
TemplateURL String Non Non URL du fichier contenant le corps du modèle.

L'URL doit pointer vers un modèle sur un serveur web ou dans un compartiment Object Storage Service (OSS). La longueur du corps du modèle doit être comprise entre 1 et 524 288 octets.

Exemples d'URL OSS : oss://ros/template/demo et oss://ros/template/demo?RegionId=cn-hangzhou.

Si la région du compartiment OSS n'est pas spécifiée, la valeur du paramètre RegionId est utilisée.
Remarque Vous devez spécifier un seul des paramètres TemplateBody, TemplateURL et TemplateId.
AutoDeployment Map Non Non Paramètres de déploiement automatique. Paramètres de AutoDeployment.
PermissionModel String Non Non Modèle d'autorisation. Valeurs valides :
  • SELF_MANAGED : modèle d'autorisation autogéré.

    Nécessite la création de rôles RAM pour les comptes administrateur et d'exécution avec une relation de confiance afin de déployer des piles au sein du compte d'exécution.

  • SERVICE_MANAGED : modèle d'autorisation géré par le service.

    ROS crée des rôles liés au service pour les comptes administrateur et d'exécution. Le compte administrateur utilise son rôle pour déployer des piles au sein du compte d'exécution.

Remarque Pour utiliser le modèle d'autorisation géré par le service, votre compte doit être un compte de gestion ou un compte administrateur délégué dans l'annuaire des ressources avec l'accès approuvé activé. Pour plus d'informations, consultez Étape 1 : (Facultatif) Créer un compte administrateur délégué et Étape 2 : Activer l'accès approuvé.
ExecutionRoleName String Non Non Nom du rôle RAM pour le compte d'exécution lors de la création d'un groupe de piles autogéré. Obligatoire pour les groupes de piles autogérés.

Valeur par défaut : AliyunROSStackGroupExecutionRole. Ce rôle gère les piles des instances de pile dans le groupe de piles.

Entre 1 et 64 caractères. Peut contenir des lettres, des chiffres et des traits d'union (-).

TemplateId String Non Non ID du modèle. S'applique aux modèles partagés et privés.
Remarque Vous devez spécifier un seul des paramètres TemplateBody, TemplateURL et TemplateId.

Syntaxe de AutoDeployment

"AutoDeployment": {
  "Enabled": Boolean,
  "RetainStacksOnAccountRemoval": Boolean
}

Paramètres de AutoDeployment

Paramètre Type Obligatoire Modifiable Description Contrainte
Enabled Boolean Oui Non Indique s'il faut activer le déploiement automatique. Valeurs valides :
  • true : active le déploiement automatique.

    Lorsqu'un membre est ajouté au dossier, ROS déploie les instances de pile du groupe de piles au sein de ce membre.

    Lorsqu'un membre est supprimé du dossier, les instances de pile au sein de ce membre sont supprimées.

  • false : désactive le déploiement automatique.

    Les instances de pile restent inchangées lorsque l'appartenance au dossier change.

RetainStacksOnAccountRemoval Boolean Non Non Indique s'il faut conserver les piles d'un membre lorsque celui-ci est supprimé du dossier. Valeurs valides :
  • true : conserve les piles.
  • false : supprime les piles.
Remarque Obligatoire lorsque Enabled est défini sur true.

Paramètres de réponse

Fn::GetAtt

StackGroupId : ID du groupe de piles.

Exemples

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "StackGroupName": {
      "Type": "String"
    },
    "TemplateId": {
      "Type": "String"
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ROS::StackGroup",
      "Properties": {
        "StackGroupName": {
          "Ref": "StackGroupName"
        },
        "TemplateId": {
          "Ref": "TemplateId"
        }
      }
    }
  },
  "Outputs": {
    "StackGroupId": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "StackGroupId"
        ]
      }
    }
  }
}