All Products
Search

This Product

    File Storage NAS:DescribeAccessGroups

    Document Center

    File Storage NAS:DescribeAccessGroups

    Last Updated:Jun 25, 2026

    Mengkueri informasi grup izin.

    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:DescribeAccessGroups

    list

    *AccessGroup

    acs:nas:{#regionId}:{#accountId}:accessgroup/{#accessgroupName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AccessGroupName

    string

    No

    Nama grup izin.

    Batasan:

    • Panjang nama harus 3 hingga 64 karakter.

    • Nama harus diawali dengan huruf dan dapat berisi huruf, angka, garis bawah (_), atau tanda hubung (-).

    DEFAULT_VPC_GROUP_NAME
    PageSize

    integer

    No

    Jumlah grup izin pada setiap halaman.

    Nilai valid: 1 hingga 100.

    Nilai default: 10.

    2
    PageNumber

    integer

    No

    Nomor halaman daftar.

    Nilai awal (nilai default): 1.

    1
    UseUTCDateTime

    boolean

    No

    Apakah waktu yang dikembalikan dalam format UTC.

    Nilai valid:

    • true (default): Waktu yang dikembalikan dalam format UTC.

    • false: Waktu yang dikembalikan tidak dalam format UTC.

    true
    FileSystemType

    string

    No

    Tipe sistem file.

    Nilai valid:

    • standard (default): NAS tujuan umum.

    • extreme: Extreme NAS.

    • cpfs: Cloud Parallel File Storage (CPFS).

    Valid values:

    • standard :

      NAS tujuan umum.

    • cpfs :

      Sistem File Paralel Cloud.

    • extreme :

      Extreme NAS.

    standard

    Elemen respons

    Element

    Type

    Description

    Example

    object

    AccessGroups

    object

    AccessGroup

    array<object>

    Kumpulan informasi grup izin.

    object

    AccessGroupName

    string

    Nama grup izin.

    DEFAULT_VPC_GROUP_NAME
    Description

    string

    Deskripsi grup izin.

    This is a test access group.
    CreateTime

    string

    Waktu saat grup izin dibuat.

    Waktu mengikuti standar ISO 8601 dan dikembalikan dalam format yyyy-MM-ddTHH:mm:ssZ.

    2020-01-05T16:00:00Z
    AccessGroupType

    string

    Jenis grup izin. Nilai Vpc menunjukkan virtual private cloud (VPC).

    Vpc
    RuleCount

    integer

    Jumlah aturan izin dalam grup izin.

    0
    MountTargetCount

    integer

    Jumlah target mount yang menerapkan grup izin.

    0
    FileSystemType

    string

    Jenis sistem file.

    Nilai yang valid:

    • standard (default): NAS Tujuan Umum.

    • extreme: NAS Ekstrem.

    • cpfs: Cloud Parallel File Storage (CPFS).

    standard
    RegionId

    string

    ID wilayah.

    cn-hangzhou
    TotalCount

    integer

    Jumlah total grup izin.

    1
    RequestId

    string

    ID permintaan.

    2514F97E-FFF0-4A1F-BF04-729CEAC6****
    PageSize

    integer

    Jumlah grup izin pada setiap halaman.

    2
    PageNumber

    integer

    Nomor halaman daftar.

    1

    Contoh

    Respons sukses

    JSONformat

    {
  "AccessGroups": {
    "AccessGroup": [
      {
        "AccessGroupName": "DEFAULT_VPC_GROUP_NAME",
        "Description": "This is a test access group.",
        "CreateTime": "2020-01-05T16:00:00Z",
        "AccessGroupType": "Vpc",
        "RuleCount": 0,
        "MountTargetCount": 0,
        "FileSystemType": "standard",
        "RegionId": "cn-hangzhou"
      }
    ]
  },
  "TotalCount": 1,
  "RequestId": "2514F97E-FFF0-4A1F-BF04-729CEAC6****",
  "PageSize": 2,
  "PageNumber": 1
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.