GetStackInstance - - Centre de documentation Alibaba Cloud

Cet exemple récupère les détails d’une pile déployée dans la région Chine (Pékin) du compte Alibaba Cloud 151266687691****. La pile est déployée dans un groupe de piles nommé MyStackGroup. Ce groupe de piles dispose d’autorisations en gestion autonome et est déployé dans la région Chine (Hangzhou).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d’appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	No	GetStackInstance	Opération à effectuer. Définissez la valeur sur GetStackInstance.
RegionId	String	No	cn-hangzhou	ID de la région du groupe de piles. Appelez l’opération DescribeRegions pour obtenir la liste des régions disponibles.
StackGroupName	String	No	MyStackGroup	Nom du groupe de piles. Il doit être unique au sein d’une région. Le nom peut contenir jusqu’à 255 caractères, incluant des chiffres, des lettres, des traits d’union (-) et des tirets bas (_). Il doit commencer par un chiffre ou une lettre.
StackInstanceAccountId	String	No	151266687691****	ID du compte propriétaire de la pile. Si le groupe de piles dispose d’autorisations en gestion autonome, la pile appartient à un compte Alibaba Cloud. Si le groupe de piles dispose d’autorisations en gestion par service, la pile appartient à un membre d’un annuaire de ressources. Remarque Pour plus d’informations sur le compte, consultez la page Overview.
StackInstanceRegionId	String	No	cn-beijing	ID de la région de la pile.

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	B8A6B693-82C8-419D-8796-DE99EC33CFF9	ID de la requête.
StackInstance	Object		Détails de la pile.
Status	String	CURRENT	État de la pile. Valeurs possibles : CURRENT : la pile est synchronisée avec le groupe de piles. OUTDATED : la pile n’est pas synchronisée avec le groupe de piles. Les causes possibles sont les suivantes : Échec de la création des piles lors de l’appel à l’opération CreateStackInstances. Échec de la mise à jour des piles, ou mise à jour partielle uniquement, lors de l’appel aux opérations UpdateStackInstances ou UpdateStackGroup. L’opération de création ou de mise à jour est toujours en cours.
StackGroupId	String	fd0ddef9-9540-4b42-a464-94f77835****	ID du groupe de piles.
StackId	String	35ad60e3-6a92-42d8-8812-f0700d45****	ID de la pile. Remarque Ce paramètre est renvoyé uniquement si la pile est dans l’état CURRENT.
DriftDetectionTime	String	2020-02-27T07:47:47	Horodatage de la dernière détection de dérive réussie sur le groupe de piles. Remarque Ce paramètre est renvoyé uniquement si une détection de dérive a été effectuée sur le groupe de piles.
StackDriftStatus	String	IN_SYNC	État de la pile lors de la dernière détection de dérive réussie sur le groupe de piles. Valeurs possibles : DRIFTED : la pile a subi une dérive. NOT_CHECKED : aucune détection de dérive réussie n’a été effectuée sur la pile. IN_SYNC : la pile est synchronisée. Remarque Ce paramètre est renvoyé uniquement si une détection de dérive a été effectuée sur le groupe de piles.
StatusReason	String	User initiated stop	Raison de l’état OUTDATED de la pile. Remarque Ce paramètre est renvoyé uniquement si la pile est dans l’état OUTDATED.
ParameterOverrides	Array of ParameterOverride		Paramètres de substitution.
ParameterKey	String	Amount	Nom du paramètre de substitution.
ParameterValue	String	1	Valeur du paramètre de substitution.
StackGroupName	String	MyStackGroup	Nom du groupe de piles.
AccountId	String	151266687691****	ID du compte propriétaire de la pile.
RegionId	String	cn-beijing	ID de la région de la pile.
RdFolderId	String	fd-4PvlVLOL8v	ID du dossier dans l’annuaire de ressources. Remarque Ce paramètre est renvoyé uniquement si le groupe de piles dispose d’autorisations en gestion par service.

Exemples

Exemple de requête

http(s)://ros.aliyuncs.com/?Action=GetStackInstance
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&StackInstanceAccountId=151266687691****
&StackInstanceRegionId=cn-beijing
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<GetStackInstanceResponse>
    <RequestId>B8A6B693-82C8-419D-8796-DE99EC33CFF9</RequestId>
    <StackInstance>
        <Status>OUTDATED</Status>
        <AccountId>151266687691****</AccountId>
        <StatusReason>Cancelled since failure tolerance has exceeded</StatusReason>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <RegionId>cn-beijing</RegionId>
    </StackInstance>
</GetStackInstanceResponse>

Format JSON

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

{
  "RequestId" : "B8A6B693-82C8-419D-8796-DE99EC33CFF9",
  "StackInstance" : {
    "Status" : "OUTDATED",
    "AccountId" : "151266687691****",
    "StatusReason" : "Cancelled since failure tolerance has exceeded",
    "ParameterOverrides" : [ ],
    "StackGroupName" : "MyStackGroup",
    "StackGroupId" : "fd0ddef9-9540-4b42-a464-94f77835****",
    "RegionId" : "cn-beijing"
  }
}

Codes d’erreur

Pour obtenir la liste des codes d’erreur, consultez la rubrique Codes d’erreur de service.

Error code

Error message

HTTP status code

Description

|

InvalidParameter

|

The specified parameter {name} is invalid, {reason}.

|

400

|

Le paramètre spécifié n’est pas valide. name correspond au nom du paramètre. reason indique la cause de l’erreur.

|

StackGroupNotFound

|

The StackGroup ({name}) could not be found.

|

404

|

Le groupe de piles spécifié n’existe pas. name correspond au nom du groupe de piles.

|

StackInstanceNotFound

|

The StackInstance could not be found.

|

404

|

La pile spécifiée n’existe pas.

|