REST Resource: projects.locations.clusters

Recurso: Cluster

Es una instancia de clúster.

Representación JSON
{
  "name": string,
  "createTime": string,
  "state": enum (State),
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "pscConfigs": [
    {
      object (PscConfig)
    }
  ],
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "pscConnections": [
    {
      object (PscConnection)
    }
  ],
  "stateInfo": {
    object (StateInfo)
  },
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (ClusterPersistenceConfig)
  },
  "redisConfigs": {
    string: string,
    ...
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "crossClusterReplicationConfig": {
    object (CrossClusterReplicationConfig)
  },
  "pscServiceAttachments": [
    {
      object (PscServiceAttachment)
    }
  ],
  "clusterEndpoints": [
    {
      object (ClusterEndpoint)
    }
  ],
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "labels": {
    string: string,
    ...
  },
  "aclPolicy": string,
  "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,
  "sizeGb": integer,
  "shardCount": integer,
  "preciseSizeGb": number,
  "deletionProtectionEnabled": boolean,
  "maintenancePolicy": {
    object (ClusterMaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (ClusterMaintenanceSchedule)
  },
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "simulateMaintenanceEvent": boolean,
  "backupCollection": string,
  "kmsKey": string,
  "ondemandMaintenance": boolean,
  "asyncClusterEndpointsDeletionEnabled": boolean,
  "maintenanceVersion": string,
  "effectiveMaintenanceVersion": string,
  "serverCaMode": enum (ServerCaMode),
  "serverCaPool": string,
  "rotateServerCertificate": boolean,
  "aclPolicyInSync": boolean
}
Campos
name

string

Obligatorio. Es el identificador. Nombre único del recurso en este permiso, incluido el proyecto y la ubicación mediante el formulario: projects/{projectId}/locations/{locationId}/clusters/{clusterId}

createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo asociada a la solicitud de creación del clúster.

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

state

enum (State)

Solo salida. Es el estado actual de este clúster. Puede ser CREATING, READY, UPDATING, DELETING y SUSPENDED.

uid

string

Solo salida. Es el identificador único asignado por el sistema para el clúster.

authorizationMode

enum (AuthorizationMode)

Es opcional. Es el modo de autorización del clúster de Redis. Si no se proporciona, la función de autenticación se inhabilita para el clúster.

transitEncryptionMode

enum (TransitEncryptionMode)

Es opcional. Es la encriptación en tránsito para el clúster de Redis. Si no se proporciona, la encriptación se inhabilita para el clúster.

pscConfigs[]

object (PscConfig)

Es opcional. Cada PscConfig configura la red del consumidor en la que se designarán IPs al clúster para el acceso del cliente a través de la automatización de Private Service Connect. Actualmente, solo se admite un PscConfig.

discoveryEndpoints[]

object (DiscoveryEndpoint)

Solo salida. Son los extremos creados en cada red determinada para que los clientes de Redis se conecten al clúster. Actualmente, solo se admite un extremo de descubrimiento.

pscConnections[]

object (PscConnection)

Solo salida. Es la lista de conexiones de PSC que se crean automáticamente a través de la automatización de la conectividad del servicio.

stateInfo

object (StateInfo)

Solo salida. Es información adicional sobre el estado actual del clúster.

nodeType

enum (NodeType)

Es opcional. Es el tipo de un nodo de Redis en el clúster. NodeType determina el tipo de máquina subyacente de un nodo de Redis.

persistenceConfig

object (ClusterPersistenceConfig)

Es opcional. Es la configuración de persistencia (RDB, AOF) para el clúster.

redisConfigs

map (key: string, value: string)

Es opcional. Pares clave-valor de las anulaciones del cliente para los parámetros de configuración de Redis mutables

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

zoneDistributionConfig

object (ZoneDistributionConfig)

Es opcional. Esta configuración se usará para determinar cómo quiere el cliente que distribuyamos los recursos del clúster dentro de la región.

crossClusterReplicationConfig

object (CrossClusterReplicationConfig)

Es opcional. Es la configuración de la replicación entre clústeres.

pscServiceAttachments[]

object (PscServiceAttachment)

Solo salida. Detalles del adjunto de servicio para configurar conexiones de PSC

clusterEndpoints[]

object (ClusterEndpoint)

Es opcional. Es una lista de extremos del clúster.

automatedBackupConfig

object (AutomatedBackupConfig)

Es opcional. Es la configuración de copia de seguridad automática del clúster.

encryptionInfo

object (EncryptionInfo)

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

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.

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" }.

aclPolicy

string

Es opcional. Es la política de ACL que se aplicará al clúster.

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. Copias de seguridad almacenadas en buckets de Cloud Storage Los buckets de Cloud Storage deben estar en la misma región que los clústeres. Se requiere permiso de lectura para importar desde los objetos de Cloud Storage proporcionados.

managedBackupSource

object (ManagedBackupSource)

Es opcional. Son las copias de seguridad que genera y administra el servicio de Memorystore.

Fin de los campos mutuamente excluyentes.
replicaCount

integer

Es opcional. Es la cantidad de nodos de réplica por fragmento.

sizeGb

integer

Solo salida. Tamaño de la memoria de Redis en GB para todo el clúster, redondeado al siguiente número entero.

shardCount

integer

Es opcional. Es la cantidad de fragmentos del clúster de Redis.

preciseSizeGb

number

Solo salida. Valor preciso del tamaño de la memoria de Redis en GB para todo el clúster.

deletionProtectionEnabled

boolean

Es opcional. La operación de eliminación fallará cuando el valor se establezca como verdadero.

maintenancePolicy

object (ClusterMaintenancePolicy)

Es opcional. ClusterMaintenancePolicy determina cuándo permitir o rechazar actualizaciones.

maintenanceSchedule

object (ClusterMaintenanceSchedule)

Solo salida. ClusterMaintenanceSchedule (solo salida) Programa de mantenimiento publicado.

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.

simulateMaintenanceEvent

boolean

Es opcional. Solo entrada. Simula un evento de mantenimiento.

backupCollection

string

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

kmsKey

string

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

ondemandMaintenance
(deprecated)

boolean

Es opcional. Solo entrada. Mantenimiento a pedido del clúster. Este campo se puede usar para activar una actualización crítica a pedido en el clúster.

asyncClusterEndpointsDeletionEnabled

boolean

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

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 del clúster.

serverCaMode

enum (ServerCaMode)

Es opcional. Modo de AC del servidor para el clúster.

serverCaPool

string

Es opcional. Es el grupo de AC administrado por el cliente para el clúster. Solo se aplica a BYOCA, es decir, si serverCaMode es SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA. Formato: "projects/{project}/locations/{region}/caPools/{ca_pool}".

rotateServerCertificate

boolean

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

aclPolicyInSync
(deprecated)

boolean

Es opcional. Solo salida. Obsoleto: Indica si las reglas de la ACL aplicadas al clúster 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 los clústeres.

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

string

Es opcional. Son los URIs de los objetos de Cloud Storage que se importarán. 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: //redis.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 redis.googleapis.com.

Estado

Representa los diferentes estados de un clúster de Redis.

Enums
STATE_UNSPECIFIED Sin establecer
CREATING Se está creando el clúster de Redis.
ACTIVE Se creó el clúster de Redis y se puede usar por completo.
UPDATING Se está actualizando la configuración del clúster de Redis.
DELETING Se está borrando el clúster de Redis.

AuthorizationMode

Es el modo de autorización disponible de un clúster de Redis.

Enums
AUTH_MODE_UNSPECIFIED Sin establecer
AUTH_MODE_IAM_AUTH Modo de autorización básico de IAM
AUTH_MODE_DISABLED Modo de autorización inhabilitada
AUTH_MODE_TOKEN_AUTH Modo de autorización basado en tokens

TransitEncryptionMode

Modo de encriptación en tránsito disponible.

Enums
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED No se configuró la encriptación en tránsito.
TRANSIT_ENCRYPTION_MODE_DISABLED La encriptación en tránsito está inhabilitada.
TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION Usa la encriptación administrada por el servidor para la encriptación en tránsito.

PscConfig

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

string

Obligatorio. 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}.

