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

ファイルシステムを作成します。

操作説明

この操作を呼び出す前に、File Storage 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:CreateFileSystem

create

*FileSystem

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

nas:EncryptedType
nas:FileSystemType

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
FileSystemType	string	任意	ファイルシステムのタイプです。列挙値: standard : 汎用 NAS。 cpfs : Cloud Paralleled File System (ローカル冗長) cpfsse : Cloud Paralleled File System SE (ゾーン冗長) extreme : エクストリーム NAS。	standard
ChargeType	string	任意	課金方法です。列挙値: PayAsYouGo : 従量課金。 Subscription : サブスクリプション。	PayAsYouGo
Duration	integer	任意	持続時間です。	1
Capacity	integer	任意	ファイルシステムの容量です。単位: GiB。	100
Bandwidth	integer	任意	ファイルシステムの最大スループットです。	150
StorageType	string	必須	ストレージタイプです。列挙値: standard : 標準エクストリーム NAS。 Capacity : 容量型 NAS。 advance_200 : Cloud Paralleled File System 200 MB/s/TiB ベースライン。 advance_100 : Cloud Paralleled File System 100 MB/s/TiB ベースライン。 Premium : プレミアム NAS。 Performance : パフォーマンス NAS。 economic : Cloud Paralleled File System エコノミー。 advance : アドバンストエクストリーム NAS。 Agentic : AgenticFS。	Performance
ZoneId	string	任意	ゾーンの ID です。	cn-hangzhou-b
ProtocolType	string	必須	ファイル転送プロトコルの種類です。列挙値: cpfs : cpfs プロトコル。 SMB : SMB プロトコル。 NFS : NFS プロトコル。	NFS
EncryptType	integer	任意	ファイルシステムを暗号化するかどうかを指定します。列挙値: 0 : 暗号化なし。 1 : NAS マネージドキー。 2 : カスタムキー暗号化。	1
SnapshotId	string	任意	スナップショットの ID です。	s-extreme-snapsho****
VpcId	string	任意	VPC の ID です。	vpc-bp18cx9a7zoh0h9b4****
VSwitchId	string	任意	vSwitch の ID です。	vsw-bp131dkqilvw5pnlt****
Description	string	任意	ファイルシステムの説明です。	このファイルシステムの説明
ClientToken	string	任意	リクエストのべき等性を確保します。クライアントで値を生成できますが、異なるリクエスト間で値が一意であることを確認する必要があります。ClientToken の値には ASCII 文字のみを使用でき、長さは 64 文字以下である必要があります。詳細については、「べき等性を確保する方法」をご参照ください。	123e4567-e89b-12d3-a456-42665544****
KmsKeyId	string	任意	KMS キーの ID です。	fcbd**-62-4a-b605-c58cc1d5**
DryRun	boolean	任意	このリクエストに対してドライランを実行するかどうかを指定します。	true
ResourceGroupId	string	任意	リソースグループの ID です。	rg-acfmwavnfdf****
Tag	array<object>	任意	タグです。
	object	任意	タグオブジェクトです。
Key	string	任意	タグキーです。	nastest
Value	string	任意	タグ値です。	testValue
RedundancyType	string	任意	ストレージの冗長性タイプです。このパラメーターは CPFS SE に対してのみ効果があります。列挙値: ZRS : ゾーン冗長。	ZRS
RedundancyVSwitchIds	array	任意	ゾーン冗長 vSwitch ID のリストです。
	string	任意	ゾーン冗長 vSwitch ID のリストです。	vsw-123xxx

API のべき等性に関する注意事項:
CreateFileSystem 操作はクラウドリソースの作成と課金に関わるため、リクエストのタイムアウトや内部サーバーエラーが発生した場合、クライアントがリクエストを再試行する可能性があります。複数回の再試行による重複注文を防ぐため、ClientToken パラメーターを指定することを推奨します。

説明

