REST Resource: projects.locations.instances

Ressource: Instanz

Eine Memorystore-Instanz.

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

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

string

ID. Eindeutiger Name der Instanz. Format: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der Erstellung der 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"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung der 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".
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" }.
state

enum (State)

Nur Ausgabe. Aktueller Status der Instanz.
stateInfo

object (StateInfo)

Nur Ausgabe. Zusätzliche Informationen zum Status der Instanz.
uid

string

Nur Ausgabe. Vom System zugewiesene eindeutige Kennung für die Instanz.
authorizationMode

enum (AuthorizationMode)

Optional. Autorisierungsmodus der Instanz.
transitEncryptionMode

enum (TransitEncryptionMode)

Optional. Nicht veränderbar. Modus für die Verschlüsselung während der Übertragung der Instanz.
shardCount

integer

Optional. Anzahl der Shards für die Instanz.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Nur Ausgabe. Nicht mehr unterstützt: Der Parameter „discoveryEndpoints“ wird nicht mehr unterstützt. Daher wird sie nicht ausgefüllt, wenn die Verbindungen mit dem Parameter „endpoints“ erstellt werden. Verwenden Sie stattdessen für die Ermittlung endpoints.connections.pscConnection und endpoints.connections.pscAutoConnection mit connectionType CONNECTION_TYPE_DISCOVERY.
nodeType

enum (NodeType)

Optional. Maschinentyp für einzelne Knoten der Instanz.
persistenceConfig

object (PersistenceConfig)

Optional. Konfiguration der Persistenz der Instanz.
engineVersion

string

Optional. Die Engine-Version der Instanz.
engineConfigs

map (key: string, value: string)

Optional. Vom Nutzer bereitgestellte Engine-Konfigurationen für die Instanz.

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

object (NodeConfig)

Nur Ausgabe. Konfiguration der einzelnen Knoten der Instanz.
zoneDistributionConfig

object (ZoneDistributionConfig)

Optional. Nicht veränderbar. Konfiguration der Zonenverteilung der Instanz für die Knotenzuweisung.
pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

Optional. Nicht veränderbar. Nicht mehr unterstützt: Verwenden Sie stattdessen den Wert „endpoints.connections.psc_auto_connection“.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Nur Ausgabe. Details zum Dienstanhang zum Konfigurieren von PSC-Verbindungen.
endpoints[]

object (InstanceEndpoint)

Optional. Endpunkte für die Instanz.
mode

enum (Mode)

Optional. Nicht veränderbar. Die Moduskonfiguration für die Instanz.
maintenancePolicy

object (MaintenancePolicy)

Optional. Die Wartungsrichtlinie für die Instanz. Wenn nicht angegeben, wird das Wartungsereignis gemäß dem internen Roll-out-Zeitplan von Memorystore durchgeführt.
maintenanceSchedule

object (MaintenanceSchedule)

Nur Ausgabe. Veröffentlichter Wartungsplan
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Optional. Die Konfiguration für die instanzübergreifende Replikation.
encryptionInfo

object (EncryptionInfo)

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

object (AutomatedBackupConfig)

Optional. Die Konfiguration für automatische Sicherungen für die Instanz.
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.
migrationConfig

object (MigrationConfig)

Nur Ausgabe. Migrationskonfiguration für die Instanz.
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. Nicht veränderbar. Sicherungen, die in Cloud Storage-Buckets gespeichert sind. Die Cloud Storage-Buckets müssen sich in derselben Region wie die Instanzen befinden. Zum Importieren aus den bereitgestellten Cloud Storage-Objekten ist die Leseberechtigung erforderlich.
managedBackupSource

object (ManagedBackupSource)

Optional. Nicht veränderbar. Sicherungen, die vom Memorystore-Dienst generiert und verwaltet werden.
Ende der sich gegenseitig ausschließenden Felder.
replicaCount

integer

Optional. Anzahl der Replikatknoten pro Shard. Wenn keine Angabe gemacht wird, lautet die Standardeinstellung 0 Replikate.
deletionProtectionEnabled

boolean

Optional. Wenn dieser Wert auf „true“ gesetzt ist, schlägt das Löschen der Instanz fehl.
simulateMaintenanceEvent

boolean

Optional. Nur Eingabe. Wartungsereignis simulieren
ondemandMaintenance
(deprecated)

boolean

Optional. Nur Eingabe. On-Demand-Wartung für die Instanz.
satisfiesPzs

boolean

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

boolean

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

boolean

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

string

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

string

Nur Ausgabe. Der vollständige Ressourcenname der Sicherungssammlung. Beispiel: projects/{project}/locations/{location}/backupCollections/{collection}
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 stellt die tatsächliche Wartungsversion der Instanz dar.
serverCaMode

