REST Resource: projects.locations.instances

Risorsa: Istanza

Un'istanza Memorystore for Memcached

Rappresentazione JSON 
{
  "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,
  "updateAvailable": boolean,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "reservedIpRangeId": [
    string
  ],
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean
}
Campi
name

string

Obbligatorio. Nome univoco della risorsa in questo ambito, inclusi progetto e località, nel formato: projects/{projectId}/locations/{locationId}/instances/{instanceId}

Nota: le istanze Memcached vengono gestite e indirizzate a livello regionale, quindi locationId si riferisce a una regione Google Cloud. Tuttavia, gli utenti possono scegliere in quali zone devono essere sottoposti a provisioning i nodi Memcached all'interno di un'istanza. Per ulteriori dettagli, consulta il campo zones.
displayName

string

Nome fornito dall'utente per l'istanza, utilizzato solo a scopo di visualizzazione. Non può contenere più di 80 caratteri.
labels

map (key: string, value: string)

Etichette delle risorse per rappresentare i metadati forniti dagli utenti. Per saperne di più, consulta la documentazione cloud sulle etichette. https://cloud.google.com/compute/docs/labeling-resources

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
authorizedNetwork

string

Il nome completo della rete Google Compute Engine a cui è connessa l'istanza. Se non specificata, verrà utilizzata la rete default.
zones[]

string

Le zone in cui devono essere sottoposti a provisioning i nodi Memcached. I nodi Memcached verranno distribuiti equamente tra queste zone. Se non viene fornito alcun valore, il servizio creerà per impostazione predefinita nodi in tutte le zone della regione per l'istanza.
nodeCount

integer

Obbligatorio. Numero di nodi nell'istanza Memcached.
nodeConfig

object (NodeConfig)

Obbligatorio. Configurazione per i nodi Memcached.
memcacheVersion

enum (MemcacheVersion)

La versione principale del software Memcached. Se non viene fornita, verrà utilizzata l'ultima versione supportata. Al momento, l'ultima versione principale supportata è MEMCACHE_1_5. La versione secondaria verrà determinata automaticamente dal nostro sistema in base all'ultima versione secondaria supportata.
parameters

object (MemcacheParameters)

Parametri definiti dall'utente da applicare al processo memcached su ogni nodo.
memcacheNodes[]

object (Node)

Solo output. Elenco dei nodi Memcached. Per ulteriori dettagli, consulta il messaggio Node.
createTime

string (Timestamp format)

Solo output. Ora in cui è stata creata l'istanza.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora in cui è stata aggiornata l'istanza.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Solo output. Lo stato di questa istanza Memcached.
memcacheFullVersion

string

Solo output. La versione completa del server memcached in esecuzione su questa istanza. Il sistema determina automaticamente la versione completa di Memcached per un'istanza in base a MemcacheVersion. Il formato della versione completa sarà "memcached-1.5.16".
instanceMessages[]

object (InstanceMessage)

Elenco di messaggi che descrivono lo stato attuale dell'istanza Memcached.
discoveryEndpoint

string

Solo output. Endpoint per l'API Discovery.
updateAvailable

boolean

Solo output. Restituisce true se è presente un aggiornamento in attesa di essere applicato
maintenancePolicy

object (MaintenancePolicy)

I criteri di manutenzione per l'istanza. Se non viene fornito, l'evento di manutenzione verrà eseguito in base alla pianificazione interna dell'implementazione di Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Solo output. Pianificazione della manutenzione pubblicata.
reservedIpRangeId[]

string

Facoltativo. Contiene l'ID degli intervalli di indirizzi IP allocati associati alla connessione di accesso al servizio privato, ad esempio "test-default" associato all'intervallo IP 10.0.0.0/29.
satisfiesPzs

boolean

Facoltativo. Solo output. Riservato per l'uso futuro.
satisfiesPzi

boolean

Facoltativo. Solo output. Riservato per l'uso futuro.

NodeConfig

Configurazione di un nodo Memcached.

Rappresentazione JSON 
{
  "cpuCount": integer,
  "memorySizeMb": integer
}
Campi
cpuCount

integer

Obbligatorio. Numero di CPU per nodo Memcached.
memorySizeMb

integer

Obbligatorio. La dimensione della memoria in MiB per ogni nodo Memcached.

MemcacheVersion

Versioni di Memcached supportate dal nostro servizio.

Enum
MEMCACHE_VERSION_UNSPECIFIED La versione di Memcache non è specificata dal cliente
MEMCACHE_1_5 Versione 1.5 di Memcached.
MEMCACHE_1_6_15 Versione 1.6.15 di Memcached.

MemcacheParameters

Rappresentazione JSON 
{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
Campi
id

string

Solo output. L'ID univoco associato a questo insieme di parametri. Gli utenti possono utilizzare questo ID per determinare se i parametri associati all'istanza differiscono da quelli associati ai nodi. Una discrepanza tra gli ID parametro può informare gli utenti che potrebbero dover intervenire per applicare i parametri ai nodi.
params

map (key: string, value: string)

Set di parametri definiti dall'utente da utilizzare nel processo memcached.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Nodo

Rappresentazione JSON 
{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  },
  "updateAvailable": boolean,
  "memcacheVersion": enum (MemcacheVersion),
  "memcacheFullVersion": string
}
Campi
nodeId

