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

Adiciona nós somente leitura a um cluster PolarDB.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-************
DBClusterId	string	Sim	O ID do cluster.	pc-*************
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor. Certifique-se de que o valor seja exclusivo entre diferentes solicitações. O token diferencia maiúsculas de minúsculas e pode conter apenas caracteres ASCII. O token pode ter até 64 caracteres.	6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
EndpointBindList	string	Não	O ID do endpoint do cluster ao qual você deseja adicionar o novo nó. Se desejar adicionar o nó a vários endpoints, separe os IDs dos endpoints com vírgulas (,). Nota Você pode chamar a operação DescribeDBClusterEndpoints para consultar os detalhes dos endpoints do cluster, incluindo os IDs dos endpoints. Você pode especificar os IDs do endpoint padrão do cluster e dos endpoints personalizados do cluster. Se você deixar este parâmetro vazio, o novo nó será adicionado a todos os endpoints do cluster que tenham o recurso Associar novos nós automaticamente ativado (o valor de `AutoAddNewNodes` é `Enable`).	pe-**************,pe-**************
PlannedStartTime	string	Não	O horário mais cedo para começar a executar a tarefa agendada para adicionar nós. Especifique o horário no formato `YYYY-MM-DDThh:mm:ssZ` (UTC). Nota O horário de início deve estar dentro das próximas 24 horas. Por exemplo, se o horário atual for `2021-01-14T09:00:00Z`, você poderá especificar um horário de início dentro do intervalo de `2021-01-14T09:00:00Z` a `2021-01-15T09:00:00Z`. Se você deixar este parâmetro vazio, a tarefa para adicionar nós será executada imediatamente.	2021-01-14T09:00:00Z
PlannedEndTime	string	Não	O horário mais tarde para começar a executar a tarefa agendada. Especifique o horário no formato `YYYY-MM-DDThh:mm:ssZ` (UTC). Nota O horário mais tarde deve ser pelo menos 30 minutos após o horário de início. Se você especificar `PlannedStartTime` mas deixar este parâmetro vazio, o horário mais tarde será padronizado para `horário de início + 30 minutos`. Por exemplo, se você definir `PlannedStartTime` como `2021-01-14T09:00:00Z` e deixar este parâmetro vazio, a tarefa começará no máximo às `2021-01-14T09:30:00Z`.	2021-01-14T09:30:00Z
DBNode	array<object>	Sim	As informações sobre o novo nó.
	object	Não
TargetClass	string	Não	A especificação do novo nó. A especificação deve ser a mesma dos nós existentes. Para obter mais informações, consulte os seguintes tópicos: PolarDB for MySQL: Especificações de nós de computação. PolarDB for PostgreSQL (Compatible with Oracle): Especificações de nós de computação. PolarDB for PostgreSQL: Especificações de nós de computação. Nota Você deve especificar pelo menos um entre DBNode.N.ZoneId e DBNode.N.TargetClass. N é um número inteiro que começa em 1. Valor máximo de N = 16 - número atual de nós. Apenas os clusters PolarDB for MySQL suportam a adição de vários nós somente leitura ao mesmo tempo. Você pode adicionar até 15 nós somente leitura. Este parâmetro é obrigatório para clusters PolarDB for PostgreSQL (Compatible with Oracle) ou PolarDB for PostgreSQL. Este parâmetro é opcional para clusters PolarDB for MySQL.	polar.mysql.x4.medium
ZoneId	string	Não	A zona do novo nó. A zona deve ser a mesma dos nós existentes. Você pode chamar a operação DescribeRegions para consultar os IDs de zona. Nota Você deve especificar pelo menos um entre DBNode.N.ZoneId e DBNode.N.TargetClass. N é um número inteiro que começa em 1. Valor máximo de N = 16 - número atual de nós. Apenas os clusters PolarDB for MySQL suportam a adição de vários nós somente leitura ao mesmo tempo. Você pode adicionar até 15 nós somente leitura. Este parâmetro é obrigatório para clusters PolarDB for PostgreSQL (Compatible with Oracle) ou PolarDB for PostgreSQL. Este parâmetro é opcional para clusters PolarDB for MySQL.	cn-qingdao-c
DBNodeType	string	Não	O tipo de nó. Valores válidos: RO STANDBY DLNode. Valores válidos: DLNode : Nó de IA. STANDBY : Nó em standby. RO : Nó somente leitura.	RO
ImciSwitch	string	Não	Especifica se o In-Memory Column Index (IMCI) deve ser ativado. Valores válidos: ON: ativado. OFF: desativado. Este é o valor padrão. Nota O PolarDB for PostgreSQL (Compatible with Oracle) e o PolarDB for PostgreSQL não suportam este parâmetro.	ON
CloudProvider	string	Não	O provedor de serviços de nuvem ao qual o nó pertence.	ENS
AutoUseCoupon	boolean	Não	Especifica se os cupons devem ser usados automaticamente. Valores válidos: true (padrão): Usar cupons. false: Não usar cupons.
PromotionCode	string	Não	O código do cupom. Se você não especificar este parâmetro, o cupom padrão será usado.	727xxxxxx934

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
DBNodeIds	object
DBNodeId	array	A lista de DBNodeIds criados.
	string	A lista de DBNodeIds criados.	pi-***************
RequestId	string	O ID da solicitação.	E053E730-5755-4AA9-AA9D-A47867******
DBClusterId	string	O ID do cluster.	pc-***************
OrderId	string	O ID do pedido.	2148126708*****

Exemplos

Resposta de sucesso

JSON formato

{
  "DBNodeIds": {
    "DBNodeId": [
      "pi-***************"
    ]
  },
  "RequestId": "E053E730-5755-4AA9-AA9D-A47867******",
  "DBClusterId": "pc-***************",
  "OrderId": "2148126708*****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ORDER.ARREARAGE	您有欠费账单，不符合购买条件，请先结清账单后再购买	You must settle the overdue payments for your account before you can make a purchase.
400	InvalidDBNodeNum.Malformed	The number of parameter DBNode.N is not valid.	The specified number of database nodes is invalid.
400	InvalidDBNode.Malformed	The specified parameter DBNode.N is not valid.	The specified DBNode.N parameter is invalid.
400	OperationDenied.CreateDBNodesWithStrictConsistencyOn	3AZ cluster does not allow create db nodes.	Nodes cannot be added for multi-zone clusters.
400	InvalidZoneId.Malformed	The specified parameter ZoneId is not valid.	The specified ZoneId parameter is invalid.
403	OperationDenied.ClusterCategory	The operation is not permitted due to cluster category.	This series is not supported by the cluster.
403	OperationDenied.DbVersion	The operation is not permitted due to DbVersion.	This operation is not supported by the database version.
404	InvalidDBClusterId.NotFound	The DBClusterId provided does not exist in our records.	The specified DBClusterId parameter does not exist in the current record.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	The specified DBClusterId parameter is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.