GetCluster - Enterprise Distributed Application Service

Mengambil informasi kluster tertentu.

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

edas:ReadCluster

get

*Cluster

acs:edas:{#regionId}:{#accountId}:namespace/{#NameSpaceId}/cluster/{#ClusterId}

None

Sintaks permintaan

GET /pop/v5/resource/cluster HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster di Enterprise Distributed Application Service (EDAS). Anda dapat memanggil operasi ListCluster untuk menanyakan ID kluster tersebut. Untuk informasi selengkapnya, lihat ListCluster.	5439271a-015b-433d-**-d76db49**

Elemen respons

Element	Type	Description	Example
	object
Code	integer	Kode status HTTP yang dikembalikan.	200
Message	string	Informasi detail yang dikembalikan.	success
RequestId	string	ID permintaan.	d76db491
Cluster	object	Informasi mengenai kluster.
VpcId	string	ID virtual private cloud (VPC).	vpc-xxxxz1mlwpb****
OversoldFactor	integer	Rasio overcommit yang didukung oleh kluster Docker. Nilai yang valid: 1: 1:1, artinya resource tidak diovercommit. 2: 1:2, artinya resource diovercommit dengan rasio 1:2. 4: 1:4, artinya resource diovercommit dengan rasio 1:4. 8: 1:8, artinya resource diovercommit dengan rasio 1:8.	2
UpdateTime	integer	Waktu terakhir kluster dimodifikasi. Nilai ini merupakan stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC.	1570708232145
MemUsed	integer	Ukuran memori yang digunakan. Satuan: MB.	1024
IaasProvider	string	Penyedia resource Infrastructure as a Service (IaaS) yang digunakan dalam kluster.	ALIYUN
CreateTime	integer	Waktu pembuatan kluster. Nilai ini merupakan stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC.	1570708232145
CpuUsed	integer	Jumlah core CPU yang digunakan.	2
Mem	integer	Total ukuran memori. Satuan: MB.	2048
RegionId	string	ID wilayah tempat kluster berada.	cn-hangzhou
Cpu	integer	Total jumlah core CPU.	4
CsClusterId	string	ID kluster Container Service for Kubernetes (ACK).	c2ce62869f4d4466b920312315f05****
NetworkMode	integer	Jenis jaringan kluster. Nilai yang valid: 1: classic network 2: virtual private cloud (VPC)	2
Description	string	Deskripsi kluster.	测试
ClusterType	integer	Tipe kluster. Nilai yang valid: 0: kluster Docker biasa 1: kluster Swarm 2: kluster Elastic Compute Service (ECS) 3: kluster Kubernetes yang dikelola sendiri di EDAS 4: kluster tempat aplikasi secara otomatis didaftarkan oleh Pandora 5: kluster ACK	2
ClusterName	string	Nama kluster.	ClusterTest
NodeNum	integer	Jumlah instance ECS.	4
ClusterImportStatus	integer	Status impor kluster. Nilai yang valid: 1: Kluster telah diimpor. 2: Impor kluster gagal. 3: Kluster sedang dalam proses impor. 4: Kluster telah dihapus. 0: Kluster belum diimpor.	0
ClusterId	string	ID kluster.	5439271a-015b-433d-befb-d76d****
SubClusterType	string	Subtipe kluster Kubernetes. Nilai yang valid: ManagedKubernetes, Ask, dan ExternalKubernetes. ManagedKubernetes merujuk pada kluster ACK. Ask merujuk pada kluster Serverless Kubernetes (ASK). ExternalKubernetes merujuk pada kluster eksternal.	ManagedKubernetes

Contoh

Respons sukses

JSONformat

{
  "Code": 200,
  "Message": "success",
  "RequestId": "d76db491",
  "Cluster": {
    "VpcId": "vpc-xxxxz1mlwpb****",
    "OversoldFactor": 2,
    "UpdateTime": 1570708232145,
    "MemUsed": 1024,
    "IaasProvider": "ALIYUN",
    "CreateTime": 1570708232145,
    "CpuUsed": 2,
    "Mem": 2048,
    "RegionId": "cn-hangzhou",
    "Cpu": 4,
    "CsClusterId": "c2ce62869f4d4466b920312315f05****",
    "NetworkMode": 2,
    "Description": "测试",
    "ClusterType": 2,
    "ClusterName": "ClusterTest",
    "NodeNum": 4,
    "ClusterImportStatus": 0,
    "ClusterId": "5439271a-015b-433d-befb-d76d****",
    "SubClusterType": "ManagedKubernetes"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.