REST Resource: projects.locations.instances

Recurso: Instance

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 de salida. Marca de tiempo de creación de la instancia.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Marca de tiempo de la última actualización de la instancia.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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. Etiquetas que representan los metadatos proporcionados por los usuarios.

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

enum (State)

Solo de salida. Estado actual de la instancia.
stateInfo

object (StateInfo)

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

string

Solo de salida. Identificador único asignado por el sistema a la instancia.
authorizationMode

enum (AuthorizationMode)

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

enum (TransitEncryptionMode)

Opcional. Inmutable. Modo de cifrado en tránsito de la instancia.
shardCount

integer

Opcional. Número de fragmentos de la instancia.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

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

enum (NodeType)

Opcional. Tipo de máquina de los nodos individuales de la instancia.
persistenceConfig

object (PersistenceConfig)

Opcional. Configuración de persistencia de la instancia.
engineVersion

string

Opcional. Versión del motor de la instancia.
engineConfigs

map (key: string, value: string)

Opcional. 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 de salida. Configuración de los nodos individuales de la instancia.
zoneDistributionConfig

object (ZoneDistributionConfig)

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

object (PscAutoConnection)

Opcional. Inmutable. Obsoleto: en su lugar, usa el valor endpoints.connections.psc_auto_connection.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Solo de salida. Detalles del adjunto de servicio para configurar las conexiones de PSC.
endpoints[]

object (InstanceEndpoint)

Opcional. Puntos finales de la instancia.
mode

enum (Mode)

Opcional. Configuración del modo de la instancia.
maintenancePolicy

object (MaintenancePolicy)

Opcional. Política de mantenimiento de la instancia. Si no se proporciona, el evento de mantenimiento se realizará según la programación de lanzamiento interna de Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Solo de salida. Calendario de mantenimiento publicado.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Opcional. Configuración de la replicación entre instancias.
encryptionInfo

object (EncryptionInfo)

Solo de salida. Información de cifrado de los datos en reposo del clúster.
automatedBackupConfig

object (AutomatedBackupConfig)

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

boolean

Opcional. Inmutable. Permite a los clientes especificar si aceptan desplegar una instancia multizona 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 desplegará en dos zonas y permanecerá en ellas durante su ciclo de vida.
Campo de unión import_sources. La fuente de la que se va a importar. import_sources solo puede ser una de las siguientes cosas:
gcsSource

object (GcsBackupSource)

Opcional. Inmutable. Copias de seguridad almacenadas en segmentos de Cloud Storage. Los segmentos de Cloud Storage deben estar en la misma región que las instancias. Se necesita el permiso de lectura para importar los objetos de Cloud Storage proporcionados.
managedBackupSource

object (ManagedBackupSource)

Opcional. Inmutable. Copias de seguridad generadas y gestionadas por el servicio Memorystore.
replicaCount

integer

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

boolean

Opcional. Si se le asigna el valor true, no se podrá eliminar la instancia.
simulateMaintenanceEvent

boolean

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

boolean

Opcional. Solo de entrada. Mantenimiento bajo demanda de la instancia.
asyncInstanceEndpointsDeletionEnabled

boolean

Opcional. Si es true, los clientes pueden eliminar de forma asíncrona los endpoints de instancia que creen y registren. Es decir, este tipo de endpoint de instancia se puede anular antes de que se eliminen las reglas de reenvío del endpoint de instancia.
kmsKey

string

Opcional. Clave de KMS que se usa para cifrar los datos en reposo del clúster.
backupCollection

string

Solo de salida. 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 segmentos de Cloud Storage. Los segmentos de Cloud Storage deben estar en la misma región que las instancias.

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

string

Opcional. Ejemplo: gs://cubo1/objeto1, gs://cubo2/carpeta2/objeto2

ManagedBackupSource

Copias de seguridad generadas y gestionadas por 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 da por hecho que la copia de seguridad está en memorystore.googleapis.com.

