ContinueCreateStack - - Centre de documentation Alibaba Cloud

Cette rubrique explique comment reprendre la création d'une pile ayant échoué. Dans cet exemple, la pile dont l'ID est 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** n'a pas pu être créée dans la région Chine (Hangzhou).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ContinueCreateStack	L'opération à effectuer. Définissez la valeur sur ContinueCreateStack.
StackId	String	Yes	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	L'ID de la pile.
RegionId	String	Yes	cn-hangzhou	L'ID de région de la pile. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
RamRoleName	String	No	test-role	Le nom du rôle RAM. Resource Orchestration Service (ROS) endosse le rôle RAM pour créer la pile et utilise les identifiants de ce rôle pour appeler les API des services Alibaba Cloud. ROS endosse le rôle RAM pour intervenir sur la pile. Si vous disposez des autorisations nécessaires pour intervenir sur la pile mais pas pour utiliser le rôle RAM, ROS endosse tout de même le rôle. Accordez uniquement les privilèges minimaux au rôle RAM. Si vous ne spécifiez pas ce paramètre, ROS endosse le rôle RAM existant associé à la pile. En l'absence de rôles RAM disponibles, ROS utilise un identifiant temporaire généré à partir des identifiants de votre compte. Le nom du rôle RAM peut compter jusqu'à 64 octets.
Mode	String	No	Recreate	Le mode selon lequel ROS reprend la création de la pile. Valeur par défaut : Recreate. Valeurs possibles : Recreate Si vous définissez ce paramètre sur Recreate, ROS poursuit uniquement la création des types de ressources suivants : Les ressources dont la création a échoué Les ressources que vous spécifiez via le paramètre RecreatingResources.N Les dépendances des ressources spécifiées dans le paramètre RecreatingResources.N Les ressources que vous n'avez pas encore créées Remarque Les paramètres RecreatingResources.N, TemplateBody et TemplateURL, ainsi que la section Parameters, prennent effet uniquement lorsque le paramètre Mode est défini sur Recreate. Ignore ROS ignore et écarte les ressources dont la création a échoué ou qui n'ont pas été créées, et marque la pile comme créée avec succès. Le corps du modèle utilisé pour créer la pile est modifié. Remarque Cette valeur est valide uniquement pour les piles ROS.
TemplateBody	String	No	{"ROSTemplateFormatVersion": "2015-09-01"}	La structure contenant le corps du modèle. La taille du corps du modèle doit être comprise entre 1 et 524 288 octets. Si la taille du corps du modèle dépasse la limite supérieure, ajoutez les paramètres au corps de la requête HTTP POST afin d'éviter les échecs de requête causés par des URL excessivement longues. Un modèle ROS est soumis aux limites suivantes : Vous pouvez modifier uniquement les sections suivantes du modèle : Description, Metadata, Resources et Outputs. Vous ne pouvez ni ajouter ni supprimer de sections dans le modèle. La section Resources est soumise aux restrictions suivantes : Vous ne pouvez pas supprimer les ressources ni modifier le corps du modèle pour les ressources dont vous ne souhaitez pas poursuivre la création. Vous pouvez supprimer les ressources ou modifier le corps du modèle pour les ressources dont vous souhaitez poursuivre la création. Vous pouvez ajouter des ressources à cette section. Remarque Ce paramètre prend effet uniquement lorsque le paramètre 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 aucun de ces paramètres, le modèle existant est utilisé.
TemplateURL	String	No	oss://ros-template/demo	L'URL du fichier contenant le corps du modèle. L'URL doit pointer vers un modèle hébergé sur un serveur web HTTP ou HTTPS, ou dans un compartiment Object Storage Service (OSS), tel que oss://ros/template/demo ou oss://ros/template/demo?RegionId=cn-hangzhou. La taille du corps du modèle peut atteindre 524 288 octets. Si vous ne spécifiez pas l'ID de région du compartiment OSS, la valeur du paramètre RegionId est utilisée. Remarque Ce paramètre prend effet uniquement lorsque le paramètre Mode est défini sur Recreate. Lorsque vous spécifiez le paramètre TemplateURL dans un modèle, celui-ci est soumis aux limites décrites pour le paramètre 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 aucun de ces paramètres, le modèle existant est utilisé.
DryRun	Boolean	No	false	Indique s'il faut uniquement valider la pile sans l'exécuter. Valeur par défaut : false. Valeurs possibles : true : valide uniquement la pile. false : valide et reprend la création de la pile.
TemplateId	String	No	5ecd1e10-b0e9-4389-a565-e4c15efc****	L'ID du modèle. Ce paramètre s'applique aux modèles partagés et aux modèles privés. Remarque Ce paramètre prend effet lorsque le paramètre `Mode` est défini sur `Recreate`. Lorsque vous spécifiez le paramètre TemplateId dans un modèle, celui-ci est soumis aux limites décrites pour le paramètre `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 aucun de ces paramètres, le modèle existant est utilisé.
TemplateVersion	String	No	v1	La version du modèle. Ce paramètre prend effet uniquement lorsque le paramètre TemplateId est spécifié.
RecreatingResources.N	String	No	WebServer	La ressource N dont ROS poursuit la création après l'échec initial. Vous pouvez ajouter de nouvelles ressources aux ressources recréées par ROS. ROS crée également toutes les dépendances de ces nouvelles ressources. Remarque Ce paramètre prend effet uniquement pour les piles ROS.
Parameters.N.ParameterKey	String	Yes	Amount	Le nom du paramètre de modèle N que vous souhaitez utiliser pour remplacer un autre paramètre. 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 indiqué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 prend effet uniquement lorsque le paramètre Mode est défini sur Recreate.
Parameters.N.ParameterValue	String	Yes	12	La valeur du paramètre de modèle N que vous souhaitez utiliser pour remplacer un autre paramètre. Valeur maximale de N : 200. Pour les piles ROS, les limites suivantes s'appliquent aux paramètres de modèle utilisés pour en remplacer d'autres : Vous ne pouvez pas modifier les valeurs de condition dans la section Conditions d'un modèle, c'est-à-dire passer de true à false ou inversement. Les paramètres de modèle peuvent être référencés uniquement par les ressources dont ROS poursuit la création. Remarque Ce paramètre prend effet uniquement lorsque le paramètre Mode est défini sur Recreate.
Parallelism	Long	No	1	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 le définir sur un entier supérieur ou égal à 0. Remarque Si vous définissez ce paramètre sur un entier supérieur à 0, cette valeur est utilisée. 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 dans Terraform est 10. Si vous laissez ce paramètre vide, la valeur spécifiée lors de la requête précédente est utilisée. Si ce paramètre était également vide lors de la requête précédente, aucune limite n'est imposée aux piles ROS. Cependant, la valeur par défaut de Terraform s'applique aux piles Terraform (généralement 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.
RecreatingOptions.N	String	No	CreateNewPrepaidInstance	L'option N adoptée par ROS lors de la reprise de la création de la pile. Ce paramètre prend effet lorsque le paramètre `Mode` est défini sur `Recreate`. Valeurs possibles : 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 déjà créées, ainsi que leurs dépendances pertinentes, 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, celles-ci 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 ont été modifiés, ainsi que leurs dépendances pertinentes. Cette option facilite la configuration du paramètre RecreatingResources.N. Toutefois, 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 avaient é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 la conserve car les ressources par abonnement ne peuvent pas être supprimées. Si vous ne définissez pas le paramètre RecreatingOptions.N sur CreateNewPrepaidInstance, ROS tente de réutiliser une instance existante. Dans ce cas, vous ne pourrez pas modifier les propriétés de la ressource, ou seulement un nombre restreint d'entre elles.

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

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6	L'ID de la requête.
StackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	L'ID de la pile.
DryRunResult	Object		Le résultat de la validation.
ParametersAllowedToBeModified	Array of String	description	Les paramètres pouvant être modifiés. L'opération de modification de ces paramètres ne génère pas d'erreur de validation. Remarque Ce paramètre est renvoyé uniquement si le paramètre DryRun est défini sur `true`. La valeur du paramètre ParametersAllowedToBeModified varie en fonction des valeurs des paramètres Mode, Template*, RecreatingResources.N et RecreatingOptions.N.
ParametersConditionallyAllowedToBeModified	Array of String	name	Les paramètres pouvant être modifiés sous certaines conditions. Les nouvelles valeurs des paramètres déterminent si l'opération de modification entraîne une erreur de validation. Remarque Ce paramètre est renvoyé uniquement si le paramètre DryRun est défini sur `true`. La valeur du paramètre ParametersConditionallyAllowedToBeModified varie en fonction des valeurs des paramètres Mode, Template*, RecreatingResources.N et RecreatingOptions.N.
ParametersNotAllowedToBeModified	Array of String	cidr	Les paramètres qui ne peuvent pas être modifiés. L'opération de modification de ces paramètres entraîne une erreur de validation. Remarque Ce paramètre est renvoyé uniquement si le paramètre DryRun est défini sur `true`. La valeur du paramètre ParametersNotAllowedToBeModified varie en fonction des valeurs des paramètres Mode, Template*, RecreatingResources.N et RecreatingOptions.N.

Exemples

Exemple de requête

http(s)://ros.aliyuncs.com/?Action=ContinueCreateStack
&RegionId=cn-hangzhou
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ContinueCreateStackResponse>
    <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6</RequestId>
    <StackId>4a6c9851-3b0f-4f5f-b4ca-a14bf691****</StackId>
</ContinueCreateStackResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur du service.

Http status code	Error code	Error message	Description
400	CircularDependency	Circular Dependency Found: {reason}.	Le message d'erreur indique que le modèle contient des dépendances circulaires. reason représente la cause de l'erreur.
400	InvalidSchema	{reason}.	Le message d'erreur indique que le format du modèle est invalide. reason représente la cause de l'erreur.
400	InvalidTemplateAttribute	The Referenced Attribute ({resource} {name}) is incorrect.	Le message d'erreur indique que la propriété de ressource référencée dans la section Outputs du modèle est invalide. resource correspond au nom de la ressource. name correspond au nom de la propriété.
400	InvalidTemplatePropertyType	The specified value type of ({resource} {section}) is incorrect.	Le message d'erreur indique que le type de la propriété de ressource définie dans une section du modèle est invalide. resource correspond au nom de la ressource. section correspond au nom de la section.
400	InvalidTemplateReference	The specified reference "{name}" (in {referencer}) is incorrect.	Le message d'erreur indique que le modèle contient une référence invalide. name correspond au nom de la référence. referencer correspond au nom de l'élément référençant.
400	InvalidTemplateSection	The template section is invalid: {section}.	Le message d'erreur indique que le modèle contient une section invalide. section correspond au nom de la section.
400	InvalidTemplateVersion	The template version is invalid: {reason}.	Le message d'erreur indique que la version du modèle est invalide. reason représente la cause de l'erreur.
400	StackValidationFailed	{reason}.	Le message d'erreur indique que la validation de la pile a échoué. reason représente la cause de l'erreur.
400	UnknownUserParameter	The Parameter ({name}) was not defined in template.	Le message d'erreur indique que le paramètre spécifié n'est pas défini dans le modèle. name correspond au nom du paramètre.
400	UserParameterMissing	The Parameter {name} was not provided.	Le message d'erreur indique qu'aucune valeur n'a été fournie pour le paramètre défini dans le modèle. name correspond au nom du paramètre.
400	ContinueCreateStackValidationFailed	{reason}.	Le message d'erreur indique que la validation de l'opération de reprise de création de la pile a échoué. reason représente la cause de l'erreur.
404	ResourceNotFound	The Resource ({name}) could not be found in Stack {stack}.	Le message d'erreur indique que la ressource n'existe pas dans la pile. name correspond au nom de la ressource. stack correspond au nom ou à l'ID de la pile.
404	StackNotFound	The Stack ({name}) could not be found.	Le message d'erreur indique que la pile n'existe pas. name correspond au nom ou à l'ID de la pile.
409	ActionInProgress	Stack {name} already has an action ({action}) in progress.	Le message d'erreur indique que la pile est en cours de modification. name correspond au nom ou à l'ID de la pile. action correspond à l'opération de modification.
404	TemplateNotFound	The Tempalte ({ ID }) could not be found.	Le message d'erreur indique que le modèle n'existe pas. ID correspond à l'ID du modèle.
404	TemplateNotFound	The Template { ID } with version { version } could not be found.	Le message d'erreur indique que le modèle ou la version du modèle n'existe pas. ID correspond à l'ID du modèle. version correspond à la version du modèle.