ListStacks - - Centre de documentation Alibaba Cloud

Description

Cette rubrique explique comment interroger la liste des piles. L'exemple porte sur les piles déployées dans la région Chine (Hangzhou).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. 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	ListStacks	Opération à effectuer. Définissez la valeur sur ListStacks.
PageSize	Long	No	10	Nombre d'entrées renvoyées par page. Valeur maximale : 50. Valeur par défaut : 10.
ParentStackId	String	No	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	ID de la pile parente.
RegionId	String	Yes	cn-hangzhou	ID de région de la pile. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
PageNumber	Long	No	1	Numéro de la page à renvoyer. La numérotation commence à 1. Valeur par défaut : 1.
ShowNestedStack	Boolean	No	true	Indique s'il faut renvoyer les piles imbriquées. Valeur par défaut : false. Valeurs valides : true false Remarque Si le paramètre ParentStackId est spécifié, définissez le paramètre ShowNestedStack sur true.
StackId	String	No	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	ID de la pile. Utilisez ce paramètre pour interroger les informations de base sur la pile sans appeler l'opération GetStack.
Status.N	String	No	CREATE_COMPLETE	État N de la pile. Valeurs valides : CREATE_IN_PROGRESS : Création de la pile en cours. CREATE_FAILED : Échec de la création de la pile. CREATE_COMPLETE : Pile créée. UPDATE_IN_PROGRESS : Mise à jour de la pile en cours. UPDATE_FAILED : Échec de la mise à jour de la pile. UPDATE_COMPLETE : Pile mise à jour. DELETE_IN_PROGRESS : Suppression de la pile en cours. DELETE_FAILED : Échec de la suppression de la pile. CREATE_ROLLBACK_IN_PROGRESS : Restauration des ressources après l'échec de la création de la pile. CREATE_ROLLBACK_FAILED : Échec de la restauration des ressources après l'échec de la création de la pile. CREATE_ROLLBACK_COMPLETE : Ressources restaurées après l'échec de la création de la pile. ROLLBACK_IN_PROGRESS : Restauration des ressources de la pile en cours. ROLLBACK_FAILED : Échec de la restauration des ressources de la pile. ROLLBACK_COMPLETE : Ressources de la pile restaurées. CHECK_IN_PROGRESS : Validation de la pile en cours. CHECK_FAILED : Échec de la validation de la pile. CHECK_COMPLETE : Pile validée. REVIEW_IN_PROGRESS : Examen de la pile en cours. IMPORT_CREATE_IN_PROGRESS : Création de la pile à l'aide de ressources importées en cours. IMPORT_CREATE_FAILED : Échec de la création de la pile à l'aide de ressources importées. IMPORT_CREATE_COMPLETE : Pile créée à l'aide de ressources importées. IMPORT_CREATE_ROLLBACK_IN_PROGRESS : Restauration des ressources après l'échec de la création de la pile à l'aide de ressources importées. IMPORT_CREATE_ROLLBACK_FAILED : Échec de la restauration des ressources après l'échec de la création de la pile à l'aide de ressources importées. IMPORT_CREATE_ROLLBACK_COMPLETE : Ressources restaurées après l'échec de la création de la pile à l'aide de ressources importées. IMPORT_UPDATE_IN_PROGRESS : Mise à jour de la pile à l'aide de ressources importées en cours. IMPORT_UPDATE_FAILED : Échec de la mise à jour de la pile à l'aide de ressources importées. IMPORT_UPDATE_COMPLETE : Pile mise à jour à l'aide de ressources importées. IMPORT_UPDATE_ROLLBACK_IN_PROGRESS : Restauration des ressources après l'échec de la mise à jour de la pile à l'aide de ressources importées. IMPORT_UPDATE_ROLLBACK_FAILED : Échec de la restauration des ressources après l'échec de la mise à jour de la pile à l'aide de ressources importées. IMPORT_UPDATE_ROLLBACK_COMPLETE : Ressources restaurées après l'échec de la mise à jour de la pile à l'aide de ressources importées.
StackName.N	String	No	MyStack	Nom de la pile N. Le nom peut contenir jusqu'à 255 caractères, y compris des chiffres, des lettres, des traits d'union (-) et des traits de soulignement (_). Il doit commencer par un chiffre ou une lettre. Utilisez le caractère générique (∗) pour une recherche floue. Valeurs valides de N : 1 à 5.
Tag.N.Key	String	No	usage	Clé du tag N de la pile. Valeurs valides de N : 1 à 20.
Tag.N.Value	String	No	test	Valeur du tag N de la pile. Valeurs valides de N : 1 à 20.
ResourceGroupId	String	No	rg-acfmxazb4ph6aiy****	ID du groupe de ressources. Pour en savoir plus sur les groupes de ressources, consultez la section « Resource Group » de la rubrique Qu'est-ce que Resource Management ?.
StackIds.N	String	No	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	ID de la pile N. Spécifiez un ou plusieurs ID pour interroger simultanément une ou plusieurs piles. Valeurs valides de N : 1 à 10.

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
TotalCount	Integer	2	Nombre total de piles.
PageSize	Integer	10	Nombre d'entrées renvoyées par page. Valeur maximale : 50. Valeur par défaut : 10.
RequestId	String	FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7	ID de la requête.
PageNumber	Integer	1	Numéro de la page renvoyée.
Stacks	Array of Stack		Liste des piles.
Status	String	CREATE_COMPLETE	État de la pile.
UpdateTime	String	2022-03-10T07:44:36	Heure de mise à jour de la pile. Le format suit la norme ISO 8601 (AAAA-MM-JJThh:mm:ss) et l'heure est exprimée en UTC.
DriftDetectionTime	String	2022-03-10T06:46:36	Heure de la dernière détection de dérive réussie effectuée sur la pile.
StatusReason	String	Stack CREATE completed successfully	Raison de l'état actuel de la pile.
CreateTime	String	2022-03-10T06:44:36	Heure de création de la pile. Le format suit la norme ISO 8601 (AAAA-MM-JJThh:mm:ss) et l'heure est exprimée en UTC.
DisableRollback	Boolean	false	Indique si la restauration est désactivée en cas d'échec de la création de la pile. Valeur par défaut : false. Valeurs valides : true false
Tags	Array of Tag		Tags de la pile.
Key	String	acs:rm:rgId	Clé du tag de la pile.
Value	String	rg-aek2frunvw7****	Valeur du tag de la pile.
StackName	String	MyStack	Nom de la pile.
TimeoutInMinutes	Integer	60	Délai d'attente autorisé pour la création de la pile. Unité : minutes.
RegionId	String	cn-hangzhou	ID de région de la pile. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ParentStackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf692****	ID de la pile parente.
StackId	String	67805444-a605-45ee-a57f-83908ff6****	ID de la pile.
StackDriftStatus	String	IN_SYNC	État de la pile lors de la dernière détection de dérive réussie. Valeurs valides : DRIFTED : Détection de dérive en cours sur la pile. NOT_CHECKED : Aucune détection de dérive réussie n'a été effectuée sur la pile. IN_SYNC : Pile synchronisée.
StackType	String	ROS	Type de la pile. Valeurs valides : ROS : Pile ROS. La pile est créée à l'aide d'un modèle Resource Orchestration Service (ROS). Terraform : Pile Terraform. La pile est créée à l'aide d'un modèle Terraform.
ResourceGroupId	String	rg-aek2frunvw7****	ID du groupe de ressources.
ServiceManaged	Boolean	false	Indique si la pile est une pile gérée. Valeurs valides : true false
ServiceName	String	ACVS	Nom du service auquel appartient la pile gérée.
OperationInfo	Object		Informations supplémentaires renvoyées en cas d'échec d'une opération sur la pile. Remarque Ce paramètre est renvoyé si une opération échoue sur la pile. Le système renvoie au moins une sous-propriété. Exemple : une erreur s'est produite lors de l'appel de l'opération API d'un autre service Alibaba Cloud.
Code	String	DependencyViolation	Code d'erreur.
Message	String	There is still instance(s) in the specified security group.	Message d'erreur.
RequestId	String	071D6166-3F6B-5C7B-A1F0-0113FBB643A8	ID de la requête initiée pour appeler l'opération API d'un autre service Alibaba Cloud.
Action	String	DeleteSecurityGroup	Nom de l'opération API appartenant à un autre service Alibaba Cloud.
ResourceType	String	ALIYUN::ECS::SecurityGroup	Type de ressource sur lequel une opération a échoué.
LogicalResourceId	String	EcsSecurityGroup	ID logique de la ressource sur laquelle une opération a échoué.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

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

