REST Resource: projects.locations.instances

Ressource : Instance

Instance Memorystore.

Représentation 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
}
Champs
name

string

Identifiant. Nom unique de l'instance. Format : projects/{project}/locations/{location}/instances/{instance}

createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de création de l'instance.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de l'instance.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "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)

Facultatif. Libellés permettant de représenter les métadonnées fournies par l'utilisateur.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

state

enum (State)

Uniquement en sortie. État actuel de l'instance.

stateInfo

object (StateInfo)

Uniquement en sortie. Informations supplémentaires sur l'état de l'instance.

uid

string

Uniquement en sortie. Identifiant unique attribué par le système pour l'instance.

authorizationMode

enum (AuthorizationMode)

Facultatif. Immuable. Mode d'autorisation de l'instance.

transitEncryptionMode

enum (TransitEncryptionMode)

Facultatif. Immuable. Mode de chiffrement en transit de l'instance.

shardCount

integer

Facultatif. Nombre de segments pour l'instance.

discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Uniquement en sortie. Obsolète : utilisez plutôt les valeurs endpoints.connections.psc_auto_connection ou endpoints.connections.psc_connection.

nodeType

enum (NodeType)

Facultatif. Type de machine pour les nœuds individuels de l'instance.

persistenceConfig

object (PersistenceConfig)

Facultatif. Configuration de la persistance de l'instance.

engineVersion

string

Facultatif. Version du moteur de l'instance.

engineConfigs

map (key: string, value: string)

Facultatif. Configurations du moteur fournies par l'utilisateur pour l'instance.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodeConfig

object (NodeConfig)

Uniquement en sortie. Configuration des nœuds individuels de l'instance.

zoneDistributionConfig

object (ZoneDistributionConfig)

Facultatif. Immuable. Configuration de la distribution des zones de l'instance pour l'allocation des nœuds.

pscAutoConnections[]

object (PscAutoConnection)

Facultatif. Immuable. Obsolète : utilisez plutôt la valeur endpoints.connections.psc_auto_connection.

pscAttachmentDetails[]

object (PscAttachmentDetail)

Uniquement en sortie. Détails du rattachement de service pour configurer les connexions PSC.

endpoints[]

object (InstanceEndpoint)

Facultatif. Points de terminaison pour l'instance.

mode

enum (Mode)

Facultatif. Configuration du mode pour l'instance.

maintenancePolicy

object (MaintenancePolicy)

Facultatif. Stratégie de maintenance de l'instance. Si aucune valeur n'est fournie, l'événement de maintenance sera effectué en fonction du calendrier de déploiement interne de Memorystore.

maintenanceSchedule

object (MaintenanceSchedule)

Uniquement en sortie. Calendrier de maintenance publié.

crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Facultatif. Configuration de la réplication entre instances.

encryptionInfo

object (EncryptionInfo)

Uniquement en sortie. Informations sur le chiffrement des données au repos du cluster.

automatedBackupConfig

object (AutomatedBackupConfig)

Facultatif. Configuration de sauvegarde automatique pour l'instance.

allowFewerZonesDeployment

boolean

Facultatif. Immuable. Permet aux clients d'indiquer s'ils acceptent de déployer une instance multizone dans moins de trois zones. Une fois la zone définie, si une panne zonale se produit lors de la création de l'instance, celle-ci ne sera déployée que dans deux zones et y restera pendant toute sa durée de vie.

Champ d'union import_sources. Source à partir de laquelle importer les données. import_sources ne peut être qu'un des éléments suivants :
gcsSource

object (GcsBackupSource)

Facultatif. Immuable. Sauvegardes stockées dans des buckets Cloud Storage. Les buckets Cloud Storage doivent se trouver dans la même région que les instances. L'autorisation de lecture est requise pour importer des objets Cloud Storage fournis.

managedBackupSource

object (ManagedBackupSource)

