CreateMountTarget - Cloud Parallel File Storage - Alibaba Cloud ドキュメントセンター

マウントターゲットを作成します。

操作説明

CreateMountTarget APIを呼び出してマウントターゲットを作成する場合、一部のリソースは非同期で生成されます。CreateMountTarget APIの呼び出しが成功した後、まずDescribeMountTargets APIを呼び出してマウントターゲットのステータスを確認してください。マウントターゲットのステータスがActiveになってから、ファイルシステムのマウント操作を行ってください。そうしないと、マウントが失敗する場合があります。
このAPIを呼び出すと、操作に必要なNASサービスリンクロールが自動的に作成されます。詳細については、「NASサービスリンクロールの管理」をご参照ください。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

nas:CreateMountTarget

create

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

vpc:Vpc

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
FileSystemId	string	必須	ファイルシステムID。汎用 NAS：31a8e4**。極速 NAS：`extreme-`で始まる必要があります（例：extreme-0015）。並列ファイルストレージCPFS：`cpfs-`で始まる必要があります（例：cpfs-125487**）。	174494****
AccessGroupName	string	任意	権限グループ名。ターゲットファイルシステムが汎用 NASまたは極速 NASの場合、このパラメーターは必須です。デフォルト権限グループ：DEFAULT_VPC_GROUP_NAME（VPCデフォルト権限グループ）。	vpc-test
NetworkType	string	必須	マウントターゲットのネットワークタイプ。値をVpcに設定します。これはVirtual Private Cloud（VPC）を示します。列挙値: Vpc : VPC vpc : VPC VPC : VPC	Vpc
VpcId	string	任意	VPC ID。ネットワークタイプがVPCの場合、このパラメーターは必須です。例： NetworkType=VPCの場合、VpcIdは必須です。	vpc-2zesj9afh3y518k9o****
VSwitchId	string	任意	vSwitch ID。ネットワークタイプがVPCの場合、このパラメーターは必須です。例： NetworkType=VPCの場合、VSwitchIdは必須です。	vsw-2zevmwkwyztjuoffg****
SecurityGroupId	string	任意	セキュリティグループID。	sg-bp1fg655nh68xyz9****
EnableIpv6	boolean	任意	IPv6マウントターゲットを作成するかどうかを指定します。有効な値： true：IPv6マウントターゲットを作成します。 false（デフォルト）：IPv6マウントターゲットを作成しません。説明現在、中国本土リージョンの極速 NASのみがIPv6 機能をサポートしており、ファイルシステムでIPv6が有効になっている必要があります。	true
DryRun	boolean	任意	既存のマウントターゲットを確認するためにドライラン（事前検証）を実行するかどうかを指定します。CPFSファイルシステムのみが検証対象としてサポートされています。ドライラン操作により、実際にマウントターゲットを作成したり料金を発生させたりすることなく、パラメーターの有効性の確認やインベントリの検証を行うことができます。 true：マウントターゲットを作成せずにドライランリクエストを送信します。チェック内容には、必須パラメーターの指定有無、リクエスト形式、ビジネス制限、CPFSインベントリが含まれます。チェックが失敗した場合、対応するエラーが返されます。チェックが成功した場合、`200 HttpCode`が返されますが、`MountTargetDomain`は空です。 false（デフォルト）：通常のリクエストを送信します。チェックが成功すると、マウントターゲットが直接作成されます。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエストID。	70EACC9C-D07A-4A34-ADA4-77506C42****
MountTargetDomain	string	IPv4マウントターゲット。	174494b666-x****.cn-hangzhou.nas.aliyuncs.com
MountTargetExtra	object	マウントターゲット情報のコレクション。
DualStackMountTargetDomain	string	IPv4およびIPv6デュアルスタックマウントターゲット。	174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

例

成功レスポンス

JSONJSON

{
  "RequestId": "70EACC9C-D07A-4A34-ADA4-77506C42****",
  "MountTargetDomain": "174494b666-x****.cn-hangzhou.nas.aliyuncs.com",
  "MountTargetExtra": {
    "DualStackMountTargetDomain": "174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
202	RequestAccepted	The request has been accepted by the server.
400	InvalidFileSystem.NotsupportedIPv6	The file system does not support IPv6.
400	InvalidVSwitch.Ipv6NotTurnOn	The VSwitch you are currently using has not enabled the IPv6 function. Please enable this function first and try again.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.
400	MissingParameter.AccessGroupName	You must specify AccessGroupName when you create a standard or extreme file system mount target.
400	InvalidVSwitchId.IpNotEnough	The number of the specified VSwitch IP address is insufficient.
400	InvalidParameter.ConflictVpcCidr	The specified VPC CIDR conflicts with the server.
400	DryRunOperation	The request is validated with DryRun flag set.
400	SubAccount.NoStandardSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.
403	InvalidRamRole.NotExist	The specified RAM role does not exist.
403	InvalidRamRole.NoPermission	The specified RAM role does not have sufficient permission.
403	InvalidMountTarget.AlreadyExisted	The specified mount target already exists.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.
403	OperationDenied.MountTargetExceedLimit	The maximum number of mount target in the specified file system is exceeded.
404	InvalidParameter.VswNotFound	The specified VSwitch does not exist.
404	InvalidParameter.VpcNotFound	The specified VPC does not exist.
404	InvalidFileSystem.NotFound	The specified file system does not exist.

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

変更履歴

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