REST-Ressource: projects.locations.instances

Ressource: Instanz

JSON-Darstellung

{
  "name": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "authorizedNetwork": string,
  "zones": [
    string
  ],
  "nodeCount": integer,
  "nodeConfig": {
    object (NodeConfig)
  },
  "memcacheVersion": enum (MemcacheVersion),
  "parameters": {
    object (MemcacheParameters)
  },
  "memcacheNodes": [
    {
      object (Node)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "memcacheFullVersion": string,
  "instanceMessages": [
    {
      object (InstanceMessage)
    }
  ],
  "discoveryEndpoint": string
}
Felder
name

string

Erforderlich Eindeutiger Name der Ressource in diesem Bereich, einschließlich Projekt und Standort, im Format projects/{project_id}/locations/{locationId}/instances/{instanceId}

Hinweis: Memcached-Instanzen werden auf regionaler Ebene verwaltet und angesprochen. Daher bezieht sich locationId hier auf eine GCP-Region. Nutzer können jedoch auswählen, in welchen Zonen Memcached-Knoten innerhalb einer Instanz bereitgestellt werden sollen. Weitere Informationen finden Sie im Feld [Zonen].

displayName

string

Optional Der vom Nutzer angegebene Name der Instanz, der nur zu Anzeigezwecken verwendet wird. Darf nicht mehr als 80 Zeichen enthalten.

labels

map (key: string, value: string)

Optional Ressourcenetiketten zur Darstellung der vom Nutzer bereitgestellten Metadaten. Weitere Informationen finden Sie in der Cloud-Dokumentation zu Labels. https://cloud.google.com/compute/docs/labeling-resources

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

authorizedNetwork

string

Optional Der vollständige Name des Google Compute Engine-Netzwerks, mit dem die Instanz verbunden ist. Wenn nicht angegeben, wird das Netzwerk defaultverwendet.

zones[]

string

Optional Zonen, in denen Memcached-Knoten bereitgestellt werden sollen. Memcached-Knoten werden gleichmäßig auf diese Zonen verteilt. Wenn nicht angegeben, erstellt der Dienst standardmäßig Knoten in allen Zonen in der Region für die Instanz.

nodeCount

integer

Erforderlich Anzahl der Knoten in der Memcached-Instanz.

nodeConfig

object (NodeConfig)

Erforderlich Konfiguration für Memcached-Knoten.

memcacheVersion

enum (MemcacheVersion)

Optional Die Hauptversion der Memcached-Software. Wenn nicht angegeben, wird die neueste unterstützte Version verwendet. Derzeit ist die neueste unterstützte Hauptversion die Version MEMCACHE_1_5. Die Nebenversion wird von unserem System automatisch anhand der neuesten unterstützten Nebenversion ermittelt.

parameters

object (MemcacheParameters)

Optional: Benutzerdefinierte Parameter, die auf den Memcached-Prozess auf jedem Knoten angewendet werden sollen.

memcacheNodes[]

object (Node)

Nur Ausgabe Liste der Memcached-Knoten. Weitere Informationen finden Sie unter [Knoten].

createTime

string (Timestamp format)

Nur Ausgabe Die Uhrzeit, zu der die Instanz erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe Der Zeitpunkt, zu dem die Instanz aktualisiert wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Nur Ausgabe Der Status dieser Memcached-Instanz.

memcacheFullVersion

string

Nur Ausgabe Die Vollversion des Memcached-Servers, der auf dieser Instanz ausgeführt wird. Das System ermittelt automatisch die vollständige Memcached-Version für eine Instanz basierend auf der MemcacheVersion-Eingabe. Das Format der Vollversion lautet "Memcached-1.5.16".

instanceMessages[]

object (InstanceMessage)

Liste der Nachrichten, die den aktuellen Status der Memcached-Instanz beschreiben.

discoveryEndpoint

string

Nur Ausgabe Endpunkt für Discovery API

NodeConfig

Konfiguration für einen Memcached-Knoten.

JSON-Darstellung

{
  "cpuCount": integer,
  "memorySizeMb": integer
}
Felder
cpuCount

integer

Erforderlich Anzahl der CPUs pro Memcached-Knoten.

memorySizeMb

integer

Erforderlich Speichergröße in MiB für jeden Memcached-Knoten.

MemcacheVersion

Von unserem Dienst unterstützte Memcached-Versionen.

Enums
MEMCACHE_VERSION_UNSPECIFIED
MEMCACHE_1_5 Memcached 1.5-Version.

MemcacheParameters

JSON-Darstellung

{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
Felder
id

string

Nur Ausgabe Die eindeutige ID, die mit dieser Gruppe von Parametern verknüpft ist. Nutzer können mit dieser ID feststellen, ob sich die mit der Instanz verknüpften Parameter von den mit den Knoten verknüpften Parametern unterscheiden. Außerdem müssen alle Aktionen ausgeführt werden, um Parameter auf Knoten anzuwenden.

params

map (key: string, value: string)

Benutzerdefinierte Gruppe von Parametern für den Memcached-Prozess.

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

Node

JSON-Darstellung

{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  }
}
Felder
nodeId

string

Nur Ausgabe Kennung des Memcached-Knotens. Die Knoten-ID enthält kein Projekt und keinen Standort wie der Memcached-Instanzname.

zone

string

Nur Ausgabe Standort (GCP-Zone) für den Memcached-Knoten.

state

enum (State)

Nur Ausgabe Aktueller Status des Memcached-Knotens.

host

string

Nur Ausgabe Hostname oder IP-Adresse des Memcached-Knotens, mit dem die Clients eine Verbindung zum Memcached-Server auf diesem Knoten herstellen.

port

integer

Nur Ausgabe Die Portnummer des Memcached-Servers auf diesem Knoten.

parameters

object (MemcacheParameters)

Benutzerdefinierte Parameter, die derzeit auf den Knoten angewendet werden.

State

Verschiedene Status eines Memcached-Knotens.

Enums
STATE_UNSPECIFIED Der Knotenstatus ist nicht festgelegt.
CREATING Der Knoten wird erstellt.
READY Der Knoten wurde erstellt und kann verwendet werden.
DELETING Der Knoten wird gelöscht.
UPDATING Der Knoten wird aktualisiert.

State

Verschiedene Status einer Memcached-Instanz.

Enums
STATE_UNSPECIFIED Kein Status festgelegt.
CREATING Memcached-Instanz wird erstellt.
READY Die Memcached-Instanz wurde erstellt und kann verwendet werden.
DELETING Die Memcached-Instanz wird gelöscht.
PERFORMING_MAINTENANCE Die Memcached-Instanz wird gewartet, z. B. die Einführung der Datenebene.

InstanceMessage

JSON-Darstellung

{
  "code": enum (Code),
  "message": string
}
Felder
code

enum (Code)

Ein Code, der einer Art von Nachricht für Nutzer entspricht.

message

string

Nachricht in der Memcached-Instanz, die für die Nutzer sichtbar ist.

Code

Enums
CODE_UNSPECIFIED Der Nachrichtencode wurde nicht festgelegt.
ZONE_DISTRIBUTION_UNBALANCED Memcached-Knoten sind ungleichmäßig verteilt.

Methoden

applyParameters

ApplyParameters aktualisiert den aktuellen Parametersatz mit dem Satz der angegebenen Knoten der Memcached-Instanz.

create

Erstellt eine neue Instanz in einem bestimmten Projekt und Speicherort.

delete

Löscht eine einzelne Instanz.

get

Ruft Details zu einer einzelnen Instanz ab.

getIamPolicy

Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

Listet Instanzen in einem bestimmten Projekt und Speicherort auf.

patch

Aktualisiert eine vorhandene Instanz in einem bestimmten Projekt und Speicherort.

setIamPolicy

Legt die Zugriffskontrollrichtlinie für die angegebene Ressource fest.

testIamPermissions

Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.

updateParameters

Aktualisiert die definierten Memcached-Parameter für eine vorhandene Instanz.