Facultatif. Immuable. Sauvegardes générées et gérées par le service Memorystore.

replicaCount

integer

Facultatif. Nombre de nœuds d'instances répliquées par segment. Si aucune valeur n'est spécifiée, la valeur par défaut est de zéro réplica.

deletionProtectionEnabled

boolean

Facultatif. Si la valeur est "true", la suppression de l'instance échoue.

simulateMaintenanceEvent

boolean

Facultatif. Uniquement en entrée. Simulez un événement de maintenance.

ondemandMaintenance
(deprecated)

boolean

Facultatif. Uniquement en entrée. Maintenance à la demande pour l'instance.

asyncInstanceEndpointsDeletionEnabled

boolean

Facultatif. Si la valeur est "true", les points de terminaison d'instance créés et enregistrés par les clients peuvent être supprimés de manière asynchrone. Autrement dit, un tel point de terminaison d'instance peut être désenregistré avant la suppression des règles de transfert dans le point de terminaison d'instance.

kmsKey

string

Facultatif. Clé KMS utilisée pour chiffrer les données au repos du cluster.

backupCollection

string

Uniquement en sortie. Nom complet de la ressource de la collection de sauvegardes. Exemple : projects/{project}/locations/{location}/backupCollections/{collection}

GcsBackupSource

Sauvegardes stockées dans des buckets Cloud Storage. Les buckets Cloud Storage doivent se trouver dans la même région que les instances.

Représentation JSON
{
  "uris": [
    string
  ]
}
Champs
uris[]

string

Facultatif. Exemple : gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Sauvegardes générées et gérées par Memorystore.

Représentation JSON
{
  "backup": string
}
Champs
backup

string

Facultatif. Exemple : //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} Une version plus courte (sans le préfixe) du nom de la sauvegarde est également acceptée, comme projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId}. Dans ce cas, la sauvegarde est supposée se trouver sous memorystore.googleapis.com.

État

États possibles de l'instance.

Énumérations
STATE_UNSPECIFIED Non défini.
CREATING Création de l'instance…
ACTIVE L'instance a été créée et est utilisable.
UPDATING Mise à jour de l'instance…
DELETING Suppression de l'instance…

StateInfo

Informations supplémentaires sur l'état de l'instance.

Représentation JSON
{

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

Champ d'union info.

info ne peut être qu'un des éléments suivants :

updateInfo

object (UpdateInfo)

Uniquement en sortie. Décrit la mise à jour en cours lorsque l'état de l'instance est "EN COURS DE MISE À JOUR".

UpdateInfo

Représente des informations sur une instance dont l'état est "EN COURS DE MISE À JOUR".

Représentation JSON
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetEngineVersion": string,
  "targetNodeType": enum (NodeType)
}
Champs
targetShardCount

integer

Uniquement en sortie. Nombre cible de segments pour l'instance.

targetReplicaCount

integer

Uniquement en sortie. Nombre cible de nœuds d'instances répliquées par segment pour l'instance.

targetEngineVersion

string

Uniquement en sortie. Version du moteur cible pour l'instance.

targetNodeType

enum (NodeType)

Uniquement en sortie. Type de nœud cible pour l'instance.

AuthorizationMode

Modes d'autorisation possibles de l'instance.

Énumérations
AUTHORIZATION_MODE_UNSPECIFIED Non défini.
AUTH_DISABLED L'autorisation est désactivée.
IAM_AUTH Autorisation de base IAM.

TransitEncryptionMode

Modes de chiffrement en transit possibles pour l'instance.

Énumérations
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Non défini.
TRANSIT_ENCRYPTION_DISABLED Le chiffrement en transit est désactivé.
SERVER_AUTHENTICATION Le chiffrement géré par le serveur est utilisé pour le chiffrement en transit.

DiscoveryEndpoint

Représente un point de terminaison permettant aux clients de se connecter à l'instance.

Représentation JSON
{
  "address": string,
  "port": integer,
  "network": string
}
Champs
address

