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

File Storage NAS:CreateFileSystem

最終更新日:Oct 21, 2026

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

操作説明

  • この操作の呼び出し前に、File Storage NAS プロダクトの課金ルールと料金のフォーマットを完全に理解していることを確認してください。詳細については、「課金概要のビュー」および「料金メニュー」を参照してください。

  • ファイルシステムを作成するには、実名認証に合格する必要があります。詳細なフォーマットについては、「アカウントの実名認証」を参照してください。

  • この操作の呼び出し時、操作に必須の NAS のサービスリンクロールが自動的に作成されます。詳細なフォーマットについては、「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

*ファイルシステム。

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

  • nas:EncryptedType
  • nas:FileSystemType
なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileSystemType

string

任意

ファイルシステムのタイプ。API 呼び出し時の有効な値:

  • standard: 汎用 NAS ファイルシステム。これがデフォルト値です。

  • extreme: エクストリーム NAS ファイルシステム。

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

  • cpfsse: CPFS SE (ゾーン冗長ストレージ)。

列挙値:

  • standard :

    汎用 NAS。

  • cpfs :

    Cloud Parallel File Storage (ローカル冗長ストレージ) の呼び出し

  • cpfsse :

    Cloud Parallel File Storage 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。

有効な値については、購入ページの実際の仕様のビューを参照してください。

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

150

StorageType

string

必須

ストレージタイプ。

  • FileSystemType が standard に設定されている場合、有効な値は Performance、Capacity、Premium、および Agentic です。

  • 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 ベースライン) です。

列挙値:

  • Agentic :

    Agentic。

  • Capacity :

    Capacity。

  • Premium :

    Premium。

  • Performance :

    Performance。

  • economic :

    Economy。

  • advance :

    Advanced。

Performance

ZoneId

string

任意

ゾーンの ID。

ゾーンは、同じリージョン内で独立した仕事率網とネットワークを持つ物理的なエリアです。

FileSystemType が standard にセットされている場合、このパラメーターはオプションです。デフォルトでは、ProtocolType と StorageType の設定に基づいて、要件を満たす適格なゾーンがランダムに選択されます。

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

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

  • クロスゾーン遅延を回避するため、ファイルシステムと ECS インスタンスを同じゾーンにデプロイすることを推奨します。

cn-hangzhou-b

ProtocolType

string

必須

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

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

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

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

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

列挙値:

  • dual :

    NFS および SMB デュアルプロトコル。

  • SMB :

    SMB プロトコル。

  • NFS :

    NFS プロトコル。

NFS

EncryptType

integer

任意

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

KMS は、キーの管理とファイルシステム内の保存データの暗号化に使用されます。暗号化されたデータの読み書き時に、復号は必須ではありません。

有効な値:

  • 0: 暗号化する対象なし。これがデフォルト値です。

  • 1: NAS マネージドキーで暗号化する。この値は、FileSystemType が standard または extreme にセットされている場合にサポートされます。

  • 2: カスタムキーで暗号化する。この値は、FileSystemType が standard または extreme にセットされている場合にサポートされます。

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

  • 汎用 NAS ファイルシステム: カスタムキー (KMS) 特徴は、すべてのリージョンでサポートされています。

列挙値:

  • 0 :

    暗号化する対象なし。

  • 1 :

    NAS マネージドキーで暗号化する。

  • 2 :

    カスタムキーで暗号化する。

1

SnapshotId

string

任意

スナップショットの ID。

このパラメーターは、premium ストレージタイプのエクストリーム 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:// で始めることはできません。

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

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: インスタンスを作成せずにチェックリクエストを送信します。システムは、必須パラメーターが指定されているか、リクエストフォーマットが有効か、サービス制限を満たしているか、および File Storage NAS リソースが十分かどうかをチェックします。リクエストがチェックに失敗した場合、エラーメッセージが返されます。リクエストがチェックに合格した場合、HTTP 状態コード 200 が返され、FileSystemId パラメーターは空になります。

  • false: 通常のリクエストを送信し、リクエストがチェックに合格した場合にインスタンスを作成します。これがデフォルト値です。

true

ResourceGroupId

string

任意

リソースグループの ID。

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

rg-acfmwavnfdf****

Tag

array<object>

任意

タグ。

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

object

任意

タグオブジェクト。

Key

string

任意

タグキー。

使用制限:

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

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

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

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

nastest

Value

string

任意

タグ値。

使用制限:

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

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

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

testValue

RedundancyType

string

任意

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

列挙値:

  • ZRS :

    ゾーン冗長ストレージ。

  • LRS :

    ローカル冗長ストレージ (呼び出し)。

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

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

変更履歴

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