All Products
Search

This Product

    Resource Access Management:ListUsers

    Document Center

    Resource Access Management:ListUsers

    Last Updated:Jun 10, 2026

    Mengkueri informasi tentang semua pengguna Resource Access Management (RAM).

    Deskripsi operasi

    You can call the following API operations to query the details of all RAM users:

    • ListUsers: queries the details of all RAM users.

    • ListUserBasicInfos: queries the basic information about all RAM users. The basic information includes only the logon names (UserPrincipalName), display names (DisplayName), and user IDs (UserId).

    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

    ram:ListUsers

    list

    *User

    acs:ram::{#accountId}:user/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Marker

    string

    No

    Penanda (marker). Jika sebagian tanggapan sebelumnya terpotong, Anda dapat menggunakan parameter ini untuk mendapatkan bagian yang terpotong.

    EXAMPLE
    MaxItems

    integer

    No

    Jumlah entri per halaman. Jika tanggapan terpotong karena mencapai nilai MaxItems, nilai IsTruncated akan menjadi true.

    Nilai valid: 1 hingga 1000. Nilai default: 1000.

    1000
    Tag

    array<object>

    No

    Tag. Jumlah maksimum tag yang didukung adalah 20.

    object

    No

    The tag value.

    Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be a up to128 characters in length and cannot contain http:// or https://. The tag value cannot start with acs:.

    Key

    string

    No

    The key of tag N.

    Valid values of N: 1 to 20. N must be consecutive.

    operator
    Value

    string

    No

    The value of tag N.

    Valid values of N: 1 to 20. N must be consecutive.

    alice
    Status

    string

    No

    Status pengguna RAM yang ingin Anda kueri. Nilai valid: active, membekukan, dan active,membekukan. Jika Anda mengosongkan parameter ini, nilai active akan digunakan secara default. Jika Anda menentukan nilai untuk parameter Tag, pengguna dalam kedua status tersebut akan dikueri.

    active

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The response parameters.

    RequestId

    string

    The request ID.

    4B450CA1-36E8-4AA2-8461-86B42BF4CC4E
    IsTruncated

    boolean

    Indicates whether the response is truncated. Valid values:

    • true

    • false

    true
    Marker

    string

    The parameter that is used to obtain the truncated part. It takes effect only when IsTruncated is set to true.

    EXAMPLE
    Users

    object

    User

    array<object>

    The information about the RAM users.

    array<object>

    The information about the RAM user.

    DisplayName

    string

    The display name of the RAM user.

    test
    UserPrincipalName

    string

    The logon name of the RAM user.

    test@example.onaliyun.com
    Email

    string

    The email address of the RAM user.

    Catatan

    This parameter applies only to the Alibaba Cloud China site (aliyun.com).

    alice@example.com
    UpdateDate

    string

    The point in time when the information about the RAM user was last modified. The time is displayed in UTC.

    2023-08-21T06:12:47Z
    MobilePhone

    string

    The mobile phone number of the RAM user.

    Catatan

    This parameter applies only to the Alibaba Cloud China site (aliyun.com).

    86-1868888****
    UserId

    string

    The ID of the RAM user.

    20732900249392****
    Comments

    string

    The description.

    This is a cloud computing engineer.
    LastLoginDate

    string

    The timestamp when the RAM user last logged on to the console.

    1692598367586
    CreateDate

    string

    The point in time when the RAM user was created. The time is displayed in UTC.

    2020-08-25T09:23:57Z
    ProvisionType

    string

    The source of the RAM user. Valid values:

    • Manual: The RAM user is manually created in the RAM console.

    • SCIM: The RAM user is mapped by using System for Cross-domain Identity Management (SCIM).

    • CloudSSO: The RAM user is mapped from a CloudSSO user.

    Manual
    Status

    string

    The status of the RAM user.

    active
    Tags

    object

    Tag

    array<object>

    The tags.

    object

    TagKey

    string

    The key of the tag.

    oparator
    TagValue

    string

    The value of the tag

    alice

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
  "IsTruncated": true,
  "Marker": "EXAMPLE",
  "Users": {
    "User": [
      {
        "DisplayName": "test",
        "UserPrincipalName": "test@example.onaliyun.com",
        "Email": "alice@example.com",
        "UpdateDate": "2023-08-21T06:12:47Z",
        "MobilePhone": "86-1868888****",
        "UserId": "20732900249392****",
        "Comments": "This is a cloud computing engineer.",
        "LastLoginDate": "1692598367586",
        "CreateDate": "2020-08-25T09:23:57Z",
        "ProvisionType": "Manual",
        "Status": "active",
        "Tags": {
          "Tag": [
            {
              "TagKey": "oparator",
              "TagValue": "alice"
            }
          ]
        }
      }
    ]
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.