REST Resource: projects.locations.instances

Risorsa: Instance

Un'istanza di 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)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "migrationConfig": {
    object (MigrationConfig)
  },
  "aclPolicyInfo": {
    object (AclPolicyInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of mutually exclusive fields.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string,
  "maintenanceVersion": string,
  "effectiveMaintenanceVersion": string,
  "serverCaMode": enum (ServerCaMode),
  "serverCaPool": string,
  "rotateServerCertificate": boolean,
  "aclPolicy": string,
  "aclPolicyInSync": 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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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. Timestamp dell'ultimo aggiornamento dell'istanza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".
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. Informazioni aggiuntive sullo stato dell'istanza.
uid

string

Solo output. Identificatore univoco assegnato dal sistema per l'istanza.
authorizationMode

enum (AuthorizationMode)

Facoltativo. 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[]
(deprecated)

object (DiscoveryEndpoint)

Solo output. Ritirato: il parametro discoveryEndpoints è ritirato. Di conseguenza, non verrà compilato se le connessioni vengono create utilizzando il parametro endpoints. Al posto di questo parametro, per il discovery, utilizza endpoints.connections.pscConnection ed endpoints.connections.pscAutoConnection con connectionType CONNECTION_TYPE_DISCOVERY.
nodeType

enum (NodeType)

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

object (PersistenceConfig)

Facoltativo. Configurazione della persistenza dell'istanza.
engineVersion

string

Facoltativo. 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[]
(deprecated)

object (PscAutoConnection)

Facoltativo. Immutabile. Deprecato: utilizza invece il valore endpoints.connections.psc_auto_connection.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Solo output. Dettagli del collegamento al servizio per configurare le connessioni PSC.
endpoints[]

object (InstanceEndpoint)

Facoltativo. Endpoint per l'istanza.
mode

enum (Mode)

Facoltativo. Immutabile. La configurazione della modalità per l'istanza.
maintenancePolicy

object (MaintenancePolicy)

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

object (MaintenanceSchedule)

Solo output. Pianificazione della manutenzione pubblicata.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Facoltativo. La configurazione per la replica tra istanze.
encryptionInfo

object (EncryptionInfo)

Solo output. Informazioni sulla crittografia dei dati at-rest del cluster.
automatedBackupConfig

object (AutomatedBackupConfig)

Facoltativo. La configurazione del backup automatico per l'istanza.
availableMaintenanceVersions[]

string

Solo output. Questo campo viene utilizzato per determinare le versioni di manutenzione disponibili per l'aggiornamento self-service.
allowFewerZonesDeployment
(deprecated)

boolean

Facoltativo. Immutabile. Deprecato, non utilizzare.
migrationConfig

object (MigrationConfig)

Solo output. Configurazione della migrazione per l'istanza.
aclPolicyInfo

object (AclPolicyInfo)

Solo output. Dettagli della policy ACL applicata.
L'origine da cui eseguire l'importazione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
gcsSource

object (GcsBackupSource)

Facoltativo. Immutabile. Backup archiviati nei bucket Cloud Storage. I bucket Cloud Storage devono trovarsi nella stessa regione delle istanze. Per importare dagli oggetti Cloud Storage forniti, è necessaria l'autorizzazione in lettura.
managedBackupSource

object (ManagedBackupSource)

Facoltativo. Immutabile. Backup generati e gestiti dal servizio Memorystore.
Fine dei campi che si escludono a vicenda.
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.
simulateMaintenanceEvent

boolean

Facoltativo. Solo input. Simula un evento di manutenzione.
ondemandMaintenance
(deprecated)

boolean

Facoltativo. Solo input. Manutenzione on demand per l'istanza.
satisfiesPzs

boolean

Facoltativo. Solo output. Riservato per uso futuro.
satisfiesPzi

boolean

Facoltativo. Solo output. Riservato per uso futuro.
asyncInstanceEndpointsDeletionEnabled

boolean

Facoltativo. Se impostato su true, gli endpoint dell'istanza creati e registrati dai clienti possono essere eliminati in modo asincrono. In altre parole, l'endpoint dell'istanza può essere annullato prima che vengano eliminate le regole di forwarding nell'endpoint dell'istanza.
kmsKey

string

Facoltativo. La chiave KMS utilizzata per criptare i dati at-rest del cluster.
backupCollection

string

Solo output. Il nome completo della risorsa della raccolta di backup. Esempio: projects/{project}/locations/{location}/backupCollections/{collection}
maintenanceVersion

string

Facoltativo. Questo campo può essere utilizzato per attivare l'aggiornamento self-service per indicare la versione di manutenzione desiderata. L'input di questo campo può essere determinato dal campo availableMaintenanceVersions.
effectiveMaintenanceVersion

string

Solo output. Questo campo rappresenta la versione di manutenzione effettiva dell'istanza.
serverCaMode

enum (ServerCaMode)

Facoltativo. Immutabile. La modalità CA server per l'istanza.
serverCaPool

string

Facoltativo. Immutabile. Il pool CA gestito dal cliente per l'istanza. Applicabile solo se la modalità CA server è CUSTOMER_MANAGED_CAS_CA. Formato: "projects/{project}/locations/{region}/caPools/{ca_pool}".
rotateServerCertificate

boolean

Facoltativo. Solo input. Ruota i certificati del server.
aclPolicy

string

Facoltativo. La policy ACL per l'istanza. Formato: projects/{project}/locations/{location}/aclPolicies/{aclPolicy}
aclPolicyInSync
(deprecated)

boolean

Solo output. Deprecato: indica se le regole ACL applicate all'istanza sono sincronizzate.

GcsBackupSource

Backup archiviati nei bucket Cloud Storage. I bucket Cloud Storage devono trovarsi nella stessa regione delle istanze.

Rappresentazione JSON 
{
  "uris": [
    string
  ]
}
Campi
uris[]

string

Facoltativo. Esempio: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Backup generati e gestiti da Memorystore.

Rappresentazione JSON 
{
  "backup": string
}
Campi
backup

string

Facoltativo. Esempio: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} È supportata anche una versione più breve (senza il prefisso) del nome del backup, ad esempio projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId} In questo caso, si presuppone che il backup si trovi in memorystore.googleapis.com.