DiscoveryEndpoint

Son los extremos de cada red para que los clientes de Redis se conecten al clúster.

Representación JSON
{
  "address": string,
  "port": integer,
  "pscConfig": {
    object (PscConfig)
  }
}
Campos
address

string

Solo salida. Es la dirección del extremo de Redis expuesto que usan los clientes para conectarse al servicio. La dirección puede ser una IP o un nombre de host.

port

integer

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

pscConfig

object (PscConfig)

Solo salida. Es la configuración del cliente para determinar dónde se crea el extremo y desde dónde se accede a él.

PscConnection

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

Representación JSON
{
  "pscConnectionId": string,
  "address": 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.

address

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. Ejemplo: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.

projectId

string

Es opcional. Es el ID del proyecto del consumidor en 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. Ten en cuenta que este valor se actualiza periódicamente. Para obtener el estado más reciente de una conexión de PSC, consulta https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.

connectionType

enum (ConnectionType)

Solo salida. Es el tipo de conexión de PSC.

Número de puerto del extremo de descubrimiento expuesto. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
port

integer

Solo salida. El puerto solo se establecerá para el extremo principal/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.
PSC_CONNECTION_STATUS_ACTIVE La conexión está activa
PSC_CONNECTION_STATUS_NOT_FOUND No se encontró la conexión

Tipo de conexión

Es el tipo de conexión de PSC para el acceso al clúster.

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

StateInfo

Representa información adicional sobre el estado del clúster.

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)

