全部產品
Search
文件中心

Cloud Parallel File Storage:ModifyProtocolMountTarget

更新時間:Sep 03, 2026

修改協議服務的匯出目錄參數,只能修改權限群組和描述資訊。VPC ID 和 vSwitch ID 不允許修改,如果需要修改,需要刪除匯出目錄再新建。

介面說明

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

ProtocolServiceId

string

是

協議服務 ID。呼叫 DescribeProtocolService 介面查詢協議服務資訊後獲取。

ptc-197ed6a00f2b****

ExportId

string

是

協議服務匯出目錄 ID。呼叫 DescribeProtocolMountTarget 介面查詢匯出目錄資訊後獲取。

exp-19abf5beab8d****

FileSystemId

string

是

檔案系統 ID。呼叫 DescribeFileSystems 介面查詢檔案系統資訊後獲取(入參 FileSystemType=cpfs)。

cpfs-099394bd928c****

Description

string

否

協議服務匯出目錄的描述。

限制:

  • 長度為 2~128 個英文或中文字元。

  • 必須以大小寫字母或中文開頭,不能以 http:// 和 https:// 開頭。

  • 可以包含數字、半形冒號(:)、底線(_)或者連字號(-)。

此匯出目錄的描述資訊

DryRun

boolean

否

是否對此次修改請求執行預檢。

預檢操作會協助您檢查參數有效性、依賴條件等,並不會實際修改匯出目錄,也不會產生費用。

取值:

  • true:傳送檢查請求,不會修改匯出目錄。檢查項目包括是否填寫了必要參數、請求格式、業務限制依賴條件。

    • DryRun=true 同樣執行資源狀態檢查(含匯出目錄 AVAILABLE 狀態要求)

    • 若匯出目錄狀態不滿足要求(如 CREATING),同樣返回對應錯誤

    • DryRun 不繞過狀態檢查,僅用於驗證請求參數合法性和基本依賴關係

    • 如果檢查未通過,則返回對應錯誤。如果檢查通過,則返回 200 HttpCode。

  • false(預設值):傳送正常請求,通過檢查後直接修改匯出目錄參數。

true

ClientToken

string

否

保證請求冪等性,從您的用戶端產生一個參數值,確保不同的請求間該參數值唯一。

ClientToken 只支援 ASCII 字元,且不能超過 64 個字元。更多資訊,請參見如何保證冪等性。

說明

若使用者未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 MissingFileSystemId FileSystemId is mandatory for this action. 未指定 FileSystemId 參數。
400 MissingExportId ExportId is mandatory for this action. 未指定 ExportId 參數。
400 MissingAccessGroupName AccessGroupName is mandatory for this action. 未指定權限群組。
400 MissingProtocolServiceId ProtocolServiceId is mandatory for this action. 未指定 ProtocolServiceId 參數。
403 Instance.IncorrectStatus The specified instance is in an incorrect status. 目前狀態不允許操作。
403 OperationDenied.InvalidMntStatus The operation is denied due to invalid protocol mount targte status.
403 OperationDenied.InvalidPtcStatus The operation is denied due to invalid protocol service status. 目前協定服務狀態不支援此操作。
403 OperationDenied.InvalidState The operation is denied due to invalid file system state.
403 OperationDenied.NotSupported The operation is denied due to not supported. 檔案系統不支援協定機服務。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。
404 InvalidProtocolService.NotFound The specified protocol service does not exist. 指定的通訊協定服務不存在。
404 InvalidExportId.NotFound The specified ExportId does not exist. 指定的通訊協定服務匯出目錄不存在。
404 InvalidAccessGroupName.NotFound The specified access group does not exist. 指定的權限群組不存在。
404 InvalidAccessGroupName.NotAccessRule There has no rule in access group. 指定的權限群組中無規則。
404 InvalidDescription.InvalidFormat Description format is invalid. 指定的描述格式無效。

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

變更歷史

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