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

Cria um endpoint de cluster personalizado para um cluster PolarDB no ENS.

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

create

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

GET  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster.	pc-***************
EndpointType	string	Sim	O tipo do endpoint de cluster personalizado. Defina o valor como Custom.	Custom
Nodes	string	Não	Os nós de leitura a serem adicionados ao endpoint. Separe vários nós com vírgulas (,). Por padrão, todos os nós são incluídos.	pi-************,pi-***********
ReadWriteMode	string	Não	O modo de leitura/gravação. Valores válidos: ReadWrite: leitura/gravação (divisão automática de leitura/gravação). ReadOnly (padrão): somente leitura.	ReadOnly
AutoAddNewNodes	string	Não	Especifica se novos nós são adicionados automaticamente a este endpoint. Valores válidos: Enable: novos nós são adicionados automaticamente a este endpoint. Disable (padrão): novos nós não são adicionados automaticamente a este endpoint. Valores válidos: Enable : Novos nós são adicionados automaticamente a este endpoint. Disable : Novos nós não são adicionados automaticamente a este endpoint.	Disable
EndpointConfig	string	Não	As configurações avançadas do endpoint de cluster no formato JSON. Você pode configurar o nível de consistência, a divisão de transações, o descarregamento de leituras do nó primário e as configurações do pool de conexões. Configure a política de balanceamento de carga. Formato: {"LoadBalancePolicy":"Política de balanceamento de carga"}. Valores válidos: 0: balanceamento de carga baseado em conexão (padrão). 1: balanceamento de carga baseado em solicitação ativa. Configure o nível de consistência. Formato: `{"ConsistLevel":"Nível de consistência"}`. Valores válidos: 0: consistência eventual. 1: consistência de sessão (padrão). 2: consistência global. Configure a divisão de transações. Formato: `{"DistributedTransaction":"Divisão de transações"}`. Valores válidos: on: ativa a divisão de transações (padrão). off: desativa a divisão de transações. Configure se o nó primário aceita solicitações de leitura. Formato: `{"MasterAcceptReads":"Descarregamento de leituras do nó primário"}`. Valores válidos: on: o nó primário aceita solicitações de leitura. off: o nó primário não aceita solicitações de leitura (padrão). Configure o pool de conexões. Formato: `{"ConnectionPersist":"Pool de conexões"}`. Valores válidos: off: desativa o pool de conexões (padrão). Session: ativa o pool de conexões no nível de sessão. Transaction: ativa o pool de conexões no nível de transação. Configure a consulta paralela. Formato: {"MaxParallelDegree":"Consulta paralela"}. Valores válidos: Um grau específico de paralelismo. Exemplo: "MaxParallelDegree":"2". off: desativa a consulta paralela (padrão). Configure a distribuição automática de solicitações entre nós de armazenamento de linhas e armazenamento de colunas. Formato: {"EnableHtapImci":"Distribuição automática de solicitações entre armazenamento de linhas e armazenamento de colunas"}. Valores válidos: on: ativa a distribuição automática de solicitações entre nós de armazenamento de linhas e armazenamento de colunas. off: desativa a distribuição automática de solicitações entre nós de armazenamento de linhas e armazenamento de colunas (padrão). Configure se a proteção contra sobrecarga deve ser ativada. Formato: {"EnableOverloadThrottle":"Ativar proteção contra sobrecarga"}. Valores válidos: on: ativa a proteção contra sobrecarga. off: desativa a proteção contra sobrecarga (padrão). Nota A divisão de transações, o descarregamento de leituras do nó primário, o pool de conexões e a proteção contra sobrecarga podem ser configurados apenas quando o modo de leitura/gravação do endpoint de cluster do PolarDB for MySQL estiver definido como leitura/gravação (divisão automática de leitura/gravação). Quando o modo de leitura/gravação do endpoint de cluster do PolarDB for MySQL for somente leitura, tanto o balanceamento de carga baseado em conexão quanto o balanceamento de carga baseado em solicitação ativa são suportados. Quando o modo de leitura/gravação for leitura/gravação (divisão automática de leitura/gravação), apenas o balanceamento de carga baseado em solicitação ativa é suportado. A distribuição automática de solicitações entre nós de armazenamento de linhas e armazenamento de colunas pode ser configurada quando o modo de leitura/gravação do endpoint de cluster do PolarDB for MySQL for leitura/gravação (divisão automática de leitura/gravação), ou quando o modo de leitura/gravação for somente leitura e a política de balanceamento de carga for balanceamento de carga baseado em solicitação ativa. Apenas o PolarDB for MySQL suporta a definição do nível de consistência como consistência global. Se o parâmetro ReadWriteMode estiver definido como ReadOnly, o nível de consistência só poderá ser definido como 0. Você pode configurar o nível de consistência, a divisão de transações, o descarregamento de leituras do nó primário e o pool de conexões ao mesmo tempo. Exemplo: `{"ConsistLevel":"1","DistributedTransaction":"on","ConnectionPersist":"Session","MasterAcceptReads":"on"}`. A configuração de divisão de transações é restringida pelo nível de consistência. Por exemplo, quando o nível de consistência está definido como 0, a divisão de transações não pode ser ativada. Quando o nível de consistência está definido como 1 ou 2, a divisão de transações pode ser ativada.	{"ConsistLevel": "1","DistributedTransaction": "on"}
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação e evitar envios repetidos. O token é gerado pelo cliente, deve ser exclusivo entre as solicitações, diferencia maiúsculas e minúsculas e não pode exceder 64 caracteres ASCII de comprimento.	6000170000591aed949d0f******************
DBEndpointDescription	string	Não	O nome do endpoint de cluster personalizado.	test
SccMode	string	Não	Especifica se a consistência global (modo de alto desempenho) deve ser ativada para o nó. Valores válidos: ON: Ativado. OFF: Desativado. Valores válidos: off : Desativado. on : Ativado.	on
PolarSccWaitTimeout	string	Não	O período de tempo limite para consistência global.	100
PolarSccTimeoutAction	string	Não	A política de tempo limite para consistência global. Valores válidos: 0: Envia a solicitação para o nó primário. 2: Degradação de tempo limite. Quando uma leitura de consistência global atinge o tempo limite, a consulta é automaticamente degradada para solicitações regulares, e o cliente não recebe uma mensagem de erro.	0

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	CD35F3-F3-44CA-AFFF-BAF869******

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CD35F3-F3-44CA-AFFF-BAF869******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ClusterEndpoint.StatusNotValid	Cluster endpoint status is not valid.	O status do endpoint do cluster é inválido.
400	EndpointNum.Error	Endpoint number error.	O número de endpoints excedeu o limite.
400	LockTimeout	The request processing has failed due to lock timeout.	O processamento da solicitação falhou devido a um tempo limite de bloqueio.
403	OperationDenied.InstanceType	The operation is not permitted due to instance type.	A operação não é permitida devido ao tipo de instância.
404	EndpointConfig.Invalid	Endpoint config is invalid.	Os parâmetros de configuração avançada do endpoint do cluster são inválidos.
404	InvalidDBClusterId.NotFound	The DBClusterId provided does not exist in our records.	O DBClusterId especificado não existe nos registros atuais.
404	EndpointConfig.Conflict	Endpoint config is invalid, CausalConsistRead should be session since node SCC mode enabled.	A configuração do endpoint é inválida. CausalConsistRead deve ser definido como session porque a consistência global (modo de alto desempenho) está ativada para o nó.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.