Describe la actualización en curso del clúster cuando el estado del clúster es UPDATING.

Fin de los campos mutuamente excluyentes.

UpdateInfo

Representa información sobre un clúster en proceso de actualización.

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

integer

Cantidad objetivo de fragmentos para el clúster de Redis

targetReplicaCount

integer

Es la cantidad objetivo de nodos de réplica por fragmento.

targetNodeType

enum (NodeType)

Es el tipo de nodo de destino para el clúster de Redis.

ClusterPersistenceConfig

Es la configuración de la funcionalidad de persistencia.

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

enum (PersistenceMode)

Es opcional. Es el modo de persistencia.

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

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 de 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. 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 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 de instantáneas disponibles.

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 de la persistencia basada en AOF.

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

enum (AppendFsync)

Opcional. Es la configuración de fsync.

AppendFsync

Son los modos de fsync disponibles.

Enums
APPEND_FSYNC_UNSPECIFIED Sin establecer Valor predeterminado: EVERYSEC
NO Nunca se realiza fsync. Normalmente, Linux vaciará los datos cada 30 segundos con esta configuración, pero depende del ajuste exacto del kernel.
EVERYSEC fsync cada segundo. Lo suficientemente rápido, y es posible que pierdas 1 segundo de datos si hay un desastre
ALWAYS fsync cada vez que se agregan comandos de escritura nuevos al AOF Tiene la mejor protección contra la pérdida de datos a costa del rendimiento.

ZoneDistributionConfig

Es la configuración de distribución de zonas para la asignación de recursos del clúster.

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

enum (ZoneDistributionMode)

Es opcional. Es el modo de distribución de zonas. El valor predeterminado es MULTI_ZONE si no se especifica.

zone

string

Es opcional. Cuando se selecciona la distribución de ZONA ÚNICA, el campo de zona se usa para asignar todos los recursos en esa zona. Esto no se aplica a MULTI_ZONE y se ignoraría para los clústeres de MULTI_ZONE.

zones[]

string

Es opcional. Especifica las zonas de un clúster multizona en las que Redis Cluster asigna recursos. Esta marca no se aplica a los clústeres de zona única.

ZoneDistributionMode

Define varios modos de distribución de zonas.

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Sin establecer. Valor predeterminado: MULTI_ZONE
MULTI_ZONE Distribuye todos los recursos en 3 zonas elegidas al azar dentro de la región.
SINGLE_ZONE Distribuye todos los recursos en una sola zona. Cuando se selecciona este modo, se debe especificar el campo de zona.

CrossClusterReplicationConfig

Es la configuración de la replicación entre clústeres.

