Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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, die folgendes Format haben: projects/{project_id}/locations/{locationId}/instances/{instanceId}

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

displayName

string

Optional. Vom Nutzer angegebener Name für die Instanz, die nur zu Anzeigezwecken verwendet wird. Darf nicht länger als 80 Zeichen sein.

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 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. Die neueste unterstützte Hauptversion ist MEMACHC_1_5. Die Nebenversion wird automatisch von unserem System auf der Grundlage 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 in der Nachricht [Node].

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 der Aktualisierung der Instanz.

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 vollständige Version des Memcached-Servers, der auf dieser Instanz ausgeführt wird. Das System bestimmt automatisch die gesamte Memcache-Version für eine Instanz anhand der Memcache-Version von Eingabe. Die Vollversion umfasst das Format "memcached-1.5.1".

instanceMessages[]

object (InstanceMessage)

Auflistung der Nachrichten, die den aktuellen Status der Memcache-Instanz beschreiben.

discoveryEndpoint

string

Nur Ausgabe Endpunkt für Discovery API

NodeConfig

Konfiguration für einen Memcache-Knoten.

JSON-Darstellung

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

integer

Erforderlich. Anzahl der CPU-Ressourcen pro Memcache-Knoten.

memorySizeMb

integer

Erforderlich. Arbeitsspeichergröße in MiB für jeden Memcache-Knoten.

MemcacheVersion

Memcache-Versionen, die von unserem Dienst unterstützt werden.

Enums
MEMCACHE_VERSION_UNSPECIFIED
MEMCACHE_1_5 Memcached 1.5-Version.

MemcacheParameters

JSON-Darstellung

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

string

Nur Ausgabe Eindeutige ID für diese Gruppe von Parametern. Nutzer können mit dieser ID feststellen, ob die mit der Instanz verknüpften Parameter von den Parametern abweichen und alle Aktionen ausgeführt werden müssen, um Parameter auf Knoten anzuwenden.

params

map (key: string, value: string)

Benutzerdefinierter Satz von Parametern, die im Memcache-Prozess verwendet werden.

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 Kennzeichnung des Memcache-Knotens. Die Knoten-ID enthält weder das Projekt noch den Standort wie den Memcache-Instanznamen.

zone

string

Nur Ausgabe Speicherort (GCP-Zone) für den Memcache-Knoten.

state

enum (State)

Nur Ausgabe Aktueller Status des Memcache-Knotens:

host

string

Nur Ausgabe Hostname oder IP-Adresse des Memcache-Knotens, der von den Clients verwendet wird, um eine Verbindung zum Memcache-Server auf diesem Knoten herzustellen.

port

integer

Nur Ausgabe Die Portnummer des Memcache-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 ist einsatzbereit.
DELETING Der Knoten wird gelöscht.
UPDATING Der Knoten wird aktualisiert.

State

Verschiedene Status einer Memcached-Instanz.

Enums
STATE_UNSPECIFIED Kein Status festgelegt.
CREATING Die Memcache-Instanz wird erstellt.
READY Die Memcache-Instanz wurde erstellt und ist einsatzbereit.
DELETING Die Memcache-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 Benachrichtigung für Nutzer entspricht.

message

string

Die Nachricht auf Memcache-Instanz, die den Nutzern zur Verfügung gestellt wird.

Code

Enums
CODE_UNSPECIFIED Der Nachrichtencode ist nicht festgelegt.
ZONE_DISTRIBUTION_UNBALANCED Die Memcache-Knoten werden ungleichmäßig verteilt.

Methoden

applyParameters

ApplyParameters aktualisiert den aktuellen Parametersatz auf den Satz der angegebenen Knoten der Memcache-Instanz.

create

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

delete

Löscht eine einzelne Instanz.

get

Ruft Details einer einzelnen Instanz ab.

getIamPolicy

Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

Listet Instanzen in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert eine vorhandene Instanz in einem angegebenen Projekt und an einem angegebenen Standort.

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 Memcache-Parameter für eine vorhandene Instanz.