GetStackGroupOperation - - Centre de documentation Alibaba Cloud

Dans cet exemple, l'ID d'opération 6da106ca-1784-4a6f-a7e1-e723863d∗∗∗∗ permet d'interroger les détails d'une opération effectuée sur le groupe de piles nommé MyStackGroup. Le groupe de piles 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. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil 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	GetStackGroupOperation	L'opération à effectuer. Définissez la valeur sur GetStackGroupOperation.
RegionId	String	Oui	cn-hangzhou	ID de la région du groupe de piles. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
OperationId	String	Oui	6da106ca-1784-4a6f-a7e1-e723863d****	ID de l'opération à interroger. Appelez l'opération ListStackGroupOperations pour obtenir les informations sur l'opération.

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
RequestId	String	14A07460-EBE7-47CA-9757-12CC4761D47A	ID de la requête.
StackGroupOperation	Object		Détails de l'opération sur le groupe de piles.
Status	String	SUCCEEDED	Statut de l'opération. Valeurs possibles : RUNNING : L'opération est en cours. SUCCEEDED : L'opération a réussi. FAILED : L'opération a échoué. STOPPING : L'opération est en cours d'arrêt. STOPPED : L'opération est arrêtée.
StackGroupId	String	fd0ddef9-9540-4b42-a464-94f77835****	ID du groupe de piles.
Action	String	DELETE	Opération effectuée. Valeurs possibles : CREATE UPDATE DELETE DETECT_DRIFT
CreateTime	String	2020-01-20T09:22:3	Heure de début de l'opération.
RetainStacks	Boolean	true	Indique si les piles concernées sont conservées lors de la suppression des instances de pile dans le groupe de piles. Valeurs possibles : true : Les piles sont conservées. false : Les piles sont supprimées. Soyez prudent. Remarque Ce paramètre n'est renvoyé que lors de la suppression des instances de pile.
StackGroupName	String	MyStackGroup	Nom du groupe de piles.
OperationId	String	6da106ca-1784-4a6f-a7e1-e723863d****	ID de l'opération effectuée sur le groupe de piles.
OperationDescription	String	Create stack instance in hangzhou	Description de l'opération. Remarque Ce paramètre n'est renvoyé que si le paramètre de requête OperationDescription est spécifié dans l'opération CreateStackInstances pour créer des instances de pile.
StackGroupDriftDetectionDetail	Object		Détails de la détection de dérive. Remarque Ce paramètre n'est renvoyé que lorsque la détection de dérive est effectuée sur le groupe de piles.
DriftDetectionTime	String	2020-02-27T07:47:47	Heure de début de la détection de dérive.
TotalStackInstancesCount	Integer	2	Nombre d'instances de pile.
FailedStackInstancesCount	Integer	0	Nombre d'instances de pile dont la détection de dérive a échoué.
DriftDetectionStatus	String	COMPLETED	Statut de la détection de dérive. Valeurs possibles : COMPLETED : La détection de dérive est terminée sur toutes les instances de pile. FAILED : La détection de dérive est effectuée. Le nombre d'instances de pile dont la détection a échoué dépasse le seuil spécifié. PARTIAL_SUCCESS : La détection de dérive est effectuée. Le nombre d'instances de pile dont la détection a échoué ne dépasse pas le seuil spécifié. IN_PROGRESS : La détection de dérive est en cours sur le groupe de piles. STOPPED : La détection de dérive est annulée pour le groupe de piles.
StackGroupDriftStatus	String	DRIFTED	Statut de dérive du groupe de piles. Valeurs possibles : DRIFTED : Au moins une instance de pile du groupe de piles présente une dérive. NOT_CHECKED : Aucune détection de dérive n'a été achevée dans le groupe de piles. IN_SYNC : Toutes les instances de pile du groupe de piles sont synchronisées.
InProgressStackInstancesCount	Integer	0	Nombre d'instances de pile dont la détection de dérive était en cours.
InSyncStackInstancesCount	Integer	1	Nombre d'instances de pile synchronisées.
CancelledStackInstancesCount	Integer	0	Nombre d'instances de pile pour lesquelles la détection de dérive a été annulée.
DriftedStackInstancesCount	Integer	1	Nombre d'instances de pile présentant une dérive.
OperationPreferences	Object		Préférences d'opération.
MaxConcurrentCount	Integer	1	Nombre maximal de comptes dans lesquels les opérations sur les piles sont exécutées simultanément dans chaque région. Valeurs possibles : 1 à 20. Remarque Un seul des paramètres MaxConcurrentCount et MaxConcurrentPercentage est renvoyé.
FailureToleranceCount	Integer	1	Nombre maximal d'échecs d'opération de pile autorisés au sein des comptes de chaque région. Si cette valeur est dépassée, l'opération échoue dans la région. En cas d'échec dans une région, l'opération échoue également dans les autres régions. Valeurs possibles : 0 à 20. Remarque Un seul des paramètres FailureToleranceCount et FailureTolerancePercentage est renvoyé.
MaxConcurrentPercentage	Integer	10	Pourcentage du nombre total de comptes dans lesquels les opérations sur les piles sont exécutées simultanément, par rapport au nombre total de comptes de chaque région. Valeurs possibles : 1 à 100. Remarque Un seul des paramètres MaxConcurrentCount et MaxConcurrentPercentage est renvoyé.
RegionIdsOrder	Array of String	["cn-hangzhou","cn-beijing"]	Régions dans l'ordre d'exécution de l'opération.
FailureTolerancePercentage	Integer	10	Pourcentage du nombre total de comptes dans lesquels des échecs d'opération de pile peuvent se produire, par rapport au nombre total de comptes de chaque région. Si cette valeur est dépassée, l'opération échoue dans la région. Valeurs possibles : 0 à 100. Remarque Un seul des paramètres FailureToleranceCount et FailureTolerancePercentage est renvoyé.
EndTime	String	2020-01-20T09:22:4	Heure de fin de l'opération.
ExecutionRoleName	String	AliyunROSStackGroupExecutionRole	Nom du rôle RAM spécifié pour le compte d'exécution lors de la création du groupe de piles disposant d'autorisations gérées par l'utilisateur. Le compte administrateur, dont le rôle RAM est AliyunROSStackGroupAdministrationRole, assume ce rôle RAM. Si ce paramètre n'est pas spécifié, la valeur par défaut AliyunROSStackGroupExecutionRole est renvoyée.
AdministrationRoleName	String	AliyunROSStackGroupAdministrationRole	Nom du rôle RAM spécifié pour le compte administrateur dans Resource Orchestration Service (ROS) lors de la création du groupe de piles disposant d'autorisations gérées par l'utilisateur. Si ce paramètre n'est pas spécifié, la valeur par défaut AliyunROSStackGroupAdministrationRole est renvoyée.
DeploymentTargets	Object		Dossiers dans lesquels déployer les instances de pile disposant d'autorisations gérées par le service.
RdFolderIds	Array of String	["fd-4PvlVLOL8v"]	ID des dossiers du répertoire de ressources.
AccountIds	Array of String	["151266687691**","141261387191**"]	ID des comptes membres dans le répertoire de ressources. Remarque Ce paramètre n'est renvoyé que si le paramètre de requête AccountIds est spécifié dans l'opération UpdateStackInstances pour mettre à jour les instances de pile.

