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

Cria uma instância Hologres.

Descrição da operação

Aviso Esta operação de API incorre em taxas. Certifique-se de compreender totalmente os métodos de cobrança e os preços do Hologres antes de chamar esta operação.

Para obter mais informações sobre a cobrança do Hologres, consulte Visão geral da cobrança.
Ao criar uma instância Hologres, você deve especificar a região e a zona onde a instância reside. Uma região pode conter várias zonas. Detalhes:

   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 (Alibaba Finance Cloud in Shanghai): cn-shanghai-finance-1z, cn-shanghai-finance-1f
   cn-hangzhou-finance (Alibaba Finance Cloud in Hangzhou): cn-hangzhou-finance-k
   cn-shenzhen-finance-1 (Alibaba Finance Cloud in Shenzhen): cn-shenzhen-finance-1d
   ap-northeast-1 (Japan): ap-northeast-1a
   ap-southeast-1 (Singapore): ap-southeast-1c, ap-southeast-1a
   ap-southeast-3 (Kuala Lumpur): ap-southeast-3b
   ap-southeast-5 (Jakarta): ap-southeast-5b
   eu-central-1 (Frankfurt): eu-central-1a
   us-east-1 (Silicon Valley): us-east-1a
   us-west-1 (Virginia): 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 resources.

*

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. Você pode acessar os endpoints de serviço para visualizar as regiões suportadas.	cn-hangzhou
zoneId	string	Sim	O ID da zona. Para obter mais informações, consulte a seção "Notas de uso".	cn-hangzhou-h
vpcId	string	Sim	O ID da nuvem privada virtual (VPC). O ID da região da VPC deve ser o mesmo da instância.	vpc-t4netc3y5xxxx
vSwitchId	string	Sim	O ID do vSwitch. O ID da zona do vSwitch deve ser o mesmo da instância.	vsw-2vccsiymtxxxxxx
resourceGroupId	string	Não	O ID do grupo de recursos. Se este parâmetro for deixado em branco, o grupo de recursos padrão da conta será usado.	""
instanceName	string	Sim	O nome da instância. O nome deve ter de 2 a 64 caracteres. Cada caractere chinês ou letra conta como um caractere.	my_holo
instanceType	string	Sim	O tipo de instância. Valores válidos: Standard: instância de uso geral. Follower: instância secundária somente leitura. Warehouse: instância de grupo de computação. Shared: instância compartilhada. Severless: instância Serverless. Valores válidos: Warehouse : Warehouse. Follower : Follower. Standard : Standard. Serverless : Serverless. Shared : Shared.	Standard
cpu	integer	Não	As especificações da instância. Valores válidos: 32 núcleos e 128 GB de memória (número de nós de computação: 2) 64 núcleos e 256 GB de memória (número de nós de computação: 4) 96 núcleos e 384 GB de memória (número de nós de computação: 6) 128 núcleos e 512 GB de memória (número de nós de computação: 8) etc. Nota Especifique apenas o número de núcleos. Para comprar uma instância com mais de 1.024 núcleos, abra um ticket. Você não precisa especificar as especificações para uma instância Shared.	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.	500
coldStorageSize	integer	Não	A capacidade de armazenamento de baixa frequência da instância. Unidade: GB. Nota Este parâmetro é ignorado para instâncias pay-as-you-go.	500
gatewayCount	integer	Não	O número de gateways. Valores válidos: 2 a 50. Nota Este parâmetro é obrigatório apenas para instâncias 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 Shared. Uma instância Shared usa especificações definidas e o método de cobrança padrão é pay-as-you-go. Valores válidos: PostPaid : PostPaid. PrePaid : PrePaid.	PostPaid
autoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valor padrão: true. Valores válidos: true: ativa o pagamento automático. false: gera um pedido não pago. Nota Valor padrão: true. Se o seu método de pagamento tiver saldo insuficiente, você pode definir o parâmetro AutoPay como false para gerar um pedido não pago. Em seguida, você pode fazer login no console de Despesas e Custos para concluir o pagamento.	true
pricingCycle	string	Não	O ciclo de cobrança. Valores válidos: Month: cobrança mensal. Hour: cobrança por hora. Nota O PrePaid suporta apenas Month. O PostPaid suporta apenas Hour. Para instâncias Shared, este parâmetro é definido automaticamente como Hour e não precisa ser especificado. Valores válidos: Month : Month. Hour : Hour.	Month
duration	integer	Não	A duração da assinatura. Por exemplo, um valor de 2 indica dois meses. Nota Este parâmetro não é obrigatório se o método de cobrança for pay-as-you-go.	2
autoRenew	boolean	Não	Especifica se a renovação automática mensal deve ser ativada. Valor padrão: false. Valores válidos: true: ativa a renovação automática. false: desativa a renovação automática.	false
leaderInstanceId	string	Não	O ID da instância líder. Este parâmetro é obrigatório para instâncias Follower. Nota As instâncias líder e follower devem atender às seguintes condições: A instância líder está no estado Running. As instâncias líder e follower têm o mesmo ID de região. As instâncias líder e follower têm o mesmo ID de zona. A instância líder está associada a menos de 10 instâncias follower. As instâncias líder e follower pertencem à mesma conta Alibaba Cloud.	hgpostcn-cn-lbj3aworq112
initialDatabases	string	Não	Os bancos de dados iniciais.	chatbot
enableServerlessComputing	boolean	Não	Especifica se o Serverless Computing deve ser ativado. Valores válidos: true : Ativado. false : Desativado.	true
storageType	string	Não	O tipo de armazenamento. Valores válidos: local : Armazenamento com redundância local. redundant : Armazenamento com redundância de zona (multizona).	redundant

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	9CC37B9F-F4B4-5FF1-939B-AEE78DC70130
Data	object	O resultado retornado.
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	A mensagem de erro detalhada.	InvalidVpcOrVSwitch.NotAvailable
Success	string	Indica se a instância foi criada. Valores válidos: true: A instância foi criada. false: Falha ao criar a instância.	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 validação de parâmetro, o parâmetro Data ainda será retornado, mas o parâmetro Success será definido como false, e os parâmetros Code e Message serão incluídos. A menos que uma exceção seja lançada, o sucesso da operação é determinado pelo parâmetro Data.Success.
Ao usar o SDK mais recente para chamar esta operação, um erro de tempo limite de solicitação pode ser retornado porque o período de tempo limite padrão do cliente no SDK é inconsistente com o do servidor. No entanto, a operação é realmente chamada com sucesso. Para evitar esse problema, você pode definir o parâmetro ReadTimeout como 20000 antes de chamar a operação.

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.