enum (ServerCaMode)

Optional. Nicht veränderbar. Der Modus für Serverzertifizierungsstellen für die Instanz.
serverCaPool

string

Optional. Nicht veränderbar. Der vom Kunden verwaltete Zertifizierungsstellenpool für die Instanz. Gilt nur, wenn der Server-CA-Modus CUSTOMER_MANAGED_CAS_CA ist. Format: „projects/{project}/locations/{region}/caPools/{ca_pool}“.
rotateServerCertificate

boolean

Optional. Nur Eingabe. Rotieren Sie die Serverzertifikate.
aclPolicy

string

Optional. Die ACL-Richtlinie für die Instanz. Format: projects/{project}/locations/{location}/aclPolicies/{aclPolicy}
aclPolicyInSync
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Gibt an, ob die auf die Instanz angewendeten ACL-Regeln synchronisiert sind.

GcsBackupSource

Sicherungen, die in Cloud Storage-Buckets gespeichert sind. Die Cloud Storage-Buckets müssen sich in derselben Region wie die Instanzen befinden.

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

string

Optional. Beispiel: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Von Memorystore generierte und verwaltete Backups.

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

string

Optional. Beispiel: //memorystore.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 memorystore.googleapis.com befindet.

Bundesland

Mögliche Status der Instanz.

Enums
STATE_UNSPECIFIED Nicht festgelegt.
CREATING Instanz wird erstellt.
ACTIVE Die Instanz wurde erstellt und kann verwendet werden.
UPDATING Instanz wird aktualisiert.
DELETING Instanz wird gelöscht.
MIGRATING Instanz wird migriert.

StateInfo

Zusätzliche Informationen zum Status der Instanz.

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)

Nur Ausgabe. Beschreibt das laufende Update, wenn der Instanzstatus UPDATING ist.
Ende der sich gegenseitig ausschließenden Felder.

UpdateInfo

Stellt Informationen zu einer Instanz mit dem Status „AKTUALISIERT“ dar.

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

integer

Nur Ausgabe. Zielanzahl der Shards für die Instanz.
targetReplicaCount

integer

Nur Ausgabe. Zielanzahl der Replikatknoten pro Shard für die Instanz.
targetEngineVersion

string

Nur Ausgabe. Ziel-Engine-Version für die Instanz.
targetNodeType

enum (NodeType)

Nur Ausgabe. Zielknotentyp für die Instanz.

AuthorizationMode

Mögliche Autorisierungsmodi der Instanz.

Enums
AUTHORIZATION_MODE_UNSPECIFIED Nicht festgelegt.
AUTH_DISABLED Autorisierung deaktiviert.
IAM_AUTH IAM-basierte grundlegende Autorisierung.
TOKEN_AUTH Tokenbasierte Autorisierung.

TransitEncryptionMode

Mögliche Verschlüsselungsmodi für die Übertragung der Instanz.

Enums
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Nicht festgelegt.
TRANSIT_ENCRYPTION_DISABLED Die Verschlüsselung während der Übertragung ist deaktiviert.
SERVER_AUTHENTICATION Die serverseitige Verschlüsselung wird für die Verschlüsselung während der Übertragung verwendet.

DiscoveryEndpoint

Stellt einen Endpunkt dar, über den Clients eine Verbindung zur Instanz herstellen können.

JSON-Darstellung 
{
  "address": string,
  "port": integer,
  "network": string
}
Felder
address

string

Nur Ausgabe. Die IP-Adresse des bereitgestellten Endpunkts, zu dem Clients eine Verbindung herstellen.
port

integer

Nur Ausgabe. Die Portnummer des gefährdeten Endpunkts.
network

string

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

PersistenceConfig

Stellt die Persistenzkonfiguration für eine Instanz dar.

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

enum (PersistenceMode)

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

Mögliche 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 für die RDB-basierte Persistenz.

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

enum (SnapshotPeriod)

Optional. Zeitraum zwischen RDB-Snapshots.
rdbSnapshotStartTime

string (Timestamp format)

Optional. Zeitpunkt, zu dem der erste Snapshot erstellt wurde bzw. erstellt werden soll und an dem 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

Mögliche 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 für die AOF-basierte Persistenz.

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

enum (AppendFsync)

Optional. Der fsync-Modus.

AppendFsync

Mögliche fsync-Modi.

