REST Resource: projects.locations.clusters

Ressource: Cluster

Eine Clusterinstanz.

JSON-Darstellung
{
  "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
}
Felder
name

string

Erforderlich. ID. Eindeutiger Name der Ressource in diesem Bereich, einschließlich Projekt und Standort, die folgendes Format haben: projects/{projectId}/locations/{locationId}/clusters/{clusterId}

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für die Anfrage zur Clustererstellung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

state

enum (State)

Nur Ausgabe. Der aktuelle Status dieses Clusters. Kann CREATING, READY, UPDATING, DELETING und SUSPENDED sein

uid

string

Nur Ausgabe. Vom System zugewiesene eindeutige Kennung für den Cluster.

authorizationMode

enum (AuthorizationMode)

Optional. Der Autorisierungsmodus des Redis-Clusters. Wenn nicht angegeben, ist die Authentifizierungsfunktion für den Cluster deaktiviert.

transitEncryptionMode

enum (TransitEncryptionMode)

Optional. Die Verschlüsselung während der Übertragung für den Redis-Cluster. Wenn nicht angegeben, ist die Verschlüsselung für den Cluster deaktiviert.

pscConfigs[]

object (PscConfig)

Optional. Jede PscConfig konfiguriert das Nutzer-Netzwerk, in dem dem Cluster IP-Adressen für den Clientzugriff über die Private Service Connect-Automatisierung zugewiesen werden. Derzeit wird nur eine PscConfig unterstützt.

discoveryEndpoints[]

object (DiscoveryEndpoint)

Nur Ausgabe. Endpunkte, die in jedem angegebenen Netzwerk erstellt werden, damit Redis-Clients eine Verbindung zum Cluster herstellen können. Derzeit wird nur ein Discovery-Endpunkt unterstützt.

pscConnections[]

object (PscConnection)

Nur Ausgabe. Die Liste der PSC-Verbindungen, die automatisch durch die Automatisierung von Dienstverbindungen erstellt werden.

stateInfo

object (StateInfo)

Nur Ausgabe. Zusätzliche Informationen zum aktuellen Status des Clusters.

nodeType

enum (NodeType)

Optional. Der Typ eines Redis-Knotens im Cluster. NodeType bestimmt den zugrunde liegenden Maschinentyp eines Redis-Knotens.

persistenceConfig

object (ClusterPersistenceConfig)

Optional. Persistenzkonfiguration (RDB, AOF) für den Cluster.

redisConfigs

map (key: string, value: string)

Optional. Schlüssel/Wert-Paare mit Kundenüberschreibungen für veränderbare Redis-Konfigurationen

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

zoneDistributionConfig

object (ZoneDistributionConfig)

Optional. Mit dieser Konfiguration wird festgelegt, wie Clusterressourcen in der Region verteilt werden sollen.

crossClusterReplicationConfig

object (CrossClusterReplicationConfig)

Optional. Konfiguration der clusterübergreifenden Replikation.

pscServiceAttachments[]

object (PscServiceAttachment)

Nur Ausgabe. Details zum Dienstanhang zum Konfigurieren von PSC-Verbindungen

clusterEndpoints[]

object (ClusterEndpoint)

Optional. Eine Liste der Cluster-Endpunkte.

automatedBackupConfig

object (AutomatedBackupConfig)

Optional. Die Konfiguration für automatische Sicherungen für den Cluster.

encryptionInfo

object (EncryptionInfo)

Nur Ausgabe. Verschlüsselungsinformationen der Daten im Ruhezustand des Clusters.

availableMaintenanceVersions[]

string

Nur Ausgabe. Anhand dieses Felds werden die verfügbaren Wartungsversionen für das Selfservice-Update ermittelt.

allowFewerZonesDeployment
(deprecated)

boolean

Optional. Nicht veränderbar. Verworfen, nicht verwenden.

labels

map (key: string, value: string)

Optional. Labels zur Darstellung von vom Nutzer bereitgestellten Metadaten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

aclPolicy

string

