すべてのプロダクト
Search
ドキュメントセンター

Cloud Parallel File Storage:ModifyProtocolMountTarget

最終更新日:Sep 03, 2026

プロトコルサービスのエクスポートディレクトリパラメーターを変更します。変更できるのは権限グループと説明のみです。VPC ID および vSwitch ID は変更できません。これらを変更するには、エクスポートディレクトリを削除して新規に作成してください。

操作説明

  • 事前準備: この操作は Cloud Parallel File Storage (CPFS) ファイルシステムにのみ適用されます。

  • ステータスの前提条件: この操作を呼び出す前に、ExportId に対応するエクスポートディレクトリが AVAILABLE 状態である必要があります。 DescribeProtocolMountTarget を呼び出してステータスをクエリし、作成が完了するまで待ってから再試行してください。

  • 依存関係チェーン:

    1. DescribeFileSystems (FileSystemType を cpfs にセット) を呼び出して CPFS ファイルシステムを取得します。

    2. DescribeProtocolService を呼び出して、プロトコルサービスが Running 状態であることを確認します。

    3. DescribeProtocolMountTarget を呼び出して、エクスポートディレクトリが AVAILABLE 状態であることを確認します。

    4. エクスポートディレクトリが存在しない場合は、 CreateProtocolMountTarget を呼び出して先に作成してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

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 はステータスチェックをバイパスしません。リクエストパラメーターの有効性と基本的な依存関係を検証するのみです。

    • チェックに失敗した場合は対応するエラーが返されます。チェックに成功した場合は HTTP 状態コード 200 が返されます。

  • false (デフォルト): 通常のリクエストを送信します。チェックに成功すると、エクスポートディレクトリパラメーターが直接変更されます。

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. 指定された説明のフォーマットが無効です。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。