Todos os produtos
Search
Central de documentação

Data Transmission Service:ListTagResources

Última atualização: Jun 27, 2026

Consulta tags associadas a instâncias de migração de dados, sincronização de dados ou rastreamento de alterações, ou consulta instâncias associadas a tags específicas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta também gera códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ListTagResources

Operação a ser executada. Defina o valor como ListTagResources.

RegionId String Sim cn-hangzhou

ID da região onde reside a instância de migração de dados, sincronização de dados ou rastreamento de alterações. Para mais informações, consulte Lista de regiões suportadas.

ResourceType String Sim ALIYUN::DTS::INSTANCE

Tipo de recurso. Valor válido: ALIYUN::DTS::INSTANCE.

NextToken String Não 212db86sca4384811e0b5e8707ec2****

Token de consulta.

Nota Se uma consulta não retornar todos os resultados, especifique o parâmetro NextToken retornado na próxima consulta para obter mais resultados.
ResourceId.N RepeatList Não dtsntk10k6r12v****

ID da instância de migração de dados, sincronização de dados ou rastreamento de alterações. Chame a operação DescribeDtsJobs para consultar o ID da instância.

Nota
  • N indica o número de série da instância. Por exemplo, ResourceId.0 especifica o ID da primeira instância e ResourceId.1 especifica o ID da segunda instância. É possível consultar de 1 a 50 IDs de instância por vez.
  • Especifique pelo menos um dos parâmetros ResourceId.N e Tag.N.Key.
Tag.N.Key String Não testkey1

Chave da tag.

Nota
  • N indica o número de série da tag. Por exemplo, Tag.0.Key especifica a chave da primeira tag e Tag.1.Key especifica a chave da segunda tag. Especifique de 1 a 20 chaves de tag por vez.
  • Especifique pelo menos um dos parâmetros ResourceId.N e Tag.N.Key. Os parâmetros não podem ser strings vazias.
Tag.N.Value String Não testvalue1

Valor da tag.

Nota
  • N indica o número de série da tag. Por exemplo, Tag.0.Value especifica o valor da primeira tag e Tag.1.Value especifica o valor da segunda tag. Especifique de 1 a 20 valores de tag por vez.
  • Este parâmetro pode ser uma string vazia.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
ErrCode String InternalError

Código de erro retornado se a solicitação falhar.

ErrMessage String The request processing has failed due to some unknown error.

Mensagem de erro retornada se a solicitação falhar.

NextToken String 212db86sca4384811e0b5e8707ec2****

Token de consulta.

Nota Se uma consulta não retornar todos os resultados, especifique o parâmetro NextToken retornado na próxima consulta para obter mais resultados.
RequestId String 609AD332-F2B1-48B7-BF43-41FEE641****

ID da solicitação.

Success Boolean true

Indica se a solicitação foi bem-sucedida.

TagResources Array of TagResource

As tags.

TagResource
ResourceId String dtsntk10k6r12v****

ID da instância DTS.

ResourceType String ALIYUN::DTS::INSTANCE

Tipo de recurso. Valor válido: ALIYUN::DTS::INSTANCE.

TagKey String testkey1

Chave da tag.

TagValue String testvalue1

Valor da tag.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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 erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

419

QuotaExceed.TagsPerResource

The maximum number of tags for each resource is exceeded.

Mensagem de erro retornada porque o número máximo de tags por recurso foi atingido.

Para obter uma lista de códigos de erro, visite o API Error Center.