REST Resource: projects.locations.instances

Recurso: Instancia

Es una instancia de Memorystore.

Representación JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "stateInfo": {
    object (StateInfo)
  },
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "shardCount": integer,
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (PersistenceConfig)
  },
  "engineVersion": string,
  "engineConfigs": {
    string: string,
    ...
  },
  "nodeConfig": {
    object (NodeConfig)
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "pscAutoConnections": [
    {
      object (PscAutoConnection)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "migrationConfig": {
    object (MigrationConfig)
  },
  "aclPolicyInfo": {
    object (AclPolicyInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of mutually exclusive fields.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string,
  "maintenanceVersion": string,
  "effectiveMaintenanceVersion": string,
  "serverCaMode": enum (ServerCaMode),
  "serverCaPool": string,
  "rotateServerCertificate": boolean,
  "aclPolicy": string,
  "aclPolicyInSync": boolean
}
Campos
name

string

Es el identificador. Nombre único de la instancia. Formato: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de creación de la instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la actualización más reciente de la instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Es opcional. Son etiquetas para representar los metadatos proporcionados por el usuario.

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

enum (State)

Solo salida. Es el estado actual de la instancia.
stateInfo

object (StateInfo)

Solo salida. Es información adicional sobre el estado de la instancia.
uid

string

Solo salida. Es el identificador único asignado por el sistema para la instancia.
authorizationMode

enum (AuthorizationMode)

Es opcional. Es el modo de autorización de la instancia.
transitEncryptionMode

enum (TransitEncryptionMode)

Es opcional. Inmutable. Es el modo de encriptación en tránsito de la instancia.
shardCount

integer

Es opcional. Es la cantidad de fragmentos de la instancia.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Solo salida. Obsoleto: El parámetro discoveryEndpoints está obsoleto. Por lo tanto, no se completará si las conexiones se crean con el parámetro endpoints. En lugar de este parámetro, para el descubrimiento, usa endpoints.connections.pscConnection y endpoints.connections.pscAutoConnection con connectionType CONNECTION_TYPE_DISCOVERY.
nodeType

enum (NodeType)

Es opcional. Es el tipo de máquina para los nodos individuales de la instancia.
persistenceConfig

object (PersistenceConfig)

Es opcional. Es la configuración de persistencia de la instancia.
engineVersion

string

Es opcional. Es la versión del motor de la instancia.
engineConfigs

map (key: string, value: string)

Es opcional. Son los parámetros de configuración del motor proporcionados por el usuario para la instancia.

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

object (NodeConfig)

Solo salida. Es la configuración de los nodos individuales de la instancia.
zoneDistributionConfig

object (ZoneDistributionConfig)

Es opcional. Inmutable. Es la configuración de distribución de zonas de la instancia para la asignación de nodos.
pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

Es opcional. Inmutable. Obsoleto: Usa el valor endpoints.connections.psc_auto_connection en su lugar.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Solo salida. Son los detalles del adjunto de servicio para configurar conexiones de PSC.
endpoints[]

object (InstanceEndpoint)

Es opcional. Son los extremos de la instancia.
mode

enum (Mode)

Es opcional. Inmutable. Es la configuración del modo de la instancia.
maintenancePolicy

object (MaintenancePolicy)

Es opcional. Es la política de mantenimiento de la instancia. Si no se proporciona, el evento de mantenimiento se realizará según el programa de lanzamiento interno de Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Solo salida. Programa de mantenimiento publicado.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Es opcional. Es la configuración para la replicación entre instancias.
encryptionInfo

object (EncryptionInfo)

Solo salida. Es la información de encriptación de los datos en reposo del clúster.
automatedBackupConfig

object (AutomatedBackupConfig)

Es opcional. Es la configuración de copia de seguridad automática para la instancia.
availableMaintenanceVersions[]

string

Solo salida. Este campo se usa para determinar las versiones de mantenimiento disponibles para la actualización de autoservicio.
allowFewerZonesDeployment
(deprecated)

boolean

Es opcional. Inmutable. Está obsoleto y no se debe usar.
migrationConfig

object (MigrationConfig)

Solo salida. Es la configuración de migración de la instancia.
aclPolicyInfo

object (AclPolicyInfo)

Solo salida. Son los detalles de la política de ACL aplicada.
Es la fuente desde la que se importará. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
gcsSource

object (GcsBackupSource)

Es opcional. Inmutable. Copias de seguridad almacenadas en buckets de Cloud Storage Los buckets de Cloud Storage deben estar en la misma región que las instancias. Se requiere permiso de lectura para importar desde los objetos de Cloud Storage proporcionados.
managedBackupSource

object (ManagedBackupSource)

Es opcional. Inmutable. Son las copias de seguridad que genera y administra el servicio de Memorystore.
Fin de los campos mutuamente excluyentes.
replicaCount

integer

Es opcional. Cantidad de nodos de réplica por fragmento. Si se omite, el valor predeterminado es 0 réplicas.
deletionProtectionEnabled

boolean

Es opcional. Si se establece como verdadero, fallará la eliminación de la instancia.
simulateMaintenanceEvent

boolean

Es opcional. Solo entrada. Simula un evento de mantenimiento.
ondemandMaintenance
(deprecated)

boolean

Es opcional. Solo entrada. Es el mantenimiento a pedido de la instancia.
satisfiesPzs

boolean

Es opcional. Solo salida. Se reserva para usarlo más adelante.
satisfiesPzi

boolean

Es opcional. Solo salida. Se reserva para usarlo más adelante.
asyncInstanceEndpointsDeletionEnabled

boolean

Es opcional. Si es verdadero, los extremos de instancias que crean y registran los clientes se pueden borrar de forma asíncrona. Es decir, se puede anular el registro de un extremo de instancia de este tipo antes de que se borren las reglas de reenvío en el extremo de instancia.
kmsKey

string

Es opcional. Es la clave de KMS que se usa para encriptar los datos en reposo del clúster.
backupCollection

string

Solo salida. Es el nombre completo del recurso de la colección de copias de seguridad. Ejemplo: projects/{project}/locations/{location}/backupCollections/{collection}
maintenanceVersion

string

Es opcional. Este campo se puede usar para activar la actualización de autoservicio y, así, indicar la versión de mantenimiento deseada. El campo availableMaintenanceVersions puede determinar la entrada de este campo.
effectiveMaintenanceVersion

string

Solo salida. Este campo representa la versión de mantenimiento real de la instancia.
serverCaMode

enum (ServerCaMode)

Es opcional. Inmutable. Es el modo de AC del servidor para la instancia.
serverCaPool

string

Es opcional. Inmutable. Es el grupo de AC administrado por el cliente para la instancia. Solo se aplica si el modo de CA del servidor es CUSTOMER_MANAGED_CAS_CA. Formato: "projects/{project}/locations/{region}/caPools/{ca_pool}".
rotateServerCertificate

boolean

Es opcional. Solo entrada. Rota los certificados del servidor.
aclPolicy

string

Es opcional. Es la política de ACL para la instancia. Formato: projects/{project}/locations/{location}/aclPolicies/{aclPolicy}
aclPolicyInSync
(deprecated)

boolean

Solo salida. Obsoleto: Indica si las reglas de ACL aplicadas a la instancia están sincronizadas.

GcsBackupSource

Copias de seguridad almacenadas en buckets de Cloud Storage Los buckets de Cloud Storage deben estar en la misma región que las instancias.

Representación JSON 
{
  "uris": [
    string
  ]
}
Campos
uris[]

string

Es opcional. Ejemplo: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Son las copias de seguridad que genera y administra Memorystore.

Representación JSON 
{
  "backup": string
}
Campos
backup

string

Es opcional. Ejemplo: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup}. También se admite una versión más corta (sin el prefijo) del nombre de la copia de seguridad, como projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId}. En este caso, se supone que la copia de seguridad está en memorystore.googleapis.com.

Estado

Son los estados posibles de la instancia.

Enums
STATE_UNSPECIFIED Sin establecer
CREATING Se está creando la instancia.
ACTIVE Se creó la instancia y se puede usar.
UPDATING Se está actualizando la instancia.
DELETING Se está borrando la instancia.
MIGRATING Se está migrando la instancia.

StateInfo

Es información adicional sobre el estado de la instancia.

Representación JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of mutually exclusive fields.
}
Campos
La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
updateInfo

object (UpdateInfo)

Solo salida. Describe la actualización en curso cuando el estado de la instancia es UPDATING.
Fin de los campos mutuamente excluyentes.

UpdateInfo

Representa información sobre la instancia con el estado UPDATING.

Representación JSON 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
Campos
targetShardCount

integer

Solo salida. Es la cantidad objetivo de fragmentos para la instancia.
targetReplicaCount

integer

Solo salida. Es la cantidad objetivo de nodos de réplica por fragmento para la instancia.
targetEngineVersion

string

Solo salida. Es la versión del motor de destino para la instancia.
targetNodeType

enum (NodeType)

Solo salida. Es el tipo de nodo de destino para la instancia.

AuthorizationMode

Son los posibles modos de autorización de la instancia.

Enums
AUTHORIZATION_MODE_UNSPECIFIED Sin establecer
AUTH_DISABLED La autorización está inhabilitada.
IAM_AUTH Autorización básica de IAM
TOKEN_AUTH Autorización basada en tokens.

TransitEncryptionMode

Son los posibles modos de encriptación en tránsito de la instancia.

Enums
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Sin establecer
TRANSIT_ENCRYPTION_DISABLED La encriptación en tránsito está inhabilitada.
SERVER_AUTHENTICATION La encriptación administrada por el servidor se usa para la encriptación en tránsito.

DiscoveryEndpoint

Representa un endpoint para que los clientes se conecten a la instancia.

Representación JSON 
{
  "address": string,
  "port": integer,
  "network": string
}
Campos
address

string

Solo salida. Dirección IP del extremo expuesto al que se conectan los clientes.
port

integer

Solo salida. Número de puerto del extremo expuesto.
network

string

Solo salida. Es la red en la que se reservará la dirección IP del extremo de detección, con el formato projects/{networkProject}/global/networks/{network_name}.

PersistenceConfig

Representa la configuración de persistencia de una instancia.

Representación JSON 
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Campos
mode

enum (PersistenceMode)

Es opcional. Es el modo de persistencia actual.
rdbConfig

object (RDBConfig)

Es opcional. Es la configuración de la RDB. Este campo se ignorará si el modo no es RDB.
aofConfig

object (AOFConfig)

Es opcional. Es la configuración de AOF. Este campo se ignorará si el modo no es AOF.

PersistenceMode

Son los modos de persistencia posibles.

Enums
PERSISTENCE_MODE_UNSPECIFIED Sin establecer
DISABLED La persistencia está inhabilitada y se borran todos los datos de instantáneas.
RDB La persistencia basada en RDB está habilitada.
AOF Se habilitó la persistencia basada en AOF.

RDBConfig

Es la configuración para la persistencia basada en RDB.

Representación JSON 
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Campos
rdbSnapshotPeriod

enum (SnapshotPeriod)

Es opcional. Es el período entre las instantáneas de RDB.
rdbSnapshotStartTime

string (Timestamp format)

Es opcional. Fecha y hora en que se intentó o se intentará tomar la primera instantánea, y con la que se alinearán las instantáneas futuras. Si no se proporciona, se usará la hora actual.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

SnapshotPeriod

Son los períodos posibles para las instantáneas.

Enums
SNAPSHOT_PERIOD_UNSPECIFIED Sin establecer
ONE_HOUR Una hora.
SIX_HOURS Seis horas.
TWELVE_HOURS Doce horas.
TWENTY_FOUR_HOURS Veinticuatro horas.

AOFConfig

Es la configuración para la persistencia basada en AOF.

Representación JSON 
{
  "appendFsync": enum (AppendFsync)
}
Campos
appendFsync

enum (AppendFsync)

Es opcional. Es el modo de fsync.

AppendFsync

Son los modos de fsync posibles.

Enums
APPEND_FSYNC_UNSPECIFIED Sin establecer Valor predeterminado: EVERY_SEC
NEVER Nunca se realiza fsync. Normalmente, Linux vaciará los datos cada 30 segundos con esta configuración, pero depende del ajuste exacto del kernel.
EVERY_SEC Sincroniza cada segundo. Es posible que pierdas 1 segundo de datos si ocurre un desastre.
ALWAYS Fsync cada vez que se agregan comandos de escritura nuevos al AOF. Es la mejor protección contra la pérdida de datos, pero a costa del rendimiento.

NodeConfig

Representa la configuración de los nodos de la instancia.

Representación JSON 
{
  "sizeGb": number
}
Campos
sizeGb

number

Solo salida. Tamaño de la memoria del nodo en GB.

ZoneDistributionConfig

Es la configuración de distribución de zonas para la asignación de recursos de instancias.

Representación JSON 
{
  "zone": string,
  "zones": [
    string
  ],
  "mode": enum (ZoneDistributionMode)
}
Campos
zone

string

Es opcional. Define la zona en la que se asignarán todos los recursos con el modo SINGLE_ZONE. Se ignora para el modo MULTI_ZONE.
zones[]

string

Es opcional. Especifica las zonas de una instancia multizona en las que la instancia de Memorystore asigna recursos. Esta marca no se aplica a las instancias de una sola zona.
mode

enum (ZoneDistributionMode)

Es opcional. Es el modo de distribución de zonas actual. El valor predeterminado es MULTI_ZONE.

ZoneDistributionMode

Son los modos de distribución de zonas posibles.

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Sin establecer. Valor predeterminado: MULTI_ZONE
MULTI_ZONE Distribuye los recursos en 3 zonas elegidas al azar dentro de la región.
SINGLE_ZONE Aprovisiona recursos en una sola zona. Se debe especificar el campo de zona.

PscAutoConnection

Son los detalles de los recursos del consumidor en una conexión de PSC.

Representación JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
Campos
pscConnectionId

string

Solo salida. Es el ID de conexión de PSC de la regla de reenvío conectada al adjunto de servicio.
ipAddress

string

Solo salida. Es la IP asignada en la red del consumidor para la regla de reenvío de PSC.
forwardingRule

string

Solo salida. Es el URI de la regla de reenvío del lado del consumidor. Formato: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Obligatorio. Es el ID del proyecto del consumidor en el que se establecen las conexiones de PSC. Debe ser el mismo projectId en el que se está creando la instancia.
network

string

Obligatorio. Es la red en la que se crean los extremos de PSC, con el formato projects/{projectId}/global/networks/{network_name}.
serviceAttachment

string

Solo salida. Es el adjunto de servicio que es el destino de la conexión de PSC, con el formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo salida. Es el estado de la conexión de PSC: indica si existe una conexión y si está ACTIVA o si ya no existe. Ten en cuenta que este valor se actualiza periódicamente. Usa las APIs de Private Service Connect para conocer el estado más reciente.
connectionType

enum (ConnectionType)

Solo salida. Es el tipo de conexión de PSC.
Son los puertos del extremo expuesto. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
port

integer

Opcional. El puerto solo se establecerá para el extremo principal o de lectura, o de descubrimiento.
Fin de los campos mutuamente excluyentes.

PscConnectionStatus

Es el estado de la conexión de PSC.

Enums
PSC_CONNECTION_STATUS_UNSPECIFIED No se especificó el estado de la conexión de PSC.
ACTIVE La conexión está activa
NOT_FOUND No se encontró la conexión

Tipo de conexión

Tipo de conexión de PSC

Enums
CONNECTION_TYPE_UNSPECIFIED No se configuró el tipo de conexión
CONNECTION_TYPE_DISCOVERY Es la conexión que se usará para el descubrimiento de la topología.
CONNECTION_TYPE_PRIMARY Es la conexión que se usará como extremo principal para acceder al principal.
CONNECTION_TYPE_READER Es la conexión que se usará como extremo de lectura para acceder a las réplicas.

PscAttachmentDetail

Es la configuración de un adjunto de servicio del clúster para crear conexiones de PSC.

Representación JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Campos
serviceAttachment

string

Solo salida. Es el URI del adjunto de servicio que tu objeto PscConnection creado por ti mismo debe usar como destino.
connectionType

enum (ConnectionType)

Solo salida. Es el tipo de extremo de PSC.

InstanceEndpoint

InstanceEndpoint consta de conexiones de PSC que se crean como un grupo en cada red de VPC para acceder a la instancia. En cada grupo, habrá una conexión para cada adjunto de servicio en el clúster.

Representación JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Campos
connections[]

object (ConnectionDetail)

Es opcional. Es un grupo de conexiones de PSC. Se crean en la misma red de VPC, una para cada adjunto de servicio en el clúster.

ConnectionDetail

Es la información de cada conexión de PSC.

Representación JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of mutually exclusive fields.
}
Campos
Se puede crear una conexión de PSC a una instancia a través de la automatización de la conectividad de servicios (conexión automática) durante la creación del clúster, o bien la pueden crear los clientes por su cuenta (conexión creada por el usuario). La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
pscAutoConnection