Estado

Posibles estados de la instancia.

Enumeraciones
STATE_UNSPECIFIED Sin definir.
CREATING Se está creando la instancia.
ACTIVE Se ha creado la instancia y se puede usar.
UPDATING Se está actualizando la instancia.
DELETING Se está eliminando la instancia.

StateInfo

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 solo puede ser una de las siguientes cosas:
updateInfo

object (UpdateInfo)

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

UpdateInfo

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

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

integer

Solo de salida. Número de fragmentos objetivo de la instancia.
targetReplicaCount

integer

Solo de salida. Número objetivo de nodos de réplica por fragmento de la instancia.
targetEngineVersion

string

Solo de salida. Versión del motor de destino de la instancia.
targetNodeType

enum (NodeType)

Solo de salida. Tipo de nodo de destino de la instancia.

AuthorizationMode

Posibles modos de autorización de la instancia.

Enumeraciones
AUTHORIZATION_MODE_UNSPECIFIED Sin definir.
AUTH_DISABLED Autorización inhabilitada.
IAM_AUTH Autorización básica de gestión de identidades y accesos.

TransitEncryptionMode

Posibles modos de cifrado en tránsito de la instancia.

Enumeraciones
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Sin definir.
TRANSIT_ENCRYPTION_DISABLED El cifrado en tránsito está inhabilitado.
SERVER_AUTHENTICATION El encriptado gestionado por el servidor se usa para el encriptado 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 de salida. Dirección IP a la que se conectan los clientes del endpoint expuesto.
port

integer

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

string

Solo de salida. La red en la que se reservará la dirección IP del endpoint de descubrimiento, 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. Modo de persistencia actual.
rdbConfig

object (RDBConfig)

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

object (AOFConfig)

Opcional. Configuración de AOF. Este campo se ignorará si el modo no es AOF.

PersistenceMode

Posibles modos de persistencia.

Enumeraciones
PERSISTENCE_MODE_UNSPECIFIED Sin definir.
DISABLED La persistencia está inhabilitada y se eliminan todos los datos de las capturas.
RDB La persistencia basada en RDB está habilitada.
AOF La persistencia basada en AOF está habilitada.

RDBConfig

Configuración de la persistencia basada en RDB.

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

enum (SnapshotPeriod)

Opcional. Periodo entre las copias de RDB.
rdbSnapshotStartTime

string (Timestamp format)

Opcional. Hora en la que se intentó o se intentará hacer la primera instantánea y a la que se alinearán las futuras. Si no se proporciona, se usará la hora actual.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

SnapshotPeriod

Posibles periodos de la instantánea.

Enumeraciones
SNAPSHOT_PERIOD_UNSPECIFIED Sin definir.
ONE_HOUR Una hora.
SIX_HOURS Seis horas.
TWELVE_HOURS Doce horas.
TWENTY_FOUR_HOURS Veinticuatro horas.

AOFConfig

Configuración de la persistencia basada en AOF.

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

enum (AppendFsync)

Opcional. El modo fsync.

AppendFsync

Posibles modos de fsync.

Enumeraciones
APPEND_FSYNC_UNSPECIFIED Sin definir. Valor predeterminado: EVERY_SEC
NEVER Nunca fsync. Normalmente, Linux vaciará los datos cada 30 segundos con esta configuración, pero depende de la configuración exacta del kernel.
EVERY_SEC Sincroniza cada segundo. Si se produce un desastre, es posible que pierdas 1 segundo de datos.
ALWAYS Sincroniza cada vez que se añadan nuevos comandos de escritura al archivo AOF. La mejor protección contra la pérdida de datos a costa del rendimiento.

NodeConfig

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

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

number

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

ZoneDistributionConfig

Configuración de la 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 en el modo MULTI_ZONE.
mode

enum (ZoneDistributionMode)

Opcional. Modo de distribución de zonas actual. El valor predeterminado es MULTI_ZONE.

