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 di 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. Deprecato: il parametro discoveryEndpoints è deprecato. Di conseguenza, non verrà compilato se le connessioni vengono create utilizzando il parametro degli endpoint. Anziché questo parametro, per la scoperta utilizza endpoints.connections.pscConnection e 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. Ritirato: 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 importare. 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. È necessaria l'autorizzazione di lettura per importare dagli oggetti Cloud Storage forniti.
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 il valore è impostato su true, l'eliminazione dell'istanza non riuscirà.
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 delle istanze creati e registrati dai clienti possono essere eliminati in modo asincrono. ovvero, un endpoint di istanza può essere annullato prima dell'eliminazione delle regole di forwarding nell'endpoint di 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 di 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 presume che il backup si trovi in memorystore.googleapis.com.

Stato

I possibili stati dell'istanza.

Enum
STATE_UNSPECIFIED Non impostato.
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 impostato.
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 impostato.
TRANSIT_ENCRYPTION_DISABLED La crittografia in transito è disabilitata.
SERVER_AUTHENTICATION La crittografia gestita dal server viene utilizzata per la crittografia in transito.

DiscoveryEndpoint

Rappresenta un endpoint a cui i client possono connettersi 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_name}.

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

PersistenceMode

Modalità di persistenza possibili.

Enum
PERSISTENCE_MODE_UNSPECIFIED Non impostato.
DISABLED La persistenza è 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'orario attuale.

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 impostato.
ONE_HOUR Un'ora.
SIX_HOURS Sei ore.
TWELVE_HOURS 12 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

Modalità fsync possibili.

Enum
APPEND_FSYNC_UNSPECIFIED Non impostato. Valore predefinito: EVERY_SEC
NEVER Mai fsync. Normalmente Linux scarica i dati ogni 30 secondi con questa configurazione, ma dipende dalla messa a punto esatta del kernel.
EVERY_SEC Sincronizzazione ogni secondo. Potresti perdere un secondo di dati in caso di disastro.
ALWAYS Fsync ogni volta che vengono aggiunti nuovi comandi di scrittura al file 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 delle zone per l'allocazione delle risorse delle istanze.

Rappresentazione JSON 
{
  "zone": string,
  "zones": [
    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.
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 in modo casuale 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,
  "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 connessa al collegamento del 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. L'ID progetto 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 e se è 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/lettore 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 a primary.
CONNECTION_TYPE_READER Connessione che verrà utilizzata come endpoint del lettore per accedere alle repliche.

PscAttachmentDetail

Configurazione di un collegamento del 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 PscConnection creata autonomamente deve utilizzare come target.
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 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 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à di servizio (connessione automatica) durante la creazione del cluster oppure può essere creata dai clienti stessi (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à di servizio.
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 connessa al collegamento del 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. 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_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 e se è 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/lettore o di rilevamento.
Fine dei campi che si escludono a vicenda.

Modalità

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

Enum
MODE_UNSPECIFIED La modalità non è specificata.
STANDALONE

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

MaintenancePolicy

Policy di manutenzione per istanza.

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

string (Timestamp format)

Solo output. 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. 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 coperte da questa policy. Minimo 1. Per la versione attuale, il numero massimo di weekly_window previsto è uno.

WeeklyMaintenanceWindow

Finestra temporale specificata per le operazioni settimanali.

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

enum (DayOfWeek)

Facoltativo. Consente di definire una pianificazione da eseguire in un giorno specifico della settimana.
startTime

object (TimeOfDay)

Facoltativo. Ora di inizio della finestra in UTC.

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 primaria utilizzata come origine di 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 output di tutte le istanze membro che partecipano alla replica tra istanze. Questa visualizzazione 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 vengono replicate. 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 es. interruzione regionale), è 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. È un'istanza indipendente e non viene replicata da o verso altre istanze.
PRIMARY Un'istanza che consente sia operazioni di lettura che di scrittura. Tutti i dati scritti in questa istanza vengono replicati anche nelle istanze secondarie collegate.
SECONDARY Un'istanza che consente solo letture e replica i 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 output 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 primaria 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 a una frequenza fissa.
Fine dei campi che si escludono a vicenda.

FixedFrequencySchedule

Questa pianificazione consente di attivare il backup a una frequenza fissa (attualmente è supportato solo il backup giornaliero).

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

object (TimeOfDay)

Obbligatorio. L'ora di inizio di ogni backup automatico in formato UTC. Deve essere impostata all'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 backup automatico abilitata.

ServerCaMode

La modalità CA server per l'istanza.

Enum
SERVER_CA_MODE_UNSPECIFIED Modalità CA 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 da CAS.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA

Deprecato: 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 il completamento 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 l'intero 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 l'intero 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 presenta 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 la migrazione dell'istanza non è in corso. L'istanza ha subito 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 vuoi.
ROLLING_BACK Indica che un tentativo di migrazione precedente non è riuscito. Lo stato di alto livello dell'istanza sarà MIGRATING. L'istanza non è pronta per un nuovo tentativo di migrazione. È in corso il rollback per ripristinare lo stato originale dell'istanza. L'istanza rimarrà in questo stato finché il rollback non andrà a buon fine.
REPLICATION_ESTABLISHED L'istanza è in fase di migrazione. L'istanza ha stabilito una replica riuscita ed è pronta per il cutover.
MIGRATED La migrazione dell'istanza è stata eseguita correttamente.

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 revisione della policy ACL applicata.
aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

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

Metodi

addTokenAuthUser

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

backup

 Istanza di backup.

create

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

delete

 Elimina una singola istanza.

finishMigration

 Completa il processo di migrazione.

get

 Recupera i dettagli di una singola istanza.

getCertificateAuthority

 Recupera i dettagli dell'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.