ListTagResources - File Storage NAS: Central de Documentação do Alibaba Cloud

Consulta tags.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

nas:ListTagResources

get

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceType	string	Sim	O tipo do recurso. Valores válidos: filesystem accesspoint	filesystem
NextToken	string	Não	O token de paginação utilizado na próxima solicitação para recuperar uma nova página de resultados.	无
ResourceId	array	Não	O ID do recurso. O ID do recurso de destino. Valores válidos de N: 1 a 50.	03e08484f0
	string	Não	O ID do recurso. Exemplo de ID de um sistema de arquivos NAS de uso geral: 31a8e4**. Os IDs de sistemas de arquivos Extreme NAS devem começar com extreme-, por exemplo, extreme-0015. Os IDs de sistemas de arquivos CPFS devem começar com cpfs-. Exemplo: cpfs-125487. Access Point: um ponto de acesso criado em um NAS de uso geral, associado ao ID do sistema de arquivos especificado, como '31a8e4/ap-896m22**'.	03e08484f0
Tag	array<object>	Não	As tags da instância reservada. O array pode conter até 20 tags. Se o array contiver várias tags, cada chave de tag é única.
	object	Não	A tag.
Key	string	Não	A chave de uma tag. Limites: A chave da tag não pode ser nula ou uma string vazia. O valor da tag pode ter até 128 caracteres. O valor da tag não pode começar com `aliyun` ou `acs:`. O valor da tag não pode conter `http://` ou `https://`.	nastest
Value	string	Não	O valor de uma tag. Limites: O valor da tag pode ter até 128 caracteres. O valor da tag não pode conter `http://` ou `https://`.	filetest

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NextToken	string	Um token de paginação. Pode ser utilizado na próxima solicitação para recuperar uma nova página de resultados. Se o valor deste parâmetro for nulo, nenhuma consulta será realizada após a consulta atual.	无
RequestId	string	O ID da solicitação.	2D69A58F-345C-4FDE-88E4-BF518948****
TagResources	object
TagResource	array<object>	A lista de recursos.
	object
ResourceType	string	The resource type.	filesystem
TagValue	string	The tag value.	test
ResourceId	string	The resource ID.	i-2zebd226fxed6h4iadhe
TagKey	string	The tag key.	test1

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": " 无",
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "filesystem",
        "TagValue": "test",
        "ResourceId": "i-2zebd226fxed6h4iadhe",
        "TagKey": "test1"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter.ResourceIdOrTag	Either ResourceId or Tag must be specified.	Either ResourceId or Tag must be specified.
400	InvalidNextToken	The NextToken is invalid.	The NextToken is invalid.
400	NumberExceed.ResourceIds	The maximum number of ResourceIds is exceeded. The maximum is 50.	The maximum number of resource ID is exceeded. The maximum is 50.
400	MissingParameter.ResourceIds	You must specify ResourceIds.	You must specify ResourceId.
400	Duplicate.ResourceId	The request contains duplicated ResourceId.	ResourceId cannot be duplicated.
400	NumberExceed.Tags	The maximum number of Tags is exceeded. The maximum is 20.	The maximum number of Tags is exceeded. The maximum is 20.
400	Duplicate.TagKey	The Tag.N.Key contains a duplicated key.	The specified TagKey is duplicated.
400	InvalidResourceId.NotFound	The ResourceId does not exist.	The specified ResourceId does not exist.
400	InvalidParameter.TagKey	The specified Tag.n.Key is invalid.	The specified TagKey is invalid.
400	InvalidParameter.TagValue	The specified Tag.n.Value is invalid.	The specified TagValue is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.