すべてのプロダクト
Search
ドキュメントセンター

File Storage NAS:CreateFileSystem

最終更新日:Sep 03, 2026

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

操作説明

  • この操作を呼び出す前に、File Storage NAS の課金方法と料金を十分にご確認ください。詳細については、「課金」および「料金」をご参照ください。

  • ファイルシステムインスタンスを作成するには、実名認証を完了する必要があります。詳細については、「実名認証」をご参照ください。

  • この操作を呼び出すと、操作に必須の NAS サービスリンクロールが自動的に作成されます。詳細については、「NAS のサービスリンクロールの管理」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileSystemType

string

任意

ファイルシステムのタイプです。

有効な値:

  • standard (デフォルト): 汎用 NAS。

  • extreme: エクストリーム NAS。

  • cpfs: Cloud Parallel File Storage (CPFS) (ローカル冗長)。

  • cpfsse: CPFS SE (ゾーン冗長)。

列挙値:

  • standard :

    汎用 NAS。

  • cpfs :

    Cloud Paralleled File System (CPFS) (ローカル冗長)

  • cpfsse :

    Cloud Paralleled File System (CPFS) SE (ゾーン冗長)

  • extreme :

    エクストリーム NAS。

standard

ChargeType

string

任意

課金方法です。

有効な値:

  • PayAsYouGo (デフォルト): 従量課金。

  • Subscription: サブスクリプション。

列挙値:

  • PayAsYouGo :

    従量課金。

  • Subscription :

    サブスクリプション。

PayAsYouGo

Duration

integer

任意

サブスクリプション期間です。

単位: 月。このパラメーターは必須であり、ChargeType が Subscription に設定されている場合にのみ有効です。

サブスクリプションインスタンスの有効期限切れ前に更新されない場合、インスタンスは有効期限切れ時に自動的にリリースされます。

1

Capacity

integer

任意

ファイルシステムの容量です。単位: GiB。 このパラメーターは必須であり、FileSystemType が extreme、cpfs、または cpfsse に設定されている場合にのみ有効です。

利用可能な値については、購入ページの実際の仕様をご参照ください。

100

Bandwidth

integer

任意

ファイルシステムの最大スループットです。

単位: MB/s。

利用可能な仕様値については、購入ページの実際の仕様をご参照ください。

並列ファイルシステム CPFS 従量課金購入ページ

150

StorageType

string

必須

ストレージタイプです。

  • FileSystemType が standard に設定されている場合、有効な値: Performance、Capacity、Premium、Agentic (AgenticFS)。

  • FileSystemType が extreme に設定されている場合、有効な値: standard および advance。

  • FileSystemType が cpfs に設定されている場合、有効な値: advance_100 (100 MB/s/TiB ベースライン)、advance_200 (200 MB/s/TiB ベースライン)、economic。

  • FileSystemType が cpfsse に設定されている場合、有効な値: advance_100 (100 MB/s/TiB ベースライン)。

列挙値:

  • standard :

    標準エクストリーム NAS。

  • Agentic :

    Agentic。

  • Capacity :

    Capacity。

  • advance_200 :

    Cloud Paralleled File System (CPFS) 200 MB/s/TiB ベースライン。

  • advance_100 :

    Cloud Paralleled File System (CPFS) 100 MB/s/TiB ベースライン。

  • Premium :

    Premium。

  • Performance :

    Performance。

  • economic :

    エクストリーム NAS economy。

  • advance :

    エクストリーム NAS advanced。

Performance

ZoneId

string

任意

ゾーンの ID です。

ゾーンとは、リージョン内で独立した電源供給とネットワークを持つ物理的なエリアです。

FileSystemType が standard に設定されている場合、このパラメーターは任意です。デフォルトでは、条件付きの ProtocolType および StorageType 構成を満たすアクティブなゾーンがランダムに選択されます。

FileSystemType が extreme または cpfs に設定されている場合、このパラメーターは必須です。

説明
  • 同じリージョン内の異なるゾーンにあるファイルシステムと Elastic Computing Service (ECS) インスタンスは相互に通信できます。

  • クロスゾーンレイテンシを回避するため、ファイルシステムと Elastic Computing Service (ECS) サーバーを同じゾーンに配置してください。

cn-hangzhou-b

ProtocolType

string

必須

ファイル転送プロトコルの種類です。

  • FileSystemType が standard に設定されている場合、有効な値: NFS および SMB。

  • FileSystemType が extreme に設定されている場合、有効な値: NFS。

  • FileSystemType が cpfs に設定されている場合、有効な値: cpfs。

  • FileSystemType が cpfsse に設定されている場合、有効な値: cpfs。

