CreateFileset - Cloud Parallel File Storage - Alibaba Cloud ドキュメントセンター

ファイルセットを作成します。

操作説明

CPFS の使用上の注意
- Fileset の作成は、CPFS 2.2.0 以降のバージョンでのみサポートされています。バージョン情報は、コンソールのファイルシステムの詳細ページで確認できます。
- 1 つの CPFS ファイルシステムで作成できる Fileset は最大 10 個です。
- 親ディレクトリは、既存のディレクトリである必要があります。
- Fileset パスがサポートする最大深度は 8 階層です。ルートディレクトリ / は 0 階層目とします。たとえば、Fileset パスが /test/aaa/ccc/ の場合、パスの深度は 3 階層です。
- Fileset 内に Fileset をネストすることはサポートされていません。つまり、親ディレクトリが Fileset として指定されている場合、そのサブディレクトリを Fileset として指定することはできません。
- Fileset は最大 100 万個のファイルをサポートします。ファイル数がこの上限を超えると、新しいファイルの追加時に no space というエラーメッセージが返されます。
CPFS for Lingjun の使用上の注意
- Fileset の作成は、CPFS for Lingjun 2.7.0 以降のバージョンでのみサポートされています。バージョン情報は、コンソールのファイルシステムの詳細ページで確認できます。
- 1 つの CPFS ファイルシステムで作成できる Fileset は最大 500 個です。
- Fileset パスは新しいパスである必要があり、既存のパスは使用できません。Fileset パスは名前の変更をサポートしておらず、パスをシンボリックリンクにすることもできません。
- Fileset パスがサポートする最大深度は 8 階層です。ルートディレクトリ / は 0 階層目とします。たとえば、Fileset パスが /test/aaa/ccc/ の場合、パスの深度は 3 階層です。
- Fileset パスが複数階層のディレクトリである場合、親ディレクトリは既存のディレクトリである必要があります。
- Fileset 内に Fileset をネストすることはサポートされていません。つまり、親ディレクトリが Fileset として指定されている場合、そのサブディレクトリを Fileset として指定することはできません。1 つの Fileset パスは 1 つのクォータのみをサポートします。
- Fileset の容量クォータは、最小 10 GiB からで、1 GiB 単位で拡張できます。
- Fileset は最大 100 億個のファイルまたはディレクトリをサポートし、最小 10,000 からで、1 単位で拡張できます。
- ディレクトリのクォータを変更する場合、設定するクォータ容量またはファイル数は、既に使用されている容量またはファイル数より大きい必要があります。
- クォータの統計には 15 分の遅延があり、現在の実際の使用量は 15 分後に有効になります。

今すぐお試しください

この 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:CreateFileset

create