string

Solo output. Identificatore del nodo Memcached. L'ID nodo non include il progetto o la località come il nome dell'istanza Memcached.
zone

string

Solo output. Posizione (zona Google Cloud) del nodo Memcached.
state

enum (State)

Solo output. Stato attuale del nodo Memcached.
host

string

Solo output. Nome host o indirizzo IP del nodo Memcached utilizzato dai client per connettersi al server Memcached su questo nodo.
port

integer

Solo output. Il numero di porta del server Memcached su questo nodo.
parameters

object (MemcacheParameters)

Parametri definiti dall'utente attualmente applicati al nodo.
updateAvailable

boolean

Solo output. Restituisce true se è presente un aggiornamento in attesa di essere applicato
memcacheVersion

enum (MemcacheVersion)

Solo output. Versione principale del server memcached in esecuzione su questo nodo, ad esempio MEMCACHE_1_5
memcacheFullVersion

string

Solo output. La versione completa del server memcached in esecuzione su questo nodo. Ad esempio, memcached-1.5.16

Stato

I diversi stati di un nodo Memcached.

Enum
STATE_UNSPECIFIED Lo stato del nodo non è impostato.
CREATING Il nodo è in fase di creazione.
READY Il nodo è stato creato ed è pronto per essere utilizzato.
DELETING Il nodo è in fase di eliminazione.
UPDATING Il nodo è in fase di aggiornamento.

Stato

I diversi stati di un'istanza Memcached.

Enum
STATE_UNSPECIFIED Stato non impostato.
CREATING Creazione dell'istanza Memcached in corso.
READY L'istanza Memcached è stata creata ed è pronta per essere utilizzata.
UPDATING L'istanza Memcached sta aggiornando la configurazione, ad esempio la policy e la pianificazione della manutenzione.
DELETING L'istanza Memcached è in fase di eliminazione.
PERFORMING_MAINTENANCE L'istanza Memcached è in fase di manutenzione, ad esempio implementazione del piano dati.
MEMCACHE_VERSION_UPGRADING L'istanza Memcached è in fase di upgrade della versione del motore memcached.

InstanceMessage

Rappresentazione JSON 
{
  "code": enum (Code),
  "message": string
}
Campi
code

enum (Code)

Un codice che corrisponde a un tipo di messaggio rivolto agli utenti.
message

string

Messaggio sull'istanza memcached che verrà esposta agli utenti.

Codice

Enum
CODE_UNSPECIFIED Codice messaggio non impostato.
ZONE_DISTRIBUTION_UNBALANCED I nodi Memcached sono distribuiti in modo non uniforme.

MaintenancePolicy

Policy di manutenzione per istanza.

Rappresentazione JSON 
{
  "createTime": string,
  "updateTime": string,
  "description": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
Campi
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il criterio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora in cui è stato aggiornato il criterio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
description

string

Descrizione dello scopo di queste norme. I metodi Create/Update restituiscono INVALID_ARGUMENT se la lunghezza è maggiore di 512.
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Obbligatorio. Finestra di manutenzione applicata alle risorse coperte da questa policy. Minimo 1. Per la versione attuale, il numero massimo di weekly_maintenance_windows previsto è uno.

WeeklyMaintenanceWindow

Finestra temporale specificata per le operazioni settimanali.

Rappresentazione JSON 
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Campi
day

enum (DayOfWeek)

Obbligatorio. Consente di definire una pianificazione che viene eseguita in un giorno specifico della settimana.
startTime

object (TimeOfDay)

Obbligatorio. L'ora di inizio della finestra in UTC.
duration

string (Duration format)

Obbligatorio. Durata della finestra temporale.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

MaintenanceSchedule

Pianificazione della manutenzione imminente.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "scheduleDeadlineTime": string
}
Campi
startTime

string (Timestamp format)

Solo output. L'ora di inizio di qualsiasi manutenzione pianificata imminente per questa istanza.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo output. L'ora di fine di qualsiasi manutenzione pianificata imminente per questa istanza.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
scheduleDeadlineTime

string (Timestamp format)

Solo output. La scadenza che l'ora di inizio della pianificazione della manutenzione non può superare, inclusa la ripianificazione.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Metodi

applyParameters

 ApplyParameters riavvia l'insieme di nodi specificati per aggiornarli all'insieme corrente di parametri per l'istanza Memcached.

applySoftwareUpdate

 Aggiorna il software sui nodi selezionati dell'istanza.

create

 Crea una nuova istanza in una determinata località.

delete

 Elimina una singola istanza.

get

 Recupera i dettagli di una singola istanza.

list

 Elenca le istanze in una determinata località.

patch

 Aggiorna un'istanza esistente in un determinato progetto e in una determinata località.

rescheduleMaintenance

 Esegue la fase di applicazione del verbo RescheduleMaintenance.

updateParameters

 Aggiorna i parametri Memcached definiti per un'istanza esistente.

upgrade

 Esegue l'upgrade dell'istanza Memcache a una versione più recente del motore memcached specificata nella richiesta.