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

File Storage NAS: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 :

    容量 NAS。

  • advance_200 :

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

  • advance_100 :

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

  • Premium :

    プレミアム NAS。

  • Performance :

    パフォーマンス NAS。

  • economic :

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

  • advance :

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

Performance

ZoneId

string

任意

ゾーン ID。

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

FileSystemType が standard に設定されている場合、このパラメーターは任意です。デフォルトでは、指定された ProtocolType と StorageType に一致するアクティブなゾーンがランダムに選択されます。

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

説明
  • 同じリージョン内の異なるゾーンにあるファイルシステムと Elastic Compute サービス (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 エラーコードを返します。

説明

NAS はリプレイ攻撃を防止するために SignatureNonce を使用し、各リクエストの時刻を記録するために Timestamp を使用するため、再試行時には SignatureNonce、Timestamp、Signature パラメーターを変更する必要があります。そのため、再試行では異なる 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.

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

変更履歴

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