ZoneDistributionMode

Posibles modos de distribución de zonas.

Enumeraciones
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Sin definir. 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

Detalles de los recursos de 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 de salida. ID de conexión de PSC de la regla de reenvío conectada a la vinculación de servicio.
ipAddress

string

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

string

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

string

Obligatorio. 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 está creando la instancia.
network

string

Obligatorio. La red en la que se crean los endpoints de PSC, con el formato projects/{projectId}/global/networks/{network_id}.
serviceAttachment

string

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

enum (PscConnectionStatus)

Solo de salida. El estado de la conexión PSC: si existe una conexión y 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 consultar el estado más reciente.
connectionType

enum (ConnectionType)

Solo de salida. Tipo de conexión PSC.
Campo de unión ports. Puertos del endpoint expuesto. ports solo puede ser una de las siguientes cosas:
port

integer

Opcional. El puerto solo se definirá para el endpoint principal, de lectura o de discovery.

PscConnectionStatus

Estado de la conexión PSC.

Enumeraciones
PSC_CONNECTION_STATUS_UNSPECIFIED No se ha especificado el estado de la conexión PSC.
ACTIVE La conexión está activa
NOT_FOUND No se ha encontrado la conexión

ConnectionType

Tipo de conexión PSC

Enumeraciones
CONNECTION_TYPE_UNSPECIFIED No se ha definido el tipo de conexión
CONNECTION_TYPE_DISCOVERY Conexión que se usará para el descubrimiento de la topología.
CONNECTION_TYPE_PRIMARY Conexión que se usará como endpoint principal para acceder al principal.
CONNECTION_TYPE_READER Conexión que se usará como endpoint de lectura para acceder a las réplicas.

PscAttachmentDetail

Configuración de una vinculación de servicio del clúster para crear conexiones PSC.

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

string

Solo de salida. URI de la vinculación de servicio que debe usar como destino la conexión PscConnection que has creado.
connectionType

enum (ConnectionType)

Solo de salida. Tipo de endpoint de PSC.

InstanceEndpoint

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

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

object (ConnectionDetail)

Opcional. Un grupo de conexiones PSC. Se crean en la misma red de VPC, una por cada conexión de servicio del clúster.

ConnectionDetail

Información de cada conexión 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. Una conexión PSC a una instancia se puede crear mediante la automatización de la conectividad de los servicios (conexión automática) durante la creación del clúster o la pueden crear los propios clientes (conexión creada por el usuario). connection solo puede ser una de las siguientes cosas:
pscAutoConnection

object (PscAutoConnection)

Inmutable. Información detallada de una conexión PSC creada mediante la automatización de la conectividad de servicios.
pscConnection

object (PscConnection)

Información detallada de una conexión PSC creada por el usuario.

PscConnection

Configuración de conexión 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. ID de conexión de PSC de la regla de reenvío conectada a la vinculación de servicio.
ipAddress

string

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

string

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

string

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

string

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

string

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

enum (PscConnectionStatus)

Solo de salida. El estado de la conexión PSC: si existe una conexión y 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 consultar el estado más reciente.
connectionType

enum (ConnectionType)

Solo de salida. Tipo de conexión PSC.
Campo de unión ports. Puertos del endpoint expuesto. ports solo puede ser una de las siguientes cosas:
port

integer

Opcional. El puerto solo se definirá para el endpoint principal, de lectura o de discovery.

Modo

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

Enumeraciones
MODE_UNSPECIFIED No se ha especificado el modo.
STANDALONE

Obsoleta: usa CLUSTER_DISABLED en su lugar.
CLUSTER La instancia está en modo de clúster.
CLUSTER_DISABLED El modo de clúster está inhabilitado en 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 de salida. Hora en la que se creó la política.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Hora en la que se actualizó la política.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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. Ventana de mantenimiento que se aplica a los recursos cubiertos por esta política. Mínimo 1. En la versión actual, el número máximo de weekly_window debe ser uno.

