ファイルシステムを作成します。
操作説明
-
この操作を呼び出す前に、File Storage NAS の課金方法と料金を十分にご確認ください。詳細については、「課金」および「料金」をご参照ください。
-
ファイルシステムインスタンスを作成するには、実名認証を完了する必要があります。詳細については、「実名認証」をご参照ください。
-
この操作を呼び出すと、操作に必須の NAS サービスリンクロールが自動的に作成されます。詳細については、「NAS のサービスリンクロールの管理」をご参照ください。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| 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 Service (KMS) によって管理されるキーを使用して、ファイルシステムに保存されたデータを暗号化します。暗号化されたデータの読み取りまたは書き込み時に復号は不要です。 有効な値:
説明
列挙値:
|
1 |
| SnapshotId |
string |
任意 |
スナップショットの ID です。 このパラメーターは、advanced ストレージタイプのエクストリーム 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 つの異なるゾーンから 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 エラーコードを返します。
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. | 指定されたファイルシステムタイプは Custom Key (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. | 指定されたファイルシステムはすでに存在します。DescribeFileSystems を呼び出してファイルシステム ID を指定すると、関連情報をフォーマットで確認できます。 |
| 403 | Resource.OutOfStock | The inventory of the specified zone is insufficient. | 指定されたゾーンの在庫が不足しています。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。