REST Resource: projects.locations.instances

Recurso: instância

Uma instância do Memorystore.

Representação 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
}
Campos
name

string

Identificador. Nome exclusivo da instância. Formato: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Apenas saída. Data/hora de criação da instância.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Data/hora da última atualização da instância.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Opcional. Etiquetas para representar metadados fornecidos pelos utilizadores.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (State)

Apenas saída. Estado atual da instância.
stateInfo

object (StateInfo)

Apenas saída. Informações adicionais sobre o estado da instância.
uid

string

Apenas saída. Identificador exclusivo atribuído pelo sistema para a instância.
authorizationMode

enum (AuthorizationMode)

Opcional. Imutável. Modo de autorização da instância.
transitEncryptionMode

enum (TransitEncryptionMode)

Opcional. Imutável. Modo de encriptação em trânsito da instância.
shardCount

integer

Opcional. Número de fragmentos da instância.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Apenas saída. Descontinuado: em alternativa, use os valores endpoints.connections.psc_auto_connection ou endpoints.connections.psc_connection.
nodeType

enum (NodeType)

Opcional. Tipo de máquina para nós individuais da instância.
persistenceConfig

object (PersistenceConfig)

Opcional. Configuração de persistência da instância.
engineVersion

string

Opcional. Versão do motor da instância.
engineConfigs

map (key: string, value: string)

Opcional. Configurações do motor fornecidas pelo utilizador para a instância.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
nodeConfig

object (NodeConfig)

Apenas saída. Configuração de nós individuais da instância.
zoneDistributionConfig

object (ZoneDistributionConfig)

Opcional. Imutável. Configuração da distribuição de zonas da instância para a atribuição de nós.
pscAutoConnections[]

object (PscAutoConnection)

Opcional. Imutável. Descontinuado: em alternativa, use o valor endpoints.connections.psc_auto_connection.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Apenas saída. Detalhes da associação de serviços para configurar ligações PSC.
endpoints[]

object (InstanceEndpoint)

Opcional. Pontos finais da instância.
mode

enum (Mode)

Opcional. A configuração do modo para a instância.
maintenancePolicy

object (MaintenancePolicy)

Opcional. A política de manutenção da instância. Se não for indicado, o evento de manutenção é realizado com base no cronograma de implementação interno do Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Apenas saída. Agendamento de manutenção publicado.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Opcional. A configuração para a replicação entre instâncias.
encryptionInfo

object (EncryptionInfo)

Apenas saída. Informações de encriptação dos dados em repouso do cluster.
automatedBackupConfig

object (AutomatedBackupConfig)

Opcional. A configuração de cópia de segurança automática para a instância.
allowFewerZonesDeployment

boolean

Opcional. Imutável. Permite que os clientes especifiquem se aceitam implementar uma instância de várias zonas em menos de 3 zonas. Depois de definida, se ocorrer uma indisponibilidade zonal durante a criação da instância, a instância só é implementada em 2 zonas e permanece nas 2 zonas durante o respetivo ciclo de vida.
Campo de união import_sources. A origem a partir da qual importar. import_sources só pode ser uma das seguintes opções:
gcsSource

object (GcsBackupSource)

Opcional. Imutável. Cópias de segurança armazenadas em contentores do Cloud Storage. Os contentores do Cloud Storage têm de estar na mesma região que as instâncias. É necessária autorização de leitura para importar a partir dos objetos do Cloud Storage fornecidos.
managedBackupSource

object (ManagedBackupSource)

Opcional. Imutável. Cópias de segurança geradas e geridas pelo serviço Memorystore.
replicaCount

integer

Opcional. Número de nós de réplica por fragmento. Se for omitido, a predefinição é 0 réplicas.
deletionProtectionEnabled

boolean

Opcional. Se estiver definida como verdadeira, a eliminação da instância falha.
simulateMaintenanceEvent

boolean

Opcional. Apenas entrada. Simule um evento de manutenção.
ondemandMaintenance
(deprecated)

boolean

Opcional. Apenas entrada. Manutenção a pedido da instância.
asyncInstanceEndpointsDeletionEnabled

boolean

Opcional. Se o valor for verdadeiro, os pontos finais de instâncias criados e registados pelos clientes podem ser eliminados de forma assíncrona. Ou seja, esse ponto final da instância pode ser anulado antes de as regras de encaminhamento no ponto final da instância serem eliminadas.
kmsKey

