Todos los productos
Search
Centro de documentos

File Storage NAS:DescribeMountTargets

Última actualización: Sep 01, 2026

Consulta la información de los puntos de montaje.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

nas:DescribeMountTargets

get

*FileSystem

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

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

FileSystemId

string

Sí

El ID del sistema de archivos.

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

  • NAS extremo: debe comenzar con extreme-, por ejemplo, extreme-0015****.

  • Cloud Parallel File Storage (CPFS): debe comenzar con cpfs-, por ejemplo, cpfs-125487****.

1ca404****

MountTargetDomain

string

No

La dirección del punto de montaje.

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

PageSize

integer

No

El número de puntos de montaje en cada página.

Valores válidos: de 1 a 100.

Valor predeterminado: 10.

1

PageNumber

integer

No

El número de página de la lista.

Valor inicial (valor predeterminado): 1.

1

DualStackMountTargetDomain

string

No

El dominio del punto de montaje de doble pila (IPv4 e IPv6).

Nota

Actualmente, IPv6 solo es compatible con sistemas de archivos NAS extremos en regiones de China continental.

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

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

TotalCount

integer

El número total de puntos de montaje.

1

RequestId

string

El ID de la solicitud.

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

PageSize

integer

El número de puntos de montaje en cada página cuando se utiliza la paginación.

1

PageNumber

integer

El número de página de la lista de sistemas de archivos.

1

MountTargets

object

MountTarget

array<object>

La colección de información de puntos de montaje.

array<object>

VpcId

string

El ID de la VPC.

vpc-2zesj9afh3y518k9o****

Status

string

El estado actual del punto de montaje.

Valores válidos:

  • Active: disponible.

  • Inactive: no disponible.

  • Pending: la tarea está en cola.

  • Deleting: el punto de montaje se está eliminando.

  • Hibernating: el punto de montaje está entrando en hibernación.

  • Hibernated: el punto de montaje está hibernado.

Nota

Solo puede montar un sistema de archivos cuando el estado del punto de montaje es Active.

Active

ClientMasterNodes

object

ClientMasterNode

array<object>

La colección de información de nodos de administración de clientes.

object

EcsId

string

El ID de la instancia ECS del nodo de administración.

i-hp3i3odi5ory1buo****

DefaultPasswd

string

La contraseña de inicio de sesión predeterminada.

12****

EcsIp

string

La dirección IP de la instancia ECS del nodo de administración.

192.168.1.0

MountTargetDomain

string

El punto de montaje IPv4.

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

AccessGroup

string

El nombre del grupo de permisos aplicado al punto de montaje.

DEFAULT_VPC_GROUP_NAME

DualStackMountTargetDomain

string

El punto de montaje de doble pila (IPv4 e IPv6).

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

VswId

string

El ID del vSwitch.

vsw-2zevmwkwyztjuoffg****

Tags

object

Tag

array<object>

Las etiquetas. Longitud del arreglo: de 1 a 20. La clave de etiqueta (Key) debe ser única entre los múltiples objetos de etiqueta en el arreglo.

object

El objeto de etiqueta.

Key

string

La clave de la etiqueta.

Límites:

  • No puede estar vacía ni ser una cadena vacía.

  • Puede tener una longitud máxima de 128 caracteres.

  • No puede comenzar con aliyun o acs:.

  • No puede contener http:// o https://.

nastest

Value

string

El valor de la etiqueta.

Límites:

  • Puede tener una longitud máxima de 128 caracteres.

  • No puede contener http:// o https://.

mounttargettest

NetworkType

string

El tipo de red. El valor es Vpc, que indica una nube privada virtual (VPC).

Vpc

IPVersion

string

El tipo de punto de montaje.

  • IPv4: punto de montaje IPv4.

  • DualStack: punto de montaje de doble pila.

IPv4

AccessPointAccessOnly

boolean

Indica si el punto de montaje de VPC de Lingjun admite acceso solo a través de puntos de acceso.

true

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 InvalidFileSystem.NotsupportedIPv6 The file system does not support IPv6.
404 InvalidMountTarget.NotFound The specified mount target does not exist.
404 InvalidFileSystem.NotFound The specified file system does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.