修改協議服務的匯出目錄參數,只能修改權限群組和描述資訊。VPC ID 和 vSwitch ID 不允許修改,如果需要修改,需要刪除匯出目錄再新建。
介面說明
-
前提條件:該介面僅適用於 CPFS 檔案系統。
-
狀態前提:呼叫本介面前,ExportId 對應的匯出目錄必須處於 AVAILABLE 狀態。請先透過 DescribeProtocolMountTarget 查詢狀態,等待建立完成後再重試。
-
前置依賴鏈:
透過 DescribeFileSystems (入參 FileSystemType=cpfs)獲取 CPFS 檔案系統。
透過 DescribeProtocolService 確認協議服務狀態為 Running。
透過 DescribeProtocolMountTarget 確認匯出目錄狀態為 AVAILABLE。
如無匯出目錄,需先呼叫 CreateProtocolMountTarget 建立。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ProtocolServiceId |
string |
是 |
協議服務 ID。呼叫 DescribeProtocolService 介面查詢協議服務資訊後獲取。 |
ptc-197ed6a00f2b**** |
| ExportId |
string |
是 |
協議服務匯出目錄 ID。呼叫 DescribeProtocolMountTarget 介面查詢匯出目錄資訊後獲取。 |
exp-19abf5beab8d**** |
| FileSystemId |
string |
是 |
檔案系統 ID。呼叫 DescribeFileSystems 介面查詢檔案系統資訊後獲取(入參 FileSystemType=cpfs)。 |
cpfs-099394bd928c**** |
| Description |
string |
否 |
協議服務匯出目錄的描述。 限制:
|
此匯出目錄的描述資訊 |
| DryRun |
boolean |
否 |
是否對此次修改請求執行預檢。 預檢操作會協助您檢查參數有效性、依賴條件等,並不會實際修改匯出目錄,也不會產生費用。 取值:
|
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. | 指定的描述格式無效。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。