DescribeClusterDetail - Container Service for Kubernetes

Mengkueri detail kluster tertentu berdasarkan ID kluster.

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

cs:DescribeClusterDetail

get

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

None

Sintaks permintaan

GET /clusters/{ClusterId} HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster.	cdde1f21ae22e483ebcb068a6eb7f****

Parameter permintaan

Parameter

Type

Required

Description

Example

Tidak ada parameter yang diperlukan.

Elemen respons

Element	Type	Description	Example
	object	Badan respons.
cluster_id	string	ID kluster.	c82e6987e2961451182edacd74faf****
cluster_type	string	Tipe kluster. `Kubernetes`: Kluster Edisi Khusus Kubernetes. `ManagedKubernetes`: Tipe kluster ACK Managed, termasuk kluster ACK Managed (ACK Pro dan ACK Basic), Layanan Kontainer Serverless (Pro dan Basic), kluster ACK Edge (Pro dan Basic), dan kluster ACK Lingjun (Pro). `ExternalKubernetes`: Kluster terdaftar.	Kubernetes
created	string	Pengatur waktu saat kluster dibuat.	2025-04-07T09:57:26+08:00
init_version	string	Versi Kubernetes awal kluster.	1.32.1-aliyun.1
current_version	string	Versi Kubernetes kluster saat ini. Untuk informasi lebih lanjut tentang versi Kubernetes yang didukung oleh ACK, lihat Ikhtisar versi Kubernetes.	1.32.1-aliyun.1
next_version	string	Versi Kubernetes ke mana kluster dapat ditingkatkan.	1.xx.x-aliyun.1
deletion_protection	boolean	Apakah perlindungan penghapusan diaktifkan untuk kluster. Perlindungan penghapusan mencegah kluster terhapus secara tidak sengaja melalui konsol atau API. Nilai valid: `true`: Perlindungan penghapusan diaktifkan. Kluster tidak dapat dihapus melalui konsol atau API. `false`: Perlindungan penghapusan tidak diaktifkan. Kluster dapat dihapus melalui konsol atau API.	true
docker_version `deprecated`	string	Versi Docker yang digunakan dalam kluster.	19.03.5
external_loadbalancer_id `deprecated`	string	ID Instans Server Load Balancer (SLB) yang terkait dengan Ingress kluster.	lb-2zehc05z3b8dwiifh****
meta_data	string	Metadata kluster.	\"Addons\":***
name	string	Nama kluster.	cluster-demo
network_mode `deprecated`	string	Jenis jaringan yang digunakan oleh kluster, seperti VPC.	vpc
region_id	string	ID wilayah tempat kluster diterapkan.	cn-beijing
resource_group_id	string	ID kelompok sumber daya tempat kluster berada.	rg-acfmyvw3wjm****
security_group_id	string	ID grup keamanan yang terkait dengan kluster.	sg-25yq****
size	integer	Jumlah node dalam kluster, termasuk node master dan node worker.	5
state	string	Status kluster. Nilai valid: `initial`: Kluster sedang dibuat. `failed`: Pembuatan kluster gagal. `running`: Kluster berjalan. `updating`: Kluster sedang diperbarui. `upgrading`: Kluster sedang ditingkatkan. `removing`: Node sedang dihapus. `draining`: Node sedang dikosongkan. `scaling`: Kluster sedang diskalakan. `inactive`: Kluster tidak aktif. `unavailable`: Kluster tidak tersedia. `deleting`: Kluster sedang dihapus. `deleted`: Kluster telah dihapus. `delete_failed`: Penghapusan kluster gagal. `waiting`: Kluster berada dalam status diakses, menunggu untuk dihubungkan. `disconnected`: Kluster terputus.	running
tags	array	Tag Sumber daya kluster.
	tag	Tag Sumber daya kluster.
