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 per l'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. Tramite i client degli endpoint è possibile 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 di 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 "key": value coppie. 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 viene impostato su true, l'eliminazione dell'istanza non andrà a buon fine.

Stato

Stati possibili 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 L'autorizzazione è disattivata.
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 è disattivata.
SERVER_AUTHENTICATION La crittografia gestita dal server viene utilizzata per la crittografia dei dati in transito.

DiscoveryEndpoint

Rappresenta un endpoint per consentire ai client di connettersi all'istanza.

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

string

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

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 ulteriori informazioni, visita la pagina 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 di grandi dimensioni.
STANDARD_SMALL Standard piccolo.

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 è disabilitata e tutti i dati dello snapshot vengono eliminati.
RDB La persistenza basata su RDB è abilitata.
AOF La persistenza basata su AOF è attivata.

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 specificata, verrà usata l'ora corrente.

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

SnapshotPeriod

Possibili periodi di istantanea.

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 Linux esegue il flush dei dati ogni 30 secondi con questa configurazione, ma dipende dall'ottimizzazione esatta del kernel.
EVERY_SEC Esegui la sincronizzazione ogni secondo. In caso di disastro, potresti perdere 1 secondo di dati.
ALWAYS Esegui Fsync ogni volta che nuovi comandi di scrittura vengono aggiunti 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 delle istanze.

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. Ignorato per la modalità MULTI_ZONE.

mode

enum (ZoneDistributionMode)

Facoltativo. Modalità di distribuzione delle zone 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 forwarding connessa al collegamento al 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 forwarding lato consumer. 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 risiede l'indirizzo IP, nel formato projects/{projectId}/global/networks/{network_id}.

Metodi

create

Crea una nuova istanza in un determinato progetto e posizione.

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.