Optional. Die ACL-Richtlinie, die auf den Cluster angewendet werden soll.

aclPolicyInfo

object (AclPolicyInfo)

Nur Ausgabe. Details der angewendeten ACL-Richtlinie.

Die Quelle, aus der importiert werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
gcsSource

object (GcsBackupSource)

Optional. In Cloud Storage-Buckets gespeicherte Sicherungen. Die Cloud Storage-Buckets müssen sich in derselben Region wie die Cluster befinden. Zum Importieren aus den bereitgestellten Cloud Storage-Objekten ist die Leseberechtigung erforderlich.

managedBackupSource

object (ManagedBackupSource)

Optional. Sicherungen, die vom Memorystore-Dienst generiert und verwaltet werden.

Ende der sich gegenseitig ausschließenden Felder.
replicaCount

integer

Optional. Die Anzahl der Replikatknoten pro Shard.

sizeGb

integer

Nur Ausgabe. Die Redis-Arbeitsspeichergröße in GB für den gesamten Cluster, auf die nächste Ganzzahl aufgerundet.

shardCount

integer

Optional. Anzahl der Shards für den Redis-Cluster.

preciseSizeGb

number

Nur Ausgabe. Genaue Größe des Redis-Arbeitsspeichers in GB für den gesamten Cluster.

deletionProtectionEnabled

boolean

Optional. Der Löschvorgang schlägt fehl, wenn der Wert auf „true“ gesetzt ist.

maintenancePolicy

object (ClusterMaintenancePolicy)

Optional. ClusterMaintenancePolicy bestimmt, wann Updates zugelassen oder abgelehnt werden.

maintenanceSchedule

object (ClusterMaintenanceSchedule)

Nur Ausgabe. ClusterMaintenanceSchedule Output only Published maintenance schedule.

satisfiesPzs

boolean

Optional. Nur Ausgabe. Reserviert für zukünftige Verwendungen.

satisfiesPzi

boolean

Optional. Nur Ausgabe. Reserviert für zukünftige Verwendungen.

simulateMaintenanceEvent

boolean

Optional. Nur Eingabe. Wartungsereignis simulieren

backupCollection

string

Optional. Nur Ausgabe. Der vollständige Ressourcenname der Sicherungssammlung. Beispiel: projects/{project}/locations/{location}/backupCollections/{collection}

kmsKey

string

Optional. Der KMS-Schlüssel, der zum Verschlüsseln der inaktiven Daten des Clusters verwendet wird.

ondemandMaintenance
(deprecated)

boolean

Optional. Nur Eingabe. Bedarfsgesteuerte Wartung für den Cluster. Mit diesem Feld kann ein On-Demand-Update für kritische Sicherheitslücken im Cluster ausgelöst werden.

asyncClusterEndpointsDeletionEnabled

boolean

Optional. Wenn „true“ festgelegt ist, können Clusterendpunkte, die von Kunden erstellt und registriert wurden, asynchron gelöscht werden. Das bedeutet, dass ein solcher Clusterendpunkt abgemeldet werden kann, bevor die Weiterleitungsregeln im Clusterendpunkt gelöscht werden.

maintenanceVersion

string

Optional. Mit diesem Feld kann ein Selfservice-Update ausgelöst werden, um die gewünschte Wartungsversion anzugeben. Die Eingabe für dieses Feld kann über das Feld „availableMaintenanceVersions“ bestimmt werden.

effectiveMaintenanceVersion

string

Nur Ausgabe. Dieses Feld gibt die tatsächliche Wartungsversion des Clusters an.

serverCaMode

enum (ServerCaMode)

Optional. Modus für Serverzertifizierungsstellen für den Cluster.

serverCaPool

string

Optional. Kundenverwalteter CA-Pool für den Cluster. Gilt nur für BYOCA, d.h. wenn „serverCaMode“ SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA ist. Format: „projects/{project}/locations/{region}/caPools/{ca_pool}“.

rotateServerCertificate

boolean

Optional. Nur Eingabe. Rotieren Sie die Serverzertifikate.