WeeklyMaintenanceWindow

Periodo 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 ejecute un día de la semana específico.
startTime

object (TimeOfDay)

Opcional. Hora de inicio del intervalo en UTC.

MaintenanceSchedule

Calendario de mantenimiento próximo.

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

string (Timestamp format)

Solo de salida. Hora de inicio de cualquier mantenimiento programado para esta instancia.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Hora de finalización de cualquier mantenimiento programado para esta instancia.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

Configuración de la 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. El rol de la instancia en la replicación entre instancias.
primaryInstance

object (RemoteInstance)

Opcional. Detalles de la instancia principal que se usa como origen de replicación de esta instancia secundaria.

Este campo solo se define en una instancia secundaria.
secondaryInstances[]

object (RemoteInstance)

Opcional. Lista de instancias secundarias que se replican desde esta instancia principal.

Este campo solo se define en una instancia principal.
updateTime

string (Timestamp format)

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

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Una vista de solo salida de todas las instancias miembro que participan en la replicación entre instancias. Esta vista la proporcionará cada instancia de miembro, independientemente de su rol de instancia(principal 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 de la que está replicando. Sin embargo, en los casos en los que la instancia principal no esté disponible(por ejemplo, si hay una interrupción regional), se puede enviar una solicitud Getinstance a cualquier otra instancia miembro y este campo mostrará todas las instancias miembro que participen en la replicación entre instancias.

InstanceRole

El rol de la instancia en la replicación entre instancias.

Enumeraciones
INSTANCE_ROLE_UNSPECIFIED No se ha definido 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 en ninguna otra instancia ni desde ninguna otra instancia.
PRIMARY Una instancia que permite tanto lecturas como escrituras. Los datos que se escriban en esta instancia también se replicarán en las instancias secundarias adjuntas.
SECONDARY Una instancia que solo permite lecturas y replica datos de una instancia principal.

RemoteInstance

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 recurso completa de la instancia remota con el formato projects//locations//instances/
uid

string

Solo de salida. Identificador único de la instancia remota.

Tipo de miembro

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 de salida. La instancia principal que actúa como origen de la replicación de las instancias secundarias.
secondaryInstances[]

object (RemoteInstance)

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

AutomatedBackupConfig

Configuración de la 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. 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 conservan las copias de seguridad automatizadas antes de que se eliminen. El valor debe estar entre 1 y 365 días. Si no se especifica, el valor predeterminado es 35 días.

Duración en segundos con hasta nueve decimales, que termina con "s". Por ejemplo: "3.5s".
Campo de unión schedule. La programación de las copias de seguridad automáticas. schedule solo puede ser una de las siguientes cosas:
fixedFrequencySchedule

object (FixedFrequencySchedule)

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

FixedFrequencySchedule

Esta programación permite que la copia de seguridad se active con una frecuencia fija (actualmente, solo se admite la frecuencia diaria).

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

object (TimeOfDay)

Obligatorio. La hora de inicio de cada copia de seguridad automática en UTC. Debe ser la hora en punto. Este campo es obligatorio.

AutomatedBackupMode

El modo de copia de seguridad automática.

Enumeraciones
AUTOMATED_BACKUP_MODE_UNSPECIFIED Valor predeterminado. No se ha especificado la configuración de la copia de seguridad automatizada.
DISABLED Configuración de copia de seguridad automática inhabilitada.
ENABLED Se ha habilitado la configuración de copias de seguridad automatizadas.

Métodos

backup

 Instancia de copia de seguridad.

create

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

delete

 Elimina una sola instancia.

get

 Obtiene los detalles de una sola instancia.

getCertificateAuthority

 Obtiene detalles sobre la autoridad de certificación de una instancia.

list

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

patch

 Actualiza los parámetros de una sola instancia.

rescheduleMaintenance

 Reprograma el próximo evento de mantenimiento.