*Fileset

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
FileSystemId	string	必須	ファイルシステムの ID です。 CPFS ファイルシステムの ID は `cpfs-` で始まる必要があります。例：cpfs-099394bd928c**。 CPFS for Lingjun ファイルシステムの ID は `bmcpfs-` で始まる必要があります。例：bmcpfs-290w65p03ok64ya**。	bmcpfs-290w65p03ok64y*****
FileSystemPath	string	必須	ファイルセットの絶対パスです。 CPFS のパス制限。指定するパスの親ディレクトリは、ファイルシステム内に存在するディレクトリである必要があります。パスの長さは 2～1024 文字である必要があります。パスはスラッシュ (/) で始まり、スラッシュ (/) で終わる必要があります。 CPFS for Lingjun のパス制限パスの長さは 2～1024 文字である必要があります。パスはスラッシュ (/) で始まり、スラッシュ (/) で終わる必要があります。ファイルセットパスは新しいパスである必要があり、既存のパスは使用できません。ファイルセットパスは名前の変更をサポートしておらず、シンボリックリンクにすることもできません。ファイルセットパスがサポートする最大深度は 8 階層です。ルートディレクトリ / の深度は 0 階層です。たとえば、ファイルセットパス /test/aaa/ccc/ の深度は 3 階層です。ファイルセットパスが複数階層のパスである場合、親ディレクトリは既存のディレクトリである必要があります。ネストされたファイルセットはサポートされていません。ファイルセットが親ディレクトリとして指定されている場合、そのサブディレクトリをファイルセットにすることはできません。1 つのファイルセットパスは 1 つのクォータのみをサポートします。パスの長さは 990 文字を超えることはできません。	/test/
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。ドライラン中、システムはリクエストパラメーターが有効か、リクエストされたリソースが利用可能かを確認します。ドライラン中は、ファイルセットは作成されず、料金も発生しません。有効な値： true：ドライランを実行します。システムは必須パラメーター、リクエスト構文、サービス制限、および利用可能な Apsara File Storage NAS (NAS) リソースをチェックします。チェックに失敗した場合、エラーメッセージが返されます。リクエストがドライランに成功した場合、HTTP ステータスコード 200 が返されます。FsetId パラメーターの値は返されません。 false (デフォルト)：ドライランを実行し、リクエストを送信します。リクエストがドライランに成功した場合、ファイルセットが作成されます。	false
DeletionProtection	boolean	任意	コンソールを使用するか、DeleteFileset 操作を呼び出してファイルセットをリリースできるように、削除保護を有効にするかどうかを指定します。 true：リリース保護を有効にします。 false (デフォルト)：リリース保護を無効にします。説明このパラメーターは、手動解放からのみファイルセットを保護でき、自動リリースからは保護できません。	false
Description	string	任意	ファイルセットの説明です。説明は 2～128 文字である必要があります。名前は文字で始まる必要があり、http:// または https:// で始めることはできません。説明には、文字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。	内部事务目录
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。説明このパラメーターを指定しない場合、システムは自動的にリクエスト ID をクライアントトークンとして使用します。リクエスト ID はリクエストごとに異なる場合があります。	123e4567-e89b-12d3-a456-4266554*****
Quota	object	任意	クォータ情報です。説明 CPFS for Lingjun V2.7.0 以降のみがこのパラメーターをサポートします。
FileCountLimit	integer	任意	ファイル数のクォータです。有効な値：最小値：100000。最大値：10000000000。	10000
SizeLimit	integer	任意	合計クォータ容量の上限です。単位：バイト。有効な値：最小値：10,737,418,240 (10 GiB)。拡張単位：1073741824 (1 GiB)。	10737418240

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	98696EF0-1607-4E9D-B01D-F20930B6****
FsetId	string	ファイルセット ID。	fset-1902718ea0ae****

例

成功レスポンス

JSONJSON

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "FsetId": "fset-1902718ea0ae****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	IllegalCharacters	The parameter contains illegal characters.
400	MissingFileSystemId	FileSystemId is mandatory for this action.
400	MissingFileSystemPath	FileSystemPath is mandatory for this action.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.
400	InvalidRequest	The request is invalid.
400	Quota.Invalid.Limit	Quota limit is invalid.
400	Resource.Exceed.Limit	Resource exceed limit.
400	Resource.Check.Fail	Resource check failed.
400	Fileset.Path.Duplicate	Fileset path is duplicate.
400	Fileset.Path.Nested	Fileset path is nested.
400	Fileset.Path.NotExist	Fileset.Path.Not.Exist.
400	Fileset.Path.Exist	Fileset already exist.
403	OperationDenied.AlreadyExists	The operation is denied due to IdirName already exists in parent path.
403	OperationDenied.TooManyFilesets	The operation is denied due to too many fileset in filesystem.
403	OperationDenied.TooManyDepths	The operation is denied due to Fileset path too deep.
403	OperationDenied.NestedDir	The operation is denied due to nested directory.
403	OperationDenied.DependencyViolation	The operation is denied due to dependancy violation.
403	OperationDenied.FilesetNotSupported	The operation is not supported.
404	InvalidFileSystem.NotFound	The specified file system does not exist.
404	InvalidFileSystemPath.ParentNotFound	The specified parent path does not exist.
404	InvalidFileSystemPath.NotDirectory	The specified idir parent path is not directory.
404	InvalidFileSystemPath.InvalidCharacters	The specified fileset path contains invalid characters.
404	InvalidFilesetPath.InvalidParameter	Fileset path is invalid.

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

変更履歴

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