aclPolicyInSync
(deprecated)

boolean

Optional. Nur Ausgabe. Veraltet: Gibt an, ob die auf den Cluster angewendeten ACL-Regeln synchronisiert sind.

GcsBackupSource

In Cloud Storage-Buckets gespeicherte Sicherungen. Die Cloud Storage-Buckets müssen sich in derselben Region wie die Cluster befinden.

JSON-Darstellung
{
  "uris": [
    string
  ]
}
Felder
uris[]

string

Optional. URIs der Cloud Storage-Objekte, die importiert werden sollen. Beispiel: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Von Memorystore generierte und verwaltete Backups.

JSON-Darstellung
{
  "backup": string
}
Felder
backup

string

Optional. Beispiel: //redis.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} Eine kürzere Version (ohne das Präfix) des Sicherungsnamens wird ebenfalls unterstützt, z. B. projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId}. In diesem Fall wird davon ausgegangen, dass sich die Sicherung unter redis.googleapis.com befindet.

Bundesland

Stellt die verschiedenen Status eines Redis-Clusters dar.

Enums
STATE_UNSPECIFIED Nicht festgelegt.
CREATING Der Redis-Cluster wird erstellt.
ACTIVE Der Redis-Cluster wurde erstellt und ist vollständig nutzbar.
UPDATING Die Redis-Clusterkonfiguration wird aktualisiert.
DELETING Der Redis-Cluster wird gelöscht.

AuthorizationMode

Verfügbarer Autorisierungsmodus eines Redis-Clusters.

Enums
AUTH_MODE_UNSPECIFIED Nicht festgelegt.
AUTH_MODE_IAM_AUTH Einfacher IAM-Autorisierungsmodus
AUTH_MODE_DISABLED Modus „Autorisierung deaktiviert“
AUTH_MODE_TOKEN_AUTH Tokenbasierter Autorisierungsmodus

TransitEncryptionMode

Verfügbare Modi für die Verschlüsselung während der Übertragung.

Enums
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Die Verschlüsselung während der Übertragung ist nicht festgelegt.
TRANSIT_ENCRYPTION_MODE_DISABLED Die Verschlüsselung während der Übertragung ist deaktiviert.
TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION Verwenden Sie die serverseitige Verschlüsselung für die Verschlüsselung während der Übertragung.

PscConfig

JSON-Darstellung
{
  "network": string
}
Felder
network

string

Erforderlich. Das Netzwerk, in dem die IP-Adresse des Discovery-Endpunkts reserviert wird, im Format „projects/{networkProject}/global/networks/{network_id}“.

DiscoveryEndpoint

Endpunkte in jedem Netzwerk, über die Redis-Clients eine Verbindung zum Cluster herstellen können.

JSON-Darstellung
{
  "address": string,
  "port": integer,
  "pscConfig": {
    object (PscConfig)
  }
}
Felder
address

string

Nur Ausgabe. Adresse des bereitgestellten Redis-Endpunkts, der von Clients verwendet wird, um eine Verbindung zum Dienst herzustellen. Die Adresse kann entweder eine IP-Adresse oder ein Hostname sein.

port

integer

Nur Ausgabe. Die Portnummer des exponierten Redis-Endpunkts.

pscConfig

object (PscConfig)

Nur Ausgabe. Kundenkonfiguration für den Ort, an dem der Endpunkt erstellt wird und auf den zugegriffen wird.

PscConnection

Details zu Nutzerressourcen in einer PSC-Verbindung.

JSON-Darstellung
{
  "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.
}
Felder
pscConnectionId

string

Erforderlich. Die PSC-Verbindungs-ID der Weiterleitungsregel, die mit dem Dienstanhang verbunden ist.

address

string

Erforderlich. Die IP-Adresse, die im Netzwerk des Nutzers für die PSC-Weiterleitungsregel zugewiesen ist.

forwardingRule

string

Erforderlich. Der URI der Weiterleitungsregel auf der Kundenseite. Beispiel: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.

