Todos os produtos
Search
Central de documentação

File Storage NAS:DescribeMountTargets

Última atualização: Jul 15, 2026

Consulta informações de pontos de montagem.

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:DescribeMountTargets

get

*FileSystem

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

FileSystemId

string

Sim

O ID do sistema de arquivos.

  • NAS de uso geral: 31a8e4****.

  • NAS Extreme: deve começar com extreme-, por exemplo, extreme-0015****.

  • Cloud Parallel File Storage (CPFS): deve começar com cpfs-, por exemplo, cpfs-125487****.

1ca404****

MountTargetDomain

string

Não

O endereço do ponto de montagem.

1ca404****-x****.cn-hangzhou.nas.aliyuncs.com

PageSize

integer

Não

O número de pontos de montagem em cada página.

Valores válidos: 1 a 100.

Valor padrão: 10.

1

PageNumber

integer

Não

O número da página da lista.

Valor inicial (valor padrão): 1.

1

DualStackMountTargetDomain

string

Não

O domínio do ponto de montagem dual-stack (IPv4 e IPv6).

Nota

Atualmente, o IPv6 é suportado apenas por sistemas de arquivos NAS Extreme em regiões da China continental.

1ca404****-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

TotalCount

integer

O número total de pontos de montagem.

1

RequestId

string

O ID da solicitação.

3BAB90FD-B4A0-48DA-9F09-2B963510****

PageSize

integer

O número de pontos de montagem em cada página quando a paginação é utilizada.

1

PageNumber

integer

O número da página da lista de sistemas de arquivos.

1

MountTargets

object

MountTarget

array<object>

A coleção de informações dos pontos de montagem.

array<object>

VpcId

string

O ID da VPC.

vpc-2zesj9afh3y518k9o****

Status

string

O status atual do ponto de montagem.

Valores válidos:

  • Active: disponível.

  • Inactive: indisponível.

  • Pending: a tarefa está na fila.

  • Deleting: o ponto de montagem está sendo excluído.

  • Hibernating: o ponto de montagem está entrando em hibernação.

  • Hibernated: o ponto de montagem está hibernado.

Nota

Você só pode montar um sistema de arquivos quando o status for Active.

Active

ClientMasterNodes

object

ClientMasterNode

array<object>

As informações do nó de gerenciamento do cliente.

object

EcsId

string

O ID da instância ECS do nó de gerenciamento.

i-hp3i3odi5ory1buo****

DefaultPasswd

string

A senha de logon padrão.

12****

EcsIp

string

O endereço IP da instância ECS do nó de gerenciamento.

192.168.1.0

MountTargetDomain

string

O ponto de montagem IPv4.

1ca404****-w****.cn-hangzhou.nas.aliyuncs.com

AccessGroup

string

O nome do grupo de permissões aplicado ao ponto de montagem.

DEFAULT_VPC_GROUP_NAME

DualStackMountTargetDomain

string

O ponto de montagem dual-stack IPv4 e IPv6.

1ca404****-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

VswId

string

O ID do vSwitch.

vsw-2zevmwkwyztjuoffg****

Tags

object

Tag

array<object>

As tags. Comprimento do array: 1 a 20. Se o array contiver vários objetos de tag, a chave da tag (Key) deve ser única.

object

O objeto de tag.

Key

string

A chave da tag.

Limites:

  • Não pode estar vazia ou ser uma string vazia.

  • Pode ter até 128 caracteres de comprimento.

  • Não pode começar com aliyun ou acs:.

  • Não pode conter http:// ou https://.

nastest

Value

string

O valor da tag.

Limites:

  • Pode ter até 128 caracteres de comprimento.

  • Não pode conter http:// ou https://.

mounttargettest

NetworkType

string

O tipo de rede. O valor é Vpc, que indica uma nuvem privada virtual (VPC).

Vpc

IPVersion

string

O tipo de ponto de montagem.

  • IPv4: ponto de montagem IPv4.

  • DualStack: ponto de montagem dual-stack.

IPv4

AccessPointAccessOnly

boolean

Indica se o ponto de montagem da VPC Lingjun suporta acesso apenas por pontos de acesso.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 1,
  "RequestId": "3BAB90FD-B4A0-48DA-9F09-2B963510****",
  "PageSize": 1,
  "PageNumber": 1,
  "MountTargets": {
    "MountTarget": [
      {
        "VpcId": "vpc-2zesj9afh3y518k9o****",
        "Status": "Active",
        "ClientMasterNodes": {
          "ClientMasterNode": [
            {
              "EcsId": "i-hp3i3odi5ory1buo****",
              "DefaultPasswd": "12****",
              "EcsIp": "192.168.1.0"
            }
          ]
        },
        "MountTargetDomain": "1ca404****-w****.cn-hangzhou.nas.aliyuncs.com",
        "AccessGroup": "DEFAULT_VPC_GROUP_NAME",
        "DualStackMountTargetDomain": "1ca404****-x****.dualstack.cn-hangzhou.nas.aliyuncs.com",
        "VswId": "vsw-2zevmwkwyztjuoffg****",
        "Tags": {
          "Tag": [
            {
              "Key": "nastest",
              "Value": "mounttargettest"
            }
          ]
        },
        "NetworkType": "Vpc",
        "IPVersion": "IPv4",
        "AccessPointAccessOnly": true
      }
    ]
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidFileSystem.NotsupportedIPv6 The file system does not support IPv6. O sistema de arquivos não suporta IPv6.
404 InvalidMountTarget.NotFound The specified mount target does not exist. O destino de montagem especificado não existe.
404 InvalidFileSystem.NotFound The specified file system does not exist. O sistema de arquivos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.