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, die vom Nutzer bereitgestellte Metadaten darstellen.

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. Verschlüsselungsmodus für die Übertragung der Instanz.
shardCount

integer

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

object (DiscoveryEndpoint)

Nur Ausgabe. Verworfen: Der Parameter „discoveryEndpoints“ wird nicht mehr unterstützt. Daher wird es nicht ausgefüllt, wenn die Verbindungen mit dem Parameter „endpoints“ erstellt werden. Verwenden Sie für die Erkennung anstelle dieses Parameters „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. Persistenzkonfiguration der Instanz.
engineVersion

string

Optional. 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 einzelner 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. Veraltet: 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 ausgeführt.
maintenanceSchedule

object (MaintenanceSchedule)

Nur Ausgabe. Veröffentlichter Wartungszeitplan.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

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

object (EncryptionInfo)

Nur Ausgabe. Verschlüsselungsinformationen der ruhenden Daten des Clusters.
automatedBackupConfig

object (AutomatedBackupConfig)

Optional. Die Konfiguration für automatische Sicherungen für die Instanz.
availableMaintenanceVersions[]

string

Nur Ausgabe. Dieses Feld wird verwendet, um die verfügbaren Wartungsversionen für das Self-Service-Update zu ermitteln.
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 Feldern, die sich gegenseitig ausschließen. 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. Für den Import aus den angegebenen 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, beträgt 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“, können von Kunden erstellte und registrierte Instanzendpunkte 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 Self-Service-Update ausgelöst werden, um die gewünschte Wartungsversion anzugeben. Die Eingabe für dieses Feld kann durch 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 Server-CA-Modus für die Instanz.
serverCaPool

string

Optional. Nicht veränderbar. Der vom Kunden verwaltete CA-Pool 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. Verworfen: 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

Sicherungen, die von Memorystore generiert und verwaltet werden.

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 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 Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
updateInfo

object (UpdateInfo)

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

UpdateInfo

Stellt Informationen zu einer Instanz mit dem Status UPDATING 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-Basisautorisierung.
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 Für die Verschlüsselung während der Übertragung wird eine serververwaltete Verschlüsselung 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. IP-Adresse des freigegebenen Endpunkts, zu dem Clients eine Verbindung herstellen.
port

integer

Nur Ausgabe. Die Portnummer des freigegebenen 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 RDB-basierte Persistenz ist aktiviert.
AOF Die AOF-basierte Persistenz ist aktiviert.

RDBConfig

Konfiguration für 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 versucht wurde/wird 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 Vierundzwanzig Stunden.

AOFConfig

Konfiguration für 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. Dies hängt jedoch von der genauen Abstimmung des Kernels ab.
EVERY_SEC Fsync jede Sekunde. Bei einer Katastrophe können Daten von 1 Sekunde verloren gehen.
ALWAYS Fsync wird jedes Mal ausgeführt, wenn neue Schreibbefehle an die AOF angehängt werden. Der beste Schutz vor Datenverlust, allerdings 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
  ],
  "activeZones": [
    string
  ],
  "mode": enum (ZoneDistributionMode)
}
Felder
zone

string

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

string

Optional. Geben Sie die Zonen einer multizonalen Instanz an, in denen die Memorystore-Instanz Ressourcen zuweist. Dieses Flag gilt nicht für Instanzen mit einer einzelnen Zone.
activeZones[]

string

Nur Ausgabe. Die Liste der Zonen, in denen die Instanz aktive VMs hat.
mode

enum (ZoneDistributionMode)

Optional. Aktueller Zonenverteilungsmodus. Die Standardeinstellung ist MULTI_ZONE.

ZoneDistributionMode

Mögliche Zonenverteilungsmodi.

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Nicht festgelegt. Standard: MULTI_ZONE
MULTI_ZONE Verteilt Ressourcen auf drei zufällig ausgewählte Zonen innerhalb der Region.
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 im Nutzernetzwerk für die PSC-Weiterleitungsregel zugewiesene IP-Adresse.
forwardingRule

string

Nur Ausgabe. Der URI der Weiterleitungsregel auf der Nutzerseite. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Erforderlich. Die projectId des Nutzers, 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. Den aktuellen Status finden Sie in den Private Service Connect APIs.
connectionType

enum (ConnectionType)

Nur Ausgabe. Typ der PSC-Verbindung.
Ports des gefährdeten Endpunkts. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
port

integer

Optional. Der Port wird nur für den primären/Reader- 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.
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 Leseendpunkt 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, den die von Ihnen erstellte PscConnection als Ziel verwenden soll.
connectionType

enum (ConnectionType)

Nur Ausgabe. Typ des PSC-Endpunkts.

InstanceEndpoint