object (PscAutoConnection)

Inmutable. Es la información detallada de una conexión de PSC que se crea a través de la automatización de la conectividad del servicio.
pscConnection

object (PscConnection)

Es la información detallada de una conexión de PSC que creó el usuario.
Fin de los campos mutuamente excluyentes.

PscConnection

Es la configuración de conexión de PSC creada por el usuario.

Representación JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
Campos
pscConnectionId

string

Obligatorio. Es el ID de conexión de PSC de la regla de reenvío conectada al adjunto de servicio.
ipAddress

string

Obligatorio. Es la IP asignada en la red del consumidor para la regla de reenvío de PSC.
forwardingRule

string

Obligatorio. Es el URI de la regla de reenvío del lado del consumidor. Formato: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Solo salida. Es el ID del proyecto del consumidor desde el que se crea la regla de reenvío.
network

string

Obligatorio. Es la red del consumidor en la que reside la dirección IP, con el formato projects/{projectId}/global/networks/{network_name}.
serviceAttachment

string

Obligatorio. Es el adjunto de servicio que es el destino de la conexión de PSC, con el formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo salida. Es el estado de la conexión de PSC: indica si existe una conexión y si está ACTIVA o si ya no existe. Ten en cuenta que este valor se actualiza periódicamente. Usa las APIs de Private Service Connect para conocer el estado más reciente.
connectionType

