ListStacks - - Centre de documentation Alibaba Cloud

Consulte la liste des piles.

Description de l'opération

Remarques sur l'utilisation

Cette rubrique fournit un exemple de consultation de la liste des piles dans la région de 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:ListStacks

get

*Stack.

acs:ros:{#regionId}:{#accountId}:stack/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
PageSize	integer	Non	Les paramètres de pagination, spécifiant le nombre d'entrées par page dans une requête paginée. Valeur maximale : 50. Valeur par défaut : 10.	10
ParentStackId	string	Non	L'identifiant de la pile parente.	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 consulter la liste des régions la plus récente.	cn-hangzhou
PageNumber	integer	Non	Le numéro de page de la liste des piles. Valeur de départ : 1. Valeur par défaut : 1.	1
ShowNestedStack	boolean	Non	Indique si les piles imbriquées doivent être répertoriées. Valeurs valides : true false (valeur par défaut) Remarque Si ParentStackId est spécifié, la valeur est définie sur true.	true
StackId	string	Non	L'identifiant de la pile. Si vous n'avez pas besoin des informations détaillées de la pile, vous pouvez spécifier ce paramètre au lieu d'appeler l'opération GetStack.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
Status	array	Non	L'état de la pile.	CREATE_COMPLETE
	string	Non	L'état de la pile. Valeurs valides : CREATE_IN_PROGRESS : la pile est en cours de création. CREATE_FAILED : la création de la pile a échoué. CREATE_COMPLETE : la pile est créée. UPDATE_IN_PROGRESS : la pile est en cours de mise à jour. UPDATE_FAILED : la mise à jour de la pile a échoué. UPDATE_COMPLETE : la pile est mise à jour. DELETE_IN_PROGRESS : la pile est en cours de suppression. DELETE_FAILED : la suppression de la pile a échoué. CREATE_ROLLBACK_IN_PROGRESS : la création de la pile est en cours de restauration. CREATE_ROLLBACK_FAILED : la restauration de la création de la pile a échoué. CREATE_ROLLBACK_COMPLETE : la création de la pile est restaurée. ROLLBACK_IN_PROGRESS : la pile est en cours de restauration. ROLLBACK_FAILED : la restauration de la pile a échoué. ROLLBACK_COMPLETE : la pile est restaurée. CHECK_IN_PROGRESS : la pile est en cours de vérification. CHECK_FAILED : la vérification de la pile a échoué. CHECK_COMPLETE : la pile est vérifiée. REVIEW_IN_PROGRESS : la pile est en cours de révision. IMPORT_CREATE_IN_PROGRESS : la pile est en cours de création par importation de ressources. IMPORT_CREATE_FAILED : la création de la pile par importation de ressources a échoué. IMPORT_CREATE_COMPLETE : la pile est créée par importation de ressources. IMPORT_CREATE_ROLLBACK_IN_PROGRESS : la création de la pile par importation de ressources est en cours de restauration. IMPORT_CREATE_ROLLBACK_FAILED : la restauration de la création de la pile par importation de ressources a échoué. IMPORT_CREATE_ROLLBACK_COMPLETE : la création de la pile par importation de ressources est restaurée. IMPORT_UPDATE_IN_PROGRESS : la pile est en cours de mise à jour par importation de ressources. IMPORT_UPDATE_FAILED : la mise à jour de la pile par importation de ressources a échoué. IMPORT_UPDATE_COMPLETE : la pile est mise à jour par importation de ressources. IMPORT_UPDATE_ROLLBACK_IN_PROGRESS : la mise à jour de la pile par importation de ressources est en cours de restauration. IMPORT_UPDATE_ROLLBACK_FAILED : la restauration de la mise à jour de la pile par importation de ressources a échoué. IMPORT_UPDATE_ROLLBACK_COMPLETE : la mise à jour de la pile par importation de ressources est restaurée.	CREATE_COMPLETE
StackName	array	Non	Le nom de la pile.	MyStack
	string	Non	Le nom de la pile. Le nom peut comporter jusqu'à 255 caractères et doit commencer par un chiffre ou une lettre. Il peut contenir des chiffres, des lettres, des traits d'union (-) et des traits de soulignement (_). Vous pouvez utiliser des astérisques (*) pour une recherche approximative. Valeurs valides de N : 1 à 5.	MyStack
Tag	array<object>	Non	Les balises de la pile.
	object	Non
Key	string	Non	La clé de balise de la pile. Valeurs valides de N : 1 à 20.	usage
Value	string	Non	La valeur de balise de la pile. Valeurs valides de N : 1 à 20.	test
ResourceGroupId	string	Non	L'identifiant du groupe de ressources. Pour plus d'informations sur les groupes de ressources, consultez la rubrique Qu'est-ce qu'un groupe de ressources ?.	rg-acfmxazb4ph6aiy****
StackIds	array	Non	La liste des identifiants des piles.
	string	Non	L'identifiant de la pile. Vous pouvez spécifier plusieurs identifiants de pile pour consulter les détails de plusieurs piles en même temps. Valeurs valides de N : 1 à 10.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
StartTime	string	Non	L'heure de début de la plage de temps de création pour la requête. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.	2023-04-01T15:10:00Z
EndTime	string	Non	L'heure de fin de la plage de temps de création pour la requête. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.	2023-04-01T15:16:00Z

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
TotalCount	integer	Le nombre total de piles.	2
PageSize	integer	Les paramètres de pagination, spécifiant le nombre d'entrées par page dans une requête paginée. Valeur maximale : 50. Valeur par défaut : 10.	10
RequestId	string	L'identifiant de la requête.	FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7
PageNumber	integer	Le numéro de page de la liste des piles.	1
Stacks	array<object>	La liste des piles.
	array<object>
Status	string	L'état de la pile.	CREATE_COMPLETE
UpdateTime	string	L'heure de mise à jour de la pile. L'heure est affichée en UTC et suit la norme ISO 8601 au format YYYY-MM-DDThh:mm:ss sans le suffixe Z.	2022-03-10T07:44:36
DriftDetectionTime	string	L'heure à laquelle la dernière détection de dérive réussie a été effectuée sur la pile. L'heure est au format YYYY-MM-DDThh:mm:ss.	2022-03-10T06:46:36
StatusReason	string	La raison de l'état de la pile.	Stack CREATE completed successfully
CreateTime	string	L'heure de création de la pile. L'heure est affichée en UTC et suit la norme ISO 8601 au format YYYY-MM-DDThh:mm:ss sans le suffixe Z.	2022-03-10T06:44:36
DisableRollback	boolean	Indique si la stratégie de restauration doit être désactivée lorsque la création de la pile échoue. Valeurs valides : true : désactive la stratégie de restauration. La pile n'est pas restaurée lorsque sa création échoue. false (valeur par défaut) : ne désactive pas la stratégie de restauration. La pile est restaurée lorsque sa création échoue.	false
Tags	array<object>	Les balises de la pile.
	object
Key	string	La clé de balise de la pile.	acs:rm:rgId
Value	string	La valeur de balise de la pile.	rg-aek2frunvw7****
StackName	string	Le nom de la pile.	MyStack
TimeoutInMinutes	integer	Le délai d'expiration pour la création de la pile. Unité : minutes. Valeurs valides : 10, 20, 60, 120 et 1440. Ces informations sont générées à partir des journaux d'appels et peuvent être incomplètes. Veuillez les vérifier.	60
RegionId	string	L'identifiant de la région de la pile. Vous pouvez appeler l'opération DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
ParentStackId	string	L'identifiant de la pile parente.	4a6c9851-3b0f-4f5f-b4ca-a14bf692****
StackId	string	L'identifiant de la pile.	67805444-a605-45ee-a57f-83908ff6****
StackDriftStatus	string	L'état de dérive de la pile lors de la dernière détection de dérive réussie. Valeurs valides : DRIFTED : la pile a dérivé. 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.	IN_SYNC
StackType	string	Le type de la pile. Valeurs valides : ROS : la pile utilise un modèle ROS. Terraform : la pile utilise un modèle Terraform.	ROS
ResourceGroupId	string	L'identifiant du groupe de ressources.	rg-aek2frunvw7****
ServiceManaged	boolean	Indique si la pile est une pile gérée. Valeurs valides : true : la pile est une pile gérée. false : la pile n'est pas une pile gérée.	false
ServiceName	string	Le nom de service de la pile gérée.	ACVS
OperationInfo	object	Les informations supplémentaires lorsqu'une erreur se produit lors d'une opération de pile. Remarque Ce paramètre de réponse n'est renvoyé que dans des scénarios spécifiques et au moins un sous-paramètre est renvoyé. Par exemple, une erreur est signalée lors de l'appel d'une opération d'API d'un autre service Alibaba Cloud.
Code	string	Le code d'erreur. Valeurs valides : Forbidden.RAM : les autorisations RAM sont refusées. InvalidAccountStatus.NotEnoughBalance : le solde du compte est insuffisant. OrderError.EIP : une erreur de commande EIP s'est produite. QuotaExceeded.Eip : le quota EIP est dépassé. Ces informations sont générées à partir des journaux d'appels et peuvent être incomplètes. Veuillez les vérifier.	DependencyViolation
Message	string	Le message d'erreur.	There is still instance(s) in the specified security group.
RequestId	string	L'identifiant de la requête pour appeler l'opération d'API d'un autre service Alibaba Cloud.	071D6166-3F6B-5C7B-A1F0-0113FBB643A8
Action	string	Le nom de l'opération d'API d'un autre service Alibaba Cloud qui est appelée.	DeleteSecurityGroup
ResourceType	string	Le type de ressource pour lequel l'erreur d'opération s'est produite.	ALIYUN::ECS::SecurityGroup
LogicalResourceId	string	L'identifiant logique de la ressource pour laquelle l'erreur d'opération s'est produite.	EcsSecurityGroup
DeletionProtection	string	Indique si la protection contre la suppression est activée pour la pile. Valeurs valides : Enabled : la protection contre la suppression est activée pour la pile. Disabled : la protection contre la suppression est désactivée pour la pile. Dans ce cas, vous pouvez libérer la pile dans la console ou en appelant l'opération DeleteStack. Remarque Le mécanisme de protection contre la suppression pour une pile imbriquée est le même que celui de la pile racine. Valeurs valides : Enabled : Enabled. Disabled : Disabled.	Disabled

Exemples

JSON format

{
  "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": "Création de la pile terminée avec succès",
      "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": "Il reste des instances dans le groupe de sécurité spécifié",
        "RequestId": "071D6166-3F6B-5C7B-A1F0-0113FBB643A8",
        "Action": "DeleteSecurityGroup",
        "ResourceType": "ALIYUN::ECS::SecurityGroup",
        "LogicalResourceId": "EcsSecurityGroup"
      },
      "DeletionProtection": "Disabled"
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.