CreateInstance - Hologres: Central de Documentação do Alibaba Cloud

Cria uma instância Hologres na região especificada.

Descrição da operação

Aviso

Esta operação de API gera custos. Antes de chamar esta operação, certifique-se de que você compreende totalmente os métodos de cobrança e os preços do Hologres.

Para mais informações sobre a cobrança do Hologres, consulte Visão geral de cobrança.
Ao criar uma instância Hologres, você deve especificar a região e a zona da instância. Uma região pode conter várias zonas. A lista a seguir descreve as zonas disponíveis em cada região:

   cn-hangzhou (Hangzhou): cn-hangzhou-h, cn-hangzhou-j, cn-hangzhou-k
   cn-hangzhou (Hangzhou): cn-hangzhou-h, cn-hangzhou-j, cn-hangzhou-k
   cn-shanghai (Shanghai): cn-shanghai-e, cn-shanghai-f, cn-shanghai-l
   cn-beijing (Beijing): cn-beijing-i, cn-beijing-g, cn-beijing-l
   cn-zhangjiakou (Zhangjiakou): cn-zhangjiakou-b
   cn-shenzhen (Shenzhen): cn-shenzhen-d, cn-shenzhen-f, cn-shenzhen-e
   cn-wulanchabu (Ulanqab): cn-wulanchabu-a
   cn-hongkong (Hong Kong): cn-hongkong-b, cn-hongkong-d
   cn-shanghai-finance-1 (Shanghai Finance Cloud): cn-shanghai-finance-1z, cn-shanghai-finance-1f
   cn-hangzhou-finance (Hangzhou Finance Cloud): cn-hangzhou-finance-k
   cn-shenzhen-finance-1 (Shenzhen Finance Cloud): cn-shenzhen-finance-1d
   ap-northeast-1 (Tóquio): ap-northeast-1a
   ap-southeast-1 (Singapura): ap-southeast-1c, ap-southeast-1a
   ap-southeast-3 (Kuala Lumpur): ap-southeast-3b
   ap-southeast-5 (Jacarta): ap-southeast-5b
   eu-central-1 (Frankfurt): eu-central-1a
   us-east-1 (Virgínia): us-east-1a
   us-west-1 (Vale do Silício): us-west-1b

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

hologram:CreateInstance

create

*All Resource

*

Nenhuma

Sintaxe da solicitação