Exemples

Exemples de requêtes

http(s)://ros.aliyuncs.com/?Action=GetStackGroupOperation
&OperationId=6da106ca-1784-4a6f-a7e1-e723863d****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<GetStackGroupOperationResponse>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <StackGroupOperation>
        <Status>SUCCEEDED</Status>
        <Action>DELETE</Action>
        <RetainStacks>false</RetainStacks>
        <EndTime>2020-01-20T09:22:4</EndTime>
        <OperationId>645d0eed-f1e6-40b0-8e8f-0e1eaa34da6f</OperationId>
        <CreateTime>2020-01-20T09:22:3</CreateTime>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <AdministrationRoleName>AliyunROSStackGroupAdministrationRole</AdministrationRoleName>
        <OperationPreferences>
            <MaxConcurrentCount>1</MaxConcurrentCount>
            <RegionIdsOrder>cn-hangzhou</RegionIdsOrder>
            <RegionIdsOrder>cn-beijing</RegionIdsOrder>
            <FailureToleranceCount>0</FailureToleranceCount>
        </OperationPreferences>
        <ExecutionRoleName>AliyunROSStackGroupExecutionRole</ExecutionRoleName>
    </StackGroupOperation>
</GetStackGroupOperationResponse>

JSON format

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

{
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroupOperation" : {
    "Status" : "SUCCEEDED",
    "Action" : "DELETE",
    "RetainStacks" : false,
    "EndTime" : "2020-01-20T09:22:4",
    "OperationId" : "645d0eed-f1e6-40b0-8e8f-0e1eaa34da6f",
    "CreateTime" : "2020-01-20T09:22:3",
    "StackGroupName" : "MyStackGroup",
    "StackGroupId" : "fd0ddef9-9540-4b42-a464-94f77835****",
    "AdministrationRoleName" : "AliyunROSStackGroupAdministrationRole",
    "OperationPreferences" : {
      "MaxConcurrentCount" : 1,
      "RegionIdsOrder" : [ "cn-hangzhou", "cn-beijing" ],
      "FailureToleranceCount" : 0
    },
    "ExecutionRoleName" : "AliyunROSStackGroupExecutionRole"
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.

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é n'est pas valide. name indique le nom du paramètre. reason indique la raison de l'erreur.

StackGroupOperationNotFound

The StackGroupOperation ({OperationId}) could not be found.

404

L'opération spécifiée n'a pas été effectuée sur le groupe de piles. OperationId indique l'ID de l'opération.