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)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "allowFewerZonesDeployment": boolean,

  // Union field import_sources can be only one of the following:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of list of possible types for union field import_sources.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string
}
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 normalizzato in base al fuso orario UTC 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 normalizzato in base al fuso orario UTC 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 dagli utenti.

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

object (DiscoveryEndpoint)

Solo output. Deprecato: utilizza invece i valori endpoints.connections.psc_auto_connection o endpoints.connections.psc_connection.

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[]

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. La configurazione della modalità per l'istanza.

maintenancePolicy

object (MaintenancePolicy)

Facoltativo. I criteri di manutenzione per l'istanza. Se non viene fornito, l'evento di manutenzione verrà eseguito in base alla pianificazione interna dell'implementazione 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.

allowFewerZonesDeployment

boolean

Facoltativo. Immutabile. Consente ai clienti di specificare se accettano di eseguire il deployment di un'istanza multizona in meno di 3 zone. Una volta impostata, se si verifica un'interruzione zonale durante la creazione dell'istanza, questa verrà implementata solo in due zone e rimarrà all'interno delle due zone per il suo ciclo di vita.

Campo unione import_sources. L'origine da cui importare. import_sources può essere solo uno dei seguenti:
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 di lettura.

managedBackupSource

object (ManagedBackupSource)

Facoltativo. Immutabile. Backup generati e gestiti dal servizio Memorystore.

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 riuscirà.

simulateMaintenanceEvent

boolean

Facoltativo. Solo input. Simula un evento di manutenzione.

ondemandMaintenance
(deprecated)

boolean

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

asyncInstanceEndpointsDeletionEnabled

boolean

Facoltativo. Se impostato su true, gli endpoint delle istanze creati e registrati dai clienti possono essere eliminati in modo asincrono. ovvero, la registrazione di un endpoint di istanza può essere annullata 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}

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

Gli 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

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,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
Campi
targetShardCount

integer

Solo output. Numero di shard di destinazione 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.

TransitEncryptionMode

Possibili modalità di crittografia in transito dell'istanza.

Enum
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Non impostato.
TRANSIT_ENCRYPTION_DISABLED La crittografia in transito è disattivata.
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. L'indirizzo IP a cui si connettono i client dell'endpoint esposto.

port

integer

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

network

string

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

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

Possibili modalità di persistenza.

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 normalizzato in base al fuso orario UTC 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 24 ore.

AOFConfig

Configurazione per la persistenza basata su AOF.

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

enum (AppendFsync)

Facoltativo. Modalità fsync.

AppendFsync

Modalità fsync possibili.

Enum
APPEND_FSYNC_UNSPECIFIED Non impostato. Valore predefinito: EVERY_SEC
NEVER Non eseguire mai fsync. Normalmente Linux scarica i dati ogni 30 secondi con questa configurazione, ma dipende dalla messa a punto esatta del kernel.
EVERY_SEC Sincronizza ogni secondo. Potresti perdere 1 secondo di dati in caso di disastro.
ALWAYS Sincronizza 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 dell'istanza.

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

string

Facoltativo. Definisce la zona in cui verranno allocate tutte le risorse con la modalità SINGLE_ZONE. 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. 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),

  // 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 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_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 ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Per lo stato più recente, utilizza le API Private Service Connect.

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. La porta verrà impostata solo per l'endpoint Primary/Reader o Discovery.

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 primario.
CONNECTION_TYPE_READER Connessione che verrà utilizzata come endpoint di lettura 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. L'URI del collegamento al servizio che la connessione 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 esserci 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 del 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 dai clienti stessi (connessione creata dall'utente). connection può essere solo uno dei seguenti:
pscAutoConnection

object (PscAutoConnection)

Immutabile. Informazioni dettagliate su una connessione PSC creata tramite l'automazione della connettività di servizio.

pscConnection

object (PscConnection)

Informazioni dettagliate di 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),

  // 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

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_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 ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Per lo stato più recente, utilizza le API Private Service Connect.

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. La porta verrà impostata solo per l'endpoint Primary/Reader o Discovery.

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 è disattivata 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 è stato creato il criterio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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 è stato aggiornato il criterio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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. Finestra di manutenzione applicata 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 che viene eseguita in un giorno specifico della settimana.

startTime

object (TimeOfDay)

Facoltativo. L'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 normalizzato in base al fuso orario UTC 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 normalizzato in base al fuso orario UTC 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 vengono replicate da questa istanza principale.

Questo campo viene 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 normalizzato in base al fuso orario UTC 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 suo ruolo di 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 le letture che le scritture. 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 principale che funge da origine della replica per le istanze secondarie.

secondaryInstances[]

object (RemoteInstance)

Solo output. L'elenco delle istanze secondarie replicate dall'istanza principale.

AutomatedBackupConfig

La configurazione del backup automatico per un'istanza.

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

  // Union field schedule can be only one of the following:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of list of possible types for union field schedule.
}
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 è specificato, il valore predefinito è 35 giorni.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

Campo unione schedule. La pianificazione dei backup automatici. schedule può essere solo uno dei seguenti:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Facoltativo. Attiva i backup automatici a una frequenza fissa.

FixedFrequencySchedule

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

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

object (TimeOfDay)

Obbligatorio. L'ora di inizio di ogni backup automatico in 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 del backup automatico abilitata.

Metodi

backup

Istanza di backup.

create

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

delete

Elimina 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 in una determinata località.

patch

Aggiorna i parametri di una singola istanza.

rescheduleMaintenance

Ripianifica l'evento di manutenzione imminente.