すべてのプロダクト
Search

このプロダクト

    File Storage NAS:CreateLifecyclePolicy

    ドキュメントセンター

    File Storage NAS:CreateLifecyclePolicy

    最終更新日:Jul 31, 2026

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

    操作説明

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

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

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

    今すぐお試しください

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

    create

    *LifecyclePolicy

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    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
    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. 指定されたパスが存在しません。

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

    変更履歴

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