string

Uniquement en sortie. Adresse IP du point de terminaison exposé auquel les clients se connectent.

port

integer

Uniquement en sortie. Numéro de port du point de terminaison exposé.

network

string

Uniquement en sortie. Réseau dans lequel l'adresse IP du point de terminaison de découverte sera réservée, au format projects/{networkProject}/global/networks/{network_id}.

PersistenceConfig

Représente la configuration de la persistance pour une instance.

Représentation JSON
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Champs
mode

enum (PersistenceMode)

Facultatif. Mode persistance actuel.

rdbConfig

object (RDBConfig)

Facultatif. Configuration RDB. Ce champ sera ignoré si le mode n'est pas RDB.

aofConfig

object (AOFConfig)

Facultatif. Configuration AOF. Ce champ sera ignoré si le mode n'est pas AOF.

PersistenceMode

Modes de persistance possibles.

Énumérations
PERSISTENCE_MODE_UNSPECIFIED Non défini.
DISABLED La persistance est désactivée et toutes les données d'instantané sont supprimées.
RDB La persistance basée sur RDB est activée.
AOF La persistance basée sur AOF est activée.

RDBConfig

Configuration pour la persistance basée sur RDB.

Représentation JSON
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Champs
rdbSnapshotPeriod

enum (SnapshotPeriod)

Facultatif. Période entre les instantanés RDB.

rdbSnapshotStartTime

string (Timestamp format)

Facultatif. Heure à laquelle le premier instantané a été/sera tenté, et à laquelle les futurs instantanés seront alignés. Si elle n'est pas fournie, l'heure actuelle est utilisée.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

SnapshotPeriod

Périodes d'instantané possibles.

Énumérations
SNAPSHOT_PERIOD_UNSPECIFIED Non défini.
ONE_HOUR Une heure.
SIX_HOURS Six heures.
TWELVE_HOURS Douze heures.
TWENTY_FOUR_HOURS Vingt-quatre heures.

AOFConfig

Configuration pour la persistance basée sur AOF.

Représentation JSON
{
  "appendFsync": enum (AppendFsync)
}
Champs
appendFsync

enum (AppendFsync)

Facultatif. Mode fsync.

AppendFsync

Modes fsync possibles.

Énumérations
APPEND_FSYNC_UNSPECIFIED Non défini. Valeur par défaut : EVERY_SEC
NEVER Ne jamais effectuer de fsync. Normalement, Linux vide les données toutes les 30 secondes avec cette configuration, mais cela dépend du réglage exact du noyau.
EVERY_SEC Fsync chaque seconde. En cas de sinistre, vous risquez de perdre une seconde de données.
ALWAYS Fsync chaque fois que de nouvelles commandes d'écriture sont ajoutées au fichier AOF. La meilleure protection contre la perte de données, au détriment des performances.

NodeConfig

Représente la configuration des nœuds de l'instance.

Représentation JSON
{
  "sizeGb": number
}
Champs
sizeGb

number

Uniquement en sortie. Taille de la mémoire du nœud en Go.

ZoneDistributionConfig

Configuration de la répartition des zones pour l'allocation des ressources d'instance.

Représentation JSON
{
  "zone": string,
  "mode": enum (ZoneDistributionMode)
}
Champs
zone

string

Facultatif. Définit la zone dans laquelle toutes les ressources seront allouées en mode SINGLE_ZONE. Ignoré pour le mode MULTI_ZONE.

mode

enum (ZoneDistributionMode)

Facultatif. Mode de distribution actuel des zones. La valeur par défaut est MULTI_ZONE.

ZoneDistributionMode

Modes de distribution de zones possibles.

Énumérations
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Non défini. Par défaut : MULTI_ZONE
MULTI_ZONE Répartissez les ressources sur trois zones sélectionnées au hasard dans la région.
SINGLE_ZONE Provisionnez des ressources dans une seule zone. Le champ "Zone" doit être spécifié.

