プロトコルサービスのエクスポートディレクトリパラメーターを変更します。変更できるのは権限グループと説明のみです。VPC ID および vSwitch ID は変更できません。これらを変更するには、エクスポートディレクトリを削除して新規に作成してください。
操作説明
-
事前準備: この操作は Cloud Parallel File Storage (CPFS) ファイルシステムにのみ適用されます。
-
ステータスの前提条件: この操作を呼び出す前に、ExportId に対応するエクスポートディレクトリが AVAILABLE 状態である必要があります。 DescribeProtocolMountTarget を呼び出してステータスをクエリし、作成が完了するまで待ってから再試行してください。
-
依存関係チェーン:
DescribeFileSystems (FileSystemType を cpfs にセット) を呼び出して CPFS ファイルシステムを取得します。
DescribeProtocolService を呼び出して、プロトコルサービスが Running 状態であることを確認します。
DescribeProtocolMountTarget を呼び出して、エクスポートディレクトリが AVAILABLE 状態であることを確認します。
エクスポートディレクトリが存在しない場合は、 CreateProtocolMountTarget を呼び出して先に作成してください。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| 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 値を持つようにしてください。 ClientToken は ASCII 文字のみをサポートし、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」を参照してください。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なる場合があります。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| RequestId |
string |
リクエストの ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 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. | 指定された説明のフォーマットが無効です。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。