Tous les produits
Search
Centre de documentation

Resource Orchestration Service:ALIYUN::ROS::StackInstances

Dernière mise à jour :Aug 10, 2026

Crée des instances de pile dans les comptes et les régions spécifiés.

Syntaxe

{
  "Type": "ALIYUN::ROS::StackInstances",
  "Properties": {
    "OperationPreferences": Map,
    "RetainStacks": Boolean,
    "RegionIds": List,
    "AccountIds": List,
    "ParameterOverrides": Map,
    "StackGroupName": String,
    "DeploymentTargets": Map,
    "OperationDescription": String,
    "DisableRollback": Boolean,
    "TimeoutInMinutes": Integer
  }
}

Propriétés

Propriété Type Obligatoire Modifiable Description Contrainte
OperationPreferences Map Non Non Préférences d'opération pour la création des instances de pile. Pour plus d'informations, consultez Propriétés OperationPreferences.
Remarque
  • Spécifiez l'un des paramètres MaxConcurrentCount ou MaxConcurrentPercentage, mais pas les deux simultanément.
  • Spécifiez l'un des paramètres FailureToleranceCount ou FailureTolerancePercentage, mais pas les deux simultanément.
RetainStacks Boolean Non Non Indique s'il faut conserver les piles associées lors de la suppression des instances de pile. Valeurs valides :
  • true : conserve les piles associées lorsque les instances de pile sont supprimées.
  • false : supprime les piles associées lorsque les instances de pile sont supprimées.
RegionIds List Oui Non Régions dans lesquelles créer les instances de pile. Spécifiez un maximum de 20 ID de région.
AccountIds List Non Non Comptes dans lesquels déployer les piles à l'aide des autorisations gérées par l'utilisateur. Spécifiez un maximum de 20 ID de compte.
ParameterOverrides Map Non Non Paramètres à remplacer. Aucune
StackGroupName String Oui Non Nom du groupe de piles. Le nom doit être unique au sein d'une région.

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

DeploymentTargets Map Non Non Dossiers dans lesquels déployer les piles à l'aide des autorisations gérées par le service. Pour plus d'informations, consultez Propriété DeploymentTargets.
OperationDescription String Non Non Description de l'opération de création des instances de pile. La description doit comporter entre 1 et 256 caractères.
DisableRollback Boolean Non Non Indique s'il faut désactiver la restauration en cas d'échec de création des instances de pile. Valeurs valides :
  • true : désactive la restauration.
  • false : active la restauration. Il s'agit de la valeur par défaut.
TimeoutInMinutes Integer Non Non Délai d'expiration pour la création des instances de pile. Valeur par défaut : 60.

Unité : minutes.

Syntaxe OperationPreferences

"OperationPreferences": {
  "MaxConcurrentPercentage": Integer,
  "MaxConcurrentCount": Integer,
  "FailureTolerancePercentage": Integer,
  "FailureToleranceCount": Integer
}

Propriétés OperationPreferences

Propriété Type Obligatoire Modifiable Description Contrainte

| MaxConcurrentPercentage | Integer | Non | Non | Pourcentage maximal de comptes par région dans lesquels les opérations de pile peuvent être exécutées simultanément. |


Si la valeur numérique du pourcentage n'est pas un entier, Resource Orchestration Service (ROS) l'arrondit à l'entier inférieur.



Si vous ne définissez pas le paramètre MaxConcurrentPercentage, la valeur par défaut 1 est utilisée.


Valeurs valides : 1 à 100. |

| MaxConcurrentCount | Integer | Non | Non | Nombre maximal de comptes par région dans lesquels les opérations de pile peuvent être exécutées simultanément. |


Si vous ne définissez pas le paramètre MaxConcurrentCount, la valeur par défaut 1 est utilisée.


Valeurs valides : 1 à 20. |

| FailureTolerancePercentage | Integer | Non | Non | Pourcentage maximal de comptes par région dans lesquels les échecs d'opération de pile sont autorisés. | Si cette valeur est dépassée dans une région, ROS interrompt l'opération dans cette région.


Si la valeur numérique du pourcentage n'est pas un entier, ROS l'arrondit à l'entier inférieur.



Si vous ne définissez pas le paramètre FailureTolerancePercentage, la valeur par défaut 0 est utilisée.


Valeurs valides : 0 à 100. |

| FailureToleranceCount | Integer | Non | Non | Nombre maximal de comptes par région dans lesquels les échecs d'opération de pile sont autorisés. | Si cette valeur est dépassée dans une région, ROS interrompt l'opération dans cette région.


Si ROS interrompt l'opération dans une région, il interrompt également l'opération dans les autres régions.



Si vous ne définissez pas le paramètre FailureToleranceCount, la valeur par défaut 0 est utilisée.


Valeurs valides : 0 à 100. |

Syntaxe DeploymentTargets

"DeploymentTargets": {
  "RdFolderIds": List
}

Propriété DeploymentTargets

Propriété Type Obligatoire Modifiable Description Contrainte
RdFolderIds List Non Non ID des dossiers du répertoire de ressources. Spécifiez un maximum de cinq ID de dossier.

Vous pouvez créer des instances de pile dans tous les membres contenus dans les dossiers spécifiés.

Si vous spécifiez le dossier Root, des instances de pile sont créées dans tous les membres du répertoire de ressources.

Remarque Pour afficher les ID de dossier, accédez à la page Vue d'ensemble de la console Resource Management. Pour plus d'informations, consultez Informations de base sur les dossiers.

Paramètres de réponse

Fn::GetAtt

  • LastOperationId : ID de la dernière opération.

  • Stacks : détails des piles.

Exemple

Format JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "RegionIds": {
      "Type": "Json"
    },
    "ParameterOverrides": {
      "Type": "Json"
    },
    "StackGroupName": {
      "Type": "String"
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ROS::StackInstances",
      "Properties": {
        "RegionIds": {
          "Ref": "RegionIds"
        },
        "ParameterOverrides": {
          "Ref": "ParameterOverrides"
        },
        "StackGroupName": {
          "Ref": "StackGroupName"
        }
      }
    }
  },
  "Outputs": {
    "LastOperationId": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "LastOperationId"
        ]
      }
    },
    "Stacks": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "Stacks"
        ]
      }
    }
  }
}