enum (ConnectionType)

Solo salida. Es el tipo de conexión de PSC.
Son los puertos del extremo expuesto. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
port

integer

Opcional. El puerto solo se establecerá para el extremo principal o de lectura, o de descubrimiento.
Fin de los campos mutuamente excluyentes.

Modo

Es la configuración del modo, que se usa para habilitar o inhabilitar el modo de clúster.

Enums
MODE_UNSPECIFIED No se especificó el modo.
STANDALONE

Obsoleto: Usa CLUSTER_DISABLED en su lugar.
CLUSTER La instancia está en modo de clúster.
CLUSTER_DISABLED El modo de clúster está inhabilitado para la instancia.

MaintenancePolicy

Política de mantenimiento por instancia.

Representación JSON 
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
Campos
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó la política.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se actualizó la política.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Es opcional. Es el período de mantenimiento que se aplica a los recursos cubiertos por esta política. El mínimo es 1. En la versión actual, se espera que la cantidad máxima de weekly_window sea uno.

WeeklyMaintenanceWindow

Es el período especificado para las operaciones semanales.

Representación JSON 
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
day

enum (DayOfWeek)

Es opcional. Permite definir una programación que se ejecuta en el día de la semana especificado.
startTime

object (TimeOfDay)

Es opcional. Hora de inicio del período en UTC.