projectId

string

Optional. Projekt-ID des Nutzerprojekts, in dem die Weiterleitungsregel erstellt wird.

network

string

Erforderlich. Das Consumer-Netzwerk, in dem sich die IP-Adresse befindet, im Format „projects/{projectId}/global/networks/{network_id}“.

serviceAttachment

string

Erforderlich. Der Dienstanhang, der das Ziel der PSC-Verbindung ist, im Format „projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}“.

pscConnectionStatus

enum (PscConnectionStatus)

Nur Ausgabe. Der Status der PSC-Verbindung. Dieser Wert wird regelmäßig aktualisiert. Den aktuellen Status einer PSC-Verbindung finden Sie unter https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.

connectionType

enum (ConnectionType)

Nur Ausgabe. Typ der PSC-Verbindung.

Die Portnummer des bereitgestellten Erkennungs-Endpunkts. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
port

integer

Nur Ausgabe. Der Port wird nur für den primären/Leser- oder Discovery-Endpunkt festgelegt.

Ende der sich gegenseitig ausschließenden Felder.

PscConnectionStatus

Status der PSC-Verbindung.

Enums
PSC_CONNECTION_STATUS_UNSPECIFIED Der PSC-Verbindungsstatus ist nicht angegeben.
PSC_CONNECTION_STATUS_ACTIVE Die Verbindung ist aktiv.
PSC_CONNECTION_STATUS_NOT_FOUND Keine Verbindung gefunden

ConnectionType

Typ einer PSC-Verbindung für den Clusterzugriff.

Enums
CONNECTION_TYPE_UNSPECIFIED Der Typ des Clusterendpunkts ist nicht festgelegt
CONNECTION_TYPE_DISCOVERY Clusterendpunkt, der für die Erkennung der Clustertopologie verwendet wird.
CONNECTION_TYPE_PRIMARY Clusterendpunkt, der als primärer Endpunkt für den Zugriff auf die primäre Instanz verwendet wird.
CONNECTION_TYPE_READER Clusterendpunkt, der als Reader-Endpunkt für den Zugriff auf Replikate verwendet wird.

StateInfo

Stellt zusätzliche Informationen zum Status des Clusters dar.

JSON-Darstellung
{

  // 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.
}
Felder
Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
updateInfo

object (UpdateInfo)

Beschreibt die laufende Aktualisierung des Clusters, wenn der Clusterstatus UPDATING ist.

Ende der sich gegenseitig ausschließenden Felder.

UpdateInfo

Stellt Informationen zu einem Cluster dar, der aktualisiert wird.

JSON-Darstellung
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetNodeType": enum (NodeType)
}
Felder
targetShardCount

integer

Zielanzahl der Shards für den Redis-Cluster

targetReplicaCount

integer

Zielanzahl der Replikatknoten pro Shard.

targetNodeType

enum (NodeType)

Zielknotentyp für Redis-Cluster.

ClusterPersistenceConfig

Konfiguration der Persistenzfunktion.

JSON-Darstellung
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Felder
mode

enum (PersistenceMode)

Optional. Der Persistenzmodus.

rdbConfig

object (RDBConfig)

Optional. RDB-Konfiguration. Dieses Feld wird ignoriert, wenn der Modus nicht „RDB“ ist.

aofConfig

object (AOFConfig)

Optional. AOF-Konfiguration Dieses Feld wird ignoriert, wenn der Modus nicht „AOF“ ist.

PersistenceMode

Verfügbare Persistenzmodi.

Enums
PERSISTENCE_MODE_UNSPECIFIED Nicht festgelegt.
DISABLED Die Persistenz ist deaktiviert und alle Snapshot-Daten werden gelöscht.
RDB Die RDB-basierte Persistenz ist aktiviert.
AOF AOF-basierte Persistenz ist aktiviert.

RDBConfig

Konfiguration der RDB-basierten Persistenz.

JSON-Darstellung
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Felder
rdbSnapshotPeriod

enum (SnapshotPeriod)