PscAutoConnection

Détails des ressources du consommateur dans une connexion PSC.

Représentation 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.
}
Champs
pscConnectionId

string

Uniquement en sortie. ID de connexion PSC de la règle de transfert associée au rattachement de service.

ipAddress

string

Uniquement en sortie. Adresse IP allouée sur le réseau consommateur pour la règle de transfert PSC.

forwardingRule

string

Uniquement en sortie. URI de la règle de transfert côté consommateur. Format : projects/{project}/regions/{region}/forwardingRules/{forwardingRule}

projectId

string

Obligatoire. ID du projet client dans lequel les connexions PSC sont établies. Il doit s'agir du même projectId que celui dans lequel l'instance est créée.

network

string

Obligatoire. Réseau dans lequel les points de terminaison PSC sont créés, au format projects/{projectId}/global/networks/{network_id}.

serviceAttachment

string

Uniquement en sortie. Rattachement de service qui est la cible de la connexion PSC, au format projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.

pscConnectionStatus

enum (PscConnectionStatus)

Uniquement en sortie. État de la connexion PSC : indique si une connexion existe et est ACTIVE ou si elle n'existe plus. Notez que cette valeur est mise à jour régulièrement. Veuillez utiliser les API Private Service Connect pour connaître l'état le plus récent.

connectionType

enum (ConnectionType)

Uniquement en sortie. Type de connexion PSC.

Champ d'union ports. Ports du point de terminaison exposé. ports ne peut être qu'un des éléments suivants :
port

integer

Facultatif. Le port ne sera défini que pour le point de terminaison principal/lecteur ou de découverte.

PscConnectionStatus

État de la connexion PSC.

Énumérations
PSC_CONNECTION_STATUS_UNSPECIFIED L'état de la connexion PSC n'est pas spécifié.
ACTIVE La connexion est active
NOT_FOUND Connexion introuvable

ConnectionType

Type de connexion PSC

Énumérations
CONNECTION_TYPE_UNSPECIFIED Le type de connexion n'est pas défini
CONNECTION_TYPE_DISCOVERY Connexion qui sera utilisée pour la découverte de la topologie.
CONNECTION_TYPE_PRIMARY Connexion qui sera utilisée comme point de terminaison principal pour accéder à l'instance principale.
CONNECTION_TYPE_READER Connexion qui sera utilisée comme point de terminaison du lecteur pour accéder aux réplicas.

PscAttachmentDetail

Configuration d'un rattachement de service du cluster pour créer des connexions PSC.

Représentation JSON
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Champs
serviceAttachment

string

Uniquement en sortie. URI du rattachement de service que votre PscConnection créé par vous-même doit utiliser comme cible.

connectionType

enum (ConnectionType)

Uniquement en sortie. Type de point de terminaison PSC.

InstanceEndpoint

InstanceEndpoint se compose de connexions PSC créées en tant que groupe dans chaque réseau VPC pour accéder à l'instance. Dans chaque groupe, il doit y avoir une connexion pour chaque rattachement de service du cluster.

Représentation JSON
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Champs
connections[]

object (ConnectionDetail)

Facultatif. Groupe de connexions PSC. Ils sont créés dans le même réseau VPC, un pour chaque rattachement de service du cluster.

ConnectionDetail

Informations sur chaque connexion PSC.

Représentation 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.
}
Champs
Champ d'union connection. Une connexion PSC à une instance peut être créée par le biais de l'automatisation de la connectivité des services (connexion automatique) lors de la création du cluster, ou par le client lui-même (connexion créée par l'utilisateur). connection ne peut être qu'un des éléments suivants :
pscAutoConnection

object (PscAutoConnection)

Immuable. Informations détaillées sur une connexion PSC créée via l'automatisation de la connectivité des services.

pscConnection

object (PscConnection)

Informations détaillées sur une connexion PSC créée par l'utilisateur.

PscConnection

Configuration de connexion Psc créée par l'utilisateur.

Représentation 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.
}
Champs
pscConnectionId