Stato

Possibili stati dell'istanza.

Enum
STATE_UNSPECIFIED Non impostata.
CREATING Creazione dell'istanza in corso.
ACTIVE L'istanza è stata creata ed è utilizzabile.
UPDATING È in corso l'aggiornamento dell'istanza.
DELETING Eliminazione dell'istanza in corso.
MIGRATING È in corso la migrazione dell'istanza.

StateInfo

Informazioni aggiuntive sullo stato dell'istanza.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of mutually exclusive fields.
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
updateInfo

object (UpdateInfo)

Solo output. Descrive l'aggiornamento in corso quando lo stato dell'istanza è UPDATING.
Fine dei campi che si escludono a vicenda.

UpdateInfo

Rappresenta le informazioni sull'istanza con stato UPDATING.

Rappresentazione JSON 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
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.
targetEngineVersion

string

Solo output. Versione del motore di destinazione per l'istanza.
targetNodeType

enum (NodeType)

Solo output. Tipo di nodo di destinazione per l'istanza.

AuthorizationMode

Possibili modalità di autorizzazione dell'istanza.

Enum
AUTHORIZATION_MODE_UNSPECIFIED Non impostata.
AUTH_DISABLED Autorizzazione disattivata.
IAM_AUTH Autorizzazione di base IAM.
TOKEN_AUTH Autorizzazione basata su token.

TransitEncryptionMode

Possibili modalità di crittografia in transito dell'istanza.

Enum
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Non impostata.
TRANSIT_ENCRYPTION_DISABLED La crittografia 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 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_name}.

PersistenceConfig

Rappresenta la configurazione di 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 verrà ignorato se la modalità non è AOF.

PersistenceMode

Possibili modalità di persistenza.

Enum
PERSISTENCE_MODE_UNSPECIFIED Non impostata.
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. Ora in cui è stato/sarà tentato il primo snapshot e a cui verranno allineati gli snapshot futuri. Se non viene specificata, verrà utilizzata l'ora corrente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".

SnapshotPeriod

Possibili periodi di snapshot.

Enum
SNAPSHOT_PERIOD_UNSPECIFIED Non impostata.
ONE_HOUR Un'ora.
SIX_HOURS Sei ore.
TWELVE_HOURS Dodici ore.
TWENTY_FOUR_HOURS Ventiquattro 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 impostata. Valore predefinito: EVERY_SEC
NEVER Never fsync. In genere, con questa configurazione Linux svuota i dati ogni 30 secondi, ma dipende dall'ottimizzazione esatta del kernel.
EVERY_SEC 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 del nodo in GB.

ZoneDistributionConfig

Configurazione della distribuzione per zona per l'allocazione delle risorse delle istanze.

