Method: projects.locations.instances.create

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

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

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

Los parámetros de consulta

Parámetros
instanceId

string

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

Este valor está sujeto a las siguientes restricciones:

  • Debe tener entre 4 y 63 caracteres.
  • Debe empezar por una letra o un dígito
  • Solo debe contener letras minúsculas, números y guiones
  • No puede terminar con un guion
  • Debe ser único en una ubicación
requestId

string

Opcional. ID de solicitud opcional para identificar solicitudes. Especifica un ID de solicitud único para que, si tienes que volver a enviar la solicitud, el servidor sepa que debe ignorarla si ya se ha completado. El servidor garantizará que esto sea así durante al menos 60 minutos desde la primera solicitud.

Por ejemplo, supongamos que haces una solicitud inicial y se agota el tiempo de espera. Si vuelves a enviar la solicitud con el mismo ID, el servidor puede comprobar si se ha recibido la operación original con ese ID y, si es así, ignorará la segunda solicitud. De esta forma, se evita que los clientes creen compromisos duplicados por error.

El ID de solicitud debe ser un UUID válido, excepto el UUID cero (00000000-0000-0000-0000-000000000000).

Cuerpo de la solicitud

En el cuerpo de la solicitud se incluye una instancia de Instance.

Cuerpo de la respuesta

Si la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Operation.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso parent:

  • memorystore.instances.create

Para obtener más información, consulta la documentación de gestión de identidades y accesos.