DescribeAgenticDBClusters - PolarDB - Alibaba Cloud Documentation Center

Mengkueri daftar kluster Agentic Database.

Deskripsi operasi

Operasi ini mendukung pemfilteran dan pengembalian daftar operator model terkait berdasarkan parameter RelativeDBClusterId dan KubeType.
Catatan: Pastikan RelativeDBClusterId yang diberikan di permintaan cocok dengan ID Instansiasi basis data PolarDB Basis Data Relasional Cloud-Native yang ada. Jika tidak, data tidak dapat diambil dengan benar.

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.

Sintaks permintaan

GET  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
DBClusterIds	string	No	ID kluster. Pisahkan beberapa ID kluster dengan koma (,).	pc-**************
AgenticDbClusterIds	string	No	ID kluster Agentic. Pisahkan beberapa ID kluster dengan koma (,).	pagc-**************
DBClusterDescription	string	No	Deskripsi kluster. Pencocokan kabur didukung.	pc-****************
DBClusterStatus	string	No	Status kluster.	Running
PageSize	integer	No	Jumlah entri per halaman. Nilai valid: 30, 50, dan 100. Nilai default: 30.	30
PageNumber	integer	No	Nomor halaman.	1
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-************
Tag	array<object>	No	Tag.
	object	No	Tag.
Value	string	No	Nilai tag yang sesuai dengan kunci tag.	testValueData
Key	string	No	Kunci tag. Anda dapat memfilter daftar kluster berdasarkan tag. Anda dapat menentukan hingga 20 tag. Angka n untuk setiap tag harus unik dan harus berupa bilangan bulat berurutan yang dimulai dari 1. Nilai Tag.n.Key sesuai dengan Tag.n.Value.	type
MaxResults	integer	No	Jumlah maksimum entri yang akan dikembalikan. Nilai default: 10.	10
NextToken	string	No	Token paginasi. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya. Jika tidak ada kueri berikutnya, jangan berikan parameter ini.	212db86sca4384811e0b5e8707e******

Elemen respons

Element	Type	Description	Example
	object	Skema tanggapan.
TotalRecordCount	integer	Jumlah total entri.	1
PageRecordCount	integer	Jumlah kluster pada halaman saat ini.	1
RequestId	string	ID permintaan.	CDB3258F-B5DE-43C4-8935-CBA0CA******
PageNumber	integer	Nomor halaman.	1
Items	array<object>	Daftar kluster.
	array<object>	Informasi koneksi SSL.
DBClusterId	string	ID kluster.	pc-xxxxxx
RegionId	string	ID wilayah.	cn-hangzhou
ZoneId	string	ID zona.	cn-hangzhou-i
DBClusterStatus	string	Status kluster.	Running
CreateTime	string	Pengatur waktu pembuatan kluster.	2020-08-14T05:58:42Z
DBClusterDescription	string	Deskripsi kluster.	ocpx
DBType	string	Tipe mesin database.	MySQL
DBVersion	string	Versi mesin database.	8.0
Category	string	Edisi kluster. Nilai valid: Normal: Edisi Kluster Basic: Edisi node tunggal Archive: Edisi X-Engine NormalMultimaster: Kluster Multi-master (Database/Tabel)	Normal
ServerlessType	string	Tipe arsitektur tanpa server. Nilai AgileServerless menunjukkan bahwa kluster adalah Kluster serverless.	AgileServerless
PayType	string	Metode penagihan. Nilai valid: Postpaid: bayar sesuai pemakaian. Prepaid: langganan.	Postpaid
StorageType	string	Tipe penyimpanan. Nilai valid: essdpl0 essdpl1 essdpl2 essdpl3	city_redundancy
StorageUsed	integer	Penggunaan penyimpanan kluster. Unit: byte.	3009413120
ScaleMin	string	Nilai minimum: 0 hingga 32 PCU. Nilai minimum harus kurang dari atau sama dengan nilai maksimum. Unit: PCU.	1
ScaleMax	string	Nilai maksimum: 1 hingga 32 PCU. Unit: PCU.	9
VpcId	string	ID virtual private cloud (VPC) tempat titik akhir berada.	vpc-****************
VswitchId	string	ID vSwitch.	vsw-**************
Expired	string	Apakah kluster telah kedaluwarsa. Nilai valid: true false Catatan Parameter ini hanya dikembalikan untuk kluster yang metode penagihannya adalah Prepaid (langganan).	false
LockMode	string	Status penguncian kluster. Nilai valid: Unlock: Normal. ManualLock: Terkunci secara manual. LockByExpiration: Terkunci secara otomatis karena kluster kedaluwarsa.	Unlock
ExpireTime	string	Pengatur waktu kedaluwarsa kluster. Catatan Nilai spesifik hanya dikembalikan untuk kluster yang metode penagihannya adalah Prepaid (langganan). Nilai kosong dikembalikan untuk kluster Postpaid (bayar sesuai pemakaian).	2025-06-25T09:37:10Z
Tags	array<object>	Kunci tag. Anda dapat memfilter daftar kluster berdasarkan tag. Anda dapat menentukan hingga 20 tag. Angka n untuk setiap tag harus unik dan harus berupa bilangan bulat berurutan yang dimulai dari 1. Nilai Tag.n.Key sesuai dengan Tag.n.Value.
	object	Kunci tag. Anda dapat memfilter daftar kluster berdasarkan tag. Anda dapat menentukan hingga 20 tag. Angka n untuk setiap tag harus unik dan harus berupa bilangan bulat berurutan yang dimulai dari 1. Nilai Tag.n.Key sesuai dengan Tag.n.Value.
Value	string		testValueData
Key	string		MySQL
AgenticDbClusterId	string	ID kluster Agentic.	pagc-**************
AgenticDbClusterDescription	string	Deskripsi kluster Agentic.	pagc-**************
NextToken	string	Token paginasi. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya. Jika tidak ada kueri berikutnya, jangan berikan parameter ini.	212db86sca4384811e0b5e8707e******
MaxResults	integer	Jumlah maksimum entri yang akan dikembalikan. Nilai default: 10.	10

Contoh

Respons sukses

JSONformat

{
  "TotalRecordCount": 1,
  "PageRecordCount": 1,
  "RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******",
  "PageNumber": 1,
  "Items": [
    {
      "DBClusterId": "pc-xxxxxx",
      "RegionId": "cn-hangzhou",
      "ZoneId": "cn-hangzhou-i",
      "DBClusterStatus": "Running",
      "CreateTime": "2020-08-14T05:58:42Z",
      "DBClusterDescription": "ocpx",
      "DBType": "MySQL",
      "DBVersion": "8.0",
      "Category": "Normal",
      "ServerlessType": "AgileServerless",
      "PayType": "Postpaid",
      "StorageType": "city_redundancy",
      "StorageUsed": 3009413120,
      "ScaleMin": "1",
      "ScaleMax": "9",
      "VpcId": "vpc-****************",
      "VswitchId": "vsw-**************",
      "Expired": "false",
      "LockMode": "Unlock",
      "ExpireTime": "2025-06-25T09:37:10Z",
      "Tags": [
        {
          "Value": "testValueData",
          "Key": "MySQL"
        }
      ],
      "AgenticDbClusterId": "pagc-**************",
      "AgenticDbClusterDescription": "pagc-**************"
    }
  ],
  "NextToken": "212db86sca4384811e0b5e8707e******",
  "MaxResults": 10
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.