GetStackResource - - Centro de documentación de Alibaba Cloud

Consulta el recurso de una pila.

En este tema se consulta un recurso llamado WebServer en una pila cuyo ID es 4a6c9851-3b0f-4f5f-b4ca-a14bf691****. La pila está desplegada en la región China (Hangzhou).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	GetStackResource	La operación que desea ejecutar. Establezca el valor en GetStackResource.
StackId	String	Sí	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	El ID de la pila.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre las distintas solicitudes. El token puede tener hasta 64 caracteres y contener letras, dígitos, guiones (-) y guiones bajos (_). Para obtener más información, consulte Garantizar la idempotencia.
RegionId	String	Sí	cn-hangzhou	El ID de la región a la que pertenece la pila. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ShowResourceAttributes	Boolean	No	true	Especifica si se deben consultar las propiedades del recurso. Valores válidos: true false
LogicalResourceId	String	Sí	WebServer	El ID lógico del recurso definido en la plantilla.
ResourceAttributes.N	String	No	InstanceId	El nombre de la propiedad del recurso N que desea consultar. Nota Valor máximo de N: 20.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Status	String	CREATE_COMPLETE	El estado del recurso. Valores válidos: 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	La descripción del recurso.
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6	El ID de la solicitud.
StatusReason	String	state changed	El motivo por el que el recurso se encuentra en su estado actual.
PhysicalResourceId	String	d04af923-e6b7-4272-aeaa-47ec9777****	El ID físico del recurso.
CreateTime	String	2019-08-01T06:01:23	La hora en que se creó el recurso. La hora sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss y se muestra en UTC.
Metadata	Map		Los metadatos.
ResourceType	String	ALIYUN::ROS::WaitConditionHandle	El tipo de recurso.
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**"}]	La lista de propiedades del recurso.
LogicalResourceId	String	WebServer	El ID lógico del recurso definido en la plantilla.
ResourceDriftStatus	String	IN_SYNC	El estado del recurso en la última detección de desviaciones exitosa. Valores válidos: DELETED: La configuración real del recurso difiere de la esperada en la plantilla porque se eliminó el recurso. MODIFIED: La configuración real del recurso difiere de la esperada en la plantilla. NOT_CHECKED: ROS no ha comprobado si la configuración real del recurso difiere de la esperada en la plantilla. IN_SYNC: La configuración real del recurso coincide con la esperada en la plantilla.
UpdateTime	String	2019-08-01T06:01:29	La hora en que se actualizó el recurso. La hora sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss y se muestra en UTC.
DriftDetectionTime	String	2020-02-27T07:47:47	La hora en que se realizó la última detección de desviaciones exitosa en la pila.
StackName	String	test-describe-resource	El nombre de la pila. El nombre puede tener hasta 255 caracteres y contener dígitos, letras, guiones (-) y guiones bajos (_). Debe comenzar con un dígito o una letra.
StackId	String	efdf5c10-96a5-4fd7-ab89-68e7baa2****	El ID de la pila.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato 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>

Formato 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"
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.

Código de estado HTTP	Código de error	Mensaje de error	Descripción
404	ResourceNotFound	The Resource ({name}) could not be found in Stack {stack}.	El mensaje de error devuelto porque el recurso especificado no existe en la pila. name indica el nombre del recurso. stack indica el nombre o ID de la pila.
404	StackNotFound	The Stack ({name}) could not be found.	El mensaje de error devuelto porque la pila no existe. name indica el nombre o ID de la pila.