Method: projects.locations.instances.create

Crea una instancia nueva en una ubicación y un proyecto determinados.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el recurso superior en el que se creará esta instancia. Formato: projects/{project}/locations/{location}

Parámetros de consulta

Parámetros
instanceId

string

Obligatorio. Es el ID que se usará para la instancia, que se convertirá en el componente final del nombre del recurso de la instancia.

Este valor está sujeto a las siguientes restricciones:

  • Debe tener entre 4 y 63 caracteres
  • Debe comenzar con una letra o un dígito
  • Debe contener solo letras minúsculas, dígitos y guiones
  • No debe terminar con un guion
  • Debe ser único en una ubicación
requestId

string

Opcional. Un ID de solicitud opcional para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor garantizará eso durante al menos 60 minutos desde la primera solicitud.

Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente.

El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Instance.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • memorystore.instances.create

Para obtener más información, consulta la documentación de IAM.