Optional. Zeitraum zwischen RDB-Snapshots.

rdbSnapshotStartTime

string (Timestamp format)

Optional. Die Zeit, zu der der erste Snapshot erstellt wurde bzw. erstellt wird und an der zukünftige Snapshots ausgerichtet werden. Wenn nicht angegeben, wird die aktuelle Zeit verwendet.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

SnapshotPeriod

Verfügbare Snapshot-Zeiträume.

Enums
SNAPSHOT_PERIOD_UNSPECIFIED Nicht festgelegt.
ONE_HOUR Eine Stunde.
SIX_HOURS Sechs Stunden.
TWELVE_HOURS Zwölf Stunden.
TWENTY_FOUR_HOURS 24 Stunden.

AOFConfig

Konfiguration der AOF-basierten Persistenz.

JSON-Darstellung
{
  "appendFsync": enum (AppendFsync)
}
Felder
appendFsync

enum (AppendFsync)

Optional. fsync-Konfiguration.

AppendFsync

Verfügbare fsync-Modi.

Enums
APPEND_FSYNC_UNSPECIFIED Nicht festgelegt. Standard: EVERYSEC
NO Nie fsync. Normalerweise werden Daten unter Linux mit dieser Konfiguration alle 30 Sekunden geleert. Das hängt jedoch von der genauen Kernel-Abstimmung ab.
EVERYSEC fsync jede Sekunde. Schnell genug, aber bei einer Katastrophe können Daten von einer Sekunde verloren gehen
ALWAYS fsync wird jedes Mal ausgeführt, wenn dem AOF neue Schreibbefehle angehängt werden. Es bietet den besten Schutz vor Datenverlust, allerdings auf Kosten der Leistung.

ZoneDistributionConfig

Konfiguration für die Zonenverteilung für die Zuweisung von Clusterressourcen.

JSON-Darstellung
{
  "mode": enum (ZoneDistributionMode),
  "zone": string,
  "zones": [
    string
  ]
}
Felder
mode

enum (ZoneDistributionMode)

Optional. Der Modus der Zonenverteilung. Wenn nicht angegeben, wird standardmäßig MULTI_ZONE verwendet.

zone

string

Optional. Wenn SINGLE ZONE-Verteilung ausgewählt ist, wird das Zonenfeld verwendet, um alle Ressourcen in dieser Zone zuzuweisen. Dies gilt nicht für MULTI_ZONE und wird für MULTI_ZONE-Cluster ignoriert.

zones[]

string

Optional. Geben Sie die Zonen eines Mehrzonenclusters an, in denen Redis-Cluster Ressourcen zuweist. Dieses Flag gilt nicht für Cluster mit einer Zone.

ZoneDistributionMode

Definiert verschiedene Modi der Zonenverteilung.

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Nicht festgelegt. Standardwert: MULTI_ZONE
MULTI_ZONE Verteilen Sie alle Ressourcen auf drei zufällig ausgewählte Zonen innerhalb der Region.
SINGLE_ZONE Alle Ressourcen in einer einzelnen Zone verteilen Wenn dieser Modus ausgewählt ist, muss das Feld „zone“ angegeben werden.

CrossClusterReplicationConfig

Konfiguration der clusterübergreifenden Replikation.

