ListTagResources - Data Transmission Service - Centro de documentación de Alibaba Cloud

Consulta las etiquetas vinculadas a instancias de migración de datos, sincronización de datos o seguimiento de cambios, o bien consulta las instancias vinculadas a etiquetas específicas.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Se recomienda llamar a esta operación en OpenAPI Explorer. También genera código de ejemplo para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListTagResources	La operación que se va a ejecutar. Establezca el valor en ListTagResources.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde reside la instancia de migración de datos, sincronización de datos o seguimiento de cambios. Para obtener más información, consulte Lista de regiones compatibles.
ResourceType	String	Sí	ALIYUN::DTS::INSTANCE	El tipo de recurso. Valor válido: ALIYUN::DTS::INSTANCE.
NextToken	String	No	212db86sca4384811e0b5e8707ec2****	El token de consulta. Nota Si una consulta no devuelve todos los resultados, especifique el parámetro NextToken devuelto en la siguiente consulta para obtener más resultados.
ResourceId.N	RepeatList	No	dtsntk10k6r12v****	El ID de la instancia de migración de datos, sincronización de datos o seguimiento de cambios. Llame a la operación DescribeDtsJobs para consultar el ID de la instancia. Nota N indica el número de serie de la instancia. Por ejemplo, ResourceId.0 especifica el ID de la primera instancia y ResourceId.1 especifica el ID de la segunda instancia. Puede consultar de 1 a 50 ID de instancia a la vez. Debe especificar como mínimo uno de los parámetros ResourceId.N y Tag.N.Key.
Tag.N.Key	String	No	testkey1	La clave de la etiqueta. Nota N indica el número de serie de la etiqueta. Por ejemplo, Tag.0.Key especifica la clave de la primera etiqueta y Tag.1.Key especifica la clave de la segunda etiqueta. Es posible especificar de 1 a 20 claves de etiqueta a la vez. Debe especificar como mínimo uno de los parámetros ResourceId.N y Tag.N.Key. Los parámetros no pueden ser cadenas vacías.
Tag.N.Value	String	No	testvalue1	El valor de la etiqueta. Nota N indica el número de serie de la etiqueta. Por ejemplo, Tag.0.Value especifica el valor de la primera etiqueta y Tag.1.Value especifica el valor de la segunda etiqueta. Es posible especificar de 1 a 20 valores de etiqueta a la vez. Este parámetro puede ser una cadena vacía.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
ErrCode	String	InternalError	El código de error devuelto si la solicitud se realizó con errores.
ErrMessage	String	The request processing has failed due to some unknown error.	El mensaje de error devuelto si la solicitud se realizó con errores.
NextToken	String	212db86sca4384811e0b5e8707ec2****	El token de consulta. Nota Si una consulta no devuelve todos los resultados, especifique el parámetro NextToken devuelto en la siguiente consulta para obtener más resultados.
RequestId	String	609AD332-F2B1-48B7-BF43-41FEE641****	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud se realizó correctamente.
TagResources	Array of TagResource		Las etiquetas.
TagResource
ResourceId	String	dtsntk10k6r12v****	El ID de la instancia de DTS.
ResourceType	String	ALIYUN::DTS::INSTANCE	El tipo de recurso. Valor válido: ALIYUN::DTS::INSTANCE.
TagKey	String	testkey1	La clave de la etiqueta.
TagValue	String	testvalue1	El valor de la etiqueta.

Ejemplos

Solicitudes de ejemplo

http(s)://dts.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou    
&ResourceType=ALIYUN::DTS::INSTANCE
&ResourceId.1=dtsntk10k6r12v****
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<ListTagResourcesResponse>
      <RequestId>609AD332-F2B1-48B7-BF43-41FEE641****</RequestId>
      <TagResources>
            <ResourceId>dtsntk10k6r12v****</ResourceId>
            <TagKey>testkey1</TagKey>
            <ResourceType>ALIYUN::DTS::INSTANCE</ResourceType>
            <TagValue>testvalue1</TagValue>
      </TagResources>
      <Success>true</Success>
</ListTagResourcesResponse>

Formato JSON

{
    "RequestId": "609AD332-F2B1-48B7-BF43-41FEE641****",
    "TagResources": [
        {
            "ResourceId": "dtsntk10k6r12v****",
            "TagKey": "testkey1",
            "ResourceType": "ALIYUN::DTS::INSTANCE",
            "TagValue": "testvalue1"
        }
    ],
    "Success": true
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
419	QuotaExceed.TagsPerResource	The maximum number of tags for each resource is exceeded.	El mensaje de error devuelto porque se alcanzó el número máximo de etiquetas por recurso.

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