string

Obligatoire. ID de connexion PSC de la règle de transfert associée au rattachement de service.

ipAddress

string

Obligatoire. Adresse IP allouée sur le réseau consommateur pour la règle de transfert PSC.

forwardingRule

string

Obligatoire. URI de la règle de transfert côté consommateur. Format : projects/{project}/regions/{region}/forwardingRules/{forwardingRule}

projectId

string

Uniquement en sortie. ID du projet client à partir duquel la règle de transfert est créée.

network

string

Obligatoire. Réseau consommateur dans lequel réside l'adresse IP, au format projects/{projectId}/global/networks/{network_id}.

serviceAttachment

string

Obligatoire. Rattachement de service qui est la cible de la connexion PSC, au format projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.

pscConnectionStatus

enum (PscConnectionStatus)

Uniquement en sortie. État de la connexion PSC : indique si une connexion existe et est ACTIVE ou si elle n'existe plus. Notez que cette valeur est mise à jour régulièrement. Veuillez utiliser les API Private Service Connect pour connaître l'état le plus récent.

connectionType

enum (ConnectionType)

Uniquement en sortie. Type de connexion PSC.

Champ d'union ports. Ports du point de terminaison exposé. ports ne peut être qu'un des éléments suivants :
port

integer

Facultatif. Le port ne sera défini que pour le point de terminaison principal/lecteur ou de découverte.

Mode

Configuration du mode, utilisée pour activer/désactiver le mode cluster.

Énumérations
MODE_UNSPECIFIED Le mode n'est pas spécifié.
STANDALONE

Obsolète : utilisez CLUSTER_DISABLED à la place.

CLUSTER L'instance est en mode cluster.
CLUSTER_DISABLED Le mode cluster est désactivé pour l'instance.

MaintenancePolicy

Stratégie de maintenance par instance.

Représentation JSON
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
Champs
createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle la règle a été créée.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le règlement a été mis à jour.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Facultatif. Période de maintenance appliquée aux ressources couvertes par cette règle. Minimum : 1. Pour la version actuelle, le nombre maximal de weekly_window doit être égal à un.

WeeklyMaintenanceWindow

Plage horaire spécifiée pour les opérations hebdomadaires.

Représentation JSON
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
Champs
day

enum (DayOfWeek)

Facultatif. Permet de définir une programmation qui s'exécute un jour spécifique de la semaine.

startTime

object (TimeOfDay)

Facultatif. Heure de début de la période en UTC.

MaintenanceSchedule

Calendrier de maintenance à venir.

Représentation JSON
{
  "startTime": string,
  "endTime": string
}
Champs
startTime

string (Timestamp format)

Uniquement en sortie. Heure de début de toutes les maintenances planifiées à venir pour cette instance.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Uniquement en sortie. Heure de fin de toutes les maintenances planifiées à venir pour cette instance.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

Configuration de la réplication entre instances.

Représentation JSON
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Champs
instanceRole

enum (InstanceRole)

Obligatoire. Rôle de l'instance dans la réplication entre instances.

primaryInstance

object (RemoteInstance)

Facultatif. Détails de l'instance principale utilisée comme source de réplication pour cette instance secondaire.

Ce champ n'est défini que pour une instance secondaire.

secondaryInstances[]

object (RemoteInstance)

Facultatif. Liste des instances secondaires répliquées à partir de cette instance principale.

Ce champ n'est défini que pour une instance principale.

updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour de la configuration de la réplication entre instances.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

membership

object (Membership)

Uniquement en sortie. Vue en sortie uniquement de toutes les instances membres participant à la réplication multi-instances. Cette vue sera fournie par chaque instance membre, quel que soit son rôle(principal ou secondaire).