updated	string	Pengatur waktu saat kluster terakhir diperbarui.	2025-04-10T13:28:09+08:00
vpc_id	string	ID virtual private cloud (VPC) yang digunakan oleh kluster. Parameter ini diperlukan saat Anda membuat kluster.	vpc-2zecuu62b9zw7a7qn****
vswitch_id `deprecated`	string	ID vSwitch. Bidang ini sudah tidak digunakan lagi. Untuk mengkueri vSwitch lapisan kontrol, gunakan vswitch_ids. Untuk mengkueri vSwitch bidang data, gunakan vswitch_ids dalam konfigurasi kelompok node.	vsw-2zete8s4qocqg0mf6**,vsw-2zete8s4qocqg0mf6**
subnet_cidr `deprecated`	string	Blok CIDR pod.	172.20.xx.xx/16
zone_id `deprecated`	string	ID zona tempat kluster diterapkan.	cn-beijing-a
master_url	string	Alamat akses kluster, termasuk alamat akses jaringan internal dan alamat akses jaringan publik.	{\"intranet_api_server_endpoint\":\"https://192.168.xx.xx:6443\"***}
private_zone `deprecated`	boolean	Apakah PrivateZone diaktifkan untuk kluster. `true`: Diaktifkan. `false`: Tidak diaktifkan. Nilai default: false.	false
profile	string	Kelas anak kluster. `Default`: Kluster ACK Managed, termasuk kluster ACK Pro dan kluster ACK Basic. `Edge`: Kluster ACK Edge, termasuk kluster ACK Edge Pro dan kluster ACK Edge Basic. `Serverless`: Layanan Kontainer Serverless, termasuk Layanan Kontainer Serverless Pro dan Layanan Kontainer Serverless Basic. `Lingjun`: Kluster ACK Lingjun, tersedia dalam versi Pro.	Default
cluster_spec	string	Spesifikasi Produk kluster ketika `cluster_type` diatur ke `ManagedKubernetes` dan `profile` dikonfigurasi. Nilai valid: `ack.standard`: Basic (dipilih secara default jika nilai kosong) `ack.pro.small`: Pro kecil `ack.pro.xlarge`: Pro XL Tingkat Tinggi `ack.pro.2xlarge`: Pro 2XL Tingkat Tinggi `ack.pro.4xlarge`: Pro 4XL Tingkat Tinggi (hubungi layanan pelanggan untuk ditambahkan ke daftar putih) Pro XL, Pro 2XL, dan Pro 4XL adalah tiga tingkatan yang disediakan oleh ACK Pro Provisioned Control Plane. Dengan mengalokasikan sebelumnya dan mendedikasikan Sumber daya lapisan kontrol, tingkatan ini memastikan bahwa konkurensi API dan kemampuan penjadwalan pod tetap pada tingkat yang konsisten tinggi. Tingkatan ini cocok untuk pelatihan dan inferensi AI, kluster berskala sangat besar, dan beban kerja kritis. Untuk informasi tentang biaya manajemen kluster untuk edisi Pro dan lapisan kontrol yang disediakan, lihat Biaya manajemen kluster.	ack.pro.small
worker_ram_role_name	string	Nama peran RAM worker yang mengotorisasi Instance ECS untuk berfungsi sebagai node worker kluster.	KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****
maintenance_window	maintenance_window	Konfigurasi jendela pemeliharaan kluster. Konfigurasi ini hanya berlaku untuk kluster managed (kluster ACK Pro).
parameters `deprecated`	object	Kumpulan parameter Resource Orchestration Service (ROS) untuk kluster.
	string	Parameter ROS.	"ALIYUN::Region": "cn-qingdao"
container_cidr	string	Blok CIDR pod, digunakan untuk konfigurasi jaringan Flannel.	172.20.xx.xx/16
service_cidr	string	Blok CIDR layanan.	172.21.xx.xx/20
proxy_mode	string	Modus kube-proxy. `iptables`: Modus kube-proxy yang matang dan stabil. Penemuan layanan dan penyeimbangan beban untuk Kubernetes Services dikonfigurasi menggunakan aturan iptables. Performa sedang dan dipengaruhi oleh skala kluster. Modus ini cocok untuk kluster dengan jumlah Service yang sedikit kecil. `ipvs`: Modus kube-proxy berperforma tinggi. Penemuan layanan dan penyeimbangan beban untuk Kubernetes Services dikonfigurasi menggunakan modul Linux IPVS. Modus ini cocok untuk kluster dengan jumlah Service yang besar Tingkat Tinggi yang memerlukan performa penyeimbangan beban tinggi.	ipvs
timezone	string	Pengatur waktu zona.	Asia/Shanghai
node_cidr_mask	string	Hanya berlaku untuk plugin jaringan Flannel. Ukuran subnet mask yang ditetapkan ke setiap node, yang mengontrol jumlah alamat IP yang dapat dialokasikan ke node.	26
ip_stack	string	Tumpukan protokol IP kluster. Nilai valid: ipv4: membuat kluster yang hanya mendukung tumpukan stack protokol IPv4. dual: membuat kluster yang mendukung tumpukan ganda IPv4/IPv6.	ipv4
cluster_domain	string	Nama domain lokal kluster.	cluster.local
extra_sans	array	Subject Alternative Name (SAN) kustom untuk sertifikat API Server.
	string	SAN sertifikat.	192.168.xx.xx
rrsa_config	object	Konfigurasi RAM Roles for Service Accounts (RRSA).
enabled	boolean	Apakah RRSA diaktifkan.	true
oidc_name	string	Nama Penyedia Identitas OIDC.	ack-rrsa-***
oidc_arn	string	Alibaba Cloud Resource Name (ARN) dari Penyedia Identitas OIDC.	acs:ram::1138*:oidc-provider/ack-rrsa-*
max_oidc_token_expiration	string	Periode validitas maksimum yang dapat dikonfigurasi untuk token OIDC.	12h
audience	string	Audience default token OIDC. Beberapa nilai dipisahkan oleh koma (,). Nilai-nilai tersebut disertakan sebagai array dalam bidang aud token OIDC.	https://kubernetes.default.svc,https://example.***.com
issuer	string	Informasi issuer token OIDC. Beberapa nilai dipisahkan oleh koma (,). Nilai pertama menjadi nilai bidang iss dalam token OIDC dan URL issuer dari Penyedia Identitas OIDC.	https://oidc-ack-***,https://kubernetes.default.svc
open_api_configuration_url	string	URL dokumen konfigurasi OIDC.	https://oidc-ack-*/c12b990*/.well-known/openid-configuration
jwks_url	string	URL informasi kunci publik OIDC.	https://oidc-ack-*/c12b990*/keys
vswitch_ids	array	vSwitch yang digunakan oleh lapisan kontrol kluster.
	string	vSwitch yang digunakan oleh lapisan kontrol kluster.	vsw-2zete8s4qocqg0mf6****
operation_policy	object	Kebijakan O&M otomatis kluster.
cluster_auto_upgrade	object	Konfigurasi peningkatan otomatis kluster.
enabled	boolean	Apakah auto-upgrade klaster diaktifkan.	true
channel	string	Frekuensi auto-upgrade klaster. Untuk informasi lebih lanjut, lihat Frekuensi upgrade. Nilai yang valid: patch: Versi patch terbaru. stable: Versi minor terbaru kedua. rapid: Versi minor terbaru.	patch
control_plane_config	object	Konfigurasi lapisan kontrol untuk klaster Kluster Edisi Khusus Kubernetes.
charge_type	string	Metode penagihan node lapisan kontrol.	PrePaid
period	integer	Durasi langganan node.	1
period_unit	string	Unit durasi langganan.	Month
auto_renew	boolean	Apakah perpanjangan otomatis diaktifkan untuk node.	true
auto_renew_period	integer	Periode perpanjangan otomatis node.	1
instance_types	array	Tipe instans node.
	string	Tipe instans.	ecs.g6.large
image_type	string	Tipe image sistem operasi.	AliyunLinux3
image_id	string	ID image.	aliyun_3_x64_20G_alibase_20240819
key_pair	string	Nama pasangan kunci. Tentukan parameter kunci ini atau login_password.	ack
system_disk_category	string	Tipe cloud disk sistem untuk node.	cloud_essd
system_disk_size	integer	Ukuran cloud disk sistem untuk node. Nilai minimum: 40.	120
system_disk_snapshot_policy_id	string	Kebijakan cadangan snapshot otomatis untuk node.	sp-2zej1nogjvovnz4z****
system_disk_performance_level	string	Tingkat kinerja cloud disk sistem. Parameter ini hanya berlaku untuk cloud disk ESSD.	PL1
system_disk_provisioned_iops	integer	IOPS baca/tulis yang disediakan dari cloud disk sistem.	1000
system_disk_bursting_enabled	boolean	Apakah burst (lonjakan performa I/O) diaktifkan untuk cloud disk sistem.	true
deploymentset_id	string	ID Penerapan set penyebaran.	ds-bp10b35imuam5amw****
cloud_monitor_flags	boolean	Apakah Agen CloudMonitor diinstal pada node.	true
soc_enabled	boolean	Apakah penguatan keamanan MLPS 2.0 diaktifkan.	false
security_hardening_os	boolean	Apakah penguatan keamanan OS Alibaba Cloud diaktifkan.	true
cpu_policy	string	Kebijakan manajemen CPU node.	none
runtime	string	Nama waktu proses kontainer.	containerd
node_port_range	string	Range Port layanan service node.	30000-32767
size	integer	Jumlah node lapisan kontrol.	3
instance_metadata_options	InstanceMetadataOptions	Konfigurasi akses metadata Instance ECS.
auto_mode	object	Konfigurasi modus managed cerdas.
enable	boolean	Apakah modus managed cerdas diaktifkan.	false
control_plane_endpoints_config	object	Konfigurasi koneksi kluster.
load_balancers_config	array<object>	Konfigurasi penyeimbangan beban untuk akses kluster.
	object
endpoint_type	string
load_balancer_id	string
endpoint	string
internal_dns_config	object	Konfigurasi DNS internal kluster, berlaku untuk kluster ACK Managed. Nama domain internal digunakan oleh komponen sistem sisi node seperti kubelet dan kube-proxy untuk mengakses API Server. Jika akses nama domain internal tidak diaktifkan, komponen sistem sisi node mengakses API Server melalui alamat IP CLB.
bind_vpcs	array	Cakupan VPC di mana resolusi catatan DNS internal berlaku. VPC tempat klaster berada disertakan secara default.
	string	VPC tempat resolusi catatan DNS internal berlaku.	vpc-xxxxxx
enabled	boolean	Apakah akan mengaktifkan akses DNS internal untuk klaster. true: Mengaktifkan akses DNS internal. Komponen sisi node (kubelet, kube-proxy) akan mengakses API Server melalui DNS internal.	true

Contoh

Respons sukses

JSONformat

{
  "cluster_id": "c82e6987e2961451182edacd74faf****",
  "cluster_type": "Kubernetes",
  "created": "2025-04-07T09:57:26+08:00",
  "init_version": "1.32.1-aliyun.1",
  "current_version": "1.32.1-aliyun.1",
  "next_version": "1.xx.x-aliyun.1",
  "deletion_protection": true,
  "docker_version": "19.03.5",
  "external_loadbalancer_id": "lb-2zehc05z3b8dwiifh****",
  "meta_data": "\\\"Addons\\\":***",
  "name": "cluster-demo",
  "network_mode": "vpc",
  "region_id": "cn-beijing",
  "resource_group_id": "rg-acfmyvw3wjm****",
  "security_group_id": "sg-25yq****",
  "size": 5,
  "state": "running",
  "tags": [
    {
      "key": "env",
      "value": "prod"
    }
  ],
  "updated": "2025-04-10T13:28:09+08:00",
  "vpc_id": "vpc-2zecuu62b9zw7a7qn****",
  "vswitch_id": "vsw-2zete8s4qocqg0mf6****,vsw-2zete8s4qocqg0mf6****",
  "subnet_cidr": "172.20.xx.xx/16",
  "zone_id": "cn-beijing-a",
  "master_url": "{\\\"intranet_api_server_endpoint\\\":\\\"https://192.168.xx.xx:6443\\\"***}",
  "private_zone": false,
  "profile": "Default",
  "cluster_spec": "ack.pro.small",
  "worker_ram_role_name": "KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****",
  "maintenance_window": {
    "enable": false,
    "maintenance_time": "2020-10-15T12:31:00.000+08:00",
    "duration": "3h",
    "weekly_period": "Monday,Thursday",
    "recurrence": "FREQ=WEEKLY;INTERVAL=4;BYDAY=MO,TU"
  },
  "parameters": {
    "key": "\"ALIYUN::Region\": \"cn-qingdao\""
  },
  "container_cidr": "172.20.xx.xx/16",
  "service_cidr": "172.21.xx.xx/20",
  "proxy_mode": "ipvs",
  "timezone": "Asia/Shanghai",
  "node_cidr_mask": "26",
  "ip_stack": "ipv4",
  "cluster_domain": "cluster.local",
  "extra_sans": [
    "192.168.xx.xx"
  ],
  "rrsa_config": {
    "enabled": true,
    "oidc_name": "ack-rrsa-***",
    "oidc_arn": "acs:ram::1138***:oidc-provider/ack-rrsa-***",
    "max_oidc_token_expiration": "12h",
    "audience": "https://kubernetes.default.svc,https://example.***.com",
    "issuer": "https://oidc-ack-***,https://kubernetes.default.svc",
    "open_api_configuration_url": "https://oidc-ack-***/c12b990***/.well-known/openid-configuration",
    "jwks_url": "https://oidc-ack-***/c12b990***/keys"
  },
  "vswitch_ids": [
    "vsw-2zete8s4qocqg0mf6****"
  ],
  "operation_policy": {
    "cluster_auto_upgrade": {
      "enabled": true,
      "channel": "patch"
    }
  },
  "control_plane_config": {
    "charge_type": "PrePaid",
    "period": 1,
    "period_unit": "Month",
    "auto_renew": true,
    "auto_renew_period": 1,
    "instance_types": [
      "ecs.g6.large"
    ],
    "image_type": "AliyunLinux3",
    "image_id": "aliyun_3_x64_20G_alibase_20240819",
    "key_pair": "ack",
    "system_disk_category": "cloud_essd",
    "system_disk_size": 120,
    "system_disk_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
    "system_disk_performance_level": "PL1",
    "system_disk_provisioned_iops": 1000,
    "system_disk_bursting_enabled": true,
    "deploymentset_id": "ds-bp10b35imuam5amw****",
    "cloud_monitor_flags": true,
    "soc_enabled": false,
    "security_hardening_os": true,
    "cpu_policy": "none",
    "runtime": "containerd",
    "node_port_range": "30000-32767",
    "size": 3,
    "instance_metadata_options": {
      "http_tokens": "optional"
    }
  },
  "auto_mode": {
    "enable": false
  },
  "control_plane_endpoints_config": {
    "load_balancers_config": [
      {
        "endpoint_type": "",
        "load_balancer_id": "",
        "endpoint": ""
      }
    ],
    "internal_dns_config": {
      "bind_vpcs": [
        "vpc-xxxxxx"
      ],
      "enabled": true
    }
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.