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)
    }
  ],
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean
}
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.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
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

Erforderlich. Anzahl der Shards für die Instanz.
discoveryEndpoints[]

object (DiscoveryEndpoint)

Nur Ausgabe. Endpoints-Clients können darüber eine Verbindung zur Instanz herstellen. Derzeit wird nur ein Discovery-Endpunkt unterstützt.
nodeType

enum (NodeType)

Optional. Nicht veränderbar. Maschinentyp für einzelne Knoten der Instanz.
persistenceConfig

object (PersistenceConfig)

Optional. Speicherkonfiguration der Instanz.
engineVersion

string

Optional. Nicht veränderbar. Engine-Version der Instanz.
engineConfigs

map (key: string, value: string)

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

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

object (NodeConfig)

Nur Ausgabe. Konfiguration der einzelnen Knoten der Instanz.
zoneDistributionConfig

object (ZoneDistributionConfig)

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

object (PscAutoConnection)

Erforderlich. Nicht veränderbar. Nutzereingaben und Ressourcendetails der automatisch erstellten PSC-Verbindungen.
replicaCount

integer

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

boolean

Optional. Wenn die Richtlinie auf „true“ 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 Instanz wurde erstellt und ist nutzbar.
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 zur Instanz mit dem Status UPDATING dar.

JSON-Darstellung 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer
}
Felder
targetShardCount

integer

Nur Ausgabe. Angestrebte Anzahl von Shards für die Instanz.
targetReplicaCount

integer

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 vom Server verwaltete Verschlüsselung wird für die Verschlüsselung während der Übertragung verwendet.

DiscoveryEndpoint

Stellt einen Endpunkt für Clients zum Herstellen einer Verbindung zur Instanz dar.

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

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 Nano mit gemeinsam genutztem Kern.
HIGHMEM_MEDIUM Medium mit großem Arbeitsspeicher.
HIGHMEM_XLARGE Großer Arbeitsspeicher (extrem groß).
STANDARD_SMALL Standard klein

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 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 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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

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. 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-Gerät jede Sekunde an. Im Notfall kann es zu Datenverlusten von 1 Sekunde kommen.
ALWAYS Fsync wird immer dann ausgeführt, wenn neue Schreibbefehle an das AOF angehängt 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

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

enum (ZoneDistributionMode)

Optional. Verteilungsmodus der aktuellen Zone. 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 Feld für die Zone muss angegeben werden.

PscAutoConnection

Details zu Nutzerressourcen in einer PSC-Verbindung.

JSON-Darstellung 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string
}
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 Nutzerseite. Format: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

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

Methoden

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.