GetStackGroup - - Centre de documentation Alibaba Cloud

Récupère les informations relatives à un groupe de piles.

Dans cet exemple, nous récupérons les informations d'un groupe de piles nommé MyStackGroup. Ce groupe de piles dispose d'autorisations autogérées et a été créé 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 dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	GetStackGroup	Opération à effectuer. Définissez la valeur sur GetStackGroup.
RegionId	String	Oui	cn-hangzhou	ID de région du groupe de piles. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
StackGroupName	String	Non	MyStackGroup	Nom du groupe de piles. 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 traits de soulignement (_). Il doit commencer par un chiffre ou une lettre. Remarque Spécifiez l'un des paramètres StackGroupName ou StackGroupId.
StackGroupId	String	Non	fd0ddef9-9540-4b42-a464-94f77835****	ID du groupe de piles. Remarque Spécifiez l'un des paramètres StackGroupName ou StackGroupId.

Pour plus d'informations sur les paramètres de requête communs, consultez la section 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.
StackGroup	Object		Détails du groupe de piles.
StackGroupId	String	fd0ddef9-9540-4b42-a464-94f77835****	ID du groupe de piles.
Status	String	ACTIVE	Statut du groupe de piles. Valeurs valides : ACTIVE DELETED
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 autogéré. Si ce paramètre n'est pas spécifié, la valeur par défaut AliyunROSStackGroupAdministrationRole est renvoyée.
Parameters	Array of Parameter		Paramètres du groupe de piles.
ParameterKey	String	Amount	Clé du paramètre.
ParameterValue	String	12	Valeur du paramètre.
Description	String	StackGroup Description	Description du groupe de piles.
StackGroupName	String	MyStackGroup	Nom du groupe de piles.
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 autogéré. Le rôle administrateur AliyunROSStackGroupAdministrationRole assume le rôle d'exécution. Si ce paramètre n'est pas spécifié, la valeur par défaut AliyunROSStackGroupExecutionRole est renvoyée.
TemplateBody	String	{"ROSTemplateFormatVersion": "2015-09-01"}	Corps du modèle.
StackGroupDriftDetectionDetail	Object		Détails de la dernière détection de dérive effectuée sur le groupe de piles.
DriftDetectionTime	String	2020-02-27T07:47:47	Date et heure de la détection de dérive sur le groupe de piles.
TotalStackInstancesCount	Integer	2	Nombre d'instances de pile.
FailedStackInstancesCount	Integer	0	Nombre d'instances de pile ayant échoué à la détection de dérive.
DriftDetectionStatus	String	COMPLETED	Statut de la détection de dérive sur le groupe de piles. Valeurs valides : COMPLETED : La détection de dérive est effectuée et terminée sur toutes les instances de pile. FAILED : La détection de dérive est effectuée. Le nombre d'instances de pile ayant échoué à la détection de dérive dépasse le seuil spécifié. PARTIAL_SUCCESS : La détection de dérive est effectuée. Le nombre d'instances de pile ayant échoué à la détection de dérive 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 valides : DRIFTED : Au moins une instance de pile du groupe de piles a dérivé. NOT_CHECKED : Aucune détection de dérive n'est terminée sur 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 sur lesquelles 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 qui ont dérivé.
ResourceGroupId	String	rg-acfmxazb4ph6aiy****	ID du groupe de ressources. Ce paramètre est spécifié lors de la création du groupe de piles.
PermissionModel	String	SELF_MANAGED	Modèle d'autorisation. Valeurs valides : SELF_MANAGED : modèle d'autorisation autogéré SERVICE_MANAGED : modèle d'autorisation géré par le service Remarque Pour plus d'informations sur les modèles d'autorisation des groupes de piles, consultez la page Présentation.
AutoDeployment	Object		Informations sur les paramètres de déploiement automatique. Remarque Ce paramètre est renvoyé uniquement lorsque le paramètre PermissionModel est défini sur SERVICE_MANAGED.
Enabled	Boolean	true	Indique si le déploiement automatique est activé. Valeurs valides : true : Le déploiement automatique est activé. Si un compte membre est ajouté au dossier auquel appartient le groupe de piles après l'activation du déploiement automatique, le groupe de piles déploie ses instances de pile dans la région spécifiée où le compte ajouté est déployé. Si le compte est supprimé du dossier, les instances de pile de la région spécifiée sont supprimées du groupe de piles. false : Le déploiement automatique est désactivé. Après la désactivation du déploiement automatique, les instances de pile restent inchangées lorsque le compte membre du dossier est modifié.
RetainStacksOnAccountRemoval	Boolean	true	Indique si les piles du compte membre sont conservées lorsque le compte membre est supprimé du dossier. Valeurs valides : true : Les piles sont conservées. false : Les piles sont supprimées. Remarque Ce paramètre est renvoyé uniquement lorsque le paramètre Enabled est défini sur true.
RdFolderIds	Array of String	["fd-4PvlVLOL8v"]	ID de dossier du répertoire de ressources. Ce paramètre permet de déployer des instances de pile dans tous les comptes des dossiers. Remarque Ce paramètre est renvoyé uniquement lorsque le paramètre PermissionModel est défini sur SERVICE_MANAGED.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

<GetStackGroupResponse>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <StackGroup>
        <Status>ACTIVE</Status>
        <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
        <StackGroupName>MyStackGroup</StackGroupName>
        <StackGroupId>fd0ddef9-9540-4b42-a464-94f77835****</StackGroupId>
        <AdministrationRoleName>AliyunROSStackGroupAdministrationRole</AdministrationRoleName>
        <TemplateBody>
            <ROSTemplateFormatVersion>2015-09-01</ROSTemplateFormatVersion>
        </TemplateBody>
        <PermissionModel>SELF_MANAGED</PermissionModel>
        <ExecutionRoleName>AliyunROSStackGroupExecutionRole</ExecutionRoleName>
    </StackGroup>
</GetStackGroupResponse>

Format JSON

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

{
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroup" : {
    "Status" : "ACTIVE",
    "Parameters" : [ ],
    "ResourceGroupId" : "rg-acfmxazb4ph6aiy****",
    "StackGroupName" : "MyStackGroup",
    "StackGroupId" : "fd0ddef9-9540-4b42-a464-94f77835****",
    "AdministrationRoleName" : "AliyunROSStackGroupAdministrationRole",
    "TemplateBody" : {
      "ROSTemplateFormatVersion" : "2015-09-01"
    },
    "PermissionModel" : "SELF_MANAGED",
    "ExecutionRoleName" : "AliyunROSStackGroupExecutionRole"
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.

Code d'erreur

Message d'erreur

Code d'état HTTP

Description

StackGroupNotFound

The StackGroup ({name}) could not be found.

404

Le groupe de piles spécifié n'existe pas. name représente le nom du groupe de piles.