ListStackInstances - - Centre de documentation Alibaba Cloud

Cet exemple montre comment répertorier les stacks déployés dans un groupe de stacks nommé MyStackGroup. Ce groupe de stacks dispose d’autorisations gérées par l’utilisateur et est déployé 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 via OpenAPI Explorer. Celui-ci génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ListStackInstances	Opération à effectuer. Définissez la valeur sur ListStackInstances.
RegionId	String	Oui	cn-hangzhou	ID de la région à laquelle appartient le groupe de stacks. Appelez l’opération DescribeRegions pour obtenir la liste des régions la plus récente.
StackGroupName	String	Oui	MyStackGroup	Nom du groupe de stacks. 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 underscores (_). Il doit commencer par un chiffre ou une lettre.
StackInstanceAccountId	String	Non	156552876021****	ID du compte auquel appartient le stack. Si le groupe de stacks dispose d’autorisations gérées par l’utilisateur, le stack appartient à un compte Alibaba Cloud. Si le groupe de stacks dispose d’autorisations gérées par le service, le stack appartient à un membre d’un annuaire de ressources. Remarque Pour en savoir plus sur ce type de compte, consultez la rubrique Présentation.
StackInstanceRegionId	String	Non	cn-beijing	ID de la région à laquelle appartient le stack.
PageSize	Long	Non	10	Nombre d’entrées à renvoyer par page. Valeurs valides : 1 à 50. Valeur par défaut : 10.
PageNumber	Long	Non	1	Numéro de la page à renvoyer. La numérotation des pages commence à 1. Valeur par défaut : 1.

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

Paramètres de réponse

Paramètre	Type	Exemple	Description
TotalCount	Integer	1	Nombre total de stacks.
RequestId	String	85DE34BD-7FF9-480F-8C21-556E9DA93ACD	ID de la requête.
PageSize	Integer	1	Nombre d’entrées renvoyées par page.
PageNumber	Integer	1	Numéro de la page renvoyée.
StackInstances	Array of StackInstance		Détails des stacks.
Status	String	CURRENT	État du stack. Valeurs valides : CURRENT : le stack est à jour par rapport au groupe de stacks. OUTDATED : le stack n’est pas à jour par rapport au groupe de stacks. Les stacks se trouvent dans l’état OUTDATED pour les raisons suivantes possibles : Lors de l’appel de l’opération CreateStackInstances pour créer des stacks, la création a échoué. Lors de l’appel de l’opération UpdateStackInstances ou UpdateStackGroup pour mettre à jour des stacks, la mise à jour a échoué ou seule une partie des stacks a été mise à jour. L’opération de création ou de mise à jour n’est pas terminée.
StackGroupId	String	fd0ddef9-9540-4b42-a464-94f77835****	ID du groupe de stacks.
StackId	String	35ad60e3-6a92-42d8-8812-f0700d45****	ID du stack. Remarque Ce paramètre est renvoyé uniquement si le stack se trouve dans l’état CURRENT.
DriftDetectionTime	String	2020-02-27T07:47:47	Date et heure de la dernière détection de dérive réussie effectuée sur le stack. Remarque Ce paramètre est renvoyé uniquement si une détection de dérive a été effectuée sur le groupe de stacks.
StackDriftStatus	String	IN_SYNC	État du stack lors de la dernière détection de dérive réussie effectuée sur le groupe de stacks. Valeurs valides : DRIFTED : le stack a subi une dérive. NOT_CHECKED : aucune détection de dérive réussie n’a été effectuée sur le stack. IN_SYNC : le stack est synchronisé. Remarque Ce paramètre est renvoyé uniquement si une détection de dérive a été effectuée sur le groupe de stacks.
StatusReason	String	User initiated stop	Raison pour laquelle le stack se trouve dans l’état OUTDATED. Remarque Ce paramètre est renvoyé uniquement si le stack se trouve dans l’état OUTDATED.
StackGroupName	String	MyStackGroup	Nom du groupe de stacks.
AccountId	String	156552876021****	ID du compte auquel appartient le stack.
RegionId	String	cn-beijing	ID de la région à laquelle appartient le stack.
RdFolderId	String	fd-4PvlVLOL8v	ID du dossier dans l’annuaire de ressources. Remarque Ce paramètre est renvoyé uniquement si le groupe de stacks dispose d’autorisations gérées par le service.

Exemples

Exemple de requête

http(s)://ros.aliyuncs.com/?Action=ListStackInstances
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<ListStackInstancesResponse>
    <TotalCount>1</TotalCount>
    <RequestId>85DE34BD-7FF9-480F-8C21-556E9DA93ACD</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <StackInstances>
        <Status>OUTDATED</Status>
        <AccountId>156552876021****</AccountId>
        <StatusReason>User initiated stop.</StatusReason>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <RegionId>cn-beijing</RegionId>
    </StackInstances>
</ListStackInstancesResponse>

Format JSON

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

{
  "TotalCount" : 1,
  "RequestId" : "85DE34BD-7FF9-480F-8C21-556E9DA93ACD",
  "PageSize" : 10,
  "PageNumber" : 1,
  "StackInstances" : [ {
    "Status" : "OUTDATED",
    "AccountId" : "156552876021****",
    "StatusReason" : "User initiated stop.",
    "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.

Code d’erreur	Message d’erreur	Code d’état HTTP	Description
InvalidParameter	The specified parameter {name} is invalid, {reason}.	400	Le paramètre spécifié est incorrect. {name} représente le nom du paramètre et {reason} la cause de l’erreur.
StackGroupNotFound	The StackGroup ({name}) could not be found.	404	Le groupe de stacks spécifié n’existe pas. {name} représente le nom du groupe de stacks.