ファイルシステムを作成します。
操作説明
-
この操作の呼び出し前に、File Storage NAS プロダクトの課金ルールと料金のフォーマットを完全に理解していることを確認してください。詳細については、「課金概要のビュー」および「料金メニュー」を参照してください。
-
ファイルシステムを作成するには、実名認証に合格する必要があります。詳細なフォーマットについては、「アカウントの実名認証」を参照してください。
-
この操作の呼び出し時、操作に必須の NAS のサービスリンクロールが自動的に作成されます。詳細なフォーマットについては、「NAS のサービスリンクロールの管理」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
nas:CreateFileSystem |
create |
*ファイルシステム。
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemType |
string |
任意 |
ファイルシステムのタイプ。API 呼び出し時の有効な値:
列挙値:
|
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 |
任意 |
ファイルシステムを暗号化するかどうかを指定します。 KMS は、キーの管理とファイルシステム内の保存データの暗号化に使用されます。暗号化されたデータの読み書き時に、復号は必須ではありません。 有効な値:
説明
列挙値:
|
1 |
| SnapshotId |
string |
任意 |
スナップショットの ID。 このパラメーターは、premium ストレージタイプのエクストリーム 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 |
任意 |
ファイルシステムの説明。 使用制限:
|
The description of this file system |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを呼び出して値を生成できますが、異なるリクエスト間で値が一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。フォーマットの詳細については、「べき等性を確保する方法」を参照してください。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なる場合があります。 |
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。配列に複数のタグオブジェクトが含まれている場合、タグキーは一意である必要があります。 |
|
|
object |
任意 |
タグオブジェクト。 |
||
| Key |
string |
任意 |
タグキー。 使用制限:
|
nastest |
| Value |
string |
任意 |
タグ値。 使用制限:
|
testValue |
| RedundancyType |
string |
任意 |
ストレージの冗長性タイプ。このパラメーターは CPFS SE に対してのみ効果が適用されます。 有効な値: ZRS。 列挙値:
|
ZRS |
| RedundancyVSwitchIds |
array |
任意 |
ゾーン冗長 vSwitch の ID。 このパラメーターは、RedundancyType が ZRS に設定されている場合に必須です。3 つの vSwitch ID を指定する必要があり、vSwitch は 3 つの異なるゾーンに存在する必要があります。 |
|
|
string |
任意 |
ゾーン冗長 vSwitch の ID。 |
vsw-123xxx |
|
| HpnZone |
string |
任意 |
クラスター ID (高性能ネットワークゾーン)。このパラメーターは、FileSystemType が bmcpfs にセットされている場合に必須であり、ファイルシステムの作成後に変更済みにはできません。DescribeSpecifications 操作を呼び出し、利用可能な値をクエリできます。 高性能ネットワークゾーン。例: B1。 |
B1 |
API のべき等性に関する以下の項目に注意してください:
CreateFileSystem 操作はクラウドリソースの作成を伴い、料金が発生するため、リクエストタイムアウトまたは内部サーバーエラーが発生した場合、クライアントはリクエストを再試行する場合があります。複数の再試行による重複注文を防ぐため、リクエストに ClientToken パラメーターを指定してください。
この操作は、FileSystemType パラメーターが extreme または cpfs にセットされている場合にのみべき等性をサポートします。FileSystemType パラメーターが standard にセットされている場合、この操作はべき等性をサポートしません。
ClientToken パラメーターの詳細は以下のとおりです:
ClientToken は、クライアントによって生成される、64 文字以下の ASCII 文字からなる一意で大文字と小文字が区別される文字列です。例:
ClientToken=123e4567-e89b-12d3-a456-42665544****すでに使用されている ClientToken を指定し、他のリクエストパラメーターが変更されている場合、File Storage NAS は IdempotentParameterMismatch エラーコードを返します。
再試行中は、SignatureNonce、Timestamp、および Signature パラメーターを変更する必要があります。これは、File Storage NAS がリプレイ攻撃を防ぐために SignatureNonce を使用し、各リクエストの時間をマークするために Timestamp を使用するためです。したがって、再試行されたリクエストでは異なる SignatureNonce および Timestamp 値を指定する必要があり、その結果 Signature 値も異なります。
-
ClientToken パラメーターを追加した場合:
HTTP 状態コード 200 が返された場合、再試行してもサーバーの状態に影響を与えず、クライアントに同じ結果が返されます。
4xx の HTTP 状態コードが返され、エラーメッセージに後で再試行するよう促す内容がない場合、再試行しても成功しません。エラーメッセージに基づいて問題のトラブルシューティングを行い、リクエストパラメーターを変更してからリクエストを再試行してください。
5xx の HTTP 状態コードが返された場合、ネットワークタイムアウトまたは内部サーバーエラーが発生した可能性があります。同じ ClientToken とビジネスリクエストパラメーターを含めた同一のリクエストを再送信し、結果を確認できます。
-
ClientToken の有効期間は 30 日です。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答構造。 |
||
| FileSystemId |
string |
作成されたファイルシステムの ID。 |
1ca404**** |
| RequestId |
string |
リクエスト ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
例
成功レスポンス
JSONJSON
{
"FileSystemId": "1ca404****",
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****"
}
エラーコード
|
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. | 現在のリソースアクセス管理 (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. | 現在のリソースアクセス管理 (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. | 現在のリソースアクセス管理 (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 キー ID が無効です。 |
| 400 | InvalidParameter.KmsKeyIdNotFound | The specified KMS key ID does not exist. | 指定された KMS キー ID が存在しません。 |
| 403 | OperationDenied.InvalidState | The operation is not permitted when the status is processing. | ステータスが Processing の場合、この操作は実行できません。 |
| 403 | InvalidFileSystem.AlreadyExisted | The specified file system already exists. | 指定されたファイルシステムは既に存在します。DescribeFileSystems 操作を呼び出し、ファイルシステム ID を指定して関連情報を表示できます。 |
| 403 | Resource.OutOfStock | The inventory of the specified zone is insufficient. | 指定されたゾーンの在庫が不足しています。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。