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)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "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 della creazione 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".
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 coppie "key": value. 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 dei dati in transito dell'istanza.
shardCount

integer

Facoltativo. 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. Versione del motore 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.
endpoints[]

object (InstanceEndpoint)

Facoltativo. Endpoint per l'istanza.
mode

enum (Mode)

Facoltativo. La configurazione della modalità per l'istanza.
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 andrà a buon fine.

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

Ulteriori informazioni 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 dei dati 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 con core condiviso.
HIGHMEM_MEDIUM Medio con memoria elevata.
HIGHMEM_XLARGE Memoria elevata di grandi dimensioni.
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 è attivata.
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. 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 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, con questa configurazione Linux esegue lo svuotamento della cache dei dati ogni 30 secondi, ma dipende dalla regolazione esatta del kernel.
EVERY_SEC Esegui fsync 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 contro la 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 un'unica 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,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
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 consumer per la regola di inoltro PSC.
forwardingRule

string

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

string

Obbligatorio. Il projectId del consumer in cui vengono stabilite le connessioni PSC. Deve essere lo stesso projectId in cui viene creata l'istanza.
network

string

Obbligatorio. La rete in cui vengono creati gli endpoint PSC, nel formato projects/{projectId}/global/networks/{network_id}.
serviceAttachment

string

Solo output. Il collegamento del servizio che è la destinazione della connessione PSC, nel formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo output. Lo stato della connessione PSC: se esiste una connessione e se è ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Utilizza le API Private Service Connect per conoscere lo stato più recente.
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC.
Campo unione ports. Porte dell'endpoint esposto. ports può essere solo uno dei seguenti:
port

integer

Facoltativo. Solo output. La porta verrà impostata solo per l'endpoint principale/lettore o di rilevamento.

PscConnectionStatus

Stato della connessione PSC.

Enum
PSC_CONNECTION_STATUS_UNSPECIFIED Lo stato della connessione PSC non è specificato.
ACTIVE La connessione è attiva
NOT_FOUND Connessione non trovata

ConnectionType

Tipo di connessione PSC

Enum
CONNECTION_TYPE_UNSPECIFIED Il tipo di connessione non è impostato
CONNECTION_TYPE_DISCOVERY Connessione che verrà utilizzata per il rilevamento della topologia.
CONNECTION_TYPE_PRIMARY Connessione che verrà utilizzata come endpoint principale per accedere al database principale.
CONNECTION_TYPE_READER Connessione che verrà utilizzata come endpoint del lettore per accedere alle repliche.

InstanceEndpoint

InstanceEndpoint è costituito da connessioni PSC create come gruppo in ogni rete VPC per accedere all'istanza. In ogni gruppo deve essere presente una connessione per ogni collegamento del servizio nel cluster.

Rappresentazione JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Campi
connections[]

object (ConnectionDetail)

Facoltativo. Un gruppo di connessioni PSC. Vengono creati nella stessa rete VPC, uno per ogni collegamento di servizio nel cluster.

ConnectionDetail

Informazioni su ogni connessione PSC.

Rappresentazione JSON 
{

  // Union field connection can be only one of the following:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of list of possible types for union field connection.
}
Campi
Campo unione connection. Una connessione PSC a un'istanza può essere creata tramite l'automazione della connettività dei servizi (connessione automatica) durante la creazione del cluster oppure può essere creata dal cliente stesso (connessione creata dall'utente). connection può essere solo uno dei seguenti:
pscAutoConnection

object (PscAutoConnection)

Informazioni dettagliate su una connessione PSC creata tramite l'automazione della connettività dei servizi.
pscConnection

object (PscConnection)

Informazioni dettagliate su una connessione PSC creata dall'utente.

PscConnection

Configurazione della connessione PSC creata dall'utente.

Rappresentazione JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType)
}
Campi
pscConnectionId

string

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

string

Obbligatorio. L'IP allocato sulla rete del consumer per la regola di inoltro PSC.
forwardingRule

string

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

string

Solo output. Il projectId del consumatore da cui viene creata la regola di inoltro.
network

string

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

string

Obbligatorio. Il collegamento del servizio che è la destinazione della connessione PSC, nel formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo output. Lo stato della connessione PSC: se esiste una connessione e se è ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Utilizza le API Private Service Connect per conoscere lo stato più recente.
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC.

Modalità

La configurazione della modalità, utilizzata per attivare/disattivare la modalità cluster.

Enum
MODE_UNSPECIFIED La modalità non è specificata.
CLUSTER L'istanza è in modalità cluster.
CLUSTER_DISABLED La modalità cluster è disabilitata per l'istanza.

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.