ContinueCreateStack - - Centre de documentation Alibaba Cloud

Reprend la création d'une pile après l'échec de sa création.

Description de l'opération

Cette rubrique fournit un exemple sur la manière de reprendre la création d'une pile après l'échec de sa création. Dans cet exemple, la pile dont l'identifiant est 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** est créée dans la région Chine (Hangzhou).

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:ContinueCreateStack

update

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
StackId	string	Oui	L'identifiant de la pile.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
RegionId	string	Oui	L'identifiant de la région de la pile. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou
RamRoleName	string	Non	Le nom du rôle RAM. Resource Orchestration Service (ROS) endosse le rôle RAM pour créer la pile et utilise les informations d'identification du rôle pour appeler les API des services Alibaba Cloud. ROS endosse le rôle RAM pour effectuer des opérations sur la pile. Si vous disposez des autorisations nécessaires pour effectuer des opérations sur la pile, mais que vous n'avez pas les autorisations d'utilisation du rôle RAM, ROS endosse tout de même le rôle RAM. Vous devez vous assurer que le principe du moindre privilège est appliqué au rôle RAM. Si vous ne spécifiez pas ce paramètre, ROS endosse le rôle existant associé à la pile. Si aucun rôle n'est disponible, ROS utilise des informations d'identification temporaires générées à partir des informations d'identification de votre compte. Le nom du rôle RAM peut comporter jusqu'à 64 octets.	test-role
Mode	string	Non	Le mode dans lequel ROS reprend la création de la pile. Valeurs valides : Recreate (valeur par défaut) Si vous définissez ce paramètre sur Recreate, ROS reprend uniquement la création des types de ressources suivants : Ressources dont la création a échoué Ressources que vous spécifiez pour RecreatingResources.N Dépendances des ressources que vous spécifiez pour RecreatingResources.N Ressources que vous n'avez pas créées Remarque RecreatingResources.N, TemplateBody, TemplateURL et Parameters ne prennent effet que lorsque Mode est défini sur Recreate. Ignore ROS ignore et abandonne les ressources dont la création a échoué et que vous n'avez pas créées, et considère que la pile est créée avec succès. Le corps du modèle que vous utilisez pour créer la pile est modifié. Remarque Ce mode est disponible uniquement pour les piles ROS.	Recreate
TemplateBody	string	Non	La structure qui contient le corps du modèle. Le corps du modèle doit comporter entre 1 et 524 288 octets. Si la longueur 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 de requête dus à des URL excessivement longues. Un modèle ROS est soumis aux limites suivantes : Vous pouvez uniquement modifier les sections suivantes dans le modèle : Description, Metadata, Resources et Outputs. Vous ne pouvez pas ajouter de sections au modèle ni en supprimer. La section Resources est soumise aux limites suivantes : Vous ne pouvez pas supprimer les ressources ni modifier le corps du modèle pour les ressources dont vous ne souhaitez pas reprendre la création. Vous pouvez supprimer les ressources ou modifier le corps du modèle pour les ressources dont vous souhaitez reprendre la création. Vous pouvez ajouter des ressources à cette section. Remarque Ce paramètre ne prend effet que lorsque Mode est défini sur Recreate. Vous ne pouvez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId. Si vous ne spécifiez pas ces paramètres, le modèle existant est utilisé.	{"ROSTemplateFormatVersion": "2015-09-01"}
TemplateURL	string	Non	L'URL du fichier qui contient 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 Object Storage Service (OSS), par exemple oss://ros/template/demo ou oss://ros/template/demo?RegionId=cn-hangzhou. Le corps du modèle peut comporter jusqu'à 524 288 octets. Si vous ne spécifiez pas l'identifiant de la région du compartiment OSS, la valeur de RegionId est utilisée. Remarque Ce paramètre ne prend effet que lorsque Mode est défini sur Recreate. Lorsque vous spécifiez le TemplateURL d'un modèle, le modèle est soumis aux limites décrites pour TemplateBody dans cette rubrique. Vous ne pouvez spécifier qu'un seul des paramètres suivants : TemplateBody, TemplateURL et TemplateId. Si vous ne spécifiez pas ces paramètres, le modèle existant est utilisé.	oss://ros-template/demo
DryRun	boolean	Non	Indique si la pile dans la requête doit uniquement être validée. Valeurs valides : true : valide uniquement la pile. false (valeur par défaut) : valide et reprend la création de la pile.	false
TemplateId	string	Non	L'identifiant du modèle. Ce paramètre s'applique aux modèles partagés et privés. Remarque Ce paramètre prend effet lorsque `Mode` est défini sur `Recreate`. Lorsque vous spécifiez le TemplateId d'un modèle, le modèle est soumis aux limites décrites pour `TemplateBody` dans cette rubrique. Vous ne pouvez spécifier qu'un seul des paramètres suivants : `TemplateBody`, `TemplateURL` et `TemplateId`. Si vous ne spécifiez pas ces paramètres, le modèle existant est utilisé.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	Non	La version du modèle. Ce paramètre ne prend effet que lorsque TemplateId est spécifié.	v1
RecreatingResources	array	Non	Les ressources dont ROS reprend la création après l'échec de la création des ressources. Vous pouvez ajouter de nouvelles ressources à celles dont ROS reprend la création. ROS reprend la création de toutes les dépendances des nouvelles ressources. Remarque Ce paramètre est disponible uniquement pour les piles ROS.	WebServer
	string	Non	La ressource dont ROS reprend la création après l'échec de la création de la ressource. Vous pouvez ajouter de nouvelles ressources à celles dont ROS reprend la création. ROS reprend la création de toutes les dépendances des nouvelles ressources. Remarque Ce paramètre est disponible uniquement pour les piles ROS.	WebServer