JSON-Darstellung
{
  "clusterRole": enum (ClusterRole),
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Felder
clusterRole

enum (ClusterRole)

Nur Ausgabe. Die Rolle des Clusters bei der clusterübergreifenden Replikation.

primaryCluster

object (RemoteCluster)

Details des primären Clusters, der als Replikationsquelle für diesen sekundären Cluster verwendet wird.

Dieses Feld wird nur für einen sekundären Cluster festgelegt.

secondaryClusters[]

object (RemoteCluster)

Liste der sekundären Cluster, die Daten aus diesem primären Cluster replizieren.

Dieses Feld wird nur für einen primären Cluster festgelegt.

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der letzten Aktualisierung der Konfiguration für die clusterübergreifende Replikation.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

membership

object (Membership)

Nur Ausgabe. Eine reine Ausgabeansicht aller Mitgliedscluster, die an der clusterübergreifenden Replikation teilnehmen. Diese Ansicht wird von jedem Mitgliedscluster bereitgestellt, unabhängig von seiner Clusterrolle(primär oder sekundär).

Ein primärer Cluster kann Informationen zu allen sekundären Clustern liefern, die Daten daraus replizieren. Ein sekundärer Cluster kennt jedoch nur den primären Cluster, aus dem er repliziert wird. In Szenarien, in denen der primäre Cluster nicht verfügbar ist(z. B. bei einem regionalen Ausfall), kann jedoch eine „clusters.get“-Anfrage an einen beliebigen anderen Mitgliedscluster gesendet werden. In diesem Feld werden dann alle Mitgliedscluster aufgeführt, die an der clusterübergreifenden Replikation beteiligt sind.

ClusterRole

Die Rolle des Clusters bei der clusterübergreifenden Replikation.

Enums
CLUSTER_ROLE_UNSPECIFIED Die Clusterrolle ist nicht festgelegt. Das Verhalten entspricht NONE.
NONE Dieser Cluster ist nicht Teil der clusterübergreifenden Replikation. Es handelt sich um einen unabhängigen Cluster, der keine Daten in andere Cluster repliziert oder aus anderen Clustern repliziert.
PRIMARY Ein Cluster, der sowohl Lese- als auch Schreibvorgänge zulässt. Alle Daten, die in diesen Cluster geschrieben werden, werden auch in die angehängten sekundären Cluster repliziert.
SECONDARY Ein Cluster, der nur Lesezugriffe zulässt und Daten aus einem primären Cluster repliziert.

RemoteCluster

Details des Remote-Clusters, der in einer Einrichtung zur clusterübergreifenden Replikation mit diesem Cluster verknüpft ist.

JSON-Darstellung
{
  "cluster": string,
  "uid": string
}
Felder
cluster

string

Nur Ausgabe. Der vollständige Ressourcenpfad des Remote-Clusters im Format: projects//locations//clusters/

uid

string

Nur Ausgabe. Die eindeutige Kennung des Remote-Clusters.

Mitgliedschaft

Eine reine Ausgabeansicht aller Mitgliedscluster, die an der clusterübergreifenden Replikation teilnehmen.

JSON-Darstellung
{
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ]
}
Felder
primaryCluster

object (RemoteCluster)

Nur Ausgabe. Der primäre Cluster, der als Replikationsquelle für die sekundären Cluster dient.

secondaryClusters[]

object (RemoteCluster)

Nur Ausgabe. Die Liste der sekundären Cluster, die aus dem primären Cluster repliziert werden.

ClusterMaintenancePolicy

Wartungsrichtlinie pro Cluster.

JSON-Darstellung
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (ClusterWeeklyMaintenanceWindow)
    }
  ]
}
Felder
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Richtlinie erstellt wurde, d.h. das Wartungsfenster oder der Ausschlusszeitraum zugewiesen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit, zu der die Richtlinie aktualisiert wurde, d.h. das Wartungsfenster oder der Ablehnungszeitraum wurde aktualisiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

weeklyMaintenanceWindow[]

object (ClusterWeeklyMaintenanceWindow)

Optional. Das Wartungsfenster, das auf Ressourcen angewendet wird, die von dieser Richtlinie abgedeckt sind. Mindestens 1. Für die aktuelle Version wird erwartet, dass die maximale Anzahl von „weeklyMaintenanceWindow“ eins ist.

ClusterWeeklyMaintenanceWindow

Für wöchentliche Vorgänge angegebenes Zeitfenster.

JSON-Darstellung
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
Felder
day

enum (DayOfWeek)

Optional. Ermöglicht die Definition eines Zeitplans, der am angegebenen Wochentag ausgeführt wird.

startTime

object (TimeOfDay)

Optional. Beginn des Zeitfensters in UTC.

ClusterMaintenanceSchedule