Rappresentazione JSON 
{
  "zone": string,
  "zones": [
    string
  ],
  "activeZones": [
    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.
zones[]

string

Facoltativo. Specifica le zone di un'istanza multizona in cui l'istanza Memorystore alloca le risorse. Questo flag non è applicabile alle istanze a zona singola.
activeZones[]

string

Solo output. L'elenco delle zone in cui l'istanza ha VM attive.
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 3 zone scelte in modo casuale all'interno della regione.
SINGLE_ZONE Eseguire il provisioning delle risorse in una singola zona. Il campo della zona deve essere specificato.

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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
Campi
pscConnectionId

string

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

string

Solo output. L'IP allocato sulla rete consumer 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. 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_name}.
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 ed è ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Utilizza le API Private Service Connect per lo stato più recente.
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC.
Porte dell'endpoint esposto. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
port

integer

Facoltativo. La porta verrà impostata solo per l'endpoint principale/di lettura o di rilevamento.
Fine dei campi che si escludono a vicenda.

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 all'istanza principale.
CONNECTION_TYPE_READER Connessione che verrà utilizzata come endpoint di lettura per accedere alle repliche.

PscAttachmentDetail

Configurazione di un collegamento al servizio del cluster per la creazione di connessioni PSC.

Rappresentazione JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Campi
serviceAttachment

string

Solo output. URI del collegamento al servizio che la connessione PSC creata autonomamente deve utilizzare come destinazione.
connectionType

enum (ConnectionType)

Solo output. Tipo di endpoint PSC.

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 al 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 al servizio nel cluster.

ConnectionDetail

Informazioni su ogni connessione PSC.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of mutually exclusive fields.
}
Campi
Una connessione PSC a un'istanza può essere creata tramite l'automazione della connettività dei servizi (connessione automatica) durante la creazione del cluster o può essere creata dal cliente (connessione creata dall'utente). Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
pscAutoConnection

object (PscAutoConnection)

Immutabile. 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.
Fine dei campi che si escludono a vicenda.

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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
Campi
pscConnectionId

string

Obbligatorio. L'ID connessione PSC della regola di forwarding collegata al collegamento al servizio.
ipAddress

string

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

string

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

string

Solo output. Il projectId del 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_name}.
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 ed è ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Utilizza le API Private Service Connect per lo stato più recente.
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC.
Porte dell'endpoint esposto. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
port

integer

Facoltativo. La porta verrà impostata solo per l'endpoint principale/di lettura o di rilevamento.
Fine dei campi che si escludono a vicenda.

Modalità

La configurazione della modalità, utilizzata per abilitare/disabilitare la modalità cluster.

Enum
MODE_UNSPECIFIED La modalità non è specificata.
STANDALONE

Deprecato: utilizza invece CLUSTER_DISABLED.
CLUSTER L'istanza è in modalità cluster.
CLUSTER_DISABLED La modalità cluster è disabilitata per l'istanza.

MaintenancePolicy

Policy di manutenzione per l'istanza.

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

string (Timestamp format)

Solo output. La data e l'ora in cui è stata creata la policy.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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. La data e l'ora in cui è stata aggiornata la policy.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Facoltativo. Periodo di manutenzione applicato alle risorse interessate da questa policy. Minimo 1. Per la versione corrente, il numero massimo di weekly_window deve essere uno.

WeeklyMaintenanceWindow

Finestra temporale specificata per le operazioni settimanali.

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

enum (DayOfWeek)

Facoltativo. Il giorno della settimana per il periodo di manutenzione. Questo campo è obbligatorio. Non puoi utilizzare DAY_OF_WEEK_UNSPECIFIED.
startTime

object (TimeOfDay)

Facoltativo. L'ora di inizio del periodo di manutenzione in UTC. Quando specifichi un periodo di manutenzione, startTime è obbligatorio.

MaintenanceSchedule

Pianificazione della manutenzione imminente.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": 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 con normalizzazione Z 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 con normalizzazione Z 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".

CrossInstanceReplicationConfig

Configurazione della replica tra istanze.

Rappresentazione JSON 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campi
instanceRole

enum (InstanceRole)

Obbligatorio. Il ruolo dell'istanza nella replica tra istanze.
primaryInstance

object (RemoteInstance)

Facoltativo. Dettagli dell'istanza principale utilizzata come origine della replica per questa istanza secondaria.

Questo campo è impostato solo per un'istanza secondaria.
secondaryInstances[]

object (RemoteInstance)

Facoltativo. Elenco delle istanze secondarie che eseguono la replica da questa istanza principale.

Questo campo è impostato solo per un'istanza principale.
updateTime

string (Timestamp format)

Solo output. L'ultima volta che è stata aggiornata la configurazione della replica tra istanze.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".
membership

object (Membership)

Solo output. Una visualizzazione di sola visualizzazione di tutte le istanze membro che partecipano alla replica tra istanze. Questa vista verrà fornita da ogni istanza membro, indipendentemente dal ruolo dell'istanza (principale o secondaria).

Un'istanza principale può fornire informazioni su tutte le istanze secondarie che replicano i dati da essa. Tuttavia, un'istanza secondaria conosce solo l'istanza principale da cui esegue la replica. Tuttavia, per gli scenari in cui l'istanza principale non è disponibile (ad esempio un'interruzione a livello di regione), è possibile inviare una richiesta Getinstance a qualsiasi altra istanza membro e questo campo elencherà tutte le istanze membro che partecipano alla replica tra istanze.

InstanceRole

Il ruolo dell'istanza nella replica tra istanze.

Enum
INSTANCE_ROLE_UNSPECIFIED il ruolo dell'istanza non è impostato. Il comportamento è equivalente a NONE.
NONE Questa istanza non partecipa alla replica tra istanze. Si tratta di un'istanza indipendente e non viene replicata da o verso altre istanze.
PRIMARY Un'istanza che consente sia le operazioni di lettura che quelle di scrittura. Tutti i dati scritti in questa istanza vengono replicati anche nelle istanze secondarie collegate.
SECONDARY Un'istanza che consente solo la lettura e la replica dei dati da un'istanza principale.

RemoteInstance

Dettagli dell'istanza remota associata a questa istanza in una configurazione di replica tra istanze.

Rappresentazione JSON 
{
  "instance": string,
  "uid": string
}
Campi
instance

string

Facoltativo. Il percorso completo della risorsa dell'istanza remota nel formato: projects//locations//instances/
uid

string

Solo output. L'identificatore univoco dell'istanza remota.

Appartenenza

Una visualizzazione di sola visualizzazione di tutte le istanze membro che partecipano alla replica tra istanze.

Rappresentazione JSON 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Campi
primaryInstance

object (RemoteInstance)

Solo output. L'istanza principale che funge da origine della replica per le istanze secondarie.
secondaryInstances[]

object (RemoteInstance)

Solo output. L'elenco delle istanze secondarie che eseguono la replica dall'istanza principale.

AutomatedBackupConfig

La configurazione del backup automatico per un'istanza.

Rappresentazione JSON 
{
  "automatedBackupMode": enum (AutomatedBackupMode),
  "retention": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of mutually exclusive fields.
}
Campi
automatedBackupMode

enum (AutomatedBackupMode)

Facoltativo. La modalità di backup automatico. Se la modalità è disattivata, gli altri campi verranno ignorati.
retention

string (Duration format)

Facoltativo. Per quanto tempo conservare i backup automatici prima che vengano eliminati. Il valore deve essere compreso tra 1 e 365 giorni. Se non viene specificato, il valore predefinito è 35 giorni.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
La pianificazione dei backup automatici. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Facoltativo. Attiva i backup automatici con una frequenza fissa.
Fine dei campi che si escludono a vicenda.

FixedFrequencySchedule

Questa pianificazione consente di attivare il backup con una frequenza fissa (al momento è supportata solo la frequenza giornaliera).

Rappresentazione JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Campi
startTime

object (TimeOfDay)

Obbligatorio. L'ora di inizio di ogni backup automatico in UTC. Deve essere impostata sull'inizio di un'ora. Questo campo è obbligatorio.

AutomatedBackupMode

La modalità di backup automatico.

Enum
AUTOMATED_BACKUP_MODE_UNSPECIFIED Valore predefinito. La configurazione del backup automatico non è specificata.
DISABLED Configurazione del backup automatico disabilitata.
ENABLED Configurazione del backup automatico abilitata.

ServerCaMode

La modalità CA server per l'istanza.

Enum
SERVER_CA_MODE_UNSPECIFIED Modalità CA del server non specificata.
GOOGLE_MANAGED_PER_INSTANCE_CA Ogni istanza ha la propria CA gestita da Google.
GOOGLE_MANAGED_SHARED_CA L'istanza utilizza una CA condivisa gestita da Google per la regione dell'istanza.
CUSTOMER_MANAGED_CAS_CA L'istanza utilizza una CA gestita dal cliente di CAS.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA

Ritirato: utilizza GOOGLE_MANAGED_PER_INSTANCE_CA.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA

Deprecato: utilizza GOOGLE_MANAGED_SHARED_CA.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA

Deprecato: utilizza CUSTOMER_MANAGED_CAS_CA.

MigrationConfig

Configurazione per la migrazione di un'istanza.

Rappresentazione JSON 
{
  "state": enum (State),
  "forceFinishMigration": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "selfManagedSource": {
    object (SelfManagedSource)
  }
  // End of mutually exclusive fields.
}
Campi
state

enum (State)

Solo output. Stato della migrazione dell'istanza.
forceFinishMigration

boolean

Solo output. Rappresenta un flag booleano per forzare la finalizzazione della migrazione senza la convalida del recupero dell'offset tra l'origine e la destinazione prima di interrompere la replica.
Dettagli sull'origine della migrazione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
selfManagedSource

object (SelfManagedSource)

Solo output. Configurazione per la migrazione da un'istanza Valkey/Redis autogestita
Fine dei campi che si escludono a vicenda.

SelfManagedSource

Dettagli dell'istanza di origine autogestita.

Rappresentazione JSON 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
Campi
ipAddress

string

Obbligatorio. L'indirizzo IP dell'istanza di origine. Questo indirizzo IP deve essere un indirizzo IP stabile a cui l'istanza Memorystore può accedere durante il processo di migrazione.
port

integer

Obbligatorio. La porta dell'istanza di origine. Questa porta deve essere una porta stabile a cui l'istanza Memorystore può accedere durante il processo di migrazione.
networkAttachment

string

Obbligatorio. Il nome della risorsa del collegamento di rete Private Service Connect utilizzato per stabilire la connettività all'istanza di origine. Questo collegamento di rete ha i seguenti requisiti: 1. Deve trovarsi nello stesso progetto dell'istanza Memorystore. 2. Deve trovarsi nella stessa regione dell'istanza Memorystore. 3. La subnet collegata al collegamento di rete deve trovarsi nella stessa rete VPC dei nodi dell'istanza di origine.

Formato: projects/{project}/regions/{region}/networkAttachments/{networkAttachment}

Stato

Stato della migrazione dell'istanza. In futuro potrebbero essere aggiunti nuovi valori.

Enum
STATE_UNSPECIFIED L'istanza non ha attività correlate alla migrazione. Questo è lo stato iniziale.
ROLLED_BACK Al momento non è in corso la migrazione dell'istanza. L'istanza è stata sottoposta a un tentativo di migrazione non riuscito e il successivo rollback è andato a buon fine. L'istanza è ora pronta per un nuovo tentativo di migrazione, se necessario.
ROLLING_BACK Indica che un tentativo di migrazione precedente non è riuscito. Lo stato dell'istanza di alto livello sarà MIGRATING. L'istanza non è pronta per un nuovo tentativo di migrazione. Il rollback è in corso per ripristinare l'istanza allo stato originale. L'istanza rimarrà in questo stato fino al completamento del rollback.
REPLICATION_ESTABLISHED L'istanza è in fase di migrazione. L'istanza ha stabilito una replica corretta ed è pronta per il cutover.
MIGRATED La migrazione dell'istanza è stata completata.

AclPolicyInfo

Dettagli della policy ACL applicata.

Rappresentazione JSON 
{
  "appliedAclPolicy": string,
  "appliedAclPolicyRevision": string,
  "appliedAclPolicyRevisionNumber": string,
  "aclPolicyRevisionStatuses": [
    {
      object (AclPolicyRevisionStatus)
    }
  ]
}
Campi
appliedAclPolicy

string

Solo output. Il nome della risorsa della policy ACL applicata. Formato: "projects/{project}/locations/{location}/aclPolicies/{aclPolicy}"
appliedAclPolicyRevision

string

Solo output. Il nome della risorsa della revisione della policy ACL applicata. Formato: "projects/{project}/locations/{location}/aclPolicies/{aclPolicy}/revisions/{revision}"
appliedAclPolicyRevisionNumber

string (int64 format)

Solo output. Il numero di revisione della policy ACL applicata.
aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

Solo output. Un elenco di stati per le varie revisioni di questa policy ACL nell'istanza.

Metodi

addTokenAuthUser

 Aggiunge un utente di autenticazione con token per un'istanza abilitata per l'autenticazione basata su token.

backup

 Backup dell'istanza.

create

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

delete

 Elimina una singola istanza.

finishMigration

 Finalizza il processo di migrazione.

get

 Recupera i dettagli di una singola istanza.

getCertificateAuthority

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

list

 Elenca le istanze in un progetto e una località specifici.

patch

 Aggiorna i parametri di una singola istanza.

rescheduleMaintenance

 Ripianifica l'evento di manutenzione imminente.

startMigration

 Avvia la migrazione di un'istanza di origine all'istanza Memorystore di destinazione.