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

Cloud Parallel File Storage:CreateFileSystem

最終更新日:Jul 03, 2026

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

操作説明

  • この操作を使用する前に、File Storage 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

*FileSystem

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

  • nas:EncryptedType
  • nas:FileSystemType
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

FileSystemType

string

任意

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

有効な値:

  • standard (デフォルト): 汎用 NAS ファイルシステム。

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

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

  • cpfsse: Cloud Parallel File Storage (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。

  • 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。

  • Capacity :

    Capacity NAS。

  • advance_200 :

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

  • advance_100 :

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

  • Premium :

    Premium NAS。

  • Performance :

    Performance NAS。

  • economic :

    Cloud Paralleled File System (CPFS) エコノミー。

  • advance :

    アドバンスドエクストリーム NAS。

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。

列挙値:

  • cpfs :

    cpfs プロトコル。

  • SMB :

    SMB プロトコル。

  • NFS :

    NFS プロトコル。

NFS

EncryptType

integer

任意

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

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

有効な値:

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

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

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

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

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

列挙値:

  • 0 :

    暗号化しない。

  • 1 :

    NAS マネージドキー。

  • 2 :

    カスタムキー (KMS)

1

SnapshotId

string

任意

スナップショット ID。

このパラメーターは、アドバンスドストレージタイプのエクストリーム 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 つの 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.
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.

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

変更履歴

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