Recurso de REST: projects.locations.instances

Recurso: Instancia

Representación JSON

{
  "name": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "authorizedNetwork": string,
  "zones": [
    string
  ],
  "nodeCount": integer,
  "nodeConfig": {
    object (NodeConfig)
  },
  "memcacheVersion": enum (MemcacheVersion),
  "parameters": {
    object (MemcacheParameters)
  },
  "memcacheNodes": [
    {
      object (Node)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "memcacheFullVersion": string,
  "instanceMessages": [
    {
      object (InstanceMessage)
    }
  ],
  "discoveryEndpoint": string
}
Campos
name

string

Obligatorio Nombre único del recurso en este permiso, incluido el proyecto y la ubicación mediante el formulario: projects/{project_id}/locations/{locationId}/instances/{instanceId}

Nota: Las instancias de Memcached se administran y abordan a nivel regional, por lo que locationId se refiere a una región de GCP. Sin embargo, los usuarios pueden elegir en qué zonas se deben aprovisionar los nodos de Memcached dentro de las instancias. Consulta el campo [zonas] para obtener más detalles.

displayName

string

Opcional. El nombre que proporcionó el usuario para la instancia solo se usará con fines de visualización. No puede tener más de 80 caracteres.

labels

map (key: string, value: string)

Opcional. Son las etiquetas de los recursos para representar los metadatos proporcionados por el usuario. Para obtener más información, consulta la documentación de Cloud sobre las etiquetas. https://cloud.google.com/compute/docs/labeling-resources

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

authorizedNetwork

string

Opcional. El nombre completo de la red de Google Compute Engine a la que está conectada la instancia. Si no se especifica, se usará la red default.

zones[]

string

Opcional. Zonas en las que se deben aprovisionar los nodos de Memcached. Los nodos de Memcached se distribuirán de forma equitativa entre estas zonas. Si no se proporciona, el servicio creará nodos de manera predeterminada en todas las zonas de la región de la instancia.

nodeCount

integer

Obligatorio Cantidad de nodos en la instancia de Memcached.

nodeConfig

object (NodeConfig)

Obligatorio Configuración de los nodos de Memcached

memcacheVersion

enum (MemcacheVersion)

Opcional. La versión principal del software de Memcached. Si no se proporciona, se usará la última versión compatible. Actualmente, la última versión principal compatible es MEMCACH_1_5. El sistema determinará automáticamente la versión secundaria en función de la última versión secundaria compatible.

parameters

object (MemcacheParameters)

Opcional: Parámetros definidos por el usuario para aplicar al proceso de Memcached en cada nodo.

memcacheNodes[]

object (Node)

Solo salida. Lista de nodos de Memcached. Consulta el mensaje de [Nodo] para obtener más detalles.

createTime

string (Timestamp format)

Solo salida. La hora en la que se creó la instancia.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó la instancia.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Solo salida. El estado de esta instancia de Memcached.

memcacheFullVersion

string

Solo salida. La versión completa del servidor de Memcached que se ejecuta en esta instancia. El sistema determina automáticamente la versión completa de Memcached para una instancia según la entrada de MemcacheVersion. El formato de la versión completo será "memcached-1.5.16".

instanceMessages[]

object (InstanceMessage)

Lista de mensajes que describen los estados actuales de las instancias de Memcached.

discoveryEndpoint

string

Solo salida. API del extremo de descubrimiento

NodeConfig

Configuración para un nodo de Memcached.

Representación JSON

{
  "cpuCount": integer,
  "memorySizeMb": integer
}
Campos
cpuCount

integer

Obligatorio Cantidad de CPU por nodo de Memcached.

memorySizeMb

integer

Obligatorio Tamaño de memoria en MiB de cada nodo de Memcached.

Versión de Memcache

Versiones de Memcached compatibles con nuestro servicio.

Enums
MEMCACHE_VERSION_UNSPECIFIED
MEMCACHE_1_5 Versión 1.5 de Memcached.

Parámetros de Memcache

Representación JSON

{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
Campos
id

string

Solo salida. Es el ID único asociado con este conjunto de parámetros. Los usuarios pueden usar este ID para determinar si los parámetros asociados a la instancia difieren de los parámetros asociados con los nodos y se debe realizar alguna acción para aplicar los parámetros en los nodos.

params

map (key: string, value: string)

Conjunto de parámetros definido por el usuario para usar en el proceso de Memcached.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Nodo

Representación JSON

{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  }
}
Campos
nodeId

string

Solo salida. Identificador del nodo de Memcached. El ID del nodo no incluye un proyecto o una ubicación, como el nombre de la instancia de Memcached.

zone

string

Solo salida. Ubicación (zona de GCP) del nodo de Memcached.

state

enum (State)

Solo salida. Estado actual del nodo de Memcached.

host

string

Solo salida. Nombre de host o dirección IP del nodo de Memcached que usan los clientes para conectarse al servidor de Memcached en este nodo.

port

integer

Solo salida. El número de puerto del servidor de Memcached en este nodo.

parameters

object (MemcacheParameters)

Los parámetros definidos por el usuario aplicados actualmente al nodo.

State

Diferentes estados de un nodo de Memcached.

Enums
STATE_UNSPECIFIED El estado del nodo no está configurado.
CREATING Se está creando el nodo.
READY El nodo se creó y está listo para usarse.
DELETING Se está borrando el nodo.
UPDATING Se está actualizando el nodo.

State

Diferentes estados de una instancia de Memcached.

Enums
STATE_UNSPECIFIED El estado no se estableció.
CREATING Se está creando la instancia de Memcached.
READY Se creó la instancia de Memcached y está lista para usarse.
DELETING Se está borrando la instancia de Memcached.
PERFORMING_MAINTENANCE La instancia de Memcached se encuentra en mantenimiento, p. ej., se encuentra en el lanzamiento del plano de datos.

Mensaje de la instancia

Representación JSON

{
  "code": enum (Code),
  "message": string
}
Campos
code

enum (Code)

Un código que corresponde a un tipo de mensaje para el usuario.

message

string

Mensaje de la instancia de Memcached que se mostrará a los usuarios

Code

Enums
CODE_UNSPECIFIED No se ha establecido el código de mensaje.
ZONE_DISTRIBUTION_UNBALANCED Los nodos de Memcached se distribuyen de forma desigual.

Métodos

applyParameters

Los parámetros de aplicación actualizarán el conjunto actual de parámetros al conjunto de nodos especificados de la instancia de Memcached.

create

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

delete

Borra una sola instancia.

get

Obtiene los detalles de una sola instancia.

getIamPolicy

Permite obtener la política de control de acceso de un recurso.

list

Muestra una lista de instancias en una ubicación y un proyecto determinados.

patch

Actualiza una instancia existente en una ubicación y un proyecto determinados.

setIamPolicy

Permite configurar la política de control de acceso en el recurso especificado.

testIamPermissions

Permite mostrar los permisos que tiene un emisor para un recurso especificado.

updateParameters

Actualiza los parámetros definidos de Memcached de una instancia existente.