MaintenanceSchedule

Programa de mantenimiento próximo.

Representación JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Solo salida. Es la hora de inicio de cualquier mantenimiento programado próximo para esta instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo salida. Es la hora de finalización de cualquier mantenimiento programado próximo para esta instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

Es la configuración de replicación entre instancias.

Representación JSON 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campos
instanceRole

enum (InstanceRole)

Obligatorio. Es el rol de la instancia en la replicación entre instancias.
primaryInstance

object (RemoteInstance)

Es opcional. Son los detalles de la instancia principal que se usa como fuente de replicación para esta instancia secundaria.

Este campo solo se establece para una instancia secundaria.
secondaryInstances[]

object (RemoteInstance)

Es opcional. Es la lista de instancias secundarias que se replican desde esta instancia principal.

Este campo solo se establece para una instancia principal.
updateTime

string (Timestamp format)

Solo salida. Es la última vez que se actualizó la configuración de replicación entre instancias.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
membership

object (Membership)

Solo salida. Es una vista de solo salida de todas las instancias miembro que participan en la replicación entre instancias. Cada instancia de miembro proporcionará esta vista, independientemente de su rol de instancia(primaria o secundaria).

Una instancia principal puede proporcionar información sobre todas las instancias secundarias que se replican desde ella. Sin embargo, una instancia secundaria solo conoce la instancia principal desde la que se replica. Sin embargo, en situaciones en las que la instancia principal no está disponible(p.ej., una interrupción regional), se puede enviar una solicitud de Getinstance a cualquier otra instancia miembro, y este campo mostrará todas las instancias miembro que participan en la replicación entre instancias.