Enums
APPEND_FSYNC_UNSPECIFIED Nicht festgelegt. Standard: EVERY_SEC
NEVER Nie fsync. Normalerweise werden Daten unter Linux mit dieser Konfiguration alle 30 Sekunden geleert. Das hängt jedoch von der genauen Kernel-Abstimmung ab.
EVERY_SEC Fsync jede Sekunde. Im Falle einer Katastrophe können Daten von bis zu einer Sekunde verloren gehen.
ALWAYS Fsync wird jedes Mal ausgeführt, wenn dem AOF neue Schreibbefehle angehängt werden. Der beste Schutz vor Datenverlust auf Kosten der Leistung.

NodeConfig

Stellt die Konfiguration für Knoten der Instanz dar.

JSON-Darstellung 
{
  "sizeGb": number
}
Felder
sizeGb

number

Nur Ausgabe. Arbeitsspeichergröße des Knotens in GB.

ZoneDistributionConfig

Konfiguration der Zonenverteilung für die Zuweisung von Instanzressourcen.

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

string

Optional. Definiert die Zone, in der alle Ressourcen im SINGLE_ZONE-Modus zugewiesen werden. Wird im MULTI_ZONE-Modus ignoriert.
zones[]

string

Optional. Geben Sie die Zonen einer Instanz mit mehreren Zonen an, in denen Ressourcen für die Memorystore-Instanz zugewiesen werden. Dieses Flag gilt nicht für Instanzen mit einer einzelnen Zone.
mode

enum (ZoneDistributionMode)

Optional. Aktueller Modus für die Zonenverteilung. Die Standardeinstellung ist MULTI_ZONE.

ZoneDistributionMode

Mögliche Modi für die Zonenverteilung.

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Nicht festgelegt. Standardwert: MULTI_ZONE
MULTI_ZONE Ressourcen werden auf drei zufällig ausgewählte Zonen innerhalb der Region verteilt.
SINGLE_ZONE Ressourcen in einer einzelnen Zone bereitstellen. Das Feld „Zone“ muss angegeben werden.

PscAutoConnection

Details zu Nutzerressourcen in einer PSC-Verbindung.

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

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

string

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

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. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Erforderlich. Die Nutzerprojekt-ID, in der PSC-Verbindungen hergestellt werden. Dies sollte dieselbe projectId sein, in der die Instanz erstellt wird.
network

string

Erforderlich. Das Netzwerk, in dem die PSC-Endpunkte erstellt werden, im Format „projects/{projectId}/global/networks/{network_name}“.
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: ob eine Verbindung besteht und AKTIV ist oder nicht mehr besteht. 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.
Ports des gefährdeten 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

Optional. Der Port wird nur für den primären Endpunkt, den Leseendpunkt oder den 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.
ACTIVE Die Verbindung ist aktiv.
NOT_FOUND Keine Verbindung gefunden

ConnectionType

Typ einer PSC-Verbindung

Enums
CONNECTION_TYPE_UNSPECIFIED Verbindungstyp ist nicht festgelegt
CONNECTION_TYPE_DISCOVERY Verbindung, die für die Topologieerkennung verwendet wird.
CONNECTION_TYPE_PRIMARY Verbindung, die als primärer Endpunkt für den Zugriff auf die primäre Instanz verwendet wird.
CONNECTION_TYPE_READER Verbindung, die als Leserendpunkt für den Zugriff auf Replikate verwendet wird.

PscAttachmentDetail

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 des PSC-Endpunkts.

InstanceEndpoint

InstanceEndpoint besteht aus PSC-Verbindungen, die als Gruppe in jedem VPC-Netzwerk für den Zugriff auf die Instanz 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)

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

ConnectionDetail

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 einer Instanz kann entweder über die Automatisierung von Dienstverbindungen (automatische Verbindung) während der Clustererstellung oder vom Kunden selbst (vom Nutzer erstellte 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)

Nicht veränderbar. 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 Nutzer erstellt wurde.
Ende der sich gegenseitig ausschließenden Felder.

PscConnection

Vom Nutzer erstellte PSC-Verbindungskonfiguration.

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

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

string

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

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. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Nur Ausgabe. 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_name}“.
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: ob eine Verbindung besteht und AKTIV ist oder nicht mehr besteht. 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.
Ports des gefährdeten 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

Optional. Der Port wird nur für den primären Endpunkt, den Leseendpunkt oder den Discovery-Endpunkt festgelegt.
Ende der sich gegenseitig ausschließenden Felder.

Modus

Die Moduskonfiguration, mit der der Clustermodus aktiviert/deaktiviert wird.

Enums
MODE_UNSPECIFIED Der Modus ist nicht angegeben.
STANDALONE

Nicht mehr unterstützt: Verwenden Sie stattdessen CLUSTER_DISABLED.
CLUSTER Die Instanz befindet sich im Clustermodus.
CLUSTER_DISABLED Der Clustermodus ist für die Instanz deaktiviert.

