CreateInstances - Tair (Redis® OSS-Compatible): Central de Documentação do Alibaba Cloud

Cria várias instâncias da Classic Edition do banco de dados ApsaraDB for Tair (compatível com Redis OSS).

Descrição da operação

Certifique-se de compreender totalmente os métodos de cobrança e os preços do banco de dados ApsaraDB for Tair (compatível com Redis OSS) antes de chamar esta operação de API.

Nota

Esta operação de API suporta apenas a criação de instâncias da Classic Edition. Use as seguintes operações para criar uma única instância:

CreateInstance: cria uma instância de Redis de código aberto ou uma instância da Classic Edition do Tair com otimização de memória.
CreateTairInstance: cria uma instância nativa da nuvem do Tair (incluindo instâncias com otimização de memória, otimização de memória persistente e otimização de disco).

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

kvstore:CreateInstances

create

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/*

kvstore:InstanceClass
kvstore:InstanceType
kvstore:Appendonly

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Instances	string	Sim	As informações de configuração das novas instâncias. O valor deve estar no formato JSON. Para mais informações, consulte a descrição complementar do parâmetro Instances.	[{ "RegionId": "cn-hangzhou", "izNo": "cn-hangzhou-b", "quantity": 1, "instanceType": "Redis", "instanceClass": "redis.logic.sharding.1g.2db.0rodb.4proxy.default", "EngineVersion": "5.0", "ChargeType":"PrePaid", "Period":"1", "networkType": "VPC" , "vpcId": "vpc-2zex6u1nu32k3ux35oxxx", "vSwitchId": "vsw-2zesk464e647104kw3xxx" }]
Token	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, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token diferencia maiúsculas de minúsculas e pode ter até 64 caracteres ASCII.	ETnLKlblzczshOTUbOCz****
AutoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valores válidos: true: ativa o pagamento automático. Este é o valor padrão. false: desativa o pagamento automático. Você deve pagar manualmente pelo pedido. Na barra de navegação superior do console, escolha Billing > Renewal Management. No painel de navegação à esquerda, escolha Order Management > My Orders, encontre o pedido e conclua o pagamento. Nota Este parâmetro está disponível apenas quando o parâmetro ChargeType na matriz Instances está definido como PrePaid.	true
BusinessInfo	string	Não	As informações comerciais estendidas.	000000000
CouponNo	string	Não	O código do cupom. Valor padrão: `youhuiquan_promotion_option_id_for_blank`.	youhuiquan_promotion_option_id_for_blank
EngineVersion	string	Não	A versão do mecanismo compatível com Redis da instância. Valores válidos: 4.0 e 5.0. Nota Valor padrão: 5.0. Valores válidos: 4.0 : 4.0 5.0 : 5.0	5.0
RebuildInstance	boolean	Não	Especifica se a instância de origem deve ser reconstruída e restaurada a partir da lixeira. Valores válidos: true: sim. false: não. Este é o valor padrão. Nota Este parâmetro está disponível apenas quando o parâmetro SrcDBInstanceId é especificado na matriz Instances.	false
AutoRenew	string	Não	Especifica se a renovação automática deve ser ativada. Valores válidos: true: ativa a renovação automática. false: desativa a renovação automática. Este é o valor padrão. Nota Este parâmetro está disponível apenas quando o parâmetro ChargeType na matriz Instances está definido como PrePaid.	false
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-resourcegroupid1

Descrição complementar do parâmetro Instances

Nome	Tipo	Obrigatório	Exemplo	Descrição
RegionId	String	Sim	cn-hangzhou	O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. Use este parâmetro para especificar a região onde deseja criar a instância.
IzNo	String	Sim	cn-hangzhou-b	O ID da zona primária. Você pode chamar a operação DescribeRegions para consultar a lista de zonas mais recente. Use este parâmetro para especificar a zona onde deseja criar a instância.
Quantity	Integer	Não	1	O número de instâncias a serem criadas. Valores válidos: 1 a 300. Valor padrão: 1.
InstanceType	String	Não	Redis	O tipo de instância. Valores válidos: Redis (padrão): instância do banco de dados ApsaraDB for Tair (compatível com Redis OSS). Memcache: instância Memcache.
InstanceClass	String	Não	redis.master.small.default	O tipo de instância. Por exemplo, redis.master.small.default indica uma instância padrão master-replica da Community Edition (Classic Edition) de 1 GB. Para mais informações, consulte Tipos de instância. Nota Você deve especificar este parâmetro ou o parâmetro Capacity.
Capacity	Long	Não	16384	A capacidade de armazenamento da instância. Unidade: MB. Para mais informações, consulte Tipos de instância. Nota Você deve especificar este parâmetro ou o parâmetro InstanceClass.
EngineVersion	String	Não	5.0	A versão do mecanismo compatível com Redis da instância. Valores válidos: 5.0 (padrão) 4.0
ChargeType	String	Não	PrePaid	O método de cobrança. Valores válidos: PrePaid: pré-pago. PostPaid (padrão): pós-pago.
Period	Long	Não	12	O período pré-pago. Unidade: meses. Valores válidos: 1 a 9, 12, 24, 36 e 60. Nota Este parâmetro está ativo e é obrigatório apenas quando o parâmetro ChargeType está definido como PrePaid.
AutoRenew	String	Não	true	Especifica se a renovação automática deve ser ativada. Valores válidos: true: ativa a renovação automática. false (padrão): desativa a renovação automática. Nota Este parâmetro está ativo apenas quando o parâmetro ChargeType está definido como PrePaid.
InstanceName	String	Não	apitest	O nome da instância. O nome deve atender aos seguintes requisitos: O nome deve ter de 2 a 80 caracteres e começar com uma letra ou caractere chinês. O nome não pode conter espaços ou os seguintes caracteres especiais: @/:="<>{[]}
Password	String	Não	Pass!123456	A senha da instância. A senha deve atender aos seguintes requisitos: A senha deve ter de 8 a 32 caracteres. A senha deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, caracteres especiais e dígitos. Caracteres especiais suportados: !@#$%^&*()_+-=
NetworkType	String	Não	VPC	O tipo de rede. Valor válido: VPC (Virtual Private Cloud). Atualmente, apenas instâncias VPC podem ser criadas.
VpcId	String	Não	vpc-bp1nme44gek34slfc****	O ID da VPC. Você pode chamar a operação DescribeVpcs para consultar o ID da VPC.
VSwitchId	String	Não	vsw-bp1e7clcw529l773d****	O ID do vSwitch na VPC. Você pode chamar a operação DescribeVpcs para consultar o ID do vSwitch.
NodeType	String	Não	MASTER_SLAVE	O tipo de nó. Valores válidos: STAND_ALONE: autônomo. MASTER_SLAVE (padrão): master-replica (alta disponibilidade).
SrcDBInstanceId	String	Não	r-bp1zxszhcgatnx****	O ID da instância de origem. Você pode chamar a operação DescribeInstances para consultar o ID da instância. Nota Especifique este parâmetro apenas quando desejar criar uma instância com base nos dados de backup da instância de origem.
BackupId	String	Não	111111111	O ID do conjunto de backup. Você pode chamar a operação DescribeBackups para consultar o ID do conjunto de backup. Nota Se você deseja criar uma instância com base nos dados de backup de uma instância específica, deve especificar o parâmetro SrcDBInstanceId para identificar a instância de origem e especificar este parâmetro para identificar o conjunto de backup. O sistema cria a instância com base nos dados do conjunto de backup.
RebuildInstance	String	Não	false	Especifica se a instância de origem deve ser reconstruída e recuperada da lixeira. Valores válidos: true: sim. false (padrão): não. Nota Se você especificar este parâmetro, também deverá especificar o parâmetro SrcDBInstanceId.

Exemplo de solicitação para o parâmetro Instances

[{
    "RegionId": "cn-hangzhou",
    "izNo": "cn-hangzhou-b",
    "quantity": 1,
    "instanceType": "Redis",
    "instanceClass": "redis.logic.sharding.1g.2db.0rodb.4proxy.default",
    "EngineVersion": "5.0",
    "ChargeType": "PrePaid",
    "Period":"1",
    "networkType": "VPC" , 
    "vpcId": "vpc-2zex6u1nu32k3ux35xxxx", 
    "vSwitchId": "vsw-2zesk464e647104kwxxxx"
}]

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	string	O ID do pedido.	20905403119****
RequestId	string	O ID da solicitação.	561AFBF1-BE20-44DB-9BD1-6988B53E****
InstanceIds	object
InstanceId	array	A lista de IDs de instância das instâncias criadas.
	string	O ID da instância.	r-bp16e70a4338****

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": "20905403119****",
  "RequestId": "561AFBF1-BE20-44DB-9BD1-6988B53E****",
  "InstanceIds": {
    "InstanceId": [
      "r-bp16e70a4338****"
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Zone.Closed	Specified zone is closed.	A zona especificada está indisponível.
400	MissingParameter	Period is mandatory for this action.
400	InvalidToken.Malformed	The Specified parameter "Token" is not valid.
400	InvalidInstanceName.Malformed	The Specified parameter "InstanceName" is not valid.
400	InvalidPassword.Malformed	The Specified parameter "Password" is not valid.	O parâmetro NewPassword especificado não atende aos requisitos.
400	InvalidInstances.Malformed	The Specified parameter "Instances" is not valid.	O parâmetro Instances especificado é inválido.
400	InsufficientBalance	Your account does not have enough balance.
400	QuotaExceed.AfterpayInstance	Living afterpay instances quota exceeded.
400	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.
400	ResourceNotAvailable	Resource you requested is not available for finance user.
400	PaymentMethodNotFound	No payment method has been registered on the account.
400	IdempotentParameterMismatch	Request uses a client token in a previous request but is not identical to that request.	A verificação de idempotência falhou.
400	QuotaNotEnough	Quota not enough in this zone.
400	QuotaExceed	Living afterpay instances quota exceed.
400	VpcServiceError	Invoke vpc service failed.
400	IzNotSupportVpcError	Specify iz not support vpc.
400	InvalidVpcIdRegion.NotSupported	The Specified vpcId or vSwitchId not supported.
400	ResourceGroupNotExist	The Specified ResourceGroupId does not exist.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.
404	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.	A especificação de armazenamento especificada não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.