GetProtocolMountTarget - 查詢協議服務匯出目錄資訊 - Cloud Parallel File Storage

查詢協議服務匯出目錄資訊。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:GetProtocolMountTarget

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
NextToken	string	否	當請求的返回結果被截斷時，您可以使用 NextToken 再次發起請求，擷取從當前截斷位置之後的內容。	M18xMA==
MaxResults	integer	否	每次查詢結果的個數。取值範圍：10~100。預設值：20。	20
FileSystemId	string	是	檔案系統 ID。 CPFS：必須以`cpfs-`開頭，例如 cpfs-125487**。 CPFS 智算版：必須以`bmcpfs-`開頭，例如 bmcpfs-0015。 CPFS SE：必須以`cpfsse-`開頭，例如 cpfsse-022c71b134**。	cpfs-099394bd928c****
ClientToken	string	否	保證請求等冪性，從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。 ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證等冪性。說明若使用者未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。	123e4567-e89b-12d3-a456-42665544****
ProtocolServiceId	string	是	協議服務 ID。	ptc-197ed6a00f2b****
ExportId	string	是	協議服務匯出目錄 ID。	exp-19abf5beab8d****

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID。	6299428C-3861-435D-AE54-9B330A00****
NextToken	string	當請求的返回結果被截斷時，您可以使用 NextToken 再次發起請求，擷取從當前截斷位置之後的內容。	M18xMA==
ProtocolMountTarget	object	協議服務匯出目錄資訊
ExportId	string	匯出目錄 ID。	exp-19abf5beab8d****
ProtocolMountTargetDomain	string	協議服務匯出目錄的網域名稱。	cpfs-0229cb80bcc0**-x**.cn-***.cpfs.aliyuncs.com
ProtocolType	string	檔案系統協議類型。包括： NFS：NFS 檔案協議 SMB：SMB 檔案協議 cpfs：CPFS 檔案系統支援的協議類型	NFS
VpcId	string	協議服務匯出的專用網路 ID。	vpc-bp1h5mxoqfuo3xurf****
VSwitchId	string	協議服務匯出的交換器 ID。	vsw-8vb2qjnxs6hiobzve****
VSwitchIds	array	協議服務匯出的交換器 ID 列表。
	string	協議服務匯出的交換器 ID。	vsw-bp1q3ro8erikjjrb2****
FsetId	string	Fileset ID。	fset-299b4ca04de8****
Path	string	查詢到的 CPFS 目錄的路徑。格式：長度為 1~1024 個字元。使用 UTF-8 編碼。必須以正斜線（/）開頭和結尾，根目錄為`/`。	/
AccessGroupName	string	許可權組名稱。預設許可權組：DEFAULT_VPC_GROUP_NAME	DEFAULT_VPC_GROUP_NAME
CreateTime	string	建立時間。返回格式：yyyy-MM-dd HH:mm:ss	2025-12-22 17:49:25
Status	string	協議服務匯出目錄的狀態。包括： CREATING：建立中。 AVAILABLE ：可用。 MODIFYING：修改中。 DELETING：刪除中。 STOPPING：停止中。	AVAILABLE
Description	string	協議服務匯出的描述。	此協議服務匯出的描述。

樣本

正常返回樣本

JSON格式

{
  "RequestId": "6299428C-3861-435D-AE54-9B330A00****",
  "NextToken": "M18xMA==",
  "ProtocolMountTarget": {
    "ExportId": "exp-19abf5beab8d****",
    "ProtocolMountTargetDomain": "cpfs-0229cb80bcc0****-x******.cn-*****.cpfs.aliyuncs.com",
    "ProtocolType": "NFS",
    "VpcId": "vpc-bp1h5mxoqfuo3xurf****",
    "VSwitchId": "vsw-8vb2qjnxs6hiobzve****",
    "VSwitchIds": [
      "vsw-bp1q3ro8erikjjrb2****"
    ],
    "FsetId": "fset-299b4ca04de8****",
    "Path": "/",
    "AccessGroupName": "DEFAULT_VPC_GROUP_NAME",
    "CreateTime": "2025-12-22 17:49:25",
    "Status": "AVAILABLE",
    "Description": "此協議服務匯出的描述。"
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	MissingFileSystemId	FileSystemId is mandatory for this action.	未指定FileSystemId參數。
400	MissingExportId	ExportId is mandatory for this action.	未指定ExportId參數。
404	InvalidFileSystem.NotFound	The specified file system does not exist.	指定的檔案系統不存在。
404	Resource.NotFound	The specified resource does not exist.	指定的資源不存在。

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

變更歷史

更多資訊，參考變更詳情。