InstanceRole

Es el rol de la instancia en la replicación entre instancias.

Enums
INSTANCE_ROLE_UNSPECIFIED No se configuró el rol de la instancia. El comportamiento es equivalente a NONE.
NONE Esta instancia no participa en la replicación entre instancias. Es una instancia independiente y no se replica hacia ni desde ninguna otra instancia.
PRIMARY Es una instancia que permite lecturas y escrituras. Todos los datos escritos en esta instancia también se replican en las instancias secundarias adjuntas.
SECONDARY Es una instancia que solo permite lecturas y replica datos de una instancia principal.

RemoteInstance

Son los detalles de la instancia remota asociada a esta instancia en una configuración de replicación entre instancias.

Representación JSON 
{
  "instance": string,
  "uid": string
}
Campos
instance

string

Es opcional. Ruta de acceso completa del recurso de la instancia remota con el siguiente formato: projects//locations//instances/
uid

string

Solo salida. Es el identificador único de la instancia remota.

Membresía

Es una vista de solo salida de todas las instancias miembro que participan en la replicación entre instancias.

Representación JSON 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Campos
primaryInstance

object (RemoteInstance)

Solo salida. Es la instancia principal que actúa como fuente de replicación para las instancias secundarias.
secondaryInstances[]

object (RemoteInstance)

