Lista todos os clusters em uma região especificada.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
cs:DescribeClustersForRegion |
list |
*All Resource
|
Nenhuma | Nenhuma |
Sintaxe da solicitação
GET /regions/{region_id}/clusters HTTP/1.1Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| region_id |
string |
Sim |
O ID da região. |
cn-hangzhou |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| name |
string |
Não |
O nome do cluster. A pesquisa difusa é suportada. |
test-cluster |
| cluster_type |
string |
Não |
O tipo do cluster. Valores válidos:
Valores válidos:
|
Kubernetes |
| page_size |
integer |
Não |
O número de entradas por página. |
3 |
| page_number |
integer |
Não |
O número da página. |
10 |
| profile |
string |
Não |
O subtipo do cluster. Valores válidos:
Valores válidos:
|
Serverless |
| cluster_spec |
string |
Não |
A especificação do cluster. Valores válidos:
Pro XL, Pro 2XL e Pro 4XL são três níveis do plano de controle provisionado do ACK Pro. Esses níveis garantem um alto nível consistente de concorrência de API e capacidades de agendamento de pods por meio da pré-alocação e dedicação de recursos do plano de controle. São adequados para treinamento e inferência de IA, clusters de grande escala e serviços de missão crítica. Para informações sobre a taxa de gerenciamento de cluster para a edição Pro e as edições de plano de controle provisionado, consulte taxa de gerenciamento de cluster. Valores válidos:
|
ack.standard |
| cluster_id |
string |
Não |
O ID do cluster. |
c8155823d057948c69a**** |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O corpo da resposta. |
||
| clusters |
array<object> |
Uma lista de detalhes dos clusters. |
|
|
object |
Os detalhes de um cluster. |
||
| cluster_id |
string |
O ID do cluster. |
c905d1364c2dd4b6284a3f41790c4**** |
| cluster_type |
string |
O tipo do cluster. Valores válidos:
|
ManagedKubernetes |
| created |
string |
A hora em que o cluster foi criado. |
2020-12-01T20:40:40+08:00 |
| init_version |
string |
A versão inicial do cluster. |
1.16.6-aliyun.1 |
| current_version |
string |
A versão atual do cluster. |
1.16.6-aliyun.1 |
| next_version |
string |
A versão para a qual o cluster pode ser atualizado. |
1.18.8-aliyun.1 |
| deletion_protection |
boolean |
Especifica se a proteção contra exclusão está ativada. Se este parâmetro estiver definido como true, o cluster não poderá ser excluído no console ou por uma chamada de API. Valores válidos:
|
false |
| name |
string |
O nome do cluster. |
test-cluster |
| profile |
string |
O subtipo do cluster. Valores válidos:
|
Default |
| region_id |
string |
O ID da região. |
cn-beijing-a |
| resource_group_id |
string |
O ID do grupo de recursos ao qual o cluster pertence. |
rg-acfmyvw3wjm**** |
| security_group_id |
string |
O ID do grupo de segurança ao qual o cluster pertence. |
sg-2zeihch86ooz9io4**** |
| container_cidr |
string |
O bloco CIDR da rede de Pods. |
172.20.0.0/16 |
| service_cidr |
string |
O bloco CIDR de serviço. |
172.21.0.0/20 |
| proxy_mode |
string |
O modo kube-proxy do cluster. Valores válidos:
|
ipvs |
| timezone |
string |
O fuso horário do cluster. |
Asia/Shanghai |
| ip_stack |
string |
A pilha IP do cluster. |
ipv4 |
| cluster_domain |
string |
O domínio do cluster. |
cluster.local |
| size |
integer |
O número de nós no cluster. |
2 |
| state |
string |
O estado do ciclo de vida do cluster. Valores válidos:
|
running |
| tags |
array |
Uma lista de tags do cluster. |
|
| tag |
Uma tag do cluster. |
||
| updated |
string |
A hora da última atualização do cluster. |
2020-12-08T15:37:00+08:00 |
| vpc_id |
string |
O ID da VPC onde o cluster está implantado. |
vpc-2zeg8nf1ukc0fcmvq**** |
| vswitch_ids |
array |
Uma lista de IDs de vSwitch para o plano de controle do cluster. |
|
|
string |
O ID do vSwitch para o plano de controle. |
vsw-2vc41xuumx5z2rdma**** |
|
| cluster_spec |
string |
A especificação do cluster. Valores válidos:
Pro XL, Pro 2XL e Pro 4XL são três especificações disponíveis para o plano de controle provisionado do ACK Pro. Essas especificações pré-alocam e dedicam recursos do plano de controle para garantir alta concorrência de API e capacidades de agendamento de Pods. São adequadas para treinamento e inferência de IA, clusters de grande escala e serviços de missão crítica. Para informações sobre as taxas de gerenciamento de cluster para a edição Pro e as edições de plano de controle provisionado, consulte Taxa de gerenciamento de cluster. |
ack.standard |
| page_info |
object |
As informações de paginação. |
|
| page_number |
integer |
O número da página. |
1 |
| page_size |
integer |
O número de entradas por página. |
10 |
| total_count |
integer |
O número total de entradas. |
10 |
Exemplos
Resposta de sucesso
JSON formato
{
"clusters": [
{
"cluster_id": "c905d1364c2dd4b6284a3f41790c4****",
"cluster_type": "ManagedKubernetes",
"created": "2020-12-01T20:40:40+08:00",
"init_version": "1.16.6-aliyun.1",
"current_version": "1.16.6-aliyun.1",
"next_version": "1.18.8-aliyun.1",
"deletion_protection": false,
"name": "test-cluster",
"profile": "Default",
"region_id": "cn-beijing-a",
"resource_group_id": "rg-acfmyvw3wjm****",
"security_group_id": "sg-2zeihch86ooz9io4****",
"container_cidr": "172.20.0.0/16",
"service_cidr": "172.21.0.0/20",
"proxy_mode": "ipvs",
"timezone": "Asia/Shanghai",
"ip_stack": "ipv4",
"cluster_domain": "cluster.local",
"size": 2,
"state": "running",
"tags": [
{
"key": "env",
"value": "prod"
}
],
"updated": "2020-12-08T15:37:00+08:00",
"vpc_id": "vpc-2zeg8nf1ukc0fcmvq****",
"vswitch_ids": [
"vsw-2vc41xuumx5z2rdma****"
],
"cluster_spec": "ack.standard"
}
],
"page_info": {
"page_number": 1,
"page_size": 10,
"total_count": 10
}
}Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.