- Ressource: Instanz
- Bundesland
- StateInfo
- UpdateInfo
- AuthorizationMode
- TransitEncryptionMode
- DiscoveryEndpoint
- NodeType
- PersistenceConfig
- PersistenceMode
- RDBConfig
- SnapshotPeriod
- AOFConfig
- AppendFsync
- NodeConfig
- ZoneDistributionConfig
- ZoneDistributionMode
- PscAutoConnection
- PscConnectionStatus
- ConnectionType
- InstanceEndpoint
- ConnectionDetail
- PscConnection
- Modus
- Methoden
Ressource: Instanz
Eine Memorystore-Instanz.
JSON-Darstellung |
---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "state": enum ( |
Felder | |
---|---|
name |
Kennung. Eindeutiger Name der Instanz. Format: projects/{project}/locations/{location}/instances/{instance} |
create |
Nur Ausgabe. Der Erstellungszeitstempel der Instanz. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
update |
Nur Ausgabe. Der Zeitstempel der letzten Aktualisierung der Instanz. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
labels |
Optional. Labels zur Darstellung der vom Nutzer bereitgestellten Metadaten. Ein Objekt, das eine Liste von |
state |
Nur Ausgabe. Aktueller Status der Instanz. |
state |
Nur Ausgabe. Zusätzliche Informationen zum Status der Instanz. |
uid |
Nur Ausgabe. Vom System zugewiesene eindeutige Kennung für die Instanz. |
authorization |
Optional. Nicht veränderbar. Autorisierungsmodus der Instanz. |
transit |
Optional. Nicht veränderbar. Verschlüsselungsmodus der Instanz während der Übertragung. |
shard |
Optional. Anzahl der Shards für die Instanz. |
discovery |
Nur Ausgabe. Endpunkte, über die Clients eine Verbindung zur Instanz herstellen können. Derzeit wird nur ein Discovery-Endpunkt unterstützt. |
node |
Optional. Nicht veränderbar. Maschinentyp für einzelne Knoten der Instanz. |
persistence |
Optional. Speicherkonfiguration der Instanz. |
engine |
Optional. Nicht veränderbar. Engine-Version der Instanz. |
engine |
Optional. Von Nutzern bereitgestellte Engine-Konfigurationen für die Instanz. Ein Objekt, das eine Liste von |
node |
Nur Ausgabe. Konfiguration einzelner Knoten der Instanz. |
zone |
Optional. Nicht veränderbar. Zonenverteilungskonfiguration der Instanz für die Knotenzuordnung. |
psc |
Pflichtangabe. Nicht veränderbar. Nutzereingaben und Ressourcendetails der automatisch erstellten PSC-Verbindungen. |
endpoints[] |
Optional. Endpunkte für die Instanz. |
mode |
Optional. Die Moduskonfiguration für die Instanz. |
replica |
Optional. Anzahl der Replikatknoten pro Shard. Wenn keine Angabe gemacht wird, ist der Standardwert „0 Replikate“. |
deletion |
Optional. Wenn diese Option auf „wahr“ gesetzt ist, schlägt das Löschen der Instanz fehl. |
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 |
Felder | |
---|---|
Union-Feld Für |
|
update |
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 } |
Felder | |
---|---|
target |
Nur Ausgabe. Die angestrebte Anzahl von Shards für die Instanz. |
target |
Nur Ausgabe. Zielanzahl der Replikatknoten pro Shard 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 |
Nur Ausgabe. IP-Adresse des freigegebenen Endpunkts, zu dem Clients eine Verbindung herstellen. |
port |
Nur Ausgabe. Die Portnummer des freigegebenen Endpunkts. |
network |
Nur Ausgabe. Das Netzwerk, in dem die IP-Adresse des Discovery-Endpunkts reserviert wird, im Format „projects/{networkProject}/global/networks/{network_id}“. |
NodeType
Mögliche Knotentypen der Instanz. Weitere Informationen finden Sie unter https://cloud.google.com/memorystore/docs/valkey/instance-node-specification.
Enums | |
---|---|
NODE_TYPE_UNSPECIFIED |
Nicht definiert. |
SHARED_CORE_NANO |
Gemeinsam genutzter Kern, nano. |
HIGHMEM_MEDIUM |
Speichermedium mit großem Speicher. |
HIGHMEM_XLARGE |
Großer Arbeitsspeicher, extra groß |
STANDARD_SMALL |
Standard klein |
PersistenceConfig
Stellt die Speicherkonfiguration für eine Instanz dar.
JSON-Darstellung |
---|
{ "mode": enum ( |
Felder | |
---|---|
mode |
Optional. Aktueller Persistenzmodus. |
rdb |
Optional. RDB-Konfiguration. Dieses Feld wird ignoriert, wenn der Modus nicht „RDB“ ist. |
aof |
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 ( |
Felder | |
---|---|
rdb |
Optional. Zeitraum zwischen RDB-Snapshots. |
rdb |
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. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
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 ( |
Felder | |
---|---|
append |
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 | |
---|---|
size |
Nur Ausgabe. Arbeitsspeichergröße des Knotens in GB. |
ZoneDistributionConfig
Zonenverteilungskonfiguration für die Zuweisung von Instanzressourcen.
JSON-Darstellung |
---|
{
"zone": string,
"mode": enum ( |
Felder | |
---|---|
zone |
Optional. Definiert die Zone, in der alle Ressourcen im Modus SINGLE_ZONE zugewiesen werden. Wird im Modus „MULTI_ZONE“ ignoriert. |
mode |
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 ( |
Felder | |
---|---|
psc |
Nur Ausgabe. Die PSC-Verbindungs-ID der Weiterleitungsregel, die mit dem Dienstanhang verbunden ist. |
ip |
Nur Ausgabe. Die IP-Adresse, die im Nutzernetzwerk für die PSC-Weiterleitungsregel zugewiesen ist. |
forwarding |
Nur Ausgabe. Der URI der Weiterleitungsregel auf Verbraucherseite. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule} |
project |
Pflichtangabe. 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 |
Pflichtangabe. Das Netzwerk, in dem die PSC-Endpunkte erstellt werden, im Format „projects/{projectId}/global/networks/{network_id}“. |
service |
Nur Ausgabe. Der Dienstanhang, der das Ziel der PSC-Verbindung ist, im Format projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}. |
psc |
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. |
connection |
Nur Ausgabe. Art der PSC-Verbindung. |
Union-Feld ports . Ports des freigegebenen Endpunkts. Für ports ist nur einer der folgenden Werte zulässig: |
|
port |
Optional. Nur Ausgabe. „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. |
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 ( |
Felder | |
---|---|
connections[] |
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 |
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: |
|
psc |
Detaillierte Informationen zu einer PSC-Verbindung, die über die Automatisierung von Dienstverbindungen erstellt wird. |
psc |
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 ( |
Felder | |
---|---|
psc |
Nur Ausgabe. Die PSC-Verbindungs-ID der Weiterleitungsregel, die mit dem Dienstanhang verbunden ist. |
ip |
Pflichtangabe. Die IP-Adresse, die im Nutzernetzwerk für die PSC-Weiterleitungsregel zugewiesen ist. |
forwarding |
Pflichtangabe. Der URI der Weiterleitungsregel auf der Seite des Verbrauchers. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule} |
project |
Nur Ausgabe. Die Projekt-ID des Nutzers, in dem die Weiterleitungsregel erstellt wird. |
network |
Pflichtangabe. Das Netzwerk des Nutzers, in dem sich die IP-Adresse befindet, im Format projects/{projectId}/global/networks/{network_id}. |
service |
Pflichtangabe. Der Dienstanhang, der das Ziel der PSC-Verbindung ist, im Format projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}. |
psc |
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. |
connection |
Nur Ausgabe. Art der PSC-Verbindung. |
Modus
Die Moduskonfiguration, mit der der Clustermodus aktiviert oder deaktiviert wird.
Enums | |
---|---|
MODE_UNSPECIFIED |
Der Modus ist nicht angegeben. |
CLUSTER |
Die Instanz befindet sich im Clustermodus. |
CLUSTER_DISABLED |
Der Clustermodus ist für die Instanz deaktiviert. |
Methoden |
|
---|---|
|
Erstellt eine neue Instanz in einem angegebenen Projekt und an einem angegebenen Ort. |
|
Löscht eine einzelne Instanz. |
|
Ruft Details zu einer einzelnen Instanz ab. |
|
Ruft Details zur Zertifizierungsstelle für eine Instanz ab. |
|
Listet Instanzen in einem angegebenen Projekt und an einem angegebenen Standort auf. |
|
Aktualisiert die Parameter einer einzelnen Instanz. |