string

Opcional. A chave do KMS usada para encriptar os dados em repouso do cluster.
backupCollection

string

Apenas saída. O nome de recurso completo da coleção de cópias de segurança. Exemplo: projects/{project}/locations/{location}/backupCollections/{collection}

GcsBackupSource

Cópias de segurança armazenadas em contentores do Cloud Storage. Os contentores do Cloud Storage têm de estar na mesma região que as instâncias.

Representação JSON 
{
  "uris": [
    string
  ]
}
Campos
uris[]

string

Opcional. Exemplo: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Cópias de segurança geradas e geridas pelo memorystore.

Representação JSON 
{
  "backup": string
}
Campos
backup

string

Opcional. Exemplo: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} Também é suportada uma versão mais curta (sem o prefixo) do nome da cópia de segurança, como projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId}. Neste caso, assume-se que a cópia de segurança está em memorystore.googleapis.com.

Estado

Estados possíveis da instância.

Enumerações
STATE_UNSPECIFIED Não definido.
CREATING A instância está a ser criada.
ACTIVE A instância foi criada e está utilizável.
UPDATING A instância está a ser atualizada.
DELETING A instância está a ser eliminada.

StateInfo

Informações adicionais sobre o estado da instância.

Representação JSON 
{

  // Union field info can be only one of the following:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of list of possible types for union field info.
}
Campos

Campo de união info.

info só pode ser uma das seguintes opções:
updateInfo

object (UpdateInfo)

Apenas saída. Descreve a atualização em curso quando o estado da instância é UPDATING.

UpdateInfo

Representa informações sobre a instância com o estado UPDATING.

Representação JSON 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
Campos
targetShardCount

integer

Apenas saída. Número de fragmentos de destino para a instância.
targetReplicaCount

integer

Apenas saída. Número de nós de réplica de destino por fragmento para a instância.
targetEngineVersion

string

Apenas saída. Versão do motor de destino para a instância.
targetNodeType

enum (NodeType)

Apenas saída. Tipo de nó de destino para a instância.

AuthorizationMode

Modos de autorização possíveis da instância.

Enumerações
AUTHORIZATION_MODE_UNSPECIFIED Não definido.
AUTH_DISABLED Autorização desativada.
IAM_AUTH Autorização básica de IAM.

TransitEncryptionMode

Modos de encriptação em trânsito possíveis da instância.

Enumerações
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Não definido.
TRANSIT_ENCRYPTION_DISABLED A encriptação em trânsito está desativada.
SERVER_AUTHENTICATION A encriptação gerida pelo servidor é usada para a encriptação em trânsito.

DiscoveryEndpoint

Representa um ponto final para os clientes se ligarem à instância.

Representação JSON 
{
  "address": string,
  "port": integer,
  "network": string
}
Campos
address

string

Apenas saída. Endereço IP ao qual os clientes do ponto final exposto se ligam.
port

integer

Apenas saída. O número da porta do ponto final exposto.
network

string

Apenas saída. A rede onde o endereço IP do ponto final de deteção vai ser reservado, no formato projects/{networkProject}/global/networks/{network_id}.

PersistenceConfig

Representa a configuração de persistência de uma instância.

Representação JSON 
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Campos
mode

enum (PersistenceMode)

Opcional. Modo de persistência atual.
rdbConfig

object (RDBConfig)

Opcional. Configuração da RDB. Este campo é ignorado se o modo não for RDB.
aofConfig

object (AOFConfig)

Opcional. Configuração do AOF. Este campo é ignorado se o modo não for AOF.

PersistenceMode

Modos de persistência possíveis.

Enumerações
PERSISTENCE_MODE_UNSPECIFIED Não definido.
DISABLED A persistência está desativada e todos os dados de instantâneos são eliminados.
RDB A persistência baseada em RDB está ativada.
AOF A persistência baseada em AOF está ativada.

RDBConfig

Configuração para persistência baseada em RDB.

Representação JSON 
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Campos
rdbSnapshotPeriod

enum (SnapshotPeriod)

Opcional. Período entre instantâneos RDB.
rdbSnapshotStartTime

string (Timestamp format)

Opcional. Hora em que foi/vai ser tentado o primeiro instantâneo e à qual os instantâneos futuros vão ser alinhados. Se não for indicado, é usada a hora atual.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

