全部產品
Search
文件中心

File Storage NAS:DescribeMountedClients - 查詢已掛載的用戶端列表

更新時間:Apr 04, 2026

查詢已掛載的用戶端列表。

介面說明

  • 僅通用型 NAS 支援該介面。

  • 用戶端列表顯示近一分鐘對檔案系統有讀寫訪問的用戶端 IP,部分已掛載而沒有訪問檔案系統的用戶端 IP 可能不在此列表中顯示。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:DescribeMountedClients

list

*FileSystem

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

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

地區 ID。

cn-hangzhou

PageSize

integer

分頁查詢時,每個分頁包含的用戶端 IP 的個數。

取值範圍:1~100

預設值:10

10

FileSystemId

string

檔案系統 ID。

31a8e4****

ClientIP

string

用戶端 IP 位址。

  • 當您指定用戶端 IP 時,調用介面會判斷用戶端列表是否包含該用戶端 IP。若包含,則返回該用戶端 IP;若不包含,則返回空列表。

  • 當您未指定用戶端 IP 時,調用介面會返回近 1 分鐘使用 NAS 檔案系統的所有用戶端 IP 列表。

10.10.10.1

MountTargetDomain

string

掛載點。

1111222****95.cn-hangzhou.nas.aliyuncs.com

PageNumber

integer

用戶端列表的分頁頁碼。

起始值(預設值):1

1

返回參數

名稱

類型

描述

樣本值

object

TotalCount

integer

查詢到的用戶端 IP 的總個數。

10

RequestId

string

請求 ID。

A70BEE5D-76D3-49FB-B58F-1F398211****

PageSize

integer

每個分頁包含的用戶端 IP 個數。

10

PageNumber

integer

用戶端列表的分頁頁碼。

1

Clients

object

Client

array<object>

用戶端資訊集合。

object

ClientIP

string

用戶端 IP 位址。

10.10.10.1

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 10,
  "RequestId": "A70BEE5D-76D3-49FB-B58F-1F398211****",
  "PageSize": 10,
  "PageNumber": 1,
  "Clients": {
    "Client": [
      {
        "ClientIP": "10.10.10.1"
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情