MaintenancePolicy

Wartungsrichtlinie pro Instanz.

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

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Richtlinie erstellt 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. Der Zeitpunkt, zu dem die Richtlinie aktualisiert 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".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

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 „weekly_window“ eins ist.

WeeklyMaintenanceWindow

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.

MaintenanceSchedule

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

CrossInstanceReplicationConfig

Konfiguration der instanzübergreifenden Replikation.

JSON-Darstellung 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Felder
instanceRole

enum (InstanceRole)

Erforderlich. Die Rolle der Instanz bei der instanzübergreifenden Replikation.
primaryInstance

object (RemoteInstance)

Optional. Details zur primären Instanz, die als Replikationsquelle für diese sekundäre Instanz verwendet wird.

Dieses Feld wird nur für eine sekundäre Instanz festgelegt.
secondaryInstances[]

object (RemoteInstance)

Optional. Liste der sekundären Instanzen, deren Daten aus dieser primären Instanz repliziert werden.

Dieses Feld wird nur für eine primäre Instanz festgelegt.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der letzten Aktualisierung der Konfiguration für die instanzü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 Mitgliedsinstanzen, die an der instanzübergreifenden Replikation beteiligt sind. Diese Ansicht wird von jeder Mitgliedsinstanz bereitgestellt, unabhängig von ihrer Instanzrolle(primär oder sekundär).

Eine primäre Instanz kann Informationen zu allen sekundären Instanzen liefern, die Daten von ihr replizieren. Eine sekundäre Instanz kennt jedoch nur die primäre Instanz, von der sie repliziert wird. In Szenarien, in denen die primäre Instanz nicht verfügbar ist(z. B. bei einem regionalen Ausfall), kann jedoch eine Getinstance-Anfrage an eine beliebige andere Mitgliedsinstanz gesendet werden. In diesem Feld werden alle Mitgliedsinstanzen aufgeführt, die an der instanzübergreifenden Replikation beteiligt sind.

InstanceRole

Die Rolle der Instanz bei der instanzübergreifenden Replikation.

Enums
INSTANCE_ROLE_UNSPECIFIED Die Instanzrolle ist nicht festgelegt. Das Verhalten entspricht NONE.
NONE Diese Instanz ist nicht Teil der instanzübergreifenden Replikation. Es handelt sich um eine unabhängige Instanz, die nicht zu oder von anderen Instanzen repliziert wird.
PRIMARY Eine Instanz, die sowohl Lese- als auch Schreibvorgänge zulässt. Alle Daten, die in diese Instanz geschrieben werden, werden auch in die angehängten sekundären Instanzen repliziert.
SECONDARY Eine Instanz, die nur Lesezugriffe zulässt und Daten aus einer primären Instanz repliziert.

RemoteInstance

Details der Remote-Instanz, die in einer Einrichtung zur instanzübergreifenden Replikation mit dieser Instanz verknüpft ist.

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

string

Optional. Der vollständige Ressourcenpfad der Remote-Instanz im Format: projects//locations//instances/
uid

string

Nur Ausgabe. Die eindeutige Kennung der Remote-Instanz.

Mitgliedschaft

Eine reine Ausgabeansicht aller Mitgliedsinstanzen, die an der instanzübergreifenden Replikation beteiligt sind.

JSON-Darstellung 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Felder
primaryInstance

object (RemoteInstance)

Nur Ausgabe. Die primäre Instanz, die als Replikationsquelle für die sekundären Instanzen dient.
secondaryInstances[]

object (RemoteInstance)

Nur Ausgabe. Die Liste der sekundären Instanzen, die Daten aus der primären Instanz replizieren.

AutomatedBackupConfig

Die Konfiguration für automatische Sicherungen für eine Instanz.

