- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Permissões do IAM
Cria uma nova instância em um determinado projeto e local.
Solicitação HTTP
POST https://memorystore.googleapis.com/v1/{parent=projects/*/locations/*}/instances
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
parent |
Obrigatório. O recurso pai em que essa instância será criada. Formato: projects/{project}/locations/{location} |
Parâmetros de consulta
Parâmetros | |
---|---|
instanceId |
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:
|
requestId |
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 vai garantir 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.