<ListStacksResponse>
    <TotalCount>2</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7</RequestId>
    <PageNumber>1</PageNumber>
    <Stacks>
        <Status>CREATE_COMPLETE</Status>
        <UpdateTime>2022-03-10T07:44:36</UpdateTime>
        <DriftDetectionTime>2022-03-10T06:46:36</DriftDetectionTime>
        <StatusReason>Stack CREATE completed successfully</StatusReason>
        <CreateTime>2022-03-10T06:44:36</CreateTime>
        <DisableRollback>false</DisableRollback>
        <Tags>
            <Key>acs:rm:rgId</Key>
            <Value>rg-aek2frunvw7****</Value>
        </Tags>
        <StackName>MyStack</StackName>
        <TimeoutInMinutes>60</TimeoutInMinutes>
        <RegionId>cn-hangzhou</RegionId>
        <ParentStackId>4a6c9851-3b0f-4f5f-b4ca-a14bf692****</ParentStackId>
        <StackId>67805444-a605-45ee-a57f-83908ff6****</StackId>
        <StackDriftStatus>IN_SYNC</StackDriftStatus>
        <StackType>ROS</StackType>
        <ResourceGroupId>rg-aek2frunvw7****</ResourceGroupId>
        <ServiceManaged>false</ServiceManaged>
        <ServiceName>ACVS</ServiceName>
        <OperationInfo>
            <Code>DependencyViolation</Code>
            <Message>There is still instance(s) in the specified security group.</Message>
            <RequestId>071D6166-3F6B-5C7B-A1F0-0113FBB643A8</RequestId>
            <Action>DeleteSecurityGroup</Action>
            <ResourceType>ALIYUN::ECS::SecurityGroup</ResourceType>
            <LogicalResourceId>EcsSecurityGroup</LogicalResourceId>
        </OperationInfo>
    </Stacks>
