All Products
Search

This Product

    Container Service for Kubernetes:DescribeClustersV1

    Document Center

    Container Service for Kubernetes:DescribeClustersV1

    Last Updated:Sep 10, 2026

    Mengkueri daftar kluster ACK yang memenuhi kondisi tertentu, seperti tipe kluster dan spesifikasi kluster, dalam akun saat ini.

    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:GetClusters

    get

    *Cluster

    acs:cs:*:{#accountId}:cluster/*

    		 None None

    Sintaks permintaan

    GET /api/v1/clusters HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    name

    string

    No

    Nama kluster.

    cluster-demo
    cluster_type

    string

    No

    Tipe kluster.

    • Kubernetes: Kluster ACK spesifikasi khusus.

    • ManagedKubernetes: Tipe kluster ACK terkelola, termasuk kluster ACK terkelola (Pro dan Basic), Layanan Kontainer Serverless (Pro dan Basic), kluster ACK Edge (Pro dan Basic), dan kluster ACK Lingjun (Pro).

    Kubernetes
    page_size

    integer

    No

    Jumlah catatan per halaman.

    10
    page_number

    integer

    No

    Nomor halaman saat ini.

    1
    profile

    string

    No

    Saat Anda mengatur cluster_type ke ManagedKubernetes, Anda dapat menentukan subtipe kluster lebih lanjut.

    • Default: Kluster ACK terkelola, 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 Pro.

    Default
    cluster_spec

    string

    No

    Spesifikasi kluster saat cluster_type diatur ke ManagedKubernetes dan profile dikonfigurasi. Nilai valid:

    • ack.standard: Basic

    • ack.pro.small: Pro

    • ack.pro.xlarge: Pro XL

    • ack.pro.2xlarge: Pro 2XL

    • ack.pro.4xlarge: Pro 4XL (hubungi layanan pelanggan untuk ditambahkan ke daftar putih)

    Pro XL, Pro 2XL, dan Pro 4XL adalah tiga tier yang disediakan oleh ACK Pro Lapisan Kontrol Terprovisi. Dengan mengalokasikan dan mendedikasikan resource lapisan kontrol, tier-tier ini memastikan bahwa konkurensi API dan kemampuan penjadwalan pod tetap berada pada tingkat yang tinggi secara konsisten. Tier ini cocok untuk pelatihan dan inferensi AI, kluster skala ultra-besar, dan beban kerja yang sangat kritis.

    Untuk informasi mengenai biaya manajemen kluster untuk edisi Pro dan lapisan kontrol terprovisi, lihat Biaya manajemen kluster.

    ack.pro.small
    region_id

    string

    No

    Wilayah kluster. Tentukan parameter ini untuk memfilter daftar kluster berdasarkan wilayah.

    cn-hangzhou
    cluster_id

    string

    No

    ID kluster.

    c3fb96524f9274b4495df0f12a6b5****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Badan respons.

    clusters

    array<object>

    Daftar informasi kluster.

    array<object>

    Instans kluster.

    cluster_domain

    string

    Nama domain lokal kluster.

    Kluster.local
    cluster_id

    string

    ID kluster.

    c3fb96524f9274b4495df0f12a6b5****
    cluster_spec

    string

    Spesifikasi kluster.

    ack.standard
    cluster_type

    string

    Tipe kluster.

    Kubernetes
    container_cidr

    string

    Blok CIDR Pod. Ini adalah konfigurasi jaringan Flannel.

    172.20.xx.xx/16
    created

    string

    Waktu pembuatan kluster.

    2025-04-07T09:57:26+08:00
    current_version

    string

    Versi kluster saat ini.

    1.32.1-aliyun.1
    deletion_protection

    boolean

    Apakah perlindungan penghapusan diaktifkan untuk kluster. Perlindungan penghapusan mencegah kluster terhapus secara tidak sengaja di konsol atau melalui pemanggilan operasi API. Nilai valid:

    • true: Perlindungan penghapusan diaktifkan. Kluster tidak dapat dihapus di konsol atau melalui pemanggilan operasi API.

    • false: Perlindungan penghapusan tidak diaktifkan. Kluster dapat dihapus di konsol atau melalui pemanggilan operasi API.

    true
    docker_version deprecated

    string

    Versi Docker yang digunakan oleh kluster.

    19.03.5
    external_loadbalancer_id deprecated

    string

    Instans SLB yang terkait dengan Ingress kluster.

    Tipe instans default: instans guaranteed-performance (slb.s1.kecil).

    lb-2vcrbmlevo6kjpgch****
    init_version

    string

    Versi awal kluster. Untuk informasi selengkapnya tentang versi Kubernetes yang didukung oleh ACK, lihat Ikhtisar rilis versi Kubernetes.

    1.32.1-aliyun.1
    ip_stack

    string

    Stack protokol IP kluster. Nilai valid:

    • ipv4: membuat kluster yang hanya mendukung stack protokol IPv4.

    • dual: membuat kluster yang mendukung stack ganda IPv4/IPv6.

    ipv4
    maintenance_window maintenance_window

    Jendela pemeliharaan kluster. Fitur ini hanya berlaku untuk kluster terkelola ACK dan kluster Layanan Kontainer Serverless.

    master_url

    string

    Alamat akses server API kluster, termasuk alamat akses jaringan internal dan alamat akses jaringan publik.

    {\"api_server_endpoint\":\"\",\"intranet_api_server_endpoint\":\"https://192.168.xx.xx:6443\"}
    meta_data

    string

    Metadata kluster.

    {\"Addons\":[{\"config\":***}}
    name

    string

    Nama kluster.

    Kluster-demo
    network_mode deprecated

    string

    Modus jaringan kluster. Nilai valid:

    • classic: jaringan klasik.

    • vpc: virtual private cloud (VPC).

    • overlay: jaringan overlay.

    • calico: jaringan Protokol Calico.

    vpc
    next_version

    string

    Versi yang tersedia untuk peningkatan kluster.

    1.xx.x-aliyun.1
    operation_policy

    object

    Kebijakan O&M otomatis kluster.

    cluster_auto_upgrade

    object

    Konfigurasi peningkatan otomatis kluster.

    channel

    string

    Frekuensi peningkatan otomatis kluster. Untuk informasi selengkapnya, lihat Frekuensi peningkatan.

    Nilai valid:

    • patch: versi patch terbaru.

    • stable: versi minor kedua terbaru.

    • rapid: versi minor terbaru.

    patch
    enabled

    boolean

    Apakah peningkatan otomatis kluster diaktifkan.

    true
    private_zone deprecated

    boolean

    Konfigurasi Private Zone kluster. Nilai valid:

    • true: Private Zone diaktifkan.

    • false: Private Zone tidak diaktifkan.

    false
    profile

    string

    Subtipe kluster.

    Default
    proxy_mode

    string

    Modus proxy kube-proxy. Nilai valid:

    • iptables: modus kube-proxy yang matang dan stabil. Penemuan layanan dan load balancing untuk Layanan Kubernetes dikonfigurasi menggunakan aturan iptables. Performanya rata-rata dan dipengaruhi oleh skala kluster. Modus ini cocok untuk kluster yang berisi sejumlah kecil Layanan.

    • ipvs: modus kube-proxy Tingkat Tinggi. Penemuan layanan dan load balancing untuk Layanan Kubernetes dikonfigurasi menggunakan modul Linux IPVS. Modus ini cocok untuk kluster yang berisi sejumlah besar Layanan dan memerlukan load balancing Tingkat Tinggi.

    ipvs
    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-2vcgwsrwgt5mp0yi****
    service_cidr

    string

    Blok CIDR layanan.

    172.21.xx.xx/20
    size

    integer

    Jumlah node saat ini di kluster, termasuk node master dan node worker.

    5
    state

    string

    Status kluster. Nilai valid:

    • initial: Kluster sedang dibuat.

    • failed: Kluster gagal dibuat.

    • running: Kluster sedang 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: Kluster gagal dihapus.

    • waiting: Kluster dalam status menunggu untuk dihubungkan.

    • disconnected: Kluster terputus.

    Berjalan
    subnet_cidr deprecated

    string

    [Deprecated] Gunakan container_cidr untuk mendapatkan blok CIDR kontainer.

    null
    tags

    array

    Tag sumber daya kluster.

    tag

    Tag sumber daya kluster.

    timezone

    string

    Zona waktu.

    Asia/Shanghai
    updated

    string

    Waktu terakhir kluster diperbarui.

    2025-04-07T09:57:26+08:00
    vpc_id

    string

    ID VPC yang terkait dengan kluster.

    vpc-2vcg932hsxsxuqbgl****
    vswitch_id deprecated

    string

    ID vSwitch kluster.

    vsw-2vc41xuumx5z2rdma****,vsw-2vc41xuumx5z2rdma****
    vswitch_ids

    array

    vSwitch untuk lapisan kontrol kluster.

    string

    vSwitch untuk lapisan kontrol kluster.

    vsw-2vc41xuumx5z2rdma****
    worker_ram_role_name deprecated

    string

    Nama peran RAM worker yang memberikan izin kepada instans ECS untuk menjadi node worker kluster.

    KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****
    zone_id deprecated

    string

    ID zona kluster.

    cn-beijing-b
    page_info

    object

    Informasi paginasi.

    page_number

    integer

    Nomor halaman.

    3
    page_size

    integer

    Jumlah entri per halaman.

    20
    total_count

    integer

    Jumlah total hasil.

    50

    Contoh

    Respons sukses

    JSONformat

    {
  "clusters": [
    {
      "cluster_domain": "Kluster.local",
      "cluster_id": "c3fb96524f9274b4495df0f12a6b5****",
      "cluster_spec": "ack.standard",
      "cluster_type": "Kubernetes",
      "container_cidr": "172.20.xx.xx/16",
      "created": "2025-04-07T09:57:26+08:00",
      "current_version": "1.32.1-aliyun.1",
      "deletion_protection": true,
      "docker_version": "19.03.5",
      "external_loadbalancer_id": "lb-2vcrbmlevo6kjpgch****",
      "init_version": "1.32.1-aliyun.1",
      "ip_stack": "ipv4",
      "maintenance_window": {
        "duration": "3h",
        "enable": false,
        "exclusions": [
          {
            "description": "Semua perubahan dilarang selama periode pembekuan",
            "end_time": "2026-11-15T00:00:00+08:00",
            "scope": "NoOperations",
            "start_time": "2026-11-01T00:00:00+08:00"
          }
        ],
        "maintenance_time": "2020-10-15T12:31:00.000+08:00",
        "recurrence": "FREQ=WEEKLY;INTERVAL=4;BYDAY=MO,TU",
        "weekly_period": "Monday,Thursday"
      },
      "master_url": "{\\\"api_server_endpoint\\\":\\\"\\\",\\\"intranet_api_server_endpoint\\\":\\\"https://192.168.xx.xx:6443\\\"}",
      "meta_data": "{\\\"Addons\\\":[{\\\"config\\\":***}}",
      "name": "Kluster-demo",
      "network_mode": "vpc",
      "next_version": "1.xx.x-aliyun.1",
      "operation_policy": {
        "cluster_auto_upgrade": {
          "channel": "patch",
          "enabled": true
        }
      },
      "private_zone": false,
      "profile": "Default",
      "proxy_mode": "ipvs",
      "region_id": "cn-beijing",
      "resource_group_id": "rg-acfmyvw3wjm****",
      "security_group_id": "sg-2vcgwsrwgt5mp0yi****",
      "service_cidr": "172.21.xx.xx/20",
      "size": 5,
      "state": "Berjalan",
      "subnet_cidr": "null",
      "tags": [
        {
          "key": "env",
          "value": "prod"
        }
      ],
      "timezone": "Asia/Shanghai",
      "updated": "2025-04-07T09:57:26+08:00",
      "vpc_id": "vpc-2vcg932hsxsxuqbgl****",
      "vswitch_id": "vsw-2vc41xuumx5z2rdma****,vsw-2vc41xuumx5z2rdma****",
      "vswitch_ids": [
        "vsw-2vc41xuumx5z2rdma****"
      ],
      "worker_ram_role_name": "KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****",
      "zone_id": "cn-beijing-b"
    }
  ],
  "page_info": {
    "page_number": 3,
    "page_size": 20,
    "total_count": 50
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.