GetStackResource - - Centre de documentation Alibaba Cloud

Cette rubrique explique comment interroger la ressource nommée WebServer dans une pile dont l'ID est 4a6c9851-3b0f-4f5f-b4ca-a14bf691****. La pile est déployée 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	GetStackResource	Opération à effectuer. Définissez la valeur sur GetStackResource.
StackId	String	Yes	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	ID de la pile.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	Jeton client utilisé pour garantir l'idempotence de la requête. Générez la valeur via le client, en veillant à son unicité pour chaque requête. Le jeton peut contenir jusqu'à 64 caractères, notamment des lettres, des chiffres, des traits d'union (-) et des tirets bas (_). Pour plus d'informations, consultez Garantir l'idempotence.
RegionId	String	Yes	cn-hangzhou	ID de la région à laquelle appartient la pile. Appelez l'opération DescribeRegions pour consulter la liste des régions.
ShowResourceAttributes	Boolean	No	true	Indique s'il faut interroger les propriétés de la ressource. Valeurs possibles : true false
LogicalResourceId	String	Yes	WebServer	ID logique de la ressource définie dans le modèle.
ResourceAttributes.N	String	No	InstanceId	Nom de la propriété de ressource N à interroger. Remarque Valeur maximale de N : 20.

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

Paramètres de réponse

Parameter	Type	Example	Description
Status	String	CREATE_COMPLETE	État de la ressource. Valeurs possibles : CREATE_COMPLETE CREATE_FAILED CREATE_IN_PROGRESS UPDATE_IN_PROGRESS UPDATE_FAILED UPDATE_COMPLETE DELETE_IN_PROGRESS DELETE_FAILED CHECK_IN_PROGRESS CHECK_FAILED CHECK_COMPLETE IMPORT_IN_PROGRESS IMPORT_FAILED IMPORT_COMPLETE
Description	String	no description	Description de la ressource.
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6	ID de la requête.
StatusReason	String	state changed	Raison de l'état actuel de la ressource.
PhysicalResourceId	String	d04af923-e6b7-4272-aeaa-47ec9777****	ID physique de la ressource.
CreateTime	String	2019-08-01T06:01:23	Heure de création de la ressource. L'heure respecte la norme ISO 8601 au format AAAA-MM-JJThh:mm:ss et est affichée en UTC.
Metadata	Map		Métadonnées.
ResourceType	String	ALIYUN::ROS::WaitConditionHandle	Type de ressource.
ResourceAttributes	Array of Object	[{"ResourceAttributeKey": "CurlCli","ResourceAttributeValue": "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2**\\&resource=WaitConditionHandle\\&expire=156468\\&signature=991d910a901a89db6580d74233119960c004**"}]	Liste des propriétés de la ressource.
LogicalResourceId	String	WebServer	ID logique de la ressource définie dans le modèle.
ResourceDriftStatus	String	IN_SYNC	État de la ressource lors de la dernière détection de dérive réussie. Valeurs possibles : DELETED : la configuration réelle de la ressource diffère de la configuration attendue du modèle car la ressource a été supprimée. MODIFIED : la configuration réelle de la ressource diffère de la configuration attendue du modèle. NOT_CHECKED : ROS n'a pas vérifié si la configuration réelle de la ressource diffère de la configuration attendue du modèle. IN_SYNC : la configuration réelle de la ressource correspond à la configuration attendue du modèle.
UpdateTime	String	2019-08-01T06:01:29	Heure de mise à jour de la ressource. L'heure respecte la norme ISO 8601 au format AAAA-MM-JJThh:mm:ss et est affichée en UTC.
DriftDetectionTime	String	2020-02-27T07:47:47	Heure de la dernière détection de dérive réussie sur la pile.
StackName	String	test-describe-resource	Nom de la pile. Le nom peut contenir jusqu'à 255 caractères, notamment des chiffres, des lettres, des traits d'union (-) et des tirets bas (_). Il doit commencer par un chiffre ou une lettre.
StackId	String	efdf5c10-96a5-4fd7-ab89-68e7baa2****	ID de la pile.

Exemples

Exemple de requête

http(s)://ros.aliyuncs.com/?Action=GetStackResource
&RegionId=cn-hangzhou
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&LogicalResourceId=WebServer
&<Common request parameters>

Exemple de réponse correcte

Format XML

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

