All Products
Search

This Product

    Bastionhost:ListUserGroups

    Document Center

    Bastionhost:ListUserGroups

    Last Updated:Jun 10, 2026

    Mengkueri daftar grup pengguna di bastion host.

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID bastion host tempat Anda ingin mengkueri grup pengguna.

    Catatan

    Anda dapat memanggil operasi DescribeInstances untuk mengkueri ID bastion host.

    bastionhost-cn-st220aw****
    RegionId

    string

    No

    ID region bastion host tempat Anda ingin mengkueri grup pengguna.

    Catatan

    Untuk informasi lebih lanjut tentang pemetaan antara ID region dan nama region, lihat Region dan zona.

    cn-hangzhou
    PageNumber

    string

    No

    Nomor halaman yang akan dikembalikan. Nilai default: 1.

    1
    PageSize

    string

    No

    Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 100. Nilai default: 20. Jika Anda mengosongkan parameter ini, 20 entri dikembalikan pada setiap halaman.

    20
    UserGroupName

    string

    No

    Nama grup pengguna yang ingin Anda kueri. Hanya pencocokan persis yang didukung.

    TestGroup01

    Saat Anda memanggil operasi API ini, Anda harus menyertakan parameter permintaan umum Alibaba Cloud API dalam permintaan Anda selain parameter permintaan yang dijelaskan dalam topik ini. Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum. Untuk format permintaan, lihat contoh permintaan dalam topik ini.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Data respons.

    TotalCount

    integer

    Jumlah total grup pengguna yang dikembalikan.

    1
    RequestId

    string

    ID permintaan.

    EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
    UserGroups

    array<object>

    Grup pengguna yang dikembalikan.

    object

    UserGroupName

    string

    Nama grup pengguna.

    TestGroup01
    MemberCount

    integer

    Jumlah pengguna dalam grup pengguna.

    6
    Comment

    string

    Deskripsi grup pengguna.

    comment
    UserGroupId

    string

    ID grup pengguna.

    1

    Contoh

    Respons sukses

    JSONformat

    {
  "TotalCount": 1,
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "UserGroups": [
    {
      "UserGroupName": "TestGroup01",
      "MemberCount": 6,
      "Comment": "comment",
      "UserGroupId": "1"
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The argument is invalid.
    500 InternalError An unknown error occurred.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.