GetStackGroupOperation - - Centre de documentation Alibaba Cloud

Consulte les informations relatives à une opération de groupe de piles dans une région d'Alibaba Cloud.

Description de l'opération

Dans cet exemple, les informations relatives à l'opération de groupe de piles dont l'identifiant est 6da106ca-1784-4a6f-a7e1-e723863d**** sont consultées. Le groupe de piles nommé MyStackGroup dispose d'autorisations auto-gérées et est déployé dans la région Chine (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:GetStackGroupOperation

get

*StackGroupOperation

acs:ros:{#regionId}:{#accountId}:stackgroupoperation/{#OperationId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du groupe de piles. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
OperationId	string	Oui	L'identifiant de l'opération. Vous pouvez appeler l'opération ListStackGroupOperations pour obtenir l'identifiant de l'opération.	6da106ca-1784-4a6f-a7e1-e723863d****

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

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	14A07460-EBE7-47CA-9757-12CC4761D47A
StackGroupOperation	object	Les informations relatives à l'opération de groupe de piles.
Status	string	L'état de l'opération. Valeurs valides : RUNNING SUCCEEDED FAILED STOPPING STOPPED	SUCCEEDED
StackGroupId	string	L'identifiant du groupe de piles.	fd0ddef9-9540-4b42-a464-94f77835****
Action	string	Le type d'opération. Valeurs valides : CREATE UPDATE DELETE DETECT_DRIFT	DELETE
CreateTime	string	L'heure à laquelle l'opération a été initiée.	2020-01-20T09:22:3
RetainStacks	boolean	Indique si les piles sont conservées lorsque les instances de pile associées sont supprimées. Lorsque vous supprimez une instance de pile, vous pouvez choisir de supprimer ou de conserver la pile à laquelle l'instance de pile est associée. Valeurs valides : true : les piles sont conservées lorsque les instances de pile associées sont supprimées. false : les piles sont supprimées lorsque les instances de pile associées sont supprimées. Procédez avec prudence. Remarque Ce paramètre n'est renvoyé que si vous supprimez des instances de pile.	true
StackGroupName	string	Le nom du groupe de piles.	MyStackGroup
OperationId	string	L'identifiant de l'opération.	6da106ca-1784-4a6f-a7e1-e723863d****
OperationDescription	string	La description de l'opération. Remarque Ce paramètre n'est renvoyé que si OperationDescription est spécifié lors de l'appel de l'opération CreateStackInstances pour créer des instances de pile.	Créer une instance de pile à Hangzhou
StackGroupDriftDetectionDetail	object	Les informations relatives à la détection de dérive. Remarque Ce paramètre n'est renvoyé que si une détection de dérive est effectuée.
DriftDetectionTime	string	The time when drift detection was performed.	2020-02-27T07:47:47
TotalStackInstancesCount	integer	The number of stack instances.	2
FailedStackInstancesCount	integer	The number of stack instances that failed drift detection.	0
DriftDetectionStatus	string	The drift detection state. Valid values: COMPLETED: Drift detection is performed on the stack group and all stack instances passed the drift detection. FAILED: Drift detection is performed on the stack group. The number of stack instances that failed the drift detection exceeds the specified threshold. PARTIAL_SUCCESS: Drift detection is performed on the stack group. The number of stack instances that failed the drift detection does not exceed the specified threshold. IN_PROGRESS: Drift detection is being performed on the stack group. STOPPED: Drift detection is canceled for the stack group.	COMPLETED
StackGroupDriftStatus	string	The drift state of the stack group. Valid values: DRIFTED: At least one stack instance in the stack group has drifted. NOT_CHECKED: No successful drift detection is performed in the stack group. IN_SYNC: All the stack instances in the stack group are being synchronized.	DRIFTED
InProgressStackInstancesCount	integer	The number of stack instances on which drift detection was being performed.	0
InSyncStackInstancesCount	integer	The number of stack instances that were being synchronized.	1
CancelledStackInstancesCount	integer	The number of stack instances for which drift detection was canceled.	0
DriftedStackInstancesCount	integer	The number of stack instances that have drifted.	1
OperationPreferences	object	Les paramètres de l'opération.
MaxConcurrentCount	integer	The maximum number of accounts within which stacks are deployed at the same time in each region. Valid values: 1 to 20. Remarque Only one of MaxConcurrentCount and MaxConcurrentPercentage can be returned.	1
FailureToleranceCount	integer	The number of accounts within which stack operation failures are allowed to occur in each region. If the value of this parameter is exceeded in a region, Resource Orchestration Service (ROS) stops the operation in the region. If the operation is stopped in one region, the operation is no longer performed in other regions. Valid values: 0 to 20. Remarque Only one of FailureToleranceCount and FailureTolerancePercentage can be returned.	1
MaxConcurrentPercentage	integer	The percentage of the maximum number of accounts within which stacks are deployed at the same time to the total number of accounts in each region. Valid values: 1 to 100. Remarque Only one of MaxConcurrentCount and MaxConcurrentPercentage can be returned.	10
RegionIdsOrder	array	The regions in the order of operation execution.
	string	The region in the order of operation execution.	["cn-hangzhou","cn-beijing"]
FailureTolerancePercentage	integer	The percentage of the number of accounts within which stack operation failures are allowed to occur to the total number of accounts in each region. If the value of this parameter is exceeded in a region, ROS stops the operation in the region. Valid values: 0 to 100. Remarque Only one of FailureToleranceCount and FailureTolerancePercentage can be returned.	10
EndTime	string	L'heure à laquelle l'opération s'est terminée.	2020-01-20T09:22:4
ExecutionRoleName	string	Le nom du rôle RAM que vous spécifiez pour le compte d'exécution lorsque vous créez le groupe de piles auto-géré. Le rôle d'administrateur AliyunROSStackGroupAdministrationRole assume le rôle d'exécution pour effectuer les opérations. Si ce paramètre n'est pas spécifié, la valeur par défaut AliyunROSStackGroupExecutionRole est renvoyée.	AliyunROSStackGroupExecutionRole
AdministrationRoleName	string	Le nom du rôle RAM que vous spécifiez pour le compte administrateur lorsque vous créez le groupe de piles auto-géré. ROS assume le rôle d'administrateur pour effectuer les opérations. Si ce paramètre n'est pas spécifié, la valeur par défaut AliyunROSStackGroupAdministrationRole est renvoyée.	AliyunROSStackGroupAdministrationRole
DeploymentTargets	object	Les destinations pour déployer des instances de pile lorsque la pile dispose d'autorisations gérées par le service.
RdFolderIds	array	The IDs of the folders in the resource directory.
	string	The ID of the folder in the resource directory.	["fd-4PvlVLOL8v"]
AccountIds	array	The IDs of the members in the resource directory. Remarque This parameter is returned only if AccountIds is specified when the UpdateStackInstances operation is called to update stack instances.
	string	The ID of the member in the resource directory. Remarque This parameter is returned only if AccountIds is specified when the UpdateStackInstances opeation is called to update stack instances.	["151266687691**","141261387191**"]

Exemples

JSON format

{
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroupOperation": {
    "Status": "SUCCEEDED",
    "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
    "Action": "DELETE",
    "CreateTime": "2020-01-20T09:22:3",
    "RetainStacks": true,
    "StackGroupName": "MyStackGroup",
    "OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****",
    "OperationDescription": "Create stack instance in hangzhou",
    "StackGroupDriftDetectionDetail": {
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "TotalStackInstancesCount": 2,
      "FailedStackInstancesCount": 0,
      "DriftDetectionStatus": "COMPLETED",
      "StackGroupDriftStatus": "DRIFTED",
      "InProgressStackInstancesCount": 0,
      "InSyncStackInstancesCount": 1,
      "CancelledStackInstancesCount": 0,
      "DriftedStackInstancesCount": 1
    },
    "OperationPreferences": {
      "MaxConcurrentCount": 1,
      "FailureToleranceCount": 1,
      "MaxConcurrentPercentage": 10,
      "RegionIdsOrder": [
        "[\"cn-hangzhou\",\"cn-beijing\"]"
      ],
      "FailureTolerancePercentage": 10
    },
    "EndTime": "2020-01-20T09:22:4",
    "ExecutionRoleName": "AliyunROSStackGroupExecutionRole",
    "AdministrationRoleName": "AliyunROSStackGroupAdministrationRole",
    "DeploymentTargets": {
      "RdFolderIds": [
        "[\"fd-4PvlVLOL8v\"]"
      ],
      "AccountIds": [
        "[\"151266687691****\",\"141261387191****\"]"
      ]
    }
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.