Todos os produtos
Search
Central de documentação

:ListTagResources

Última atualização: Jun 28, 2026

Consulta as tags associadas a um ou mais recursos do Server Migration Center (SMC). Os recursos do SMC incluem origens de migração e tarefas de migração.

Parâmetros da solicitação

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

A operação a ser executada. Defina o valor como ListTagResources.

ResourceType String Sim sourceserver

O tipo de recurso do SMC. Valores válidos:

  • sourceserver: origem de migração
  • replicationjob: tarefa de migração
NextToken String Não caeba0bbb2be03f84eb48b699f0a4883

O token necessário para a próxima consulta.

ResourceId.N String Não s-bp1e2fsl57knvuug****

O ID do recurso do SMC. Os recursos do SMC incluem origens de migração e tarefas de migração.

Tag.N.Key String Não TestKey

A chave da tag N. A chave deve ter de 1 a 64 caracteres. Valores válidos de N: 1 a 20.

Use Tag.N para correspondência exata dos recursos do SMC aos quais a tag está associada. A tag N consiste em um par chave-valor.

  • As chaves e os valores das tags diferenciam maiúsculas de minúsculas.
  • Se você definir apenas o parâmetro Tag.N.Key, todos os recursos associados às tags especificadas serão retornados.
  • Se você definir apenas o parâmetro Tag.N.Value, a mensagem de erro InvalidParameter.TagValue será retornada.
  • Ao especificar vários pares chave-valor de tag simultaneamente, apenas os recursos do SMC que corresponderem a todos os pares serão retornados.
Tag.N.Value String Não TestValue

O valor da tag N. O valor deve ter de 1 a 64 caracteres. Valores válidos de N: 1 a 20.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

NextToken

String

caeba0bbb2be03f84eb48b699f0a4883

O token necessário para a próxima consulta.

Se este parâmetro retornar um valor nulo, não há mais tags para consultar.

RequestId

String

17743161-66F3-4E7F-B8AE-845FB28B928F

O ID da solicitação.

TagResources

Array of TagResource

As informações retornadas sobre os recursos e as tags do SMC, incluindo o ID, o tipo e os pares chave-valor das tags dos recursos.

TagResource

ResourceType

String

ALIYUN::SMC::SOURCESERVER

O tipo do recurso.

TagValue

String

TestValue

O valor da tag do recurso.

ResourceId

String

s-bp1e2fsl57knvuug****

O ID do recurso.

TagKey

String

TestKey

A chave da tag do recurso.

Exemplos

Exemplos de solicitações

http(s)://smc.aliyuncs.com/?Action=ListTagResources
&ResourceType=sourceserver
&NextToken=caeba0bbb2be03f84eb48b699f0a4883
&ResourceId=["s-bp1e2fsl57knvuug****"]
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ListTagResourcesResponse>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <RequestId>17743161-66F3-4E7F-B8AE-845FB28B928F</RequestId>
    <TagResources>
        <ResourceType>ALIYUN::SMC::SOURCESERVER</ResourceType>
        <TagValue>TestValue</TagValue>
        <ResourceId>s-bp1e2fsl57knvuug****</ResourceId>
        <TagKey>TestKey</TagKey>
    </TagResources>
</ListTagResourcesResponse>

Formato JSON

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

{
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId" : "17743161-66F3-4E7F-B8AE-845FB28B928F",
  "TagResources" : [ {
    "ResourceType" : "ALIYUN::SMC::SOURCESERVER",
    "TagValue" : "TestValue",
    "ResourceId" : "s-bp1e2fsl57knvuug****",
    "TagKey" : "TestKey"
  } ]
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

NumberExceed.Tags

The maximum number of the Tag parameters cannot exceed 20.

Mensagem retornada quando o número de tags especificadas excede o limite superior de 20.

400

MissingParameter.ResourceType

You must specify ResourceType.

Mensagem retornada quando o tipo de recurso não é especificado.

400

InvalidResourceType.NotFound

The specified ResourceType does not exist.

Mensagem retornada quando o tipo de recurso especificado não existe.

400

NumberExceed.ResourceIds

The maximum number of ResourceId parameters cannot exceed 50.

Mensagem retornada quando o número de IDs de recurso especificados excede o limite superior de 50.

400

Duplicate.ResourceId

The ResourceId contains duplicate values.

Mensagem retornada quando IDs de recurso duplicados são especificados.

400

InvalidResourceId.NotFound

The specified ResourceIds do not exist.

Mensagem retornada quando o recurso especificado não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.