Parameters	array<object>	Non	Les paramètres du modèle que vous souhaitez utiliser pour remplacer des paramètres spécifiques.
	object	Non
ParameterKey	string	Oui	Le nom du paramètre de modèle N que vous souhaitez utiliser pour remplacer un paramètre spécifique. Si vous ne spécifiez pas le nom et la valeur d'un paramètre de modèle, ROS utilise le nom et la valeur spécifiés lors de l'opération précédente effectuée pour créer la pile. Valeur maximale de N : 200. Remarque Ce paramètre ne prend effet que lorsque Mode est défini sur Recreate.	Amount
ParameterValue	string	Oui	La valeur du paramètre de modèle N que vous souhaitez utiliser pour remplacer un paramètre spécifique. Valeur maximale de N : 200. Pour les piles ROS, les paramètres de modèle que vous utilisez pour remplacer des paramètres spécifiques sont soumis aux limites suivantes : Vous ne pouvez pas modifier les valeurs de condition dans la section Conditions d'un modèle de true à false ou de false à true. Les paramètres de modèle ne peuvent être référencés que par les ressources dont ROS reprend la création. Remarque Ce paramètre ne prend effet que lorsque Mode est défini sur Recreate.	12
Parallelism	integer	Non	Le nombre maximal d'opérations simultanées pouvant être effectuées sur les ressources. Par défaut, ce paramètre est vide. Vous pouvez définir ce paramètre sur un entier supérieur ou égal à 0. Remarque 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. Cependant, la valeur par défaut de Terraform est utilisée pour les piles Terraform. Dans la plupart des cas, la valeur par défaut dans Terraform est 10. Si vous laissez ce paramètre vide, la valeur que vous avez spécifiée pour ce paramètre dans la requête précédente est utilisée. Si vous avez laissé ce paramètre vide dans la requête précédente, aucune limite n'est imposée aux piles ROS. Cependant, la valeur par défaut de Terraform est utilisée pour les piles Terraform. Dans la plupart des cas, la valeur par défaut dans Terraform est 10. Si vous définissez ce paramètre sur une valeur spécifique, ROS associe cette valeur à la pile. Cette valeur affecte les opérations ultérieures sur la pile.	1
RecreatingOptions	array	Non	Les options que ROS adopte lorsqu'il reprend la création de la pile.
	string	Non	L'option que ROS adopte lorsqu'il reprend la création de la pile. Ce paramètre prend effet lorsque `Mode` est défini sur `Recreate`. Valeurs valides : TryToFixSignalFailureByRerunEcsCommand : ROS tente de corriger les signaux existants de type FAILURE. Lorsque la création des ressources ALIYUN::ROS::WaitCondition échoue, ROS utilise les ressources ALIYUN::ECS::RunCommand et ALIYUN::ECS::Invocation associées et créées, ainsi que les dépendances correspondantes, pour recréer les ressources ALIYUN::ROS::WaitCondition. Remarque Cette valeur est valide uniquement pour les piles ROS. IgnoreExistingSignalFailure : ROS ignore les signaux existants de type FAILURE. Si la création des ressources ALIYUN::ROS::WaitCondition échoue, les ressources sont considérées comme créées avec succès lorsque ROS reprend la création de la pile. Remarque Cette valeur est valide uniquement pour les piles ROS. AutoRecreatingResources : ROS recrée automatiquement les ressources dont le contenu du modèle ou les paramètres référencés sont modifiés, ainsi que les dépendances correspondantes. Cette option facilite les configurations de RecreatingResources.N. Cependant, des ressources inutiles peuvent également être recréées. Remarque Cette valeur est valide uniquement pour les piles ROS. CreateNewPrepaidInstance : ROS crée une nouvelle instance par abonnement si la création des ressources par abonnement échoue, ou si vous utilisez ROS pour recréer des ressources par abonnement qui ont été créées avec succès. Remarque Cette valeur est valide uniquement pour les piles ROS. Si une instance par abonnement est déjà créée, ROS conserve cette instance car les ressources par abonnement ne peuvent pas être supprimées. Si vous ne définissez pas RecreatingOptions.N sur CreateNewPrepaidInstance, ROS tente de réutiliser une instance existante. Si ROS réutilise l'instance, vous ne pouvez pas modifier les propriétés de la ressource, ou vous ne pouvez modifier qu'un petit nombre de propriétés de la ressource.	CreateNewPrepaidInstance

