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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-30 UTC."],[],[],null,["# Method: projects.locations.instances.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nCreates a new Instance in a given project and location.\n\n### HTTP request\n\n`POST https://memorystore.googleapis.com/v1/{parent=projects/*/locations/*}/instances`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Instance](/memorystore/docs/valkey/reference/rest/v1/projects.locations.instances#Instance).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/memorystore/docs/valkey/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `memorystore.instances.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]