Method: projects.locations.instances.create

Cria uma nova instância em um determinado projeto e local.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso pai em que essa instância será criada. Formato: projects/{project}/locations/{location}

Parâmetros de consulta

Parâmetros
instanceId

string

Obrigatório. O ID a ser usado na instância, que se tornará o componente final do nome do recurso da instância.

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

  • Precisa ter de 4 a 63 caracteres
  • Precisa começar com uma letra ou um dígito
  • Só pode conter letras minúsculas, dígitos e hifens
  • Não pode terminar com um hífen
  • Precisa ser exclusivo em um local
requestId

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se você precisar repetir sua solicitação, o servidor saberá que a solicitação deve ser ignorada se ela já tiver sido concluída. O servidor garante isso por pelo menos 60 minutos desde a primeira solicitação.

Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente.

O ID da solicitação precisa ser um UUID válido, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).

Corpo da solicitação

O corpo da solicitação contém uma instância de Instance.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • memorystore.instances.create

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