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)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },

  // 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,
  "ondemandMaintenance": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "backupCollection": string
}
Felder
name

string

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

createTime

string (Timestamp format)

Nur Ausgabe. Der Erstellungszeitstempel der Instanz.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 Zeitstempel der letzten Aktualisierung der Instanz.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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. Speicherkonfiguration 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. Zonenverteilungskonfiguration der Instanz für die Knotenzuordnung.

pscAutoConnections[]
(deprecated)

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 Sie keinen Wert angeben, wird das Wartungsereignis gemäß dem internen Zeitplan für die Einführung von Memorystore ausgeführt.

maintenanceSchedule

object (MaintenanceSchedule)

Nur Ausgabe. Veröffentlichter Wartungszeitplan.

crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

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

automatedBackupConfig

object (AutomatedBackupConfig)

Optional. Die Konfiguration für die automatische Sicherung der Instanz.

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. Für den Import 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, ist der Standardwert „0 Replikate“.

deletionProtectionEnabled

boolean

Optional. Wenn diese Option auf „wahr“ gesetzt ist, schlägt das Löschen der Instanz fehl.

ondemandMaintenance

boolean

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

asyncInstanceEndpointsDeletionEnabled

boolean

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

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

Von Memorystore generierte und verwaltete Sicherungen

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 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 eine 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 angestrebte Anzahl von 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 definiert.
AUTH_DISABLED Autorisierung deaktiviert.
IAM_AUTH IAM-Grundautorisierung.

TransitEncryptionMode

Mögliche Verschlüsselungsmodi der Instanz während der Übertragung.

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 für Clients dar, über den eine Verbindung zur Instanz hergestellt werden kann.

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_id}“.

PersistenceConfig

Stellt die Speicherkonfiguration 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 wird deaktiviert und alle Snapshot-Daten werden gelöscht.
RDB Die RDB-basierte Persistenz ist aktiviert.
AOF Die 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 versucht wurde bzw. wird, und auf den zukünftige Snapshots ausgerichtet werden. Wenn nicht angegeben, wird die aktuelle Uhrzeit verwendet.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 einer Stunde.
SIX_HOURS sechs Stunden.
TWELVE_HOURS zwölf Stunden.
TWENTY_FOUR_HOURS 24 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 definiert. Standard: EVERY_SEC
NEVER Nie fsync. Normalerweise werden bei dieser Konfiguration alle 30 Sekunden Daten gelöscht. Die genaue Abstimmung hängt jedoch vom Kernel ab.
EVERY_SEC Fsync jede Sekunde. Bei einem Notfallereignis können Sie bis zu 1 Sekunde an Daten verlieren.
ALWAYS Fsync wird jedes Mal ausgeführt, wenn der AOF neue Schreibbefehle hinzugefügt werden. Der beste Schutz vor Datenverlusten, der aber zu Leistungseinbußen führt.

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

Zonenverteilungskonfiguration 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 Modus SINGLE_ZONE zugewiesen werden. Wird im Modus „MULTI_ZONE“ ignoriert.

mode

enum (ZoneDistributionMode)

Optional. Aktueller Zonenverteilungsmodus. Die Standardeinstellung ist MULTI_ZONE.

ZoneDistributionMode

Mögliche Zonenverteilungsmodi

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Nicht festgelegt. Standardeinstellung: MULTI_ZONE
MULTI_ZONE Ressourcen auf drei zufällig ausgewählte Zonen innerhalb der Region verteilen
SINGLE_ZONE Ressourcen in einer einzelnen Zone bereitstellen. Das Zonenfeld 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 Nutzernetzwerk für die PSC-Weiterleitungsregel zugewiesen ist.

forwardingRule

string

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

projectId

string

Erforderlich. Die Projekt-ID des Nutzers, für den PSC-Verbindungen hergestellt werden. Dies sollte die Projekt-ID 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: Gibt an, ob eine Verbindung vorhanden und AKTIV ist oder nicht mehr vorhanden ist. Dieser Wert wird regelmäßig aktualisiert. Aktuelle Informationen zum Status erhalten Sie über die Private Service Connect APIs.

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. „port“ wird nur für den primären/Lesegerät- oder Discovery-Endpunkt 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 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 verwendet wird.
CONNECTION_TYPE_READER Verbindung, die als Leserendpunkt zum 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. Der URI des Dienstanhangs, den Ihre selbst erstellte PscConnection als Ziel verwenden soll.

