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)
  },
  "allowFewerZonesDeployment": boolean,

  // Union field import_sources can be only one of the following:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of list of possible types for union field import_sources.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string
}
Felder
name

string

Kennung. 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 der 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. Nicht veränderbar. Autorisierungsmodus der Instanz.
transitEncryptionMode

enum (TransitEncryptionMode)

Optional. Nicht veränderbar. Verschlüsselungsmodus der Instanz während der Übertragung.
shardCount

integer

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

object (DiscoveryEndpoint)

Nur Ausgabe. Verworfen: Verwenden Sie stattdessen die Werte „endpoints.connections.psc_auto_connection“ oder „endpoints.connections.psc_connection“.
nodeType

enum (NodeType)

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

object (PersistenceConfig)

Optional. Konfiguration der Persistenz der Instanz.
engineVersion

string

Optional. Engine-Version der Instanz.
engineConfigs

map (key: string, value: string)

Optional. Von Nutzern 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 Knotenzuordnung.
pscAutoConnections[]

object (PscAutoConnection)

Optional. Nicht veränderbar. Verworfen: 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. 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 Memorystore-Rollout-Zeitplan 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 inaktiven Daten des Clusters.
automatedBackupConfig

object (AutomatedBackupConfig)

Optional. Die Konfiguration für automatische Sicherungen für die Instanz.
allowFewerZonesDeployment

boolean

Optional. Nicht veränderbar. Ermöglicht es Kunden anzugeben, ob sie mit der Bereitstellung einer multizonalen Instanz in weniger als drei Zonen einverstanden sind. Wenn während der Instanzerstellung ein zonales Problem auftritt, wird die Instanz nur in zwei Zonen bereitgestellt und bleibt während ihres gesamten Lebenszyklus in diesen beiden Zonen.
Union-Feld import_sources. Die Quelle, aus der importiert werden soll. Für import_sources ist nur einer der folgenden Werte zulässig:
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.
replicaCount

integer

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

boolean

Optional. Wenn sie 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.
asyncInstanceEndpointsDeletionEnabled

boolean

Optional. Bei „true“ können Instanzendpunkte, die von Kunden erstellt und registriert werden, 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 ruhenden Daten des Clusters verwendet wird.
backupCollection

string

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

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 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 definiert.
CREATING Instanz wird erstellt...
ACTIVE Die Instanz wurde erstellt und kann verwendet werden.
UPDATING Instanz wird aktualisiert.
DELETING Instanz wird gelöscht...

StateInfo

Zusätzliche Informationen zum Status der Instanz.

JSON-Darstellung 
{

  // Union field info can be only one of the following:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of list of possible types for union field info.
}
Felder

Union-Feld info.

Für info ist nur einer der folgenden Werte zulässig:
updateInfo

object (UpdateInfo)

Nur Ausgabe. Beschreibt die laufende Aktualisierung, wenn der Instanzstatus UPDATING ist.

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. Die Zielanzahl der Shards für die Instanz.
targetReplicaCount

integer

Nur Ausgabe. Die 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 definiert.
AUTH_DISABLED Autorisierung deaktiviert.
IAM_AUTH IAM-Standardautorisierung.

TransitEncryptionMode

Mögliche Modi für die Verschlüsselung während der Übertragung der Instanz.

Enums
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Nicht definiert.
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. IP-Adresse des bereitgestellten Endpunkts, zu dem Clients eine Verbindung herstellen.
port

integer

Nur Ausgabe. Die Portnummer des bereitgestellten Endpunkts.
network

string

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

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 definiert.
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 wird und an dem zukünftige Snapshots ausgerichtet werden. Wenn nicht angegeben, wird die aktuelle Uhrzeit 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 definiert.
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 definiert. 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. Bei einem Notfallereignis können Daten von einer Sekunde verloren gehen.
ALWAYS Fsync wird jedes Mal ausgeführt, wenn dem AOF neue Schreibbefehle angehängt werden. Der beste Schutz vor Datenverlusten 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,
  "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.
mode

enum (ZoneDistributionMode)

Optional. Aktueller Zonenverteilungsmodus. 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 Verteilen Sie 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),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
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 Consumer-Seite. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Erforderlich. Die Consumer-Projekt-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_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: 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.
Union-Feld ports. Ports des freigegebenen Endpunkts. Für ports ist nur einer der folgenden Werte zulässig:
port

integer

Optional. Der Port wird nur für den primären Endpunkt, den Leseendpunkt oder den Erkennungsendpunkt festgelegt.

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 den primären Endpunkt 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, 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 für jede Dienstanhänge im Cluster eine Verbindung 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 
{

  // Union field connection can be only one of the following:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of list of possible types for union field connection.
}
Felder
Union-Feld connection. 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. Für connection ist nur einer der folgenden Werte zulässig:
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.

PscConnection

Der Nutzer hat eine PSC-Verbindungskonfiguration erstellt.

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

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
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 Consumer-Seite. 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 Netzwerk des Dienstnutzers, 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: 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.
Union-Feld ports. Ports des freigegebenen Endpunkts. Für ports ist nur einer der folgenden Werte zulässig:
port

integer

Optional. Der Port wird nur für den primären Endpunkt, den Leseendpunkt oder den Erkennungsendpunkt festgelegt.

Modus

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

Enums
MODE_UNSPECIFIED Der Modus ist nicht angegeben.
STANDALONE

Eingestellt: 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 sind. Mindestens 1. Für die aktuelle Version wird erwartet, dass die maximale Anzahl von „weekly_window“ 1 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 einer 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".
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 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 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 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 keine Daten mit anderen Instanzen repliziert.
PRIMARY Eine Instanz, die sowohl Lese- als auch Schreibvorgänge zulässt. Alle Daten, die in diese Instanz geschrieben werden, werden auch auf die angehängten sekundären Instanzen repliziert.
SECONDARY Eine Instanz, die nur Lesezugriff ermöglicht und Daten von einer primären Instanz repliziert.

RemoteInstance

Details der Remote-Instanz, die in einer Einrichtung für die instanzübergreifende 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 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,

  // Union field schedule can be only one of the following:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of list of possible types for union field schedule.
}
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".
Union-Feld schedule. Der Zeitplan für automatische Sicherungen. Für schedule ist nur einer der folgenden Werte zulässig:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Optional. Automatische Sicherungen in einem festen Rhythmus auslösen

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 werden. Dies ist ein Pflichtfeld.

AutomatedBackupMode

Der Modus für automatische Sicherungen.

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

Methoden

backup

 Sicherungsinstanz.

create

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

delete

 Löscht eine einzelne Instanz.

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.