REST Resource: projects.locations.instances

Risorsa: istanza

Un'istanza Memorystore.

Rappresentazione JSON 
{
  "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
}
Campi
name

string

Identificatore. Nome univoco dell'istanza. Formato: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Solo output. Timestamp di creazione dell'istanza.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento dell'istanza.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Facoltativo. Etichette per rappresentare i metadati forniti dall'utente.

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

enum (State)

Solo output. Stato attuale dell'istanza.
stateInfo

object (StateInfo)

Solo output. Ulteriori informazioni sullo stato dell'istanza.
uid

string

Solo output. Identificatore univoco assegnato dal sistema all'istanza.
authorizationMode

enum (AuthorizationMode)

Facoltativo. Immutabile. Modalità di autorizzazione dell'istanza.
transitEncryptionMode

enum (TransitEncryptionMode)

Facoltativo. Immutabile. Modalità di crittografia in transito dell'istanza.
shardCount

integer

Obbligatorio. Numero di shard per l'istanza.
discoveryEndpoints[]

object (DiscoveryEndpoint)

Solo output. Endpoint tramite i quali i client possono connettersi all'istanza. Al momento è supportato un solo endpoint di rilevamento.
nodeType

enum (NodeType)

Facoltativo. Immutabile. Tipo di macchina per i singoli nodi dell'istanza.
persistenceConfig

object (PersistenceConfig)

Facoltativo. Configurazione della persistenza dell'istanza.
engineVersion

string

Facoltativo. Immutabile. del motore di ricerca dell'istanza.
engineConfigs

map (key: string, value: string)

Facoltativo. Configurazioni del motore fornite dall'utente per l'istanza.

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

object (NodeConfig)

Solo output. Configurazione dei singoli nodi dell'istanza.
zoneDistributionConfig

object (ZoneDistributionConfig)

Facoltativo. Immutabile. Configurazione della distribuzione delle zone dell'istanza per l'allocazione dei nodi.
pscAutoConnections[]

object (PscAutoConnection)

Obbligatorio. Immutabile. Input utente e dettagli delle risorse delle connessioni PSC create automaticamente.
replicaCount

integer

Facoltativo. Numero di nodi di replica per shard. Se omesso, il valore predefinito è 0 repliche.
deletionProtectionEnabled

boolean

Facoltativo. Se impostato su true, l'eliminazione dell'istanza non riuscirà.

Stato

Possibili stati dell'istanza.

Enum
STATE_UNSPECIFIED Non impostato.
CREATING Creazione dell'istanza in corso.
ACTIVE L'istanza è stata creata ed è utilizzabile.
UPDATING Aggiornamento dell'istanza in corso.
DELETING Eliminazione dell'istanza in corso.

StateInfo

Informazioni aggiuntive sullo stato dell'istanza.

Rappresentazione JSON 
{

  // Union field info can be only one of the following:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of list of possible types for union field info.
}
Campi

Campo unione info.

info può essere solo uno dei seguenti:
updateInfo

object (UpdateInfo)

Solo output. Descrive l'aggiornamento in corso quando lo stato dell'istanza è UPDATING.

UpdateInfo

Rappresenta le informazioni sull'istanza con stato UPDATING.

Rappresentazione JSON 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer
}
Campi
targetShardCount

integer

Solo output. Numero target di shard per l'istanza.
targetReplicaCount

integer

Solo output. Numero target di nodi di replica per shard per l'istanza.

AuthorizationMode

Possibili modalità di autorizzazione dell'istanza.

Enum
AUTHORIZATION_MODE_UNSPECIFIED Non impostato.
AUTH_DISABLED Autorizzazione disabilitata.
IAM_AUTH Autorizzazione di base IAM.

TransitEncryptionMode

Possibili modalità di crittografia in transito dell'istanza.

Enum
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Non impostato.
TRANSIT_ENCRYPTION_DISABLED La crittografia dei dati in transito è disabilitata.
SERVER_AUTHENTICATION La crittografia gestita dal server viene utilizzata per la crittografia dei dati in transito.

DiscoveryEndpoint

Rappresenta un endpoint per la connessione dei client all'istanza.

Rappresentazione JSON 
{
  "address": string,
  "port": integer,
  "network": string
}
Campi
address

string

Solo output. Indirizzo IP a cui si connettono i client dell'endpoint esposto.
port

integer

Solo output. Il numero di porta dell'endpoint esposto.
network

string

Solo output. La rete in cui verrà riservato l'indirizzo IP dell'endpoint di rilevamento, nel formato projects/{networkProject}/global/networks/{network_id}.

NodeType

Possibili tipi di nodi dell'istanza. Per saperne di più, consulta https://cloud.google.com/memorystore/docs/valkey/instance-node-specification.

Enum
NODE_TYPE_UNSPECIFIED Non impostato.
SHARED_CORE_NANO Nano core condiviso.
HIGHMEM_MEDIUM Mezzo memoria elevato.
HIGHMEM_XLARGE Memoria elevata: molto grande.
STANDARD_SMALL Piccolo standard.

