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

File Storage NAS:CreateLifecyclePolicy

最終更新日:Sep 03, 2026

ライフサイクル管理ポリシーを作成します。

操作説明

  • 汎用 NAS ファイルシステムおよび Lingjun 向け CPFS のみがライフサイクル管理ポリシーの作成をサポートしています。

  • 各 Lingjun 向け CPFS ファイルシステムでは、最大 10 個の Auto タイプおよび 100 個の OnDemand タイプのライフサイクル管理ポリシーがサポートされています。

  • 汎用 NAS のライフサイクル管理ポリシーは、各リージョンで最大 20 個まで作成できます。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileSystemId

string

必須

ファイルシステムの ID。

31a8e4****

LifecyclePolicyName

string

任意

ライフサイクル管理ポリシーの名前。名前は 3~64 文字で、大文字または小文字で始まり、英字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。

説明

汎用 NAS では必須です。Lingjun 向け CPFS では不要です。

lifecyclepolicy_01

Path

string

任意

ライフサイクル管理ポリシーに関連付けられたディレクトリの絶対パス。汎用 NAS のみがサポートされています。

  • 汎用 NAS では、単一のディレクトリのみを関連付けることができます。パスはスラッシュ (/) で始まる必要があり、マウントポイントに存在するパスである必要があります。

説明

汎用 NAS のみがサポートされています。汎用 NAS で複数のディレクトリを同時に関連付ける場合は、代わりに Paths.N を使用してください。

  • Path と Paths のいずれか一方のみを指定できます。

/pathway/to/folder

LifecycleRuleName

string

任意

ライフサイクル管理ポリシーに関連付けられた管理ルール。汎用 NAS のみがサポートされています。

有効な値:

  • DEFAULT_ATIME_14: 14 日間アクセスされていないファイル。

  • DEFAULT_ATIME_30: 30 日間アクセスされていないファイル。

  • DEFAULT_ATIME_60: 60 日間アクセスされていないファイル。

  • DEFAULT_ATIME_90: 90 日間アクセスされていないファイル。

  • DEFAULT_ATIME_180: 180 日間アクセスされていないファイル。DEFAULT_ATIME_180 は、StorageType が Archive に設定されている場合にのみサポートされます。

説明
  • ディレクトリに IA ストレージクラスポリシーがすでに設定されている場合、アーカイブポリシーの持続時間は IA ストレージクラスポリシーの持続時間より長くする必要があります。

  • このパラメーターは汎用 NAS のみがサポートしています。

列挙値:

  • DEFAULT_ATIME_14 :

    14 日間アクセスされていないファイル。

  • DEFAULT_ATIME_90 :

    90 日間アクセスされていないファイル。

  • DEFAULT_ATIME_60 :

    60 日間アクセスされていないファイル。

  • DEFAULT_ATIME_180 :

    180 日間アクセスされていないファイル。

  • DEFAULT_ATIME_30 :

    30 日間アクセスされていないファイル。

DEFAULT_ATIME_14

StorageType

string

必須

ストレージ階層化タイプ。

  • InfrequentAccess: IA ストレージクラス。

  • Archive: アーカイブストレージクラス。

説明

汎用 NAS は InfrequentAccess および Archive をサポートしています。Lingjun 向け CPFS は InfrequentAccess のみをサポートしています。

列挙値:

  • Archive :

    アーカイブストレージクラス。

  • InfrequentAccess :

    IA ストレージクラス。

InfrequentAccess

Paths

array

任意

ライフサイクル管理ポリシーに関連付けられたディレクトリの絶対パス。

"/path1", "/path2"

string

任意

ライフサイクル管理ポリシーに関連付けられたディレクトリの絶対パス。

複数のディレクトリを関連付けることができます。各パスは転送スラッシュ (/) で始まる必要があり、マウントポイントに存在するパスである必要があります。N の有効な値: 1~10。

説明
  • Lingjun 向け CPFS では必須です。

“/path1"

Description

string

任意

ライフサイクルポリシーの説明。

フォーマット: 説明は 3~64 文字で、英字で始まり、英字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。

説明

Lingjun 向け CPFS のみがサポートされています。

Description

LifecyclePolicyType

string

任意

ポリシータイプ。

  • Auto (デフォルト): 自動実行。

  • OnDemand: オンデマンド実行。

列挙値:

  • Auto :

    自動実行。

  • OnDemand :

    オンデマンド実行。

Auto

TransitRules

array<object>

任意

ファイルデータの転送ルール。最大 1 つのルールを設定できます。

説明

Lingjun 向け CPFS ファイルシステムで LifecyclePolicyType が Auto に設定されている場合にのみサポートされます。

object

任意