</ListStacksResponse>

Format JSON

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

{
  "TotalCount" : 2,
  "PageSize" : 10,
  "RequestId" : "FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7",
  "PageNumber" : 1,
  "Stacks" : {
    "Status" : "CREATE_COMPLETE",
    "UpdateTime" : "2022-03-10T07:44:36",
    "DriftDetectionTime" : "2022-03-10T06:46:36",
    "StatusReason" : "Stack CREATE completed successfully",
    "CreateTime" : "2022-03-10T06:44:36",
    "DisableRollback" : false,
    "Tags" : {
      "Key" : "acs:rm:rgId",
      "Value" : "rg-aek2frunvw7****"
    },
    "StackName" : "MyStack",
    "TimeoutInMinutes" : 60,
    "RegionId" : "cn-hangzhou",
    "ParentStackId" : "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
    "StackId" : "67805444-a605-45ee-a57f-83908ff6****",
    "StackDriftStatus" : "IN_SYNC",
    "StackType" : "ROS",
    "ResourceGroupId" : "rg-aek2frunvw7****",
    "ServiceManaged" : false,
    "ServiceName" : "ACVS",
    "OperationInfo" : {
      "Code" : "DependencyViolation",
      "Message" : "There is still instance(s) in the specified security group.",
      "RequestId" : "071D6166-3F6B-5C7B-A1F0-0113FBB643A8",
      "Action" : "DeleteSecurityGroup",
      "ResourceType" : "ALIYUN::ECS::SecurityGroup",
      "LogicalResourceId" : "EcsSecurityGroup"
    }
  }
}

Codes d'erreur

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