POST /api/v1/instances/create HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	O corpo da solicitação.
regionId	string	Sim	O ID da região. Para mais informações, consulte Endpoints.	cn-hangzhou
zoneId	string	Sim	O ID da zona.	cn-hangzhou-h
vpcId	string	Sim	O ID da rede privada virtual (VPC). A VPC deve estar na mesma região que a instância.	vpc-t4netc3y5xxxx
vSwitchId	string	Sim	O ID do vSwitch. O vSwitch deve estar na mesma zona que a instância.	vsw-2vccsiymtxxxxxx
resourceGroupId	string	Não	O grupo de recursos. Se você deixar este parâmetro vazio, o grupo de recursos padrão da sua conta será utilizado.	""
instanceName	string	Sim	O nome da instância. O nome deve ter de 2 a 64 caracteres. Uma letra é contada como um caractere.	my_holo
instanceType	string	Sim	O tipo da instância. Valores válidos: Standard: Instância de uso geral. Follower: Instância secundária somente leitura. Warehouse: Instância de virtual warehouse. Shared: Instância compartilhada. Serverless: Instância Serverless. Valores válidos: Warehouse : Instância de virtual warehouse. Follower : Instância secundária somente leitura. Standard : Instância de uso geral. Serverless : Instância Serverless. Shared : Instância compartilhada.	Standard
cpu	integer	Não	O tipo da instância. Valores válidos: 32 vCPUs e 128 GB de memória (2 nós de computação) 64 vCPUs e 256 GB de memória (4 nós de computação) 96 vCPUs e 384 GB de memória (6 nós de computação) 128 vCPUs e 512 GB de memória (8 nós de computação) e assim por diante. Nota Especifique o número de vCPUs. Para adquirir uma instância com mais de 1.024 vCPUs, envie um ticket. Não é necessário especificar o tipo de instância para uma instância compartilhada.	64
storageSize	integer	Não	A capacidade de armazenamento padrão da instância. Unidade: GB. Nota Este parâmetro é ignorado para instâncias pay-as-you-go (PostPaid).	500
coldStorageSize	integer	Não	A capacidade de armazenamento frio da instância. Unidade: GB. Nota Este parâmetro é ignorado para instâncias pay-as-you-go (PostPaid).	500
gatewayCount	integer	Não	O número de gateways. Valores válidos: [2, 50]. Nota Você deve especificar este parâmetro apenas para instâncias de virtual warehouse.	4
chargeType	string	Sim	O método de cobrança. Valores válidos: PrePaid: Assinatura. PostPaid: Pay-as-you-go. Nota Este parâmetro é ignorado para instâncias compartilhadas. Instâncias compartilhadas utilizam especificações definidas e o método de cobrança padrão é pay-as-you-go. Valores válidos: PostPaid : Pay-as-you-go. PrePaid : Assinatura.	PostPaid
autoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valores válidos: true (padrão): O pagamento automático é ativado. false: Um pedido é gerado, mas nenhum pagamento é realizado. Nota Se o saldo da sua conta for insuficiente, defina o parâmetro `autoPay` como `false`. Quando um pedido não pago for gerado, faça login no console de Despesas e Custos para pagar o pedido.	true
pricingCycle	string	Não	O ciclo de cobrança. Valores válidos: Month: A instância é cobrada mensalmente. Hour: A instância é cobrada por hora. Nota Instâncias de assinatura suportam apenas `Month`. Instâncias pay-as-you-go suportam apenas `Hour`. Para instâncias compartilhadas, o valor é definido automaticamente como `Hour`. Valores válidos: Month : A instância é cobrada mensalmente. Hour : A instância é cobrada por hora.	Month
duration	integer	Não	A duração da assinatura, como dois meses. Nota Especifique este parâmetro apenas para instâncias de assinatura.	2
autoRenew	boolean	Não	Especifica se a renovação automática deve ser ativada. Valores válidos: true: A renovação automática é ativada. false (padrão): A renovação automática é desativada.	false
leaderInstanceId	string	Não	O ID da instância primária. Este parâmetro é obrigatório para instâncias secundárias. Nota A instância primária e as instâncias secundárias devem atender às seguintes condições: A instância primária deve estar no estado Running. A instância primária e as instâncias secundárias devem estar na mesma região e zona. Elas devem estar na mesma zona. A instância primária deve ter menos de 10 instâncias secundárias. A instância primária e as instâncias secundárias devem pertencer à mesma conta Alibaba Cloud.	hgpostcn-cn-lbj3aworq112
initialDatabases	string	Não	O banco de dados inicial.	chatbot
enableServerlessComputing	boolean	Não	Especifica se o Serverless Computing deve ser ativado. Valores válidos: true : Ativar Serverless Computing. false : Desativar Serverless Computing.	true
storageType	string	Não	A classe de armazenamento. Valores válidos: local : Armazenamento com redundância local. redundant : Armazenamento com redundância de zona.	redundant

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os detalhes da resposta.
RequestId	string	O ID da solicitação.	9CC37B9F-F4B4-5FF1-939B-AEE78DC70130
Data	object	Os resultados retornados.
InstanceId	string	O ID da instância.	hgpostcn-cn-xxxxxx
OrderId	string	O ID do pedido.	217523224780172
Code	string	O código de erro.	InvalidVpcOrVSwitch.NotAvailable
Message	string	Os detalhes do erro.	InvalidVpcOrVSwitch.NotAvailable
Success	string	Indica se a instância foi criada. true: A instância foi criada. false: A criação da instância falhou.	true
HttpStatusCode	string	O código de status HTTP.	200
ErrorMessage	string	A mensagem de erro.	null
ErrorCode	string	O código de erro.	null

Nota

Se ocorrer um erro de verificação de parâmetro, uma resposta Data ainda será retornada. Nesse caso, o valor do parâmetro Success é false, e os parâmetros Code e Message são incluídos. A menos que uma exceção seja lançada, você pode determinar se a chamada foi bem-sucedida com base no valor de Data.Success.
Ao usar o kit de desenvolvimento de software (SDK) mais recente para chamar esta operação de API, um erro de tempo limite pode ser retornado. Isso ocorre porque o período de tempo limite padrão do cliente no SDK é diferente do servidor. Esse erro pode ser retornado mesmo que a operação tenha sido chamada com sucesso. Para evitar esse problema, você pode definir o parâmetro ReadTimeout como 20000 antes de fazer a chamada.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "9CC37B9F-F4B4-5FF1-939B-AEE78DC70130",
  "Data": {
    "InstanceId": "hgpostcn-cn-xxxxxx",
    "OrderId": "217523224780172",
    "Code": "InvalidVpcOrVSwitch.NotAvailable",
    "Message": "InvalidVpcOrVSwitch.NotAvailable\n",
    "Success": "true"
  },
  "HttpStatusCode": "200",
  "ErrorMessage": "null",
  "ErrorCode": "null"
}

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.