Ambil Grup Aplikasi via API DescribeMonitorGroups - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Mengkueri daftar kelompok aplikasi dengan memanggil operasi DescribeMonitorGroups.

Deskripsi operasi

Topik ini menyediakan contoh cara mengkueri daftar kelompok aplikasi untuk akun saat ini. Tanggapan menunjukkan bahwa akun saat ini memiliki dua kelompok aplikasi: testGroup124 dan test123.

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

cms:DescribeMonitorGroups

get

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SelectContactGroups	boolean	No	Apakah akan menyertakan kelompok kontak peringatan dalam tanggapan. Nilai valid:	true
PageNumber	integer	No	Nomor halaman.	1
PageSize	integer	No	Jumlah entri per halaman.	30
Keyword	string	No	Kata kunci pencarian.	test
InstanceId	string	No	ID instans Sumber daya. Parameter ini digunakan untuk mengkueri kelompok aplikasi tempat instans tertentu berada.	i-abcdefgh12****
GroupName	string	No	Nama kelompok aplikasi.	testGroup124
IncludeTemplateHistory	boolean	No	Apakah akan menyertakan riwayat templat peringatan yang telah diterapkan ke kelompok aplikasi dalam tanggapan. Nilai valid:	true
Type	string	No	Tipe kelompok aplikasi. Nilai valid: Valid values: kubernetes : kelompok aplikasi yang disinkronkan dari Layanan Kontainer untuk Kubernetes. ehpc_cluster : kelompok aplikasi yang disinkronkan dari kluster EHPC. ess : kelompok aplikasi yang disinkronkan dari Penyesuaian Skala Otomatis (ESS). resMgr : kelompok aplikasi yang dibuat dari kelompok sumber daya. custom : kelompok aplikasi kustom. tag : kelompok aplikasi yang dibuat secara otomatis menggunakan tag. aone_group : kelompok aplikasi yang disinkronkan atau dikaitkan dari aplikasi Aone.	custom
DynamicTagRuleId	string	No	ID pencocokan aturan dinamis.	6b882d9a-5117-42e2-9d0c-4749a0c6****
GroupFounderTagKey	string	No	Kunci tag yang digunakan untuk membuat kelompok aplikasi menggunakan pencocokan aturan dinamis.	GroupKey1
GroupFounderTagValue	string	No	Nilai tag yang digunakan untuk membuat kelompok aplikasi menggunakan pencocokan aturan dinamis.	GroupValue1
GroupId	string	No	ID kelompok aplikasi. Pisahkan beberapa ID kelompok aplikasi dengan koma (,).	92****
Tag	array<object>	No	Tag kelompok aplikasi.
	object	No	Tag kelompok aplikasi.
Key	string	No	Kunci tag kelompok aplikasi. Nilai valid untuk N: 1 hingga 5.	tagKey1
Value	string	No	Nilai tag kelompok aplikasi. Nilai valid untuk N: 1 hingga 5.	tagValue1
Types	string	No	Tipe kelompok aplikasi. Nilai valid:	custom

Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	F02B299A-D374-4595-9F55-7534D604F132
Success	boolean	Indikator apakah operasi berhasil. Nilai valid:	true
Code	integer	Kode status.	200
Message	string	Paket error.	Sumber daya yang ditentukan tidak ditemukan
PageNumber	integer	Nomor halaman.	1
PageSize	integer	Jumlah entri per halaman.	30
Total	integer	Jumlah total entri.	10
Resources	object
Resource	array<object>	Sumber daya yang terkait.
	array<object>	Sumber daya yang terkait.
Type	string	Tipe kelompok aplikasi. Nilai valid:	custom
GroupFounderTagValue	string	Nilai tag yang digunakan untuk membuat kelompok aplikasi menggunakan pencocokan aturan dinamis.	GroupValue1
BindUrl	string	URL yang disinkronkan dari Layanan Kontainer untuk Kubernetes.	https://aliyun.com
GroupName	string	Nama kelompok aplikasi.	test123
GroupId	integer	ID kelompok aplikasi.	12345
ServiceId	string	ID layanan Alibaba Cloud.	49****
DynamicTagRuleId	string	ID pencocokan aturan dinamis.	6b882d9a-5117-42e2-9d0c-4749a0c6****
GmtCreate	integer	Stempel waktu saat kelompok aplikasi dibuat. Unit: milidetik.	1603181891000
GroupFounderTagKey	string	Kunci tag yang digunakan untuk membuat kelompok aplikasi menggunakan pencocokan aturan dinamis.	GroupKey1
GmtModified	integer	Stempel waktu saat kelompok aplikasi dimodifikasi. Unit: milidetik.	1603181891000
ContactGroups	object
ContactGroup	array<object>	Kelompok kontak peringatan.
	object	Kelompok kontak peringatan.
Name	string	Nama kelompok kontak peringatan.	CloudMonitor
Tags	object
Tag	array<object>	Tag yang terikat pada kelompok aplikasi.
	object	Tag yang terikat pada kelompok aplikasi.
Key	string	Kunci tag kelompok aplikasi.	tagKey1
Value	string	Nilai tag kelompok aplikasi.	tagValue1
TemplateIds	object
TemplateId	array	ID templat.
	string	Templat peringatan yang telah diterapkan ke kelompok aplikasi.	92****
ResourceGroupId	string	ID kelompok sumber daya.	rg-aek2hopjh*******
TemplateInfos	object
TemplateInfo	array<object>	Informasi templat.
	object	Informasi templat.
EffectTime	integer	Periode efektif.	1603181891000
TemplateId	string	ID templat.	123***
Ver	string	Versi.	0

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F02B299A-D374-4595-9F55-7534D604F132",
  "Success": true,
  "Code": 200,
  "Message": "Sumber daya yang ditentukan tidak ditemukan.",
  "PageNumber": 1,
  "PageSize": 30,
  "Total": 10,
  "Resources": {
    "Resource": [
      {
        "Type": "custom.",
        "GroupFounderTagValue": "GroupValue1",
        "BindUrl": "https://aliyun.com.",
        "GroupName": "test123",
        "GroupId": 12345,
        "ServiceId": "49****",
        "DynamicTagRuleId": "6b882d9a-5117-42e2-9d0c-4749a0c6****",
        "GmtCreate": 1603181891000,
        "GroupFounderTagKey": "GroupKey1",
        "GmtModified": 1603181891000,
        "ContactGroups": {
          "ContactGroup": [
            {
              "Name": "CloudMonitor."
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "tagKey1",
              "Value": "tagValue1"
            }
          ]
        },
        "TemplateIds": {
          "TemplateId": [
            "92****"
          ]
        },
        "ResourceGroupId": "rg-aek2hopjh*******",
        "TemplateInfos": {
          "TemplateInfo": [
            {
              "EffectTime": 1603181891000,
              "TemplateId": "123***",
              "Ver": "0"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	ParameterInvalid	%s
401	AccessDeniedException	You donot have sufficient access to perform this action.
500	InternalError	The request processing has failed due to some unknown error.
402	LimitExceeded	The quota for this customer had been reached.
403	AccessForbidden	The X.509 certificate or cms access key ID provided does not exist in our records.
206	%s	%s
404	ResourceNotFound	The specified resource is not found.	Sumber daya %s yang ditentukan tidak ada.
503	%s	%s
406	%s	%s
429	Throttli∂ngException	The request was denied due to request throttling.
409	%s	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.