connectionType

enum (ConnectionType)

Nur Ausgabe. Typ des PSC-Endpunkts.

InstanceEndpoint

„InstanceEndpoint“ besteht aus PSC-Verbindungen, die für den Zugriff auf die Instanz in jedem VPC-Netzwerk als Gruppe erstellt werden. In jeder Gruppe muss es eine Verbindung für jeden Dienstanschluss 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, jeweils eine 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 während der Clustererstellung über die Automatisierung der Dienstverbindung (automatische Verbindung) 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

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),

  // 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 Nutzernetzwerk für die PSC-Weiterleitungsregel zugewiesen ist.

forwardingRule

string

Erforderlich. Der URI der Weiterleitungsregel auf der Seite des Verbrauchers. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}

projectId

string

Nur Ausgabe. Die Projekt-ID des Nutzers, in dem die Weiterleitungsregel erstellt wird.

network

string

Erforderlich. Das Netzwerk des Kunden, 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: Gibt an, ob eine Verbindung vorhanden und AKTIV ist oder nicht mehr vorhanden ist. Dieser Wert wird regelmäßig aktualisiert. Aktuelle Informationen zum Status erhalten Sie über die Private Service Connect APIs.

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. „port“ wird nur für den primären/Lesegerät- oder Discovery-Endpunkt festgelegt.

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. Die Uhrzeit, zu der die Richtlinie erstellt wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit, zu der die Richtlinie aktualisiert wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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. Bei der aktuellen Version ist die maximale Anzahl von „weekly_window“ voraussichtlich „1“.

WeeklyMaintenanceWindow

Zeitfenster für wöchentliche Vorgänge.

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

enum (DayOfWeek)

Optional. Hiermit lässt sich ein Zeitplan für einen bestimmten Wochentag definieren.

startTime

object (TimeOfDay)

Optional. Beginn des Zeitfensters in UTC.

MaintenanceSchedule

Anstehende Wartungstermine

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

string (Timestamp format)

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

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 nächsten geplanten Wartung für diese Instanz.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 interinstanziellen 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, 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, zu dem die Konfiguration der Instanzübergreifenden Replikation zuletzt aktualisiert wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 Ansicht nur mit den Ausgabedaten aller Mitgliedsinstanzen, die an der interinstanziellen Replikation teilnehmen. 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 aufgelistet, die an der interinstanziellen Replikation teilnehmen.

InstanceRole

Die Rolle der Instanz bei der interinstanziellen Replikation.

Enums
INSTANCE_ROLE_UNSPECIFIED Die Instanzrolle ist nicht festgelegt. Das Verhalten entspricht NONE.
NONE Diese Instanz nimmt nicht an der interinstanzenübergreifenden Replikation teil. 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 auf die verbundenen sekundären Instanzen repliziert.
SECONDARY Eine Instanz, die nur Lesezugriff zulässt und Daten aus einer primären Instanz repliziert.

RemoteInstance

Details zur Remote-Instanz, die dieser Instanz in einer replikatübergreifenden Einrichtung zugeordnet 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 Ansicht nur mit den Ausgabedaten aller Mitgliedsinstanzen, die an der interssenziellen Replikation teilnehmen.

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. Liste der sekundären Instanzen, die von der primären Instanz repliziert werden.

AutomatedBackupConfig

Die Konfiguration der automatischen Sicherung 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 die automatische Sicherung. 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".

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 mit einer festen Häufigkeit auslösen

FixedFrequencySchedule

Mit diesem Zeitplan kann die Sicherung mit 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 vollen Stunde festgelegt sein. Dies ist ein Pflichtfeld.

AutomatedBackupMode

Der Modus für die automatische Sicherung.

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

Methoden

backup

Sicherungs-Instanz.

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 das anstehende Wartungsereignis.