Method: projects.locations.instances.create

Cria uma nova instância num determinado projeto e localização.

Pedido HTTP

POST https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/instances

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso principal onde esta instância vai ser criada. Formato: projects/{project}/locations/{location}

Parâmetros de consulta

Parâmetros
instanceId

string

Obrigatório. O ID a usar para a instância, que se torna o componente final do nome do recurso da instância.

Este valor está sujeito às seguintes restrições:

  • Tem de ter entre 4 e 63 carateres
  • Tem de começar com uma letra ou um dígito
  • Tem de conter apenas letras minúsculas, dígitos e hífenes
  • Não pode terminar com um hífen
  • Tem de ser único numa localização
requestId

string

Opcional. Um ID de pedido opcional para identificar pedidos. Especifique um ID de pedido exclusivo para que, se tiver de repetir o pedido, o servidor saiba que deve ignorá-lo se já tiver sido concluído. O servidor garante que, durante, pelo menos, 60 minutos desde o primeiro pedido.

Por exemplo, considere uma situação em que faz um pedido inicial e o pedido excede o tempo limite. Se fizer o pedido novamente com o mesmo ID do pedido, o servidor pode verificar se a operação original com o mesmo ID do pedido foi recebida e, em caso afirmativo, ignora o segundo pedido. Isto impede que os clientes criem acidentalmente compromissos duplicados.

O ID do pedido tem de ser um UUID válido, exceto o UUID zero, que não é suportado (00000000-0000-0000-0000-000000000000).

Corpo do pedido

O corpo do pedido contém uma instância de Instance.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Operation.

Âmbitos de autorização

Requer o seguinte âmbito do OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Autorizações de IAM

Requer a seguinte autorização de IAM no recurso parent:

  • memorystore.instances.create

Para mais informações, consulte a documentação do IAM.