SnapshotPeriod

Possíveis períodos de instantâneos.

Enumerações
SNAPSHOT_PERIOD_UNSPECIFIED Não definido.
ONE_HOUR Uma hora.
SIX_HOURS Seis horas.
TWELVE_HOURS Doze horas.
TWENTY_FOUR_HOURS Vinte e quatro horas.

AOFConfig

Configuração para persistência baseada em AOF.

Representação JSON 
{
  "appendFsync": enum (AppendFsync)
}
Campos
appendFsync

enum (AppendFsync)

Opcional. O modo fsync.

AppendFsync

Modos fsync possíveis.

Enumerações
APPEND_FSYNC_UNSPECIFIED Não definido. Predefinição: EVERY_SEC
NEVER Nunca fsync. Normalmente, o Linux elimina os dados a cada 30 segundos com esta configuração, mas depende da otimização exata do kernel.
EVERY_SEC Fsync a cada segundo. Pode perder 1 segundo de dados se ocorrer um desastre.
ALWAYS Fsync sempre que novos comandos de escrita são anexados ao AOF. A melhor proteção contra perda de dados ao custo do desempenho.

NodeConfig

Representa a configuração dos nós da instância.

Representação JSON 
{
  "sizeGb": number
}
Campos
sizeGb

number

Apenas saída. Tamanho da memória em GB do nó.

ZoneDistributionConfig

Configuração da distribuição de zonas para a atribuição de recursos de instâncias.

Representação JSON 
{
  "zone": string,
  "mode": enum (ZoneDistributionMode)
}
Campos
zone

string

Opcional. Define a zona onde todos os recursos vão ser atribuídos com o modo SINGLE_ZONE. Ignorado para o modo MULTI_ZONE.
mode

enum (ZoneDistributionMode)

Opcional. Modo de distribuição de zonas atual. A predefinição é MULTI_ZONE.

ZoneDistributionMode

Modos de distribuição de zonas possíveis.

Enumerações
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Não definido. Predefinição: MULTI_ZONE
MULTI_ZONE Distribuir recursos por 3 zonas escolhidas aleatoriamente na região.
SINGLE_ZONE Aprovisionar recursos numa única zona. O campo de zona tem de ser especificado.

PscAutoConnection

Detalhes dos recursos do consumidor numa ligação PSC.

Representação 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.
}
Campos
pscConnectionId

string

Apenas saída. O ID da ligação do PSC da regra de encaminhamento ligada à associação do serviço.
ipAddress

string

Apenas saída. O IP atribuído na rede do consumidor para a regra de encaminhamento do PSC.
forwardingRule

string

Apenas saída. O URI da regra de encaminhamento do lado do consumidor. Formato: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Obrigatório. O projectId do consumidor onde as ligações PSC são estabelecidas. Este deve ser o mesmo projectId no qual a instância está a ser criada.
network

string

Obrigatório. A rede onde os pontos finais do PSC são criados, no formato projects/{projectId}/global/networks/{network_id}.
serviceAttachment

string

Apenas saída. A associação de serviço que é o destino da ligação do PSC, no formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Apenas saída. O estado da associação do PSC: se existe uma associação e está ATIVA ou se já não existe. Tenha em atenção que este valor é atualizado periodicamente. Use as APIs Private Service Connect para conhecer o estado mais recente.
connectionType

enum (ConnectionType)

Apenas saída. Tipo de ligação PSC.
Campo de união ports. Portas do ponto final exposto. ports só pode ser uma das seguintes opções:
port

integer

Opcional. A porta só é definida para o ponto final principal/de leitura ou de descoberta.

PscConnectionStatus

Estado da associação da PSC.

Enumerações
PSC_CONNECTION_STATUS_UNSPECIFIED O estado da associação do PSC não está especificado.
ACTIVE A associação está ativa
NOT_FOUND Ligação não encontrada

ConnectionType

Tipo de ligação PSC

Enumerações
CONNECTION_TYPE_UNSPECIFIED O tipo de ligação não está definido
CONNECTION_TYPE_DISCOVERY Ligação que vai ser usada para a descoberta da topologia.
CONNECTION_TYPE_PRIMARY Ligação que vai ser usada como ponto final principal para aceder ao principal.
CONNECTION_TYPE_READER Ligação que vai ser usada como ponto final do leitor para aceder a réplicas.

