Mencantumkan kluster Azure Kubernetes Service (AKS) yang berjalan dalam langganan Azure

Anda dapat mencantumkan kluster Azure Kubernetes Service (AKS) dalam langganan dengan menggunakan portal Azure, Azure CLI, atau AKS REST API. Gunakan hasil Azure CLI atau REST API untuk mengidentifikasi kluster mana yang berjalan.

Sebelum Anda mulai

Memahami status kluster AKS

Detail kluster AKS mencakup status daya dan status provisi:

  • Properti powerState.code menunjukkan apakah kluster adalah Running atau Stopped.
  • Properti provisioningState menunjukkan status operasi sumber daya Azure terbaru, seperti Succeeded, , CreatingStarting, atau Stopping.

Untuk menentukan apakah kluster saat ini berjalan, gunakan powerState.code. provisioningState Nilai Succeeded tidak menunjukkan apakah kluster berjalan karena kluster yang dihentikan juga dapat memiliki status provisi yang berhasil.

Mencantumkan kluster AKS di portal Azure

  1. Masuk ke portal Azure.
  2. Di kotak pencarian portal, masukkan layanan Kubernetes, lalu pilih layanan Kubernetes.
  3. Pilih langganan yang berisi kluster AKS Anda. Anda juga dapat memfilter daftar menurut grup sumber daya, lokasi, atau properti lain yang tersedia.
  4. Pilih nama kluster untuk membuka halaman Gambaran Umum dan melihat konfigurasinya.

Pada halaman kluster, pilih Sambungkan untuk mendapatkan instruksi koneksi. Untuk melihat sumber daya dalam kluster yang sedang berjalan, pilih Sumber daya Kubernetes. Anda memerlukan izin untuk kluster AKS, API Kubernetes, dan objek Kubernetes. Untuk informasi selengkapnya, lihat Mengakses sumber daya Kubernetes dengan menggunakan portal Azure.

Prosedur portal mencantumkan dan membuka kluster. Untuk menentukan status daya kluster secara konsisten di seluruh langganan, gunakan metode Azure CLI atau REST API dalam artikel ini dan periksa powerState.code.

Mencantumkan kluster AKS dengan menggunakan Azure CLI

  1. Masuk ke Azure.

    az login

  2. Jika Anda memiliki akses ke beberapa langganan, atur langganan yang berisi kluster AKS.

    az account set --subscription <subscription-id>

  3. Cantumkan kluster AKS dalam langganan yang dipilih. Perintah berikut menampilkan nama, grup sumber daya, lokasi, status daya, dan status provisi setiap kluster:

    az aks list --query "[].{Name:name, ResourceGroup:resourceGroup, Location:location, PowerState:powerState.code, ProvisioningState:provisioningState}" --output table

    Hasil menyerupai contoh berikut:

    Name          ResourceGroup    Location    PowerState    ProvisioningState
------------  ---------------  ----------  ------------  -------------------
aks-prod      rg-aks-prod      eastus      Running       Succeeded
aks-dev       rg-aks-dev       westus2     Stopped       Succeeded

    Untuk mencantumkan kluster dalam grup sumber daya tertentu, tambahkan --resource-group parameter .

    az aks list --resource-group <resource-group-name> --query "[].{Name:name, PowerState:powerState.code}" --output table

  4. Untuk hanya mencantumkan kluster yang berjalan, filter pada powerState.code.

    az aks list --query "[?powerState.code=='Running'].{Name:name, ResourceGroup:resourceGroup, Location:location}" --output table

Untuk informasi selengkapnya tentang perintah dan opsi outputnya, lihat az aks list referensi.

Mencantumkan kluster AKS dengan menggunakan REST API

Gunakan operasi Kluster Terkelola - Daftar untuk mendapatkan kluster AKS dalam langganan. Kirim permintaan berikut, ganti <subscription-id> dengan ID langganan Azure Anda:

GET https://management.azure.com/subscriptions/<subscription-id>/providers/Microsoft.ContainerService/managedClusters?api-version=2025-09-01
Authorization: Bearer <access-token>

Respons berisi value array sumber daya kluster AKS. Ketika properties.powerState.code ada, nilainya menunjukkan apakah kluster adalah Running atau Stopped. Jika powerState hilang atau null, perlakukan status daya kluster sebagai tidak diketahui; jangan menyimpulkannya dari provisioningState. Jika respons menyertakan nextLink, kirim permintaan GET ke URL tersebut untuk mengambil halaman hasil berikutnya.

Important

Azure mengekspos sumber daya kluster Kubernetes untuk beberapa layanan. Operasi Azure Operator Nexus Network Cloud menggunakan Microsoft.NetworkCloud/kubernetesClusters jenis sumber daya dan tidak mencantumkan kluster AKS. Untuk mencantumkan kluster AKS, gunakan operasi yang Microsoft.ContainerService/managedClusters ditunjukkan dalam artikel ini.

Langkah berikutnya

  • Terakhir diperbarui pada