Une instance principale peut fournir des informations sur toutes les instances secondaires qui la répliquent. Toutefois, une instance secondaire ne connaît que l'instance principale à partir de laquelle elle effectue la réplication. Toutefois, dans les scénarios où l'instance principale n'est pas disponible(par exemple, en cas de panne régionale), une requête Getinstance peut être envoyée à n'importe quelle autre instance membre. Ce champ liste toutes les instances membres participant à la réplication multi-instances.

InstanceRole

Rôle de l'instance dans la réplication entre instances.

Énumérations
INSTANCE_ROLE_UNSPECIFIED Le rôle de l'instance n'est pas défini. Le comportement est équivalent à NONE.
NONE Cette instance ne participe pas à la réplication inter-instances. Il s'agit d'une instance indépendante qui ne réplique aucune autre instance et n'est répliquée par aucune autre instance.
PRIMARY Instance qui autorise les lectures et les écritures. Toutes les données écrites dans cette instance sont également répliquées dans les instances secondaires associées.
SECONDARY Instance qui autorise uniquement les lectures et réplique les données d'une instance principale.

RemoteInstance

Détails de l'instance distante associée à cette instance dans une configuration de réplication inter-instances.

Représentation JSON
{
  "instance": string,
  "uid": string
}
Champs
instance

string

Facultatif. Chemin d'accès complet à la ressource de l'instance distante au format suivant : projects//locations//instances/

uid

string

Uniquement en sortie. Identifiant unique de l'instance distante.

Abonnement

Vue en sortie uniquement de toutes les instances membres participant à la réplication multi-instances.

Représentation JSON
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Champs
primaryInstance

object (RemoteInstance)

Uniquement en sortie. Instance principale servant de source de réplication pour les instances secondaires.

secondaryInstances[]

object (RemoteInstance)

Uniquement en sortie. Liste des instances secondaires répliquées à partir de l'instance principale.

AutomatedBackupConfig

Configuration de la sauvegarde automatique pour une instance.

Représentation 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.
}
Champs
automatedBackupMode

enum (AutomatedBackupMode)

Facultatif. Mode de sauvegarde automatique. Si le mode est désactivé, les autres champs sont ignorés.

retention

string (Duration format)

Facultatif. Durée de conservation des sauvegardes automatiques avant leur suppression. La valeur doit être comprise entre 1 et 365 jours. Si aucune valeur n'est spécifiée, la valeur par défaut est de 35 jours.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

Champ d'union schedule. Planning des sauvegardes automatiques. schedule ne peut être qu'un des éléments suivants :
fixedFrequencySchedule

object (FixedFrequencySchedule)

Facultatif. Déclenchez des sauvegardes automatiques à une fréquence fixe.

FixedFrequencySchedule

Ce calendrier permet de déclencher la sauvegarde à une fréquence fixe (actuellement, seule la fréquence quotidienne est acceptée).

Représentation JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
Champs
startTime

object (TimeOfDay)

Obligatoire. Heure de début de chaque sauvegarde automatique en UTC. Elle doit être définie au début d'une heure. Ce champ est obligatoire.

AutomatedBackupMode

Mode de sauvegarde automatique.

Énumérations
AUTOMATED_BACKUP_MODE_UNSPECIFIED Valeur par défaut. La configuration de la sauvegarde automatique n'est pas spécifiée.
DISABLED La configuration de la sauvegarde automatique est désactivée.
ENABLED La configuration de la sauvegarde automatique est activée.

Méthodes

backup

Sauvegarder l'instance.

create

Créer une instance dans un projet et un emplacement donnés.

delete

Supprime une seule instance.

get

Récupérer les détails d'une seule instance.

getCertificateAuthority

Obtient des informations sur l'autorité de certification d'une instance.

list

Répertorie les instances d'un projet et d'un emplacement donnés.

patch

Mettre à jour les paramètres d'une seule instance.

rescheduleMaintenance

Reprogramme un événement de maintenance à venir.