Method: projects.locations.instances.create

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

Solicitação HTTP


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

Os URLs usam 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
  • Precisa conter apenas letras minúsculas, dígitos e hífens
  • 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 precisar repetir a solicitação, o servidor saberá que é preciso ignorar a solicitação se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após 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. O valor 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 um dos seguintes escopos do OAuth:

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

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.