Anstehender Wartungsplan.

JSON-Darstellung
{
  "startTime": string,
  "endTime": string
}
Felder
startTime

string (Timestamp format)

Nur Ausgabe. Die Startzeit der nächsten geplanten Wartung für diese Instanz.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

endTime

string (Timestamp format)

Nur Ausgabe. Die Endzeit der geplanten Wartung für diese Instanz.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

PscServiceAttachment

Konfiguration eines Dienstanhangs des Clusters zum Erstellen von PSC-Verbindungen.

JSON-Darstellung
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Felder
serviceAttachment

string

Nur Ausgabe. URI des Dienstanhangs, der als Ziel für die selbst erstellte PscConnection verwendet werden soll

connectionType

enum (ConnectionType)

Nur Ausgabe. Typ einer PSC-Verbindung, die auf diesen Dienstanhang ausgerichtet ist.

ClusterEndpoint

ClusterEndpoint besteht aus PSC-Verbindungen, die als Gruppe in jedem VPC-Netzwerk für den Zugriff auf den Cluster erstellt werden. In jeder Gruppe muss es eine Verbindung für jeden Dienstanhang im Cluster geben.

JSON-Darstellung
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Felder
connections[]

object (ConnectionDetail)

Erforderlich. Eine Gruppe von PSC-Verbindungen. Sie werden im selben VPC-Netzwerk erstellt, eines für jeden Dienstanhang im Cluster.

ConnectionDetail

Detaillierte Informationen zu jeder PSC-Verbindung.

JSON-Darstellung
{

  // 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.
}
Felder
Eine PSC-Verbindung zu einem Cluster kann entweder über die Service Connectivity Automation (automatisch registrierte Verbindung) während der Clustererstellung oder vom Kunden selbst (nutzerregistrierte Verbindung) erstellt werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
pscAutoConnection

object (PscAutoConnection)

Detaillierte Informationen zu einer PSC-Verbindung, die über die Automatisierung von Dienstverbindungen erstellt wurde.

pscConnection

object (PscConnection)

Detaillierte Informationen zu einer PSC-Verbindung, die vom Kunden erstellt wurde, dem der Cluster gehört.

Ende der sich gegenseitig ausschließenden Felder.

PscAutoConnection

Details zu Nutzerressourcen in einer PSC-Verbindung, die über die Automatisierung von Dienstverbindungen erstellt wird.

JSON-Darstellung
{
  "pscConnectionId": string,
  "address": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType)
}
Felder
pscConnectionId

string

Nur Ausgabe. Die PSC-Verbindungs-ID der Weiterleitungsregel, die mit dem Dienstanhang verbunden ist.

address

string

Nur Ausgabe. Die IP-Adresse, die im Netzwerk des Nutzers für die PSC-Weiterleitungsregel zugewiesen ist.

forwardingRule

string

Nur Ausgabe. Der URI der Weiterleitungsregel auf der Kundenseite. Beispiel: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.

projectId

string

Erforderlich. Die Consumer-Projekt-ID, aus der die Weiterleitungsregel erstellt wird.

network

string

Erforderlich. Das Consumer-Netzwerk, in dem sich die IP-Adresse befindet, im Format „projects/{projectId}/global/networks/{network_id}“.

serviceAttachment

string

Nur Ausgabe. Der Dienstanhang, der das Ziel der PSC-Verbindung ist, im Format „projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}“.

pscConnectionStatus

enum (PscConnectionStatus)

Nur Ausgabe. Der Status der PSC-Verbindung. Dieser Wert wird regelmäßig aktualisiert. Verwenden Sie die Private Service Connect APIs, um den aktuellen Status abzurufen.

connectionType

enum (ConnectionType)

Nur Ausgabe. Typ der PSC-Verbindung.

AutomatedBackupConfig

Die Konfiguration für automatische Sicherungen für einen Cluster.

JSON-Darstellung
{
  "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
}
Felder
automatedBackupMode

enum (AutomatedBackupMode)

