All Products
Search
Document Center

File Storage NAS:DescribeLifecyclePolicies

Last Updated:Jun 25, 2026

Mengambil daftar kebijakan manajemen siklus hidup.

Deskripsi operasi

Hanya sistem file NAS General-purpose dan CPFS for Lingjun yang mendukung fitur ini.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

nas:DescribeLifecyclePolicies

get

*LifecyclePolicy

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

FileSystemId

string

No

ID sistem file.

31a8e4****

LifecyclePolicyName

string

No

Nama kebijakan siklus hidup. Aturan penamaan:

Nama harus terdiri dari 3 hingga 64 karakter, diawali dengan huruf, dan dapat berisi huruf, digit, garis bawah (_), atau tanda hubung (-).

Catatan

Opsional untuk sistem file NAS General-purpose. Jika ditentukan, parameter ini akan diutamakan. Jika tidak ditentukan, LifecyclePolicyId akan digunakan sebagai gantinya.

lifecyclepolicy_01

PageSize

integer

No

Jumlah kebijakan manajemen siklus hidup pada setiap halaman.

Nilai valid: 1 hingga 100.

Nilai default: 10.

10

PageNumber

integer

No

Nomor halaman daftar.

Nilai awal (nilai default): 1.

1

StorageType

string

No

Tipe kelas penyimpanan. Nilai valid:

  • InfrequentAccess: Kelas penyimpanan IA.

  • Archive: Kelas penyimpanan Archive.

Catatan

Jika StorageType tidak ditentukan, semua kebijakan siklus hidup akan dikembalikan.

Valid values:

  • Archive :

    Kelas penyimpanan Archive.

  • InfrequentAccess :

    Kelas penyimpanan IA.

InfrequentAccess

LifecyclePolicyId

string

No

ID kebijakan siklus hidup.

lc-xxx

LifecyclePolicyType

string

No

Tipe kebijakan.

Nilai valid:

  • Auto: eksekusi otomatis

  • OnDemand: eksekusi sesuai permintaan

Catatan

Hanya CPFS for Lingjun yang mendukung parameter ini.

Valid values:

  • Auto :

    Eksekusi otomatis.

  • OnDemand :

    Eksekusi sesuai permintaan.

Auto

Description

string

No

Deskripsi kebijakan.

Catatan

Hanya CPFS for Lingjun yang mendukung parameter ini.

描述

Path

string

No

Memfilter hasil berdasarkan jalur.

Catatan

Hanya CPFS for Lingjun yang mendukung parameter ini.

/abc/

Elemen respons

Element

Type

Description

Example

object

TotalCount

integer

Jumlah total kebijakan manajemen siklus hidup.

10

RequestId

string

ID permintaan.

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

PageSize

integer

Jumlah kebijakan manajemen siklus hidup pada setiap halaman.

10

PageNumber

integer

Nomor halaman daftar.

1

LifecyclePolicies

array<object>

Kumpulan informasi kebijakan manajemen siklus hidup.

array<object>

FileSystemId

string

ID sistem file.

31a8e4****

LifecycleRuleName

string

Aturan manajemen yang terkait dengan kebijakan manajemen siklus hidup.

Nilai valid:

  • DEFAULT_ATIME_14: file tidak diakses dalam 14 hari terakhir

  • DEFAULT_ATIME_30: file tidak diakses dalam 30 hari terakhir

  • DEFAULT_ATIME_60: file tidak diakses dalam 60 hari terakhir

  • DEFAULT_ATIME_90: file tidak diakses dalam 90 hari terakhir.

DEFAULT_ATIME_14

CreateTime

string

Pengatur waktu ketika kebijakan manajemen siklus hidup dibuat.

Pengatur waktu mengikuti standar ISO 8601 dalam format: yyyy-MM-ddTHH:mm:ssZ.

2019-10-30T10:08:08Z

Path

string

Jalur mutlak direktori tunggal yang dikonfigurasi dalam kebijakan manajemen siklus hidup.

/pathway/to/folder

StorageType

string

Tipe kelas penyimpanan. Nilai valid:

  • InfrequentAccess: Kelas penyimpanan IA.

  • Archive: Kelas penyimpanan Archive.

InfrequentAccess

LifecyclePolicyName

string

Nama kebijakan manajemen siklus hidup.

lifecyclepolicy_01

Paths

array

Daftar jalur mutlak beberapa direktori yang dikonfigurasi dalam kebijakan manajemen siklus hidup.

string

Daftar jalur mutlak beberapa direktori yang dikonfigurasi dalam kebijakan manajemen siklus hidup.

["/path1","/path2"]

LifecyclePolicyId

string

ID kebijakan siklus hidup.

lc-xxx

Description

string

Deskripsi kebijakan.

描述

LifecyclePolicyType

string

Tipe kebijakan.

Auto

TransitRules

array<object>

Aturan transit data untuk file.

object

Aturan transit data untuk file.

Attribute

string

Atribut aturan transisi.

Atime

Threshold

string

Ambang batas aturan transisi.

3

RetrieveRules

array<object>

Aturan pengambilan data untuk file.

object

Aturan pengambilan data untuk file.

Attribute

string

Atribut aturan pengambilan.

RetrieveType

Threshold

string

Ambang batas aturan pengambilan.

All

Contoh

Respons sukses

JSONformat

{
  "TotalCount": 10,
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "PageSize": 10,
  "PageNumber": 1,
  "LifecyclePolicies": [
    {
      "FileSystemId": "31a8e4****",
      "LifecycleRuleName": "DEFAULT_ATIME_14",
      "CreateTime": "2019-10-30T10:08:08Z",
      "Path": "/pathway/to/folder",
      "StorageType": "InfrequentAccess",
      "LifecyclePolicyName": "lifecyclepolicy_01",
      "Paths": [
        "[\"/path1\",\"/path2\"]"
      ],
      "LifecyclePolicyId": "lc-xxx",
      "Description": "描述",
      "LifecyclePolicyType": "Auto",
      "TransitRules": [
        {
          "Attribute": "Atime",
          "Threshold": "3"
        }
      ],
      "RetrieveRules": [
        {
          "Attribute": "RetrieveType",
          "Threshold": "All"
        }
      ]
    }
  ]
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

404 InvalidFileSystem.NotFound The specified file system does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.