JSON-Darstellung 
{
  "automatedBackupMode": enum (AutomatedBackupMode),
  "retention": string,

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

enum (AutomatedBackupMode)

Optional. Der Modus für automatische Sicherungen. Wenn der Modus deaktiviert ist, werden die anderen Felder ignoriert.
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".
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 einer festen Häufigkeit auslösen.
Ende der sich gegenseitig ausschließenden Felder.

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

Der Modus für Serverzertifizierungsstellen für die Instanz.

Enums
SERVER_CA_MODE_UNSPECIFIED Der Modus der Server-CA ist nicht angegeben.
GOOGLE_MANAGED_PER_INSTANCE_CA Jede Instanz hat eine eigene von Google verwaltete Zertifizierungsstelle.
GOOGLE_MANAGED_SHARED_CA Die Instanz verwendet eine von Google verwaltete gemeinsame Zertifizierungsstelle für die Region der Instanz.
CUSTOMER_MANAGED_CAS_CA Die Instanz verwendet eine vom Kunden verwaltete Zertifizierungsstelle aus CAS.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA

Verworfen: Verwenden Sie stattdessen GOOGLE_MANAGED_PER_INSTANCE_CA.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA

Verworfen: Verwenden Sie stattdessen GOOGLE_MANAGED_SHARED_CA.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA

Verworfen: Verwenden Sie stattdessen CUSTOMER_MANAGED_CAS_CA.

MigrationConfig

Konfiguration für die Migration einer Instanz.

JSON-Darstellung 
{
  "state": enum (State),
  "forceFinishMigration": boolean,

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

enum (State)

Nur Ausgabe. Migrationsstatus der Instanz.
forceFinishMigration

boolean

Nur Ausgabe. Stellt ein boolesches Flag dar, mit dem die Finalisierung der Migration ohne Validierung des Offset-Aufholvorgangs zwischen Quelle und Ziel vor dem Beenden der Replikation erzwungen wird.
Details zur Migrationsquelle. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
selfManagedSource

object (SelfManagedSource)

Nur Ausgabe. Konfiguration für die Migration von einer selbstverwalteten Valkey-/Redis-Instanz
Ende der sich gegenseitig ausschließenden Felder.

SelfManagedSource

Details zur selbstverwalteten Quellinstanz.

JSON-Darstellung 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
Felder
ipAddress

string

Erforderlich. Die IP-Adresse der Quellinstanz. Diese IP-Adresse sollte eine stabile IP-Adresse sein, auf die während des gesamten Migrationsprozesses von der Memorystore-Instanz aus zugegriffen werden kann.
port

integer

Erforderlich. Der Port der Quellinstanz. Dieser Port sollte ein stabiler Port sein, auf den während des gesamten Migrationsprozesses von der Memorystore-Instanz aus zugegriffen werden kann.
networkAttachment

string

Erforderlich. Der Ressourcenname des Private Service Connect-Netzwerk-Anhangs, der zum Herstellen einer Verbindung zur Quellinstanz verwendet wird. Für diesen Netzwerkanhang gelten die folgenden Anforderungen: 1. Er muss sich im selben Projekt wie die Memorystore-Instanz befinden. 2. Sie muss sich in derselben Region wie die Memorystore-Instanz befinden. 3. Das Subnetz, das an den Netzwerkanhang angehängt ist, muss sich im selben VPC-Netzwerk wie die Knoten der Quellinstanz befinden.

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

Bundesland

Migrationsstatus der Instanz. In Zukunft können neue Werte hinzugefügt werden.

Enums
STATE_UNSPECIFIED Für die Instanz sind keine migrationsbezogenen Aktivitäten vorhanden. Dies ist der Ausgangszustand.
ROLLED_BACK Die Instanz wird derzeit nicht migriert. Bei der Instanz wurde ein Migrationsversuch unternommen, der fehlgeschlagen ist. Das anschließende Rollback war erfolgreich. Die Instanz ist jetzt bereit für einen neuen Migrationsversuch, falls gewünscht.
ROLLING_BACK Gibt an, dass ein vorheriger Migrationsversuch fehlgeschlagen ist. Der allgemeine Instanzstatus ist MIGRATING. Die Instanz ist nicht bereit für einen neuen Migrationsversuch. Ein Rollback wird ausgeführt, um die Instanz in ihren ursprünglichen Zustand zurückzusetzen. Die Instanz verbleibt in diesem Status, bis das Rollback erfolgreich ist.
REPLICATION_ESTABLISHED Die Instanz wird gerade migriert. Die Instanz hat die Replikation erfolgreich eingerichtet und ist für die Umstellung bereit.
MIGRATED Die Instanz wurde migriert.

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 in der Instanz.

Methoden

addTokenAuthUser

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

backup

 Sicherungsinstanz

create

 Erstellt eine neue Instanz in einem angegebenen Projekt und an einem angegebenen Ort.

delete

 Löscht eine einzelne Instanz.

finishMigration

 Schließt den Migrationsprozess ab.

get

 Ruft Details zu einer einzelnen Instanz ab.

getCertificateAuthority

 Ruft Details zur Zertifizierungsstelle für eine Instanz ab.

list

 Listet Instanzen in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

 Aktualisiert die Parameter einer einzelnen Instanz.

rescheduleMaintenance

 Verschiebt ein anstehendes Wartungsereignis.

startMigration

 Leitet die Migration einer Quellinstanz zur Ziel-Memorystore-Instanz ein.