<GetStackResourceResponse>
	<CreateTime>2019-08-01T06:01:23</CreateTime>
	<Description></Description>
	<LogicalResourceId>WaitConditionHandle</LogicalResourceId>
	<Metadata />
	<PhysicalResourceId></PhysicalResourceId>
	<RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId>
	<ResourceAttributes>
		<ResourceAttributeKey>CurlCli</ResourceAttributeKey>
		<ResourceAttributeValue>curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\&amp;stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****\&amp;resource=WaitConditionHandle\&amp;expire=156468****\&amp;signature=991d910a901a89db6580d74233119960c004****</ResourceAttributeValue>
	</ResourceAttributes>
	<ResourceAttributes>
		<ResourceAttributeKey>WindowsCurlCli</ResourceAttributeKey>
		<ResourceAttributeValue>curl -i -X POST -H &quot;Content-Type: application/json&quot; -H &quot;Accept: application/json&quot; -H &quot;x-acs-region-id: cn-beijing&quot; &quot;http://192.168.XX.XX/waitcondition?stackname=test-describe-resource&amp;stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****&amp;resource=WaitConditionHandle&amp;expire=156468****&amp;signature=991d910a901a89db6580d74233119960c004****&quot;</ResourceAttributeValue>
	</ResourceAttributes>
	<ResourceAttributes>
		<ResourceAttributeKey>PowerShellCurlCli</ResourceAttributeKey>
		<ResourceAttributeValue>curl -Uri &quot;http://192.168.XX.XX/waitcondition?stackname=test-describe-resource&amp;stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****&amp;resource=WaitConditionHandle&amp;expire=156468****&amp;signature=991d910a901a89db6580d74233119960c004****&quot; -Method Post -Headers @{&quot;Content-Type&quot;=&quot;application/json&quot;; &quot;Accept&quot;=&quot;application/json&quot;; &quot;x-acs-region-id&quot;=&quot;cn-beijing&quot;}</ResourceAttributeValue>
	</ResourceAttributes>
	<ResourceType>ALIYUN::ROS::WaitConditionHandle</ResourceType>
	<StackId>efdf5c10-96a5-4fd7-ab89-68e7baa2****</StackId>
	<StackName>test-describe-resource</StackName>
	<Status>UPDATE_COMPLETE</Status>
	<StatusReason>state changed</StatusReason>
	<UpdateTime>2019-08-01T06:01:29</UpdateTime>
	<DriftDetectionTime>2020-02-27T07:47:47</DriftDetectionTime>
	<ResourceDriftStatus>IN_SYNC</ResourceDriftStatus>
</GetStackResourceResponse>

Format JSON

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

{
  "CreateTime" : "2019-08-01T06:01:23",
  "Description" : "",
  "LogicalResourceId" : "WaitConditionHandle",
  "Metadata" : { },
  "PhysicalResourceId" : "",
  "RequestId" : "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "ResourceAttributes" : [ {
    "ResourceAttributeKey" : "CurlCli",
    "ResourceAttributeValue" : "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****\\&resource=WaitConditionHandle\\&expire=156468****\\&signature=991d910a901a89db6580d74233119960c004****"
  }, {
    "ResourceAttributeKey" : "WindowsCurlCli",
    "ResourceAttributeValue" : "curl -i -X POST -H \"Content-Type: application/json\" -H \"Accept: application/json\" -H \"x-acs-region-id: cn-beijing\" \"http://192.168.XX.XX/waitcondition?stackname=test-describe-resource&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****&resource=WaitConditionHandle&expire=156468****&signature=991d910a901a89db6580d74233119960c004****\""
  }, {
    "ResourceAttributeKey" : "PowerShellCurlCli",
    "ResourceAttributeValue" : "curl -Uri \"http://192.168.XX.XX/waitcondition?stackname=test-describe-resource&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****&resource=WaitConditionHandle&expire=156468****&signature=991d910a901a89db6580d74233119960c004****\" -Method Post -Headers @{\"Content-Type\"=\"application/json\"; \"Accept\"=\"application/json\"; \"x-acs-region-id\"=\"cn-beijing\"}"
  } ],
  "ResourceType" : "ALIYUN::ROS::WaitConditionHandle",
  "StackId" : "efdf5c10-96a5-4fd7-ab89-68e7baa2****",
  "StackName" : "test-describe-resource",
  "Status" : "UPDATE_COMPLETE",
  "StatusReason" : "state changed",
  "UpdateTime" : "2019-08-01T06:01:29",
  "DriftDetectionTime" : "2020-02-27T07:47:47",
  "ResourceDriftStatus" : "IN_SYNC"
}

Codes d'erreur

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

Http status code	Error code	Error message	Description
404	ResourceNotFound	The Resource ({name}) could not be found in Stack {stack}.	La ressource spécifiée n'existe pas dans la pile. name indique le nom de la ressource. stack indique le nom ou l'ID de la pile.
404	StackNotFound	The Stack ({name}) could not be found.	La pile n'existe pas. name indique le nom ou l'ID de la pile.