Optional. Der Modus für automatische Sicherungen. Wenn der Modus deaktiviert ist, werden die anderen Felder ignoriert.

Der Zeitplan für automatische Sicherungen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Optional. Automatische Sicherungen in einem festen Rhythmus auslösen

Ende der sich gegenseitig ausschließenden Felder.
retention

string (Duration format)

Optional. Wie lange automatische Sicherungen aufbewahrt werden, bevor sie gelöscht werden. Der Wert sollte zwischen 1 und 365 Tagen liegen. Wenn keine Angabe erfolgt, beträgt der Standardwert 35 Tage.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

FixedFrequencySchedule

Mit diesem Zeitplan kann die Sicherung in einer festen Häufigkeit ausgelöst werden (derzeit wird nur täglich unterstützt).

JSON-Darstellung
{
  "startTime": {
    object (TimeOfDay)
  }
}
Felder
startTime

object (TimeOfDay)

Erforderlich. Die Startzeit jeder automatischen Sicherung in UTC. Sie muss auf den Beginn einer Stunde festgelegt sein. Dies ist ein Pflichtfeld.

AutomatedBackupMode

Der Modus für automatische Sicherungen.

Enums
AUTOMATED_BACKUP_MODE_UNSPECIFIED Standardwert. Die Konfiguration für automatische Sicherungen ist nicht angegeben.
DISABLED Konfiguration für automatische Sicherungen deaktiviert.
ENABLED Konfiguration für automatische Sicherungen aktiviert.

ServerCaMode

Modus für Serverzertifizierungsstellen für den Cluster.

Enums
SERVER_CA_MODE_UNSPECIFIED Der Modus der Server-CA ist nicht angegeben.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA Jeder Cluster hat eine eigene von Google verwaltete Zertifizierungsstelle.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA Der Cluster verwendet die von Google verwaltete gemeinsame Zertifizierungsstelle in der Region.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA Der Cluster verwendet eine vom Kunden verwaltete Zertifizierungsstelle von CAS.

AclPolicyInfo

Details der angewendeten ACL-Richtlinie.

JSON-Darstellung
{
  "appliedAclPolicy": string,
  "appliedAclPolicyRevision": string,
  "appliedAclPolicyRevisionNumber": string,
  "aclPolicyRevisionStatuses": [
    {
      object (AclPolicyRevisionStatus)
    }
  ]
}
Felder
appliedAclPolicy

string

Nur Ausgabe. Der Ressourcenname der angewendeten ACL-Richtlinie. Format: „projects/{project}/locations/{location}/aclPolicies/{aclPolicy}“

appliedAclPolicyRevision

string

Nur Ausgabe. Der Ressourcenname der angewendeten ACL-Richtlinienversion. Format: „projects/{project}/locations/{location}/aclPolicies/{aclPolicy}/revisions/{revision}“

appliedAclPolicyRevisionNumber

string (int64 format)

Nur Ausgabe. Die Revisionsnummer der angewendeten ACL-Richtlinienversion.

aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

Nur Ausgabe. Eine Liste der Status für verschiedene Versionen dieser ACL-Richtlinie im Cluster.

Methoden

addTokenAuthUser

Fügt einen Nutzer mit Token-Authentifizierung für einen Cluster hinzu, für den die Token-basierte Authentifizierung aktiviert ist.

backup

Sichern Sie den Redis-Cluster.

create

Erstellt einen Redis-Cluster basierend auf den angegebenen Eigenschaften.

delete

Löscht einen bestimmten Redis-Cluster.

get

Ruft die Details eines bestimmten Redis-Clusters ab.

getCertificateAuthority

Ruft die Details der Zertifizierungsstelleninformationen für den Redis-Cluster ab.

list

Listet alle Redis-Cluster auf, die einem Projekt gehören, entweder am angegebenen Standort (Region) oder an allen Standorten.

patch

Aktualisiert die Metadaten und Konfiguration eines bestimmten Redis-Clusters.

rescheduleClusterMaintenance

Verschiebt ein anstehendes Wartungsereignis.