PscAttachmentDetail

Configuração de uma associação de serviço do cluster para criar ligações PSC.

Representação JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Campos
serviceAttachment

string

Apenas saída. URI do anexo de serviço que a PscConnection criada por si deve usar como destino.
connectionType

enum (ConnectionType)

Apenas saída. Tipo de ponto final do PSC.

InstanceEndpoint

O InstanceEndpoint consiste em ligações PSC criadas como um grupo em cada rede VPC para aceder à instância. Em cada grupo, deve existir uma ligação para cada anexo de serviço no cluster.

Representação JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Campos
connections[]

object (ConnectionDetail)

Opcional. Um grupo de ligações do PSC. São criadas na mesma rede VPC, uma para cada associação de serviço no cluster.

ConnectionDetail

Informações de cada ligação PSC.

Representação 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.
}
Campos
Campo de união connection. Uma ligação PSC a uma instância pode ser criada através da automatização da conetividade de serviços (ligação automática) durante a criação do cluster ou pode ser criada pelos próprios clientes (ligação criada pelo utilizador). connection só pode ser uma das seguintes opções:
pscAutoConnection

object (PscAutoConnection)

Imutável. Informações detalhadas de uma ligação PSC criada através da automatização da conetividade de serviços.
pscConnection

object (PscConnection)

Informações detalhadas de uma associação de PSC criada pelo utilizador.

PscConnection

Configuração de ligação do PSC criada pelo utilizador.

Representação 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.
}
Campos
pscConnectionId

string

Obrigatório. O ID da ligação do PSC da regra de encaminhamento ligada à associação do serviço.
ipAddress

string

Obrigatório. O IP atribuído na rede do consumidor para a regra de encaminhamento do PSC.
forwardingRule

string

Obrigatório. O URI da regra de encaminhamento do lado do consumidor. Formato: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

Apenas saída. O projectId do consumidor a partir do qual a regra de encaminhamento é criada.
network

string

Obrigatório. A rede do consumidor onde o endereço IP reside, no formato projects/{projectId}/global/networks/{network_id}.
serviceAttachment

string

Obrigatório. A associação de serviço que é o destino da ligação do PSC, no formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Apenas saída. O estado da associação do PSC: se existe uma associação e está ATIVA ou se já não existe. Tenha em atenção que este valor é atualizado periodicamente. Use as APIs Private Service Connect para conhecer o estado mais recente.
connectionType

enum (ConnectionType)

Apenas saída. Tipo de ligação PSC.
Campo de união ports. Portas do ponto final exposto. ports só pode ser uma das seguintes opções:
port

integer

Opcional. A porta só é definida para o ponto final principal/de leitura ou de descoberta.

Modo

A configuração do modo, que é usada para ativar/desativar o modo de cluster.

Enumerações
MODE_UNSPECIFIED O modo não está especificado.
STANDALONE

Descontinuado: use CLUSTER_DISABLED em alternativa.
CLUSTER A instância está no modo de cluster.
CLUSTER_DISABLED O modo de cluster está desativado para a instância.

MaintenancePolicy

Política de manutenção por instância.

Representação JSON 
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
Campos
createTime

string (Timestamp format)

Apenas saída. A hora em que a política foi criada.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. A hora em que a política foi atualizada.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Opcional. Janela de manutenção que é aplicada aos recursos abrangidos por esta política. Mínimo de 1. Para a versão atual, o número máximo de weekly_window esperado é um.

WeeklyMaintenanceWindow

Período especificado para as operações semanais.

Representação JSON 
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
day

enum (DayOfWeek)

Opcional. Permite definir uma programação que é executada num dia especificado da semana.
startTime

object (TimeOfDay)

Opcional. Hora de início do período em UTC.

MaintenanceSchedule

Agendamento de manutenção futura.

Representação JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Apenas saída. A hora de início de qualquer manutenção agendada futura para esta instância.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Apenas saída. A hora de fim de qualquer manutenção agendada futura para esta instância.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

Configuração de replicação entre instâncias.

Representação JSON 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campos
instanceRole

enum (InstanceRole)

Obrigatório. A função da instância na replicação entre instâncias.
primaryInstance

object (RemoteInstance)

Opcional. Detalhes da instância principal que é usada como origem de replicação para esta instância secundária.

Este campo só é definido para uma instância secundária.
secondaryInstances[]