列挙値:

  • cpfs :

    cpfs プロトコル。

  • SMB :

    SMB プロトコル。

  • NFS :

    NFS プロトコル。

  • dual :

    NFS+SMB デュアルプロトコル。

NFS

EncryptType

integer

任意

ファイルシステムを暗号化するかどうかを指定します。

Key Management Service (KMS) によって管理されるキーを使用して、ファイルシステムに保存されたデータを暗号化します。暗号化されたデータの読み取りまたは書き込み時に復号は不要です。

有効な値:

  • 0 (デフォルト): 暗号化なし。

  • 1: NAS マネージドキー。FileSystemType が standard または extreme に設定されている場合にサポートされます。

  • 2: カスタムキー (KMS)。FileSystemType が standard または extreme に設定されている場合にサポートされます。

説明
  • エクストリーム NAS: カスタムキー (KMS) は、China (Hangzhou) 金融クラウドを除くすべてのリージョンでサポートされています。

  • 汎用 NAS: カスタムキー (KMS) はすべてのリージョンでサポートされています。

列挙値:

  • 0 :

    暗号化なし。

  • 1 :

    NAS マネージドキー暗号化。

  • 2 :

    KMS 暗号化。

1

SnapshotId

string

任意

スナップショットの ID です。

このパラメーターは、advanced ストレージタイプのエクストリーム NAS ファイルシステムでのみサポートされています。

説明

スナップショットから作成されたファイルシステムは、スナップショットのソースファイルシステムと同じバージョンになります。たとえば、ソースファイルシステムのバージョンが 1 で、バージョン 2 のファイルシステムを作成したい場合は、まずスナップショットからファイルシステム A を作成し、次にバージョン 2 の構成を満たすファイルシステム B を作成して、ファイルシステム A からファイルシステム B にデータをコピーし、コピー完了後にワークロードをファイルシステム B に移行してください。

s-extreme-snapsho****

VpcId

string

任意

VPC の ID です。

  • FileSystemType が cpfs または cpfsse に設定されている場合、このパラメーターは必須です。

  • FileSystemType が standard または extreme に設定されている場合、このパラメーターは予約されており、効果はありません。設定する必要はありません。

vpc-bp18cx9a7zoh0h9b4****

VSwitchId

string

任意

vSwitch の ID です。

  • FileSystemType が cpfs に設定されている場合、このパラメーターは必須です。

  • FileSystemType が cpfs に設定されていない場合、このパラメーターは予約されており、効果はありません。設定する必要はありません。

vsw-bp131dkqilvw5pnlt****

Description

string

任意

ファイルシステムの説明です。

使用制限:

  • 説明の長さは 2~128 文字である必要があります。

  • 説明は英字で始まる必要があり、http:// または https:// で始めることはできません。

  • 説明には数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

このファイルシステムの説明

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: インスタンスを作成せずにドライランリクエストを送信します。チェック項目には、必須パラメーター、リクエストフォーマット、ビジネス使用制限、NAS の在庫が含まれます。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、HTTP 状態コード 200 が返されますが、FileSystemId は空になります。

  • false (デフォルト): 通常のリクエストを送信します。チェックに成功した後、インスタンスが作成されます。

true

ResourceGroupId

string

任意

リソースグループの ID です。

リソースグループ ID は、リソース管理コンソール で確認できます。

rg-acfmwavnfdf****

Tag

array<object>

任意

タグです。

配列の長さ: 1~20。配列に複数のタグオブジェクトが含まれる場合、タグキー (Key) は一意である必要があります。

object

任意

タグオブジェクトです。

Key

string

任意

タグキーです。

使用制限:

  • タグキーを空または空文字列にすることはできません。

  • タグキーの長さは最大 128 文字です。

  • タグキーを aliyun または acs: で始めることはできません。

  • タグキーに http:// または https:// を含めることはできません。

nastest

Value

string

任意

タグ値です。

使用制限:

  • タグ値を空または空文字列にすることはできません。

  • タグ値の長さは最大 128 文字です。

  • タグ値に http:// または https:// を含めることはできません。

testValue

RedundancyType

string

任意

ストレージの冗長性タイプです。このパラメーターは CPFS SE に対してのみ有効です。 有効な値: ZRS。

列挙値:

  • 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. 指定されたゾーンの在庫が不足しています。

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

変更履歴

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