Pour plus d'informations sur les paramètres de requête courants, consultez la rubrique Paramètres courants.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	B288A0BE-D927-4888-B0F7-B35EF84B6E6
StackId	string	L'identifiant de la pile.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
DryRunResult	object	Le résultat de la validation.
ParametersAllowedToBeModified	array	Les paramètres qui peuvent être modifiés.
	string	Le paramètre qui peut être modifié. L'opération effectuée pour modifier les paramètres ne provoque pas d'erreur de validation. Remarque Ce paramètre est renvoyé uniquement si DryRun est défini sur `true`. La valeur de ParametersAllowedToBeModified varie en fonction des valeurs de Mode, Template*, RecreatingResources.N et RecreatingOptions.N.	description
ParametersConditionallyAllowedToBeModified	array	Les paramètres qui peuvent être modifiés sous certaines conditions.
	string	Le paramètre qui peut être modifié sous certaines conditions. Les nouvelles valeurs des paramètres déterminent si l'opération effectuée pour modifier les paramètres provoque une erreur de validation. Remarque Ce paramètre est renvoyé uniquement si DryRun est défini sur `true`. La valeur de ParametersConditionallyAllowedToBeModified varie en fonction des valeurs de Mode, Template*, RecreatingResources.N et RecreatingOptions.N.	name
ParametersNotAllowedToBeModified	array	Les paramètres qui ne peuvent pas être modifiés.
	string	Le paramètre qui ne peut pas être modifié. L'opération effectuée pour modifier les paramètres provoque une erreur de validation. Remarque Ce paramètre est renvoyé uniquement si DryRun est défini sur `true`. La valeur de ParametersNotAllowedToBeModified varie en fonction des valeurs de Mode, Template*, RecreatingResources.N et RecreatingOptions.N.	cidr

Exemples

JSON format

{
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
  "DryRunResult": {
    "ParametersAllowedToBeModified": [
      "description"
    ],
    "ParametersConditionallyAllowedToBeModified": [
      "name"
    ],
    "ParametersNotAllowedToBeModified": [
      "cidr"
    ]
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.