ファイルデータの転送ルール。最大 1 つのルールを設定できます。

説明

Lingjun 向け CPFS ファイルシステムで LifecyclePolicyType が Auto に設定されている場合にのみサポートされます。

Attribute

string

任意

ルールの属性。

有効な値:

  • Atime: ファイルの最終アクセス時間。

列挙値:

  • Atime :

    ファイルの最終アクセス時間。

Atime

Threshold

string

任意

ルールのしきい値。

有効な値:

  • Attribute が Atime にセットされている場合、この値はファイルが最後にアクセスされてからの時間を日数で指定します。有効な値: 0~365。

3

RetrieveRules

array<object>

任意

ファイルデータのデータ取得ルール。最大 1 つのルールをセットできます。

説明

Lingjun 向け CPFS ファイルシステムのみがサポートされています。

説明

LifecyclePolicyType が OnDemand に設定されている場合、TransitRules または RetrieveRules の少なくとも一方を指定する必要があります。

object

任意

ファイルデータのデータ取得ルール。最大 1 つのルールをセットできます。

Attribute

string

任意

ルールの属性。有効な値:

  • RetrieveType: 取得メソッド。

列挙値:

  • RetrieveType :

    取得メソッド。

RetrieveType

Threshold

string

任意

ルールのしきい値。有効な値:

  • RetrieveType
    • AfterVisit: LifecyclePolicyType が Auto に設定されている場合にサポートされます。アクセス時のベストエフォート再現率を示します。

    • All: LifecyclePolicyType が OnDemand に設定されている場合にサポートされます。すべてのデータを取得することを示します。

列挙値:

  • All :

    すべてのデータを取得します。

  • AfterVisit :

    アクセス時のベストエフォート再現率。

All

DeleteRules

array<object>

任意

ファイルデータの有効期限および削除ルール。最大 1 つのルールを設定できます。

object

任意

ファイルデータの有効期限および削除ルール。最大 1 つのルールを設定できます。

Attribute

string

任意

ルールの属性。

有効な値:

  • Atime: ファイルの最終アクセス時間。

列挙値:

  • Atime :

    ファイルの最終アクセス時間。

Atime

Threshold

string

任意

ルールのしきい値。

有効な値:

  • Attribute が Atime にセットされている場合、この値はファイルが最後にアクセスされてからの時間を日数で指定します。有効な値: 1~365。

1

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID。

BC7C825C-5F65-4B56-BEF6-98C56C7C****

Success

boolean

リクエスト状態。

有効な値:

  • true: リクエストが成功しました。

  • false: リクエストが失敗した。

true

LifecyclePolicyId

string

ライフサイクルポリシーの ID。

lsp-bp1234567890ab****

例

成功レスポンス

JSONJSON

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "Success": true,
  "LifecyclePolicyId": "lsp-bp1234567890ab****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationDenied.FileSystemNotSupportedForLifecycle The file system does not support lifecycle. 指定されたファイルシステムはライフサイクル管理をサポートしていません。
400 OperationDenied.EncryptedFileSystemNotSupportedForLifecycle The encrypted file system does not support lifecycle. 暗号化されたファイルシステムはライフサイクル管理をサポートしていません。
400 OperationDenied.LifecyclePolicyCountLimitExceeded The maximum number of LifecyclePolicies is exceeded. ライフサイクルポリシーの数が上限に達しました。
400 InvalidLifecyclePolicy.AlreadyExist The specified LifecyclePolicy already exists. 指定されたライフサイクルポリシーはすでに存在します。
400 InvalidParameter.PathsNumberExceed The maximum number of Path.N for this operation is 10. 各ポリシーに関連付けられるパスの最大値は 10 です。
400 InvalidFilesystemType.NotSupport The API operation does not support the file system type. 現在の操作はこのファイルシステムタイプをサポートしていません。
400 InvalidParameter.PathOrPaths Either Path or Paths.N must be specified. Path または Paths.N パラメーターのいずれかを指定する必要がありますが、両方を指定することはできません。
400 MissingFileSystemId FileSystemId is mandatory for this action. FileSystemId パラメーターが指定されていません。
400 Lifecycle.Count.Exceeded The lifecycle policy count exceeds the max limit per type per filesystem. ライフサイクルポリシーの数が上限を超えています。
403 OperationDenied.NotSupportPaths.N Your request does not meet the gray condition. The Paths.N parameter is not supported. 現在のリクエストはカナリアリリースポリシーの検証を通過しませんでした。Paths.N パラメーターはサポートされていません。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定されたファイルシステムが存在しません。
404 InvalidParameter.PathNotExist The specified path does not exist. 指定されたパスが存在しません。

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

変更履歴

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