PersistenceConfig

Rappresenta la configurazione della persistenza per un'istanza.

Rappresentazione JSON 
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Campi
mode

enum (PersistenceMode)

Facoltativo. Modalità di persistenza attuale.
rdbConfig

object (RDBConfig)

Facoltativo. Configurazione RDB. Questo campo verrà ignorato se la modalità non è RDB.
aofConfig

object (AOFConfig)

Facoltativo. configurazione AOF. Questo campo viene ignorato se la modalità non è AOF.

PersistenceMode

Possibili modalità di persistenza.

Enum
PERSISTENCE_MODE_UNSPECIFIED Non impostato.
DISABLED La persistenza viene disattivata e tutti i dati degli snapshot vengono eliminati.
RDB La persistenza basata su RDB è abilitata.
AOF La persistenza basata su AOF è abilitata.

RDBConfig

Configurazione per la persistenza basata su RDB.

Rappresentazione JSON 
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Campi
rdbSnapshotPeriod

enum (SnapshotPeriod)

Facoltativo. Periodo tra gli snapshot RDB.
rdbSnapshotStartTime

string (Timestamp format)

Facoltativo. L'ora in cui è stato/verrà tentato il primo snapshot e a cui verranno allineati gli snapshot futuri. Se non viene specificato, verrà utilizzato l'ora corrente.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

SnapshotPeriod

Possibili periodi di snapshot.

Enum
SNAPSHOT_PERIOD_UNSPECIFIED Non impostato.
ONE_HOUR Un'ora.
SIX_HOURS Sei ore.
TWELVE_HOURS dodici ore.
TWENTY_FOUR_HOURS 24 ore.

AOFConfig

Configurazione per la persistenza basata su AOF.

Rappresentazione JSON 
{
  "appendFsync": enum (AppendFsync)
}
Campi
appendFsync

enum (AppendFsync)

Facoltativo. La modalità fsync.

AppendFsync

Possibili modalità fsync.

Enum
APPEND_FSYNC_UNSPECIFIED Non impostato. Valore predefinito: EVERY_SEC
NEVER Non eseguire mai fsync. Normalmente, con questa configurazione Linux svuota la cache dei dati ogni 30 secondi, ma dipende dall'ottimizzazione esatta del kernel.
EVERY_SEC Esegui fsync ogni secondo. In caso di emergenza potresti perdere 1 secondo di dati.
ALWAYS Fsync ogni volta che vengono aggiunti nuovi comandi di scrittura all'AOF. La migliore protezione dalla perdita di dati a scapito delle prestazioni.

NodeConfig

Rappresenta la configurazione dei nodi dell'istanza.

Rappresentazione JSON 
{
  "sizeGb": number
}
Campi
sizeGb

number

Solo output. Dimensioni della memoria in GB del nodo.

ZoneDistributionConfig

Configurazione della distribuzione delle zone per l'allocazione delle risorse dell'istanza.

Rappresentazione JSON 
{
  "zone": string,
  "mode": enum (ZoneDistributionMode)
}
Campi
zone

string

Facoltativo. Definisce la zona in cui verranno allocate tutte le risorse con la modalità SINGLE_ZONE. Ignorata per la modalità MULTI_ZONE.
mode

enum (ZoneDistributionMode)

Facoltativo. Modalità di distribuzione della zona attuale. Il valore predefinito è MULTI_ZONE.

ZoneDistributionMode

Possibili modalità di distribuzione delle zone.

Enum
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Non impostato. Valore predefinito: MULTI_ZONE
MULTI_ZONE Distribuisci le risorse in tre zone scelte a caso all'interno della regione.
SINGLE_ZONE Esegui il provisioning delle risorse in una singola zona. È necessario specificare il campo Zona.

PscAutoConnection

Dettagli delle risorse consumer in una connessione PSC.

Rappresentazione JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string
}
Campi
pscConnectionId

string

Solo output. L'ID connessione PSC della regola di inoltro collegata al collegamento del servizio.
ipAddress

string

Solo output. L'IP allocato sulla rete del consumatore per la regola di forwarding PSC.
forwardingRule

string

Solo output. L'URI della regola di inoltro lato consumatore. Formato: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Obbligatorio. L'ID progetto consumer da cui viene creata la regola di forwarding.
network

string

Obbligatorio. La rete consumer in cui si trova l'indirizzo IP, nel formato projects/{projectId}/global/networks/{network_id}.

Metodi

create

 Crea una nuova istanza in un progetto e in una località specifici.

delete

 Consente di eliminare una singola istanza.

get

 Recupera i dettagli di una singola istanza.

getCertificateAuthority

 Recupera i dettagli sull'autorità di certificazione per un'istanza.

list

 Elenca le istanze in un determinato progetto e località.

patch

 Aggiorna i parametri di una singola istanza.