REST Resource: projects.locations.instances

Ressource : Instance

Une 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)
    }
  ],
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean
}
Champs
name

string

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

string (Timestamp format)

Uniquement en sortie. Code temporel de création de l'instance.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
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

Obligatoire. Nombre de segments pour l'instance.
discoveryEndpoints[]

object (DiscoveryEndpoint)

Uniquement en sortie. Points de terminaison via lesquels les clients peuvent se connecter à l'instance. Actuellement, un seul point de terminaison de découverte est accepté.
nodeType

enum (NodeType)

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

object (PersistenceConfig)

Facultatif. Configuration de persistance de l'instance.
engineVersion

string

Facultatif. Immuable. Version du moteur de l'instance.
engineConfigs

map (key: string, value: string)

Facultatif. Configurations de 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 entre zones de l'instance pour l'allocation de nœuds.
pscAutoConnections[]

object (PscAutoConnection)

Obligatoire. Immuable. Données utilisateur et informations sur les ressources des connexions PSC créées automatiquement.
replicaCount

integer

Facultatif. Nombre de nœuds d'instances répliquées par segment. Si cette valeur est omise, la valeur par défaut est 0.
deletionProtectionEnabled

boolean

Facultatif. Si cette règle est définie sur "True", la suppression de l'instance échoue.

État

États possibles de l'instance.

Enums
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 UPDATING.

UpdateInfo

Représente des informations sur l'instance avec l'état UPDATING.

Représentation JSON 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer
}
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.

AuthorizationMode

Modes d'autorisation possibles de l'instance.

Enums
AUTHORIZATION_MODE_UNSPECIFIED Non défini.
AUTH_DISABLED Autorisation désactivée.
IAM_AUTH Autorisation de base IAM

TransitEncryptionMode

Modes de chiffrement en transit possibles de l'instance.

Enums
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 sur lequel l'adresse IP du point de terminaison de découverte sera réservée, au format projects/{networkProject}/global/networks/{network_id}.

NodeType

Types de nœuds possibles de l'instance. Pour en savoir plus, consultez la page https://cloud.google.com/memorystore/docs/valkey/instance-node-specification.

Enums
NODE_TYPE_UNSPECIFIED Non défini.
SHARED_CORE_NANO Cœur partagé nano.
HIGHMEM_MEDIUM Support à haute capacité de mémoire.
HIGHMEM_XLARGE Haute capacité de mémoire très volumineuse.
STANDARD_SMALL Standard avec petite taille.

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 de 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 est ignoré si le mode n'est pas AOF.

PersistenceMode

Modes de persistance possibles.

Enums
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 le 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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

SnapshotPeriod

Périodes d'instantanés possibles.

Enums
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.

Enums
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 c'est le réglage exact du noyau.
EVERY_SEC Fsync toutes les secondes. Vous risquez de perdre une seconde de données en cas de sinistre.
ALWAYS Fsync chaque fois que de nouvelles commandes d'écriture sont ajoutées à 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 distribution entre zones pour l'allocation des ressources d'instance.

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

string

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

enum (ZoneDistributionMode)

Facultatif. Mode de distribution actuel dans la zone. La valeur par défaut est MULTI_ZONE.

ZoneDistributionMode

Modes de distribution de zone possibles.

Enums
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Non défini. Valeur par défaut: MULTI_ZONE
MULTI_ZONE Répartir les ressources sur trois zones choisies 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 de consommation dans une connexion PSC.

Représentation JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string
}
Champs
pscConnectionId

string

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

string

Uniquement en sortie. Adresse IP allouée sur le réseau client 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 du client à partir duquel la règle de transfert est créée.
network

string

Obligatoire. Réseau du client sur lequel réside l'adresse IP, sous la forme projects/{projectId}/global/networks/{network_id}.

Méthodes

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

 Récupère les informations sur l'autorité de certification d'une instance.

list

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

patch

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