全部產品
Search
文件中心

Cloud Parallel File Storage:DescribeMountTargets - 查詢掛載點資訊

更新時間:May 08, 2026

查詢掛載點資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:DescribeMountTargets

get

*FileSystem

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

請求參數

名稱

類型

必填

描述

樣本值

FileSystemId

string

檔案系統 ID。

  • 通用型 NAS:31a8e4****。

  • 極速型 NAS:必須以extreme-開頭,例如 extreme-0015****。

  • CPFS:必須以cpfs-開頭,例如 cpfs-125487****。

1ca404****

MountTargetDomain

string

掛載點地址。

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

PageSize

integer

每個分頁包含的掛載點個數。

取值範圍:1~100

預設值:10

1

PageNumber

integer

列表的分頁頁碼。

起始值(預設值):1

1

DualStackMountTargetDomain

string

IPv4 和 IPv6 雙棧掛載點。

說明

當前僅極速型 NAS 中國內地各地區支援 IPv6 功能。

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

返回參數

名稱

類型

描述

樣本值

object

TotalCount

integer

掛載點總數。

1

RequestId

string

請求 ID。

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

PageSize

integer

分頁查詢時,每個分頁包含的掛載點個數。

1

PageNumber

integer

檔案系統列表的分頁頁碼。

1

MountTargets

object

MountTarget

array<object>

掛載點資訊集合。

array<object>

VpcId

string

專用網路 ID。

vpc-2zesj9afh3y518k9o****

Status

string

當前掛載點狀態。

包括:

  • Active:可用

  • Inactive:不可用

  • Pending:任務排隊中

  • Deleting:刪除中

  • Hibernating:休眠中

  • Hibernated:已休眠

說明

當狀態為 Active 時才可以掛載檔案系統。

Active

ClientMasterNodes

object

ClientMasterNode

array<object>

用戶端管理節點資訊集合。

object

EcsId

string

管理節點 ECS 執行個體 ID。

i-hp3i3odi5ory1buo****

DefaultPasswd

string

預設登入密碼。

12****

EcsIp

string

管理節點 ECS 執行個體 IP。

192.168.1.0

MountTargetDomain

string

IPv4 掛載點。

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

AccessGroup

string

掛載點所應用的許可權組名稱。

DEFAULT_VPC_GROUP_NAME

DualStackMountTargetDomain

string

IPv4 和 IPv6 雙棧掛載點。

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

VswId

string

交換器 ID。

vsw-2zevmwkwyztjuoffg****

Tags

object

Tag

array<object>

標籤數組。數組長度:1~20。如果數組中有多個標籤對象,標籤鍵 Key 不允許重複。

object

標籤對象。

Key

string

標籤鍵。 限制:

  • 不允許為空白和Null 字元串。

  • 最多支援 128 個字元。

  • 不能以 aliyun 或 acs:開頭。

  • 不能包含 http://和 https://。

nastest

Value

string

標籤值。

限制:

  • 最多支援 128 個字元。

  • 不能包含 http://和 https://。

mounttargettest

NetworkType

string

網路類型。取值為 Vpc,表示專用網路。

Vpc

IPVersion

string

掛載點類型。

  • IPv4:IPv4 掛載點。

  • DualStack:雙棧掛載點。

IPv4

AccessPointAccessOnly

boolean

樣本

正常返回樣本

JSON格式

{
  "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
      }
    ]
  }
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidFileSystem.NotsupportedIPv6 The file system does not support IPv6. 該檔案系統不支援IPv6。
404 InvalidMountTarget.NotFound The specified mount target does not exist. 指定的掛載點不存在。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情