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)
  },
  "allowFewerZonesDeployment": boolean,

  // Union field import_sources can be only one of the following:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of list of possible types for union field import_sources.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string
}
Campos
name

string

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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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)

Opcional. Son las 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)

Opcional. Inmutable. Modo de autorización de la instancia.
transitEncryptionMode

enum (TransitEncryptionMode)

Opcional. Inmutable. Modo de encriptación en tránsito de la instancia.
shardCount

integer

Opcional. Cantidad de fragmentos de la instancia.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Solo salida. Obsoleto: Usa los valores endpoints.connections.psc_auto_connection o endpoints.connections.psc_connection en su lugar.
nodeType

enum (NodeType)

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

object (PersistenceConfig)

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

string

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

map (key: string, value: string)

Opcional. Son las configuraciones del motor proporcionadas 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)

Opcional. Inmutable. Es la configuración de distribución de zonas de la instancia para la asignación de nodos.
pscAutoConnections[]

object (PscAutoConnection)

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)

Opcional. Son los extremos de la instancia.
mode

enum (Mode)

Opcional. Es la configuración del modo de la instancia.
maintenancePolicy

object (MaintenancePolicy)

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)

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)

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

boolean

Opcional. Inmutable. Permite a los clientes especificar si aceptan implementar una instancia de varias zonas en menos de 3 zonas. Una vez configurada, si se produce una interrupción zonal durante la creación de la instancia, esta solo se implementará en 2 zonas y permanecerá en ellas durante su ciclo de vida.
Campo de unión import_sources. Es la fuente desde la que se importará. import_sources puede ser solo uno de los siguientes:
gcsSource

object (GcsBackupSource)

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)

Opcional. Inmutable. Son las copias de seguridad que genera y administra el servicio de Memorystore.
replicaCount

integer

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

boolean

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

boolean

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

boolean

Opcional. Solo entrada. Mantenimiento a pedido de la instancia.
asyncInstanceEndpointsDeletionEnabled

boolean

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

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}

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

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

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.

StateInfo

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

Representación JSON 
{

  // Union field info can be only one of the following:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of list of possible types for union field info.
}
Campos

Campo de unión info.

info puede ser una de las siguientes opciones:
updateInfo

object (UpdateInfo)

Solo salida. Describe la actualización en curso cuando el estado de la instancia es UPDATING.

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.

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 extremo 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_id}.

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)

Opcional. Es el modo de persistencia actual.
rdbConfig

object (RDBConfig)

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

object (AOFConfig)

Opcional. Es la configuración del 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 Se habilitó la persistencia basada en RDB.
AOF La persistencia basada en AOF está habilitada.

RDBConfig

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

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

enum (SnapshotPeriod)

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

string (Timestamp format)

Opcional. Es la 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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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)

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. Es el 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,
  "mode": enum (ZoneDistributionMode)
}
Campos
zone

string

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.
mode

enum (ZoneDistributionMode)

Opcional. Es el modo de distribución de zona actual. La configuración predeterminada 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),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
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 ID de proyecto en el que se crea 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_id}.
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.
Campo de unión ports. Son los puertos del extremo expuesto. ports puede ser solo uno de los siguientes:
port

integer

Opcional. El puerto solo se establecerá para el extremo principal/de lectura o de descubrimiento.

PscConnectionStatus

Es el estado de la conexión de PSC.

Enums
PSC_CONNECTION_STATUS_UNSPECIFIED No se especificó el estado de conexión del 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 lector 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 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)

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

ConnectionDetail

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

Representación JSON 
{

  // Union field connection can be only one of the following:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of list of possible types for union field connection.
}
Campos
Campo de unión connection. 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 propios clientes (conexión creada por el usuario). connection puede ser solo uno de los siguientes:
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 crea el usuario.

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),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
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_id}.
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.
Campo de unión ports. Son los puertos del extremo expuesto. ports puede ser solo uno de los siguientes:
port

integer

Opcional. El puerto solo se establecerá para el extremo principal/de lectura o de descubrimiento.

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

Es la 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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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. Fecha y hora en que se actualizó la política.

Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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)

Opcional. Es el período de mantenimiento que se aplica a los recursos cubiertos por esta política. El mínimo es 1. Para 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)

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

object (TimeOfDay)

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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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)

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)

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 RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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 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

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,

  // Union field schedule can be only one of the following:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of list of possible types for union field schedule.
}
Campos
automatedBackupMode

enum (AutomatedBackupMode)

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)

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".
Campo de unión schedule. Es la programación de las copias de seguridad automáticas. schedule puede ser solo uno de los siguientes:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Opcional. Activa copias de seguridad automáticas con una frecuencia fija.

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 copias de seguridad automáticas.
ENABLED Se habilitó la configuración de copias de seguridad automáticas.

Métodos

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.

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.