現在、この操作は FileSystemType が extreme または cpfs に設定されている場合にのみべき等性をサポートしています。FileSystemType が standard の場合、この操作はべき等性をサポートしていません。

ClientToken パラメーターの詳細:

ClientToken は、クライアントによって生成される一意で大文字小文字を区別する文字列であり、64 文字以下の ASCII 文字で構成されます。例: ClientToken=123e4567-e89b-12d3-a456-42665544****
以前に使用された ClientToken を異なるリクエストパラメーターと共に指定した場合、NAS は IdempotentParameterMismatch エラーコードを返します。

説明

SignatureNonce、Timestamp、および Signature パラメーターは再試行時に変更する必要があります。これは、NAS がリプレイ攻撃を防ぐために SignatureNonce を使用し、各リクエストの時刻をマークするために Timestamp を使用するためです。したがって、新しいリクエストでは異なる SignatureNonce および Timestamp 値を提供する必要があり、これにより Signature 値も変更されます。

ClientToken パラメーターを追加した後:
- 応答が HTTP 200 の場合、再試行は前のリクエストと同じ結果を返し、サーバーの状態に影響を与えません。
- 応答が HTTP 4xx で、エラーメッセージに「後でもう一度お試しください」のようなメッセージが含まれていない場合、再試行は決して成功しません。エラーメッセージに基づいて問題をトラブルシューティングし、リクエストパラメーターを変更してから再試行してください。
- 応答が HTTP 5xx の場合、リクエストがタイムアウトしたか、内部サーバーエラーが発生した可能性があります。結果を確認するために、同じリクエスト (同じ ClientToken およびビジネスリクエストパラメーターを含む必要があります) を再送信できます。
ClientToken の有効期間は 30 日です。

レスポンスフィールド

フィールド	型	説明	例
	object	応答構造体です。
RequestId	string	リクエスト ID です。	98696EF0-1607-4E9D-B01D-F20930B6****
FileSystemId	string	作成されたファイルシステムの ID です。	1ca404****

例

成功レスポンス

JSONJSON

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "FileSystemId": "1ca404****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
202	RequestAccepted	The request has been accepted by the server.	リクエストはバックエンドによって受け入れられました。
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.	同じ ClientToken に対して異なるパラメーターが指定されました。
400	InvalidParameter.KmsServiceNotEnabled	Key Management Service is not enabled.	KMS サービスが有効化されていません。
400	DryRunOperation	The request is validated with DryRun flag set.	リクエストは検証済みです。
400	SubAccount.NoExtremeSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasExtreme. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.	現在の Resource Access Management (RAM) ユーザーには、AliyunServiceRoleForNasExtreme サービスリンクロールを作成する権限がありません。RAM ユーザーに ram:CreateServiceLinkedRole の権限付与を行ってください。
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.	現在の Resource Access Management (RAM) ユーザーには、AliyunServiceRoleForNasStandard サービスリンクロールを作成する権限がありません。RAM ユーザーに ram:CreateServiceLinkedRole の権限付与を行ってください。
400	SubAccount.NoEncryptionSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasEncryption. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.	現在の Resource Access Management (RAM) ユーザーには、AliyunServiceRoleForNasEncryption サービスリンクロールを作成する権限がありません。RAM ユーザーに ram:CreateServiceLinkedRole の権限付与を行ってください。
400	InvalidParam.NotSupportBYOK	The specified file system type does not support the BYOK encryption function.	指定されたファイルシステムタイプは、カスタムキー (KMS) で暗号化することをサポートしていません。
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.	暗号化するタイプがカスタムキー (KMS) の場合、KmsKeyId パラメーターは必須です。
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.	KMS KeyId が無効です。
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.	KMS KeyId が存在しません。
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	現在のファイルシステムステータスでは、この操作はサポートされていません。
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.	指定されたファイルシステムはすでに存在します。
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.	指定されたゾーンの在庫が不足しています。

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

変更履歴

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