„InstanceEndpoint“ besteht aus PSC-Verbindungen, die in jedem VPC-Netzwerk als Gruppe 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, und zwar eine 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 während der Clustererstellung über die Automatisierung von Dienstverbindungen (automatische Verbindung) oder vom Kunden selbst (vom Nutzer erstellte Verbindung) erstellt werden. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. 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 wird.
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 im Nutzernetzwerk für die PSC-Weiterleitungsregel zugewiesene IP-Adresse.
forwardingRule

string

Erforderlich. Der URI der Weiterleitungsregel auf der Nutzerseite. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Nur Ausgabe. Die Nutzer-Projekt-ID, aus der die Weiterleitungsregel erstellt wird.
network

string

Erforderlich. Das Nutzernetzwerk, 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. Den aktuellen Status finden Sie in den Private Service Connect APIs.
connectionType

enum (ConnectionType)

Nur Ausgabe. Typ der PSC-Verbindung.
Ports des gefährdeten Endpunkts. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
port

integer

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

Modus

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

Enums
MODE_UNSPECIFIED Der Modus ist nicht angegeben.
STANDALONE

Verworfen: 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. Wartungsfenster, das auf Ressourcen angewendet wird, die von dieser Richtlinie abgedeckt werden. Mindestens 1. In der aktuellen Version wird maximal ein „weekly_window“ erwartet.

WeeklyMaintenanceWindow

Zeitfenster für wöchentliche Vorgänge.

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

enum (DayOfWeek)

Optional. Der Wochentag für das Wartungsfenster. Dies ist ein Pflichtfeld. Sie können DAY_OF_WEEK_UNSPECIFIED nicht verwenden.
startTime

object (TimeOfDay)

Optional. Der Beginn des Wartungsfensters in UTC. Wenn Sie ein Wartungsfenster angeben, ist startTime erforderlich.

MaintenanceSchedule

Anstehender Wartungszeitplan.

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

string (Timestamp format)

Nur Ausgabe. Der Beginn 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. Das Ende der anstehenden 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 der 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, die von 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 schreibgeschützte Ansicht 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 bereitstellen, die von ihr repliziert werden. 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 eine Getinstance-Anfrage an eine beliebige andere Mitgliedsinstanz gesendet werden. In diesem Feld werden dann 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 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 Lesevorgänge zulässt und Daten aus einer primären Instanz repliziert.

RemoteInstance

Details der Remote-Instanz, die mit dieser Instanz in einer instanzübergreifenden Replikationseinrichtung 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 schreibgeschützte Ansicht 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 von der primären Instanz repliziert werden.

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 automatische Sicherungsmodus. 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 muss zwischen 1 Tag 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 Feldern, die sich gegenseitig ausschließen. 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. Der Beginn jeder automatischen Sicherung in UTC. Sie muss auf den Beginn einer Stunde festgelegt werden. Dies ist ein Pflichtfeld.

AutomatedBackupMode

Der automatische Sicherungsmodus.

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 Server-CA-Modus für die Instanz.

Enums
SERVER_CA_MODE_UNSPECIFIED Server-CA-Modus 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 von 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, um den Abschluss der Migration ohne Offset-Catch-up-Validierung zwischen Quelle und Ziel vor dem Beenden der Replikation zu erzwingen.
Details zur Migrationsquelle. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. 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 die Memorystore-Instanz während des gesamten Migrationsprozesses zugreifen kann.
port

integer

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

string

Erforderlich. Der Ressourcenname des Private Service Connect-Netzwerkanhangs, 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. Er 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 Quellinstanzknoten befinden.

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

Bundesland

Migrationsstatus der Instanz. In Zukunft werden möglicherweise neue Werte hinzugefügt.

Enums
STATE_UNSPECIFIED Die Instanz hat keine migrationsbezogenen Aktivitäten. Dies ist der Ausgangszustand.
ROLLED_BACK Die Instanz wird derzeit nicht migriert. Es wurde versucht, die Instanz zu migrieren. Dieser Versuch ist fehlgeschlagen und das anschließende Rollback war erfolgreich. Die Instanz ist jetzt für einen neuen Migrationsversuch bereit, 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. Der Rollback wird ausgeführt, um die Instanz in ihren ursprünglichen Zustand zurückzuversetzen. Die Instanz bleibt in diesem Status, bis der Rollback erfolgreich ist.
REPLICATION_ESTABLISHED Die Instanz wird gerade migriert. Die Instanz hat eine erfolgreiche Replikation 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 Versionsnummer der angewendeten ACL-Richtlinienversion.
aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

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

Methoden

addTokenAuthUser

 Fügt einen Nutzer mit Token-Authentifizierung für eine Instanz mit aktivierter Token-Authentifizierung hinzu.

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

 Initiiert die Migration einer Quellinstanz zur Memorystore-Zielinstanz.