Solo salida. Es la lista de instancias secundarias que se replican desde la instancia principal.

AutomatedBackupConfig

Es la configuración de copia de seguridad automática de una instancia.

Representación JSON 
{
  "automatedBackupMode": enum (AutomatedBackupMode),
  "retention": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of mutually exclusive fields.
}
Campos
automatedBackupMode

enum (AutomatedBackupMode)

Es opcional. Es el modo de copia de seguridad automática. Si el modo está inhabilitado, se ignorarán los demás campos.
retention

string (Duration format)

Es opcional. Cuánto tiempo se conservarán las copias de seguridad automáticas antes de que se borren El valor debe estar entre 1 y 365 días. Si no se especifica, el valor predeterminado es 35 días.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
Es la programación de las copias de seguridad automáticas. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Es opcional. Activa copias de seguridad automáticas con una frecuencia fija.
Fin de los campos mutuamente excluyentes.

FixedFrequencySchedule

Este programa permite que se active la copia de seguridad con una frecuencia fija (actualmente, solo se admite la frecuencia diaria).

Representación JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
startTime

object (TimeOfDay)

Obligatorio. Es la hora de inicio de cada copia de seguridad automática en UTC. Debe establecerse al inicio de una hora. Este campo es obligatorio.

AutomatedBackupMode

Es el modo de copia de seguridad automática.

Enums
AUTOMATED_BACKUP_MODE_UNSPECIFIED Valor predeterminado. No se especificó la configuración de copia de seguridad automática.
DISABLED Se inhabilitó la configuración de copia de seguridad automática.
ENABLED Se habilitó la configuración de copia de seguridad automática.

ServerCaMode

Es el modo de AC del servidor para la instancia.

Enums
SERVER_CA_MODE_UNSPECIFIED No se especificó el modo de la AC del servidor.
GOOGLE_MANAGED_PER_INSTANCE_CA Cada instancia tiene su propia CA administrada por Google.
GOOGLE_MANAGED_SHARED_CA La instancia usa una AC compartida administrada por Google para la región de la instancia.
CUSTOMER_MANAGED_CAS_CA La instancia usa una AC administrada por el cliente de CAS.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA

Obsoleto: Usa GOOGLE_MANAGED_PER_INSTANCE_CA en su lugar.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA

Obsoleto: Usa GOOGLE_MANAGED_SHARED_CA en su lugar.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA

Obsoleto: Usa CUSTOMER_MANAGED_CAS_CA en su lugar.

MigrationConfig

Es la configuración para la migración de una instancia.

