DescribeAIDBClusterAttribute - PolarDB: Central de Documentação do Alibaba Cloud

Consulta os detalhes de uma instância personalizada.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:DescribeAIDBClusterAttribute

get

*AICluster.

acs:polardb:{#regionId}:{#accountId}:aicluster/{#DBClusterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster.	pc-****************

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	EBEAA83D-1734-42E3-85E3-E25F6E******
DBClusterId	string	O ID do cluster.	pc-**************
DBClusterStatus	string	O status do cluster. Valores válidos: Creating: sendo criado Running: em execução Deleting: sendo liberado DBNodeCreating: adicionando um nó DBNodeDeleting: excluindo um nó ClassChanging: alterando especificações do nó Deleted: liberado	Running
DBClusterDescription	string	A descrição do cluster. Há suporte para correspondência difusa.	test
RegionId	string	O ID da região.	cn-hangzhou
ZoneId	string	O ID da zona do nó do cluster PolarDB.	cn-hangzhou-d
VPCId	string	O ID da VPC especificado para a troca de zona.	vpc-*******************
VSwitchId	string	O ID do vSwitch. Nota Se VPCId for especificado, VSwitchId será obrigatório.	vsw-*********************
InternalIp	string	O endereço IP interno.	10...72
StorageType	string	Valores válidos para o tipo de armazenamento da Enterprise Edition: PSL5 PSL4 Valores válidos para o tipo de armazenamento da Standard Edition: ESSDPL0 ESSDPL1 ESSDPL2 ESSDPL3 ESSDAUTOPL	essdpl1
DBNodes	array<object>	Os detalhes dos nós.
	array<object>	Os detalhes dos nós.
DBNodeClass	string	As especificações do cluster.	polar.pg.g8.8xlarge.gu30
CpuCores	string	O número de núcleos de CPU do nó.	2
MemorySize	string	O tamanho da memória do nó. Unidade: MB.	8192
GPU	string	O número de placas GPU.	2
DBNodeId	string	O ID do nó.	pi-****************
DBNodeDescription	string	A descrição do nó.	test
VSwitchId	string	O ID do vSwitch.	vsw-*********************
VPCId	string	O ID da VPC.	vpc-*******************
DBNodeStatus	string	O status do nó. Valores válidos: Creating: sendo criado Running: em execução Deleting: sendo excluído Rebooting: sendo reiniciado DBNodeCreating: adicionando um nó DBNodeDeleting: excluindo um nó ClassChanging: alterando especificações do nó MinorVersionUpgrading: atualizando a versão secundária Maintaining: em manutenção Switching: sendo trocado	Running
ZoneId	string	O ID da zona.	cn-hangzhou-d
VNodeId	string	O ID do nó virtual do Kubernetes.	vn-***************
LinkIP	string	O endereço IP privado.	10..12
ChildVolumes	array<object>	A lista de discos em nuvem de dados.
	object	As informações do disco em nuvem de dados.
StorageType	string	The storage class.	PL1
StorageCategory	string	The storage type.	PolarFs
SizeGB	string	The storage size.	8192
Name	string	The cloud disk name.	jueming
MountPath	string	The actual mount path.	/tmp/CrowdStrike
PublicIp	string	O endereço IP público.	101.101.101.101
CreationTime	string	A hora de criação.	2020-08-14T05:58:42Z
LockMode	string	O modo de bloqueio da instância. O valor lock indica que a instância expirou automaticamente ou possui pagamento em atraso.	Unlock
CreationTime	string	A hora de criação do cluster.	2020-08-14T05:58:42Z
PayType	string	O método de cobrança. Valores válidos: Postpaid: pay-as-you-go. Prepaid: assinatura.	Postpaid
ExpireTime	string	A hora de expiração do cluster. Nota Este parâmetro retorna um valor apenas para clusters cujo método de cobrança é Prepaid (assinatura). Um valor vazio é retornado para clusters Postpaid (pay-as-you-go).	2020-11-14T16:00:00Z
Expired	boolean	Indica se o cluster expirou. Valores válidos: true false	false
ZoneIds	string	Os IDs das zonas.	cn-hangzhou-i,cn-hangzhou-g
RunType	string	O tipo de arquitetura. Valores válidos: container: contêiner de IA ainode: nó de IA	container
KubeClusterId	string	O ID do cluster ACK.	xxxxxxxxxxxxxxxxxxxxxxx
DBVersion	string	A versão do cluster. Valores válidos: 1.0 2.0 3.0	1.0
AiNodeType	string	O tipo de nó. Valores válidos: vnode: gerenciado pelo ACK container: contêiner com login permitido maas: serviço de modelo	vnode
Volumes	array<object>	A lista de discos em nuvem de dados.
	object	As informações do disco em nuvem de dados.
StorageType	string	A classe de armazenamento.	PolarFs
StorageCategory	string	O tipo de armazenamento.	PL1
Name	string	O nome do disco em nuvem.	jueming
SizeGB	string	O tamanho do armazenamento.	8192
MountPath	string	O caminho de montagem dentro do contêiner.	/var/run/secrets/kubernetes.io/serviceaccount
EndpointList	array<object>	A lista de endereços de conexão de rede da instância.
	array<object>	O endereço de conexão de rede da instância.
NetInfoItems	array<object>	A lista de informações de rede da instância.
	object	As informações de rede da instância.
NetType	string	The network type of the connection string. Valid values: Public: public endpoint Private: private endpoint Inner: private endpoint (classic network).	Public
ConnectionString	string	The database connection address.	pc-**********.rwlb.rds.aliyuncs.com
Port	string	The port number.	3306
ModelName	string	O nome do modelo.	Qwen3-Embedding-8B
GatewayId	string
MaxQPM	string	O número máximo de solicitações por minuto.	20
PublicIp	string	O endereço IP público.	8.xxx.xxx.xxx
KVCacheInstanceId	string	O ID da instância KVCache.	pkv-xxxxx
EcsSecurityGroupId	string	O ID do grupo de segurança.	sg-xxxxxx
ModelType	string	O tipo de modelo.	custom
ApiKey	string	A chave da API.	x********
TimeSlicesType	string
VnodeKubernetesConfig	object
Labels	array<object>
	object
Key	string
Value	string
Taints	array<object>
	object
Key	string
Value	string
Effect	string
TimeSlicesInfo	object
TimeSlices	array<object>
	object
BeginTime	string
EndTime	string

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "EBEAA83D-1734-42E3-85E3-E25F6E******",
  "DBClusterId": "pc-**************",
  "DBClusterStatus": "Running",
  "DBClusterDescription": "test",
  "RegionId": "cn-hangzhou",
  "ZoneId": "cn-hangzhou-d\t\n",
  "VPCId": "vpc-*******************",
  "VSwitchId": "vsw-*********************",
  "InternalIp": "10.*.*.72",
  "StorageType": "essdpl1",
  "DBNodes": [
    {
      "DBNodeClass": "\npolar.pg.g8.8xlarge.gu30",
      "CpuCores": "2",
      "MemorySize": "8192",
      "GPU": "2",
      "DBNodeId": "pi-****************",
      "DBNodeDescription": "test",
      "VSwitchId": "vsw-*********************",
      "VPCId": "vpc-*******************",
      "DBNodeStatus": "Running",
      "ZoneId": "cn-hangzhou-d\t\n",
      "VNodeId": "vn-***************",
      "LinkIP": "10.*.*12",
      "ChildVolumes": [
        {
          "StorageType": "PL1",
          "StorageCategory": "PolarFs",
          "SizeGB": "8192",
          "Name": "jueming",
          "MountPath": "/tmp/CrowdStrike"
        }
      ],
      "PublicIp": "101.101.101.101",
      "CreationTime": "2020-08-14T05:58:42Z"
    }
  ],
  "LockMode": "Unlock",
  "CreationTime": "2020-08-14T05:58:42Z",
  "PayType": "Postpaid",
  "ExpireTime": "2020-11-14T16:00:00Z",
  "Expired": false,
  "ZoneIds": "cn-hangzhou-i,cn-hangzhou-g",
  "RunType": "container",
  "KubeClusterId": "xxxxxxxxxxxxxxxxxxxxxxx",
  "DBVersion": "1.0",
  "AiNodeType": "vnode",
  "Volumes": [
    {
      "StorageType": "PolarFs",
      "StorageCategory": "PL1",
      "Name": "jueming",
      "SizeGB": "8192",
      "MountPath": "/var/run/secrets/kubernetes.io/serviceaccount"
    }
  ],
  "EndpointList": [
    {
      "NetInfoItems": [
        {
          "NetType": "Public",
          "ConnectionString": "pc-**********.rwlb.rds.aliyuncs.com",
          "Port": "3306"
        }
      ]
    }
  ],
  "ModelName": "\nQwen3-Embedding-8B",
  "GatewayId": "",
  "MaxQPM": "20",
  "PublicIp": "8.xxx.xxx.xxx",
  "KVCacheInstanceId": "pkv-xxxxx",
  "EcsSecurityGroupId": "sg-xxxxxx",
  "ModelType": "custom",
  "ApiKey": "x********",
  "TimeSlicesType": "",
  "VnodeKubernetesConfig": {
    "Labels": [
      {
        "Key": "",
        "Value": ""
      }
    ],
    "Taints": [
      {
        "Key": "",
        "Value": "",
        "Effect": ""
      }
    ]
  },
  "TimeSlicesInfo": {
    "TimeSlices": [
      {
        "BeginTime": "",
        "EndTime": ""
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	O DBClusterId especificado não existe em nossos registros.
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.	O DBClusterId especificado não existe nos registros atuais.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.