Representación JSON
{
  "clusterRole": enum (ClusterRole),
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campos
clusterRole

enum (ClusterRole)

Solo salida. Es el rol del clúster en la replicación entre clústeres.

primaryCluster

object (RemoteCluster)

Son los detalles del clúster principal que se usa como fuente de replicación para este clúster secundario.

Este campo solo se establece para un clúster secundario.

secondaryClusters[]

object (RemoteCluster)

Es la lista de clústeres secundarios que se replican desde este clúster principal.

Este campo solo se establece para un clúster principal.

updateTime

string (Timestamp format)

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

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 todos los clústeres miembros que participan en la replicación entre clústeres. Cada clúster miembro proporcionará esta vista, independientemente de su rol(principal o secundario).

Un clúster principal puede proporcionar información sobre todos los clústeres secundarios que se replican desde él. Sin embargo, un clúster secundario solo conoce el clúster principal desde el que se replica. Sin embargo, en situaciones en las que el clúster principal no está disponible(p.ej., una interrupción regional), se puede enviar una solicitud clusters.get a cualquier otro clúster miembro, y este campo mostrará todos los clústeres miembros que participan en la replicación entre clústeres.

ClusterRole

Es el rol del clúster en la replicación entre clústeres.

Enums
CLUSTER_ROLE_UNSPECIFIED No se estableció el rol del clúster. El comportamiento es equivalente a NONE.
NONE Este clúster no participa en la replicación entre clústeres. Es un clúster independiente y no se replica hacia ni desde ningún otro clúster.
PRIMARY Es un clúster que permite operaciones de lectura y escritura. Los datos que se escriben en este clúster también se replican en los clústeres secundarios adjuntos.
SECONDARY Es un clúster que solo permite lecturas y replica datos de un clúster principal.

RemoteCluster

Son los detalles del clúster remoto asociado con este clúster en una configuración de replicación entre clústeres.

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

string

Solo salida. Ruta de acceso completa del recurso del clúster remoto con el siguiente formato: projects//locations//clusters/

uid

string

Solo salida. Es el identificador único del clúster remoto.

Membresía

Es una vista de solo salida de todos los clústeres miembros que participan en la replicación entre clústeres.

Representación JSON
{
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ]
}
Campos
primaryCluster

object (RemoteCluster)

Solo salida. Es el clúster principal que actúa como fuente de replicación para los clústeres secundarios.

secondaryClusters[]

object (RemoteCluster)

Solo salida. Es la lista de clústeres secundarios que se replican desde el clúster principal.

ClusterMaintenancePolicy

Es la política de mantenimiento por clúster.

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

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó la política, es decir, se asignó el período de mantenimiento o el período de rechazo.

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, es decir, se actualizó el período de mantenimiento o el período de denegación.

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 (ClusterWeeklyMaintenanceWindow)

Es 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 weeklyMaintenanceWindow sea uno.

ClusterWeeklyMaintenanceWindow

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.

ClusterMaintenanceSchedule

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

PscServiceAttachment

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. 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 conexión de PSC que segmenta este adjunto de servicio.

ClusterEndpoint

ClusterEndpoint consta de conexiones de PSC que se crean como un grupo en cada red de VPC para acceder al clúster. 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)

Obligatorio. 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 información detallada 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 un clúster a través de la automatización de la conectividad del servicio (conexión registrada automáticamente) durante la creación del clúster, o bien el cliente puede crearla por su cuenta (conexión registrada 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)

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 información detallada de una conexión de PSC creada por el cliente propietario del clúster.

Fin de los campos mutuamente excluyentes.

PscAutoConnection

Son los detalles de los recursos del consumidor en una conexión de PSC que se crea a través de la automatización de la conectividad de servicios.

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

string

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

address

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. Ejemplo: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.

projectId

string

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

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

AutomatedBackupConfig

Es la configuración de copia de seguridad automática de un clúster.

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

  // 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.
  "retention": string
}
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.

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

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

Modo de AC del servidor para el clúster.

Enums
SERVER_CA_MODE_UNSPECIFIED No se especificó el modo de la AC del servidor.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA Cada clúster tiene su propia AC administrada por Google.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA El clúster usa la AC compartida administrada por Google en la región.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA El clúster usa la AC administrada por el cliente de la CAS.

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 del estado de las distintas revisiones de esta política de ACL en el clúster.

Métodos

addTokenAuthUser

Agrega un usuario de autenticación con token para un clúster habilitado para la autenticación basada en tokens.

backup

Crea una copia de seguridad del clúster de Redis.

create

Crea un clúster de Redis basado en las propiedades especificadas.

delete

Borra un clúster de Redis específico.

get

Obtiene los detalles de un clúster de Redis específico.

getCertificateAuthority

Obtiene los detalles de la información de la autoridad certificadora para el clúster de Redis.

list

Enumera todos los clústeres de Redis que son propiedad de un proyecto en la ubicación (región) especificada o en todas las ubicaciones.

patch

Actualiza los metadatos y la configuración de un clúster de Redis específico.

rescheduleClusterMaintenance

Reprograma el próximo evento de mantenimiento.