Representación JSON 
{
  "state": enum (State),
  "forceFinishMigration": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "selfManagedSource": {
    object (SelfManagedSource)
  }
  // End of mutually exclusive fields.
}
Campos
state

enum (State)

Solo salida. Es el estado de migración de la instancia.
forceFinishMigration

boolean

Solo salida. Representa una marca booleana para forzar la finalización de la migración sin la validación de recuperación de la diferencia entre el origen y el destino antes de detener la replicación.
Son los detalles sobre la fuente de migración. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
selfManagedSource

object (SelfManagedSource)

Solo salida. Configuración para migrar desde una instancia autoadministrada de Valkey o Redis
Fin de los campos mutuamente excluyentes.

SelfManagedSource

Son los detalles de la instancia de origen autoadministrada.

Representación JSON 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
Campos
ipAddress

string

Obligatorio. Es la dirección IP de la instancia de origen. Esta dirección IP debe ser estable y la instancia de Memorystore debe poder acceder a ella durante todo el proceso de migración.
port

integer

Obligatorio. Es el puerto de la instancia de origen. Este puerto debe ser estable y la instancia de Memorystore debe poder acceder a él durante todo el proceso de migración.
networkAttachment

string

Obligatorio. Es el nombre del recurso del adjunto de red de Private Service Connect que se usa para establecer la conectividad con la instancia de origen. Este adjunto de red tiene los siguientes requisitos: 1. Debe estar en el mismo proyecto que la instancia de Memorystore. 2. Debe estar en la misma región que la instancia de Memorystore. 3. La subred adjunta al adjunto de red debe estar en la misma red de VPC que los nodos de la instancia de origen.

Formato: projects/{project}/regions/{region}/networkAttachments/{networkAttachment}

Estado

Es el estado de migración de la instancia. Es posible que se agreguen valores nuevos en el futuro.

Enums
STATE_UNSPECIFIED La instancia no tiene actividad relacionada con la migración. Este es el estado inicial.
ROLLED_BACK La instancia no se está migrando en este momento. La instancia se sometió a un intento de migración que falló, y la reversión posterior se realizó correctamente. La instancia ahora está lista para un nuevo intento de migración, si lo deseas.
ROLLING_BACK Indica que falló un intento de migración anterior. El estado general de la instancia será MIGRATING. La instancia no está lista para un nuevo intento de migración. Se está realizando una reversión para restablecer la instancia a su estado original. La instancia permanecerá en este estado hasta que la reversión se realice correctamente.
REPLICATION_ESTABLISHED La instancia está en proceso de migración. La instancia estableció una replicación exitosa y está lista para la migración de sistemas.
MIGRATED La instancia se migró correctamente.

AclPolicyInfo

Son los detalles de la política de ACL aplicada.

Representación JSON 
{
  "appliedAclPolicy": string,
  "appliedAclPolicyRevision": string,
  "appliedAclPolicyRevisionNumber": string,
  "aclPolicyRevisionStatuses": [
    {
      object (AclPolicyRevisionStatus)
    }
  ]
}
Campos
appliedAclPolicy

string

Solo salida. Es el nombre del recurso de la política de ACL aplicada. Formato: "projects/{project}/locations/{location}/aclPolicies/{aclPolicy}"
appliedAclPolicyRevision

string

Solo salida. Es el nombre del recurso de la revisión de la política de ACL aplicada. Formato: "projects/{project}/locations/{location}/aclPolicies/{aclPolicy}/revisions/{revision}"
appliedAclPolicyRevisionNumber

string (int64 format)

Solo salida. Número de revisión de la revisión de la política de ACL aplicada.
aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

Solo salida. Es una lista de estados de las distintas revisiones de esta política de ACL en la instancia.

Métodos

addTokenAuthUser

 Agrega un usuario de autenticación con token para una instancia habilitada para la autenticación basada en tokens.

backup

 Copia de seguridad de la instancia.

create

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

delete

 Borra una sola instancia.

finishMigration

 Finaliza el proceso de migración.

get

 Obtiene los detalles de una sola instancia.

getCertificateAuthority

 Obtiene detalles sobre la autoridad certificadora de una instancia.

list

 Enumera instancias en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de una sola instancia.

rescheduleMaintenance

 Reprograma el próximo evento de mantenimiento.

startMigration

 Inicia la migración de una instancia de origen a la instancia de destino de Memorystore.