object (RemoteInstance)

Opcional. Lista de instâncias secundárias que estão a ser replicadas a partir desta instância principal.

Este campo só é definido para uma instância principal.
updateTime

string (Timestamp format)

Apenas saída. A última vez que a configuração da replicação entre instâncias foi atualizada.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
membership

object (Membership)

Apenas saída. Uma vista apenas de saída de todas as instâncias de membros que participam na replicação entre instâncias. Esta vista é fornecida por todas as instâncias de membros, independentemente da respetiva função de instância(principal ou secundária).

Uma instância principal pode fornecer informações sobre todas as instâncias secundárias que estão a ser replicadas a partir dela. No entanto, uma instância secundária só tem conhecimento da instância principal a partir da qual está a ser replicada. No entanto, para cenários em que a instância principal não está disponível(por exemplo, uma indisponibilidade regional), é possível enviar um pedido Getinstance a qualquer outra instância membro, e este campo apresenta todas as instâncias membro que participam na replicação entre instâncias.

InstanceRole

A função da instância na replicação entre instâncias.

Enumerações
INSTANCE_ROLE_UNSPECIFIED A função da instância não está definida. O comportamento é equivalente a NONE.
NONE Esta instância não participa na replicação entre instâncias. É uma instância independente e não é replicada para nem a partir de outras instâncias.
PRIMARY Uma instância que permite leituras e escritas. Todos os dados escritos nesta instância também são replicados para as instâncias secundárias anexadas.
SECONDARY Uma instância que só permite leituras e replica dados de uma instância principal.

RemoteInstance

Detalhes da instância remota associada a esta instância numa configuração de replicação entre instâncias.

Representação JSON 
{
  "instance": string,
  "uid": string
}
Campos
instance

string

Opcional. O caminho completo do recurso da instância remota no formato: projects//locations//instances/
uid

string

Apenas saída. O identificador exclusivo da instância remota.

Subscrição

Uma vista apenas de saída de todas as instâncias de membros que participam na replicação entre instâncias.

Representação JSON 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Campos
primaryInstance

object (RemoteInstance)

Apenas saída. A instância principal que funciona como a origem da replicação para as instâncias secundárias.
secondaryInstances[]

object (RemoteInstance)

Apenas saída. A lista de instâncias secundárias que estão a ser replicadas a partir da instância principal.

AutomatedBackupConfig

A configuração da cópia de segurança automática para uma instância.

Representação 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.
}
Campos
automatedBackupMode

enum (AutomatedBackupMode)

Opcional. O modo de cópia de segurança automática. Se o modo estiver desativado, os outros campos são ignorados.
retention

string (Duration format)

Opcional. Durante quanto tempo manter as cópias de segurança automáticas antes de serem eliminadas. O valor deve estar entre 1 dia e 365 dias. Se não for especificado, o valor predefinido é 35 dias.

Uma duração em segundos com até nove dígitos fracionários, que termina com "s". Exemplo: "3.5s".
Campo de união schedule. O agendamento das cópias de segurança automáticas. schedule só pode ser uma das seguintes opções:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Opcional. Acionar cópias de segurança automáticas com uma frequência fixa.

FixedFrequencySchedule

Esta programação permite que a cópia de segurança seja acionada com uma frequência fixa (atualmente, apenas é suportada a frequência diária).

Representação JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
startTime

object (TimeOfDay)

Obrigatório. A hora de início de cada cópia de segurança automática em UTC. Tem de ser definida para o início de uma hora. Este campo é obrigatório.

AutomatedBackupMode

O modo de cópia de segurança automática.

Enumerações
AUTOMATED_BACKUP_MODE_UNSPECIFIED Valor predefinido. A configuração de cópia de segurança automática não está especificada.
DISABLED Configuração da cópia de segurança automática desativada.
ENABLED Configuração da cópia de segurança automática ativada.

Métodos

backup

 Cópia de segurança da instância.

create

 Cria uma nova instância num determinado projeto e localização.

delete

 Elimina uma única instância.

get

 Recebe detalhes de uma única instância.

getCertificateAuthority

 Obtém detalhes sobre a autoridade de certificação de uma instância.

list

 Apresenta as instâncias num determinado projeto e localização.

patch

 Atualiza os parâmetros de uma única instância.

rescheduleMaintenance

 Reagenda o evento de manutenção futuro.