ファイルシステムを作成します。
操作説明
-
この操作を使用する前に、File Storage NAS プロダクトの課金について理解してください。詳細については、課金および料金を参照してください。
-
ファイルシステムインスタンスを作成するには、まず実名認証を完了してください。詳細については、実名認証を参照してください。
-
この操作を呼び出すと、操作に必須のサービスリンクロールが自動的に作成されます。詳細については、NAS のサービスリンクロールの管理を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
nas:CreateFileSystem |
create |
*FileSystem
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemType |
string |
任意 |
ファイルシステムのタイプ。 有効な値:
列挙値:
|
standard |
| ChargeType |
string |
任意 |
課金方法。 有効な値:
列挙値:
|
PayAsYouGo |
| Duration |
integer |
任意 |
サブスクリプション期間。 単位: 月。このパラメーターは、ChargeType が Subscription に設定されている場合にのみ必須で有効になります。 サブスクリプションインスタンスがインスタンスの有効期限切れ時に更新されない場合、インスタンスは期限切れとなり自動的にリリースされます。 |
1 |
| Capacity |
integer |
任意 |
ファイルシステムの容量。単位: GiB。 このパラメーターは、FileSystemType が extreme、cpfs、または cpfsse に設定されている場合にのみ必須で有効になります。 使用可能な値については、購入ページのスペックをビューしてください: |
100 |
| Bandwidth |
integer |
任意 |
ファイルシステムの最大スループット。 単位: MB/s。 使用可能な値については、購入ページのスペックをビューしてください。 |
150 |
| StorageType |
string |
必須 |
ストレージタイプ。
列挙値:
|
Performance |
| ZoneId |
string |
任意 |
ゾーン ID。 ゾーンは、独自の電源供給とネットワークを持つリージョン内の独立した物理エリアです。 FileSystemType が standard に設定されている場合、このパラメーターは任意です。デフォルトでは、指定された ProtocolType と StorageType に一致するアクティブなゾーンがランダムに選択されます。 FileSystemType が extreme または cpfs に設定されている場合、このパラメーターは必須です。 説明
|
cn-hangzhou-b |
| ProtocolType |
string |
必須 |
ファイル転送プロトコルのタイプ。
列挙値:
|
NFS |
| EncryptType |
integer |
任意 |
ファイルシステムを暗号化するかどうかを指定します。 Key Management サービス (KMS) で管理されるキーを使用して、ファイルシステムに保存されたデータを暗号化します。暗号化されたデータは、読み取りまたは書き込み時に復号する必要はありません。 有効な値:
説明
列挙値:
|
1 |
| SnapshotId |
string |
任意 |
スナップショット ID。 このパラメーターは、アドバンスドストレージタイプのエクストリーム NAS ファイルシステムでのみサポートされています。 説明
スナップショットから作成されたファイルシステムは、スナップショットのソースファイルシステムと同じバージョンを持ちます。たとえば、ソースファイルシステムのバージョンが 1 で、バージョン 2 のファイルシステムを作成する場合、まずスナップショットからファイルシステム A を作成し、次にバージョン 2 のスペックを満たすファイルシステム B を作成し、ファイルシステム A からファイルシステム B にデータをコピーし、ワークロードをファイルシステム B に移行してください。 |
s-extreme-snapsho**** |
| VpcId |
string |
任意 |
VPC ID。
|
vpc-bp18cx9a7zoh0h9b4**** |
| VSwitchId |
string |
任意 |
vSwitch ID。
|
vsw-bp131dkqilvw5pnlt**** |
| Description |
string |
任意 |
ファイルシステムの説明。 使用制限:
|
此文件系统的描述。 |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証します。クライアントから一意の値を生成して、異なるリクエスト間で値が一意であることを確認してください。ClientToken は ASCII 文字のみをサポートし、64 文字を超えることはできません。詳細については、べき等性の確保方法を参照してください。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なる場合があります。 |
123e4567-e89b-12d3-a456-42665544**** |
| KmsKeyId |
string |
任意 |
KMS キー ID。 このパラメーターは、EncryptType が 2 に設定されている場合にのみ必須です。 |
fcbd****-62**-4a**-b605-c58cc1d5**** |
| DryRun |
boolean |
任意 |
このリクエストに対してドライランを実行するかどうかを指定します。 ドライランは、実際にインスタンスを作成したり料金を発生させたりすることなく、パラメーターの有効性とリソースの可用性を確認します。 有効な値:
|
true |
| ResourceGroupId |
string |
任意 |
リソースグループ ID。 リソースグループ ID はリソース管理コンソールで確認できます。 |
rg-acfmwavnfdf**** |
| Tag |
array<object> |
任意 |
タグ。 配列の長さ: 1~20。配列に複数のタグオブジェクトが含まれる場合、タグキー (Key) は一意である必要があります。 |
|
|
object |
任意 |
タグオブジェクト。 |
||
| Key |
string |
任意 |
タグキー。 使用制限:
|
nastest |
| Value |
string |
任意 |
タグ値。 使用制限:
|
testValue |
| RedundancyType |
string |
任意 |
ストレージの冗長性タイプ。このパラメーターは CPFS SE に対してのみ有効になります。 有効な値: ZRS。 列挙値:
|
ZRS |
| RedundancyVSwitchIds |
array |
任意 |
ゾーン冗長 vSwitch ID のリスト。 RedundancyType が ZRS に設定されている場合、このパラメーターは必須です。それぞれ異なるゾーンの 3 つの 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 エラーコードを返します。
NAS はリプレイ攻撃を防止するために SignatureNonce を使用し、各リクエストの時刻を記録するために Timestamp を使用するため、再試行時には SignatureNonce、Timestamp、Signature パラメーターを変更する必要があります。そのため、再試行では異なる 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. | |
| 400 | InvalidParameter.KmsServiceNotEnabled | Key Management Service is not enabled. | |
| 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. | |
| 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. | |
| 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. | |
| 400 | InvalidParam.NotSupportBYOK | The specified file system type does not support the BYOK encryption function. | |
| 400 | MissingParameter.KmsKeyId | When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request. | |
| 400 | InvalidParameter.InvalidKmsKeyId | The specified KMS key ID is invalid. | |
| 400 | InvalidParameter.KmsKeyIdNotFound | The specified KMS key ID does not exist. | |
| 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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。