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

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

操作説明

CreateMountTarget 操作を呼び出してマウントターゲットを作成する場合、一部のリソースは非同期で生成されます。CreateMountTarget 操作が成功した後、まずDescribeMountTargets 操作を呼び出してマウントターゲットのステータスを照会します。マウントターゲットのステータスがActiveに変わった後にのみ、ファイルシステムのマウント操作を実行してください。それ以外の場合、マウント操作が失敗する可能性があります。
この操作を呼び出すと、操作に必要なサービスリンクロールが自動的に作成されます。詳細については、「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：IDは`extreme-`で始まる必要があります（例：extreme-0015）。 Cloud Parallel File Storage（CPFS）：IDは`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マウントターゲットを作成しません。説明 IPv6は、中国本土のすべてのリージョンにおいて、極速型 NASファイルシステムでのみサポートされています。ファイルシステムで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.

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

変更履歴

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