MCP Tools Reference: memorystore.googleapis.com

Herramienta: list_instances

Enumera todas las instancias de Memorystore para Valkey.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_instances.

Solicitud de Curl 
                  
curl --location 'https://memorystore.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_instances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud para ListInstances.

ListInstancesRequest

Representación JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campos
parent

string

Obligatorio. Es el elemento principal desde el que se enumerarán las instancias. Formato: projects/{project}/locations/{location}
pageSize

integer

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.
pageToken

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.
filter

string

Es opcional. Es la expresión para filtrar los resultados.
orderBy

string

Es opcional. Ordena los resultados según un orden definido. Valores admitidos: "name", "create_time".

Esquema de salida

Mensaje de respuesta para ListInstances.

ListInstancesResponse

Representación JSON 
{
  "instances": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
instances[]

object (Instance)

Si la {ubicación} solicitada era "-", la respuesta contiene una lista de instancias de todas las ubicaciones. Se omitirán las instancias en ubicaciones inaccesibles.
nextPageToken

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.
unreachable[]

string

Ubicaciones a las que no se pudo llegar.

Instancia

Representación JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "stateInfo": {
    object (StateInfo)
  },
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "shardCount": integer,
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (PersistenceConfig)
  },
  "engineVersion": string,
  "engineConfigs": {
    string: string,
    ...
  },
  "nodeConfig": {
    object (NodeConfig)
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "pscAutoConnections": [
    {
      object (PscAutoConnection)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "migrationConfig": {
    object (MigrationConfig)
  },

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

  // Union field _replica_count can be only one of the following:
  "replicaCount": integer
  // End of list of possible types for union field _replica_count.

  // Union field _deletion_protection_enabled can be only one of the following:
  "deletionProtectionEnabled": boolean
  // End of list of possible types for union field _deletion_protection_enabled.

  // Union field _simulate_maintenance_event can be only one of the following:
  "simulateMaintenanceEvent": boolean
  // End of list of possible types for union field _simulate_maintenance_event.

  // Union field _ondemand_maintenance can be only one of the following:
  "ondemandMaintenance": boolean
  // End of list of possible types for union field _ondemand_maintenance.

  // Union field _satisfies_pzs can be only one of the following:
  "satisfiesPzs": boolean
  // End of list of possible types for union field _satisfies_pzs.

  // Union field _satisfies_pzi can be only one of the following:
  "satisfiesPzi": boolean
  // End of list of possible types for union field _satisfies_pzi.

  // Union field _async_instance_endpoints_deletion_enabled can be only one of
  // the following:
  "asyncInstanceEndpointsDeletionEnabled": boolean
  // End of list of possible types for union field
  // _async_instance_endpoints_deletion_enabled.

  // Union field _kms_key can be only one of the following:
  "kmsKey": string
  // End of list of possible types for union field _kms_key.

  // Union field _backup_collection can be only one of the following:
  "backupCollection": string
  // End of list of possible types for union field _backup_collection.

  // Union field _maintenance_version can be only one of the following:
  "maintenanceVersion": string
  // End of list of possible types for union field _maintenance_version.

  // Union field _effective_maintenance_version can be only one of the following:
  "effectiveMaintenanceVersion": string
  // End of list of possible types for union field
  // _effective_maintenance_version.

  // Union field _server_ca_mode can be only one of the following:
  "serverCaMode": enum (ServerCaMode)
  // End of list of possible types for union field _server_ca_mode.

  // Union field _server_ca_pool can be only one of the following:
  "serverCaPool": string
  // End of list of possible types for union field _server_ca_pool.

  // Union field _rotate_server_certificate can be only one of the following:
  "rotateServerCertificate": boolean
  // End of list of possible types for union field _rotate_server_certificate.

  // Union field _acl_policy can be only one of the following:
  "aclPolicy": string
  // End of list of possible types for union field _acl_policy.

  // Union field _acl_policy_in_sync can be only one of the following:
  "aclPolicyInSync": boolean
  // End of list of possible types for union field _acl_policy_in_sync.
}
Campos
name

string

Es el identificador. Es el nombre único de la instancia. Formato: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de creación de la instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la actualización más reciente de la instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "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)

Es opcional. Son etiquetas que representan los metadatos proporcionados por el usuario.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (State)

Solo salida. Es el estado actual de la instancia.
stateInfo

object (StateInfo)

Solo salida. Es información adicional sobre el estado de la instancia.
uid

string

Solo salida. Es el identificador único asignado por el sistema para la instancia.
authorizationMode

enum (AuthorizationMode)

Es opcional. Inmutable. Es el modo de autorización de la instancia.
transitEncryptionMode

enum (TransitEncryptionMode)

Es opcional. Inmutable. Modo de encriptación en tránsito de la instancia.
shardCount

integer

Es opcional. Cantidad de fragmentos de la instancia.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Solo salida. Obsoleto: El parámetro discovery_endpoints está obsoleto. Como resultado, no se completará si las conexiones se crean con el parámetro endpoints. En lugar de este parámetro, para la detección, usa endpoints.connections.pscConnection y endpoints.connections.pscAutoConnection con connectionType CONNECTION_TYPE_DISCOVERY.
nodeType

enum (NodeType)

Es opcional. Es el tipo de máquina para los nodos individuales de la instancia.
persistenceConfig

object (PersistenceConfig)

Es opcional. Es la configuración de persistencia de la instancia.
engineVersion

string

Es opcional. Es la versión del motor de la instancia.
engineConfigs

map (key: string, value: string)

Es opcional. Son las configuraciones del motor proporcionadas por el usuario para la instancia.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
nodeConfig

object (NodeConfig)

Solo salida. Es la configuración de los nodos individuales de la instancia.
zoneDistributionConfig

object (ZoneDistributionConfig)

Es opcional. Inmutable. Es la configuración de distribución de zonas de la instancia para la asignación de nodos.
pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

Es opcional. Inmutable. Obsoleto: Usa el valor endpoints.connections.psc_auto_connection en su lugar.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Solo salida. Son los detalles del adjunto de servicio para configurar las conexiones de PSC.
endpoints[]

object (InstanceEndpoint)

Es opcional. Son los extremos de la instancia.
mode

enum (Mode)

Es opcional. Es la configuración del modo de la instancia.
maintenancePolicy

object (MaintenancePolicy)

Es opcional. Es la política de mantenimiento de la instancia. Si no se proporciona, el evento de mantenimiento se realizará según el programa de lanzamiento interno de Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Solo salida. Programa de mantenimiento publicado
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Es opcional. Es la configuración para la replicación entre instancias.
encryptionInfo

object (EncryptionInfo)

Solo salida. Es la información de encriptación de los datos en reposo del clúster.
automatedBackupConfig

object (AutomatedBackupConfig)

Es opcional. Es la configuración de copia de seguridad automática de la instancia.
availableMaintenanceVersions[]

string

Solo salida. Este campo se usa para determinar las versiones de mantenimiento disponibles para la actualización de autoservicio.
allowFewerZonesDeployment
(deprecated)

boolean

Es opcional. Inmutable. Está obsoleto, no se debe usar.
migrationConfig

object (MigrationConfig)

Solo salida. Es la configuración de migración de la instancia.
Campo de unión import_sources. Es la fuente desde la que se importará. import_sources puede ser solo uno de los parámetros siguientes:
gcsSource

object (GcsBackupSource)

Es opcional. Inmutable. Copias de seguridad almacenadas en buckets de Cloud Storage Los buckets de Cloud Storage deben estar en la misma región que las instancias. Se requiere permiso de lectura para importar desde los objetos de Cloud Storage proporcionados.
managedBackupSource

object (ManagedBackupSource)

Es opcional. Inmutable. Son las copias de seguridad que genera y administra el servicio de Memorystore.

Campo de unión _replica_count.

_replica_count puede ser una de las siguientes opciones:
replicaCount

integer

Es opcional. Cantidad de nodos de réplica por fragmento. Si se omite, el valor predeterminado es 0 réplicas.

Campo de unión _deletion_protection_enabled.

_deletion_protection_enabled puede ser una de las siguientes opciones:
deletionProtectionEnabled

boolean

Es opcional. Si se establece como verdadero, fallará la eliminación de la instancia.

Campo de unión _simulate_maintenance_event.

_simulate_maintenance_event puede ser una de las siguientes opciones:
simulateMaintenanceEvent

boolean

Es opcional. Solo entrada. Simula un evento de mantenimiento.

Campo de unión _ondemand_maintenance.

_ondemand_maintenance puede ser una de las siguientes opciones:
ondemandMaintenance
(deprecated)

boolean

Es opcional. Solo entrada. Mantenimiento a pedido de la instancia.

Campo de unión _satisfies_pzs.

_satisfies_pzs puede ser una de las siguientes opciones:
satisfiesPzs

boolean

Es opcional. Solo salida. Se reserva para usarlo más adelante.

Campo de unión _satisfies_pzi.

_satisfies_pzi puede ser una de las siguientes opciones:
satisfiesPzi

boolean

Es opcional. Solo salida. Se reserva para usarlo más adelante.

Campo de unión _async_instance_endpoints_deletion_enabled.

_async_instance_endpoints_deletion_enabled puede ser una de las siguientes opciones:
asyncInstanceEndpointsDeletionEnabled

boolean

Es opcional. Si es verdadero, los extremos de instancias que crean y registran los clientes se pueden borrar de forma asíncrona. Es decir, se puede anular el registro de ese extremo de instancia antes de que se borren las reglas de reenvío en el extremo de instancia.

Campo de unión _kms_key.

_kms_key puede ser una de las siguientes opciones:
kmsKey

string

Es opcional. Es la clave de KMS que se usa para encriptar los datos en reposo del clúster.

Campo de unión _backup_collection.

_backup_collection puede ser una de las siguientes opciones:
backupCollection

string

Solo salida. Es el nombre completo del recurso de la colección de copias de seguridad. Ejemplo: projects/{project}/locations/{location}/backupCollections/{collection}

Campo de unión _maintenance_version.

_maintenance_version puede ser una de las siguientes opciones:
maintenanceVersion

string

Es opcional. Este campo se puede usar para activar la actualización de autoservicio y, así, indicar la versión de mantenimiento deseada. El campo available_maintenance_versions puede determinar la entrada de este campo.

Campo de unión _effective_maintenance_version.

_effective_maintenance_version puede ser una de las siguientes opciones:
effectiveMaintenanceVersion

string

Solo salida. Este campo representa la versión de mantenimiento real de la instancia.

Campo de unión _server_ca_mode.

_server_ca_mode puede ser una de las siguientes opciones:
serverCaMode

enum (ServerCaMode)

Es opcional. Inmutable. Es el modo de AC del servidor para la instancia.

Campo de unión _server_ca_pool.

_server_ca_pool puede ser una de las siguientes opciones:
serverCaPool

string

Es opcional. Inmutable. Es el grupo de AC administrado por el cliente para la instancia. Solo se aplica si el modo de CA del servidor es CUSTOMER_MANAGED_CAS_CA. Formato: "projects/{project}/locations/{region}/caPools/{ca_pool}".

Campo de unión _rotate_server_certificate.

_rotate_server_certificate puede ser una de las siguientes opciones:
rotateServerCertificate

boolean

Es opcional. Solo entrada. Rota los certificados del servidor.

Campo de unión _acl_policy.

_acl_policy puede ser una de las siguientes opciones:
aclPolicy

string

Es opcional. Es la política de ACL para la instancia. Formato: projects/{project}/locations/{location}/aclPolicies/{acl_policy}

Campo de unión _acl_policy_in_sync.

_acl_policy_in_sync puede ser una de las siguientes opciones:
aclPolicyInSync

boolean

Solo salida. Indica si las reglas de la LCA aplicadas a la instancia están sincronizadas con las reglas de la política de LCA más recientes. Este campo solo se aplica si se establece la política de LCA para la instancia.

GcsBackupSource

Representación JSON 
{
  "uris": [
    string
  ]
}
Campos
uris[]

string

Es opcional. Ejemplo: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Representación JSON 
{
  "backup": string
}
Campos
backup

string

Es opcional. Ejemplo: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup}. También se admite una versión más corta (sin el prefijo) del nombre de la copia de seguridad, como projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup_id}. En este caso, se supone que la copia de seguridad está en memorystore.googleapis.com.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

LabelsEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

StateInfo

Representación 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ón info.

info puede ser una de las siguientes opciones:
updateInfo

object (UpdateInfo)

Solo salida. Describe la actualización en curso cuando el estado de la instancia es UPDATING.

UpdateInfo

Representación JSON 
{

  // Union field _target_shard_count can be only one of the following:
  "targetShardCount": integer
  // End of list of possible types for union field _target_shard_count.

  // Union field _target_replica_count can be only one of the following:
  "targetReplicaCount": integer
  // End of list of possible types for union field _target_replica_count.

  // Union field _target_engine_version can be only one of the following:
  "targetEngineVersion": string
  // End of list of possible types for union field _target_engine_version.

  // Union field _target_node_type can be only one of the following:
  "targetNodeType": enum (NodeType)
  // End of list of possible types for union field _target_node_type.
}
Campos

Campo de unión _target_shard_count.

_target_shard_count puede ser una de las siguientes opciones:
targetShardCount

integer

Solo salida. Es la cantidad objetivo de fragmentos para la instancia.

Campo de unión _target_replica_count.

_target_replica_count puede ser una de las siguientes opciones:
targetReplicaCount

integer

Solo salida. Es la cantidad objetivo de nodos de réplica por fragmento para la instancia.

Campo de unión _target_engine_version.

_target_engine_version puede ser una de las siguientes opciones:
targetEngineVersion

string

Solo salida. Es la versión del motor de destino para la instancia.

Campo de unión _target_node_type.

_target_node_type puede ser una de las siguientes opciones:
targetNodeType

enum (NodeType)

Solo salida. Es el tipo de nodo de destino para la instancia.

DiscoveryEndpoint

Representación JSON 
{
  "address": string,
  "port": integer,
  "network": string
}
Campos
address

string

Solo salida. Dirección IP del extremo expuesto al que se conectan los clientes.
port

integer

Solo salida. Número de puerto del extremo expuesto.
network

string

Solo salida. Es la red en la que se reservará la dirección IP del extremo de detección, con el formato projects/{network_project}/global/networks/{network_id}.

PersistenceConfig

Representación JSON 
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Campos
mode

enum (PersistenceMode)

Es opcional. Es el modo de persistencia actual.
rdbConfig

object (RDBConfig)

Es opcional. Es la configuración de la RDB. Este campo se ignorará si el modo no es RDB.
aofConfig

object (AOFConfig)

Es opcional. Configuración de AOF Este campo se ignorará si el modo no es AOF.

RDBConfig

Representación JSON 
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Campos
rdbSnapshotPeriod

enum (SnapshotPeriod)

Es opcional. Es el período entre las instantáneas de RDB.
rdbSnapshotStartTime

string (Timestamp format)

Es opcional. Fecha y hora en que se intentó o se intentará tomar la primera instantánea, y con la que se alinearán las instantáneas futuras. Si no se proporciona, se usará la hora actual.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AOFConfig

Representación JSON 
{
  "appendFsync": enum (AppendFsync)
}
Campos
appendFsync

enum (AppendFsync)

Es opcional. Es el modo de fsync.

EngineConfigsEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

NodeConfig

Representación JSON 
{
  "sizeGb": number
}
Campos
sizeGb

number

Solo salida. Es el tamaño de la memoria del nodo en GB.

ZoneDistributionConfig

Representación JSON 
{
  "zone": string,
  "mode": enum (ZoneDistributionMode)
}
Campos
zone

string

Es opcional. Define la zona en la que se asignarán todos los recursos con el modo SINGLE_ZONE. Se ignora para el modo MULTI_ZONE.
mode

enum (ZoneDistributionMode)

Es opcional. Es el modo de distribución de zona actual. La configuración predeterminada es MULTI_ZONE.

PscAutoConnection

Representación 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

Solo salida. Es el ID de conexión de PSC de la regla de reenvío conectada al adjunto de servicio.
ipAddress

string

Solo salida. Es la IP asignada en la red del consumidor para la regla de reenvío de PSC.
forwardingRule

string

Solo salida. Es el URI de la regla de reenvío del lado del consumidor. Formato: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
projectId

string

Obligatorio. Es el project_id del proyecto del consumidor en el que se establecen las conexiones de PSC. Debe ser el mismo project_id en el que se está creando la instancia.
network

string

Obligatorio. Es la red en la que se crean los extremos de PSC, con el formato projects/{project_id}/global/networks/{network_id}.
serviceAttachment

string

Solo salida. Es el adjunto de servicio que es el destino de la conexión de PSC, con el formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo salida. Es el estado de la conexión de PSC: indica si existe una conexión y si está ACTIVA, o si ya no existe. Ten en cuenta que este valor se actualiza periódicamente. Usa las APIs de Private Service Connect para conocer el estado más reciente.
connectionType

enum (ConnectionType)

Solo salida. Es el tipo de conexión de PSC.
Campo de unión ports. Son los puertos del extremo expuesto. ports puede ser solo uno de los parámetros siguientes:
port

integer

Opcional. El puerto solo se establecerá para el extremo principal o de lectura, o de descubrimiento.

PscAttachmentDetail

Representación JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Campos
serviceAttachment

string

Solo salida. Es el URI del adjunto de servicio que tu PscConnection creado por ti mismo debe usar como destino.
connectionType

enum (ConnectionType)

Solo salida. Es el tipo de extremo de PSC.

InstanceEndpoint

Representación JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Campos
connections[]

object (ConnectionDetail)

Es opcional. Es un grupo de conexiones de PSC. Se crean en la misma red de VPC, una para cada adjunto de servicio del clúster.

ConnectionDetail

Representación 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ón connection. Se puede crear una conexión de PSC a una instancia a través de la automatización de la conectividad de servicios (conexión automática) durante la creación del clúster, o bien la pueden crear los propios clientes (conexión creada por el usuario). connection puede ser solo uno de los parámetros siguientes:
pscAutoConnection

object (PscAutoConnection)

Inmutable. Es la información detallada de una conexión de PSC que se crea a través de la automatización de la conectividad del servicio.
pscConnection

object (PscConnection)

Es la información detallada de una conexión de PSC que crea el usuario.

PscConnection

Representación 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

Obligatorio. Es el ID de conexión de PSC de la regla de reenvío conectada al adjunto de servicio.
ipAddress

string

Obligatorio. Es la IP asignada en la red del consumidor para la regla de reenvío de PSC.
forwardingRule

string

Obligatorio. Es el URI de la regla de reenvío del lado del consumidor. Formato: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
projectId

string

Solo salida. Es el ID del proyecto de consumidor desde el que se crea la regla de reenvío.
network

string

Obligatorio. Es la red del consumidor en la que reside la dirección IP, con el formato projects/{project_id}/global/networks/{network_id}.
serviceAttachment

string

Obligatorio. Es el adjunto de servicio que es el destino de la conexión de PSC, con el formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo salida. Es el estado de la conexión de PSC: indica si existe una conexión y si está ACTIVA, o si ya no existe. Ten en cuenta que este valor se actualiza periódicamente. Usa las APIs de Private Service Connect para conocer el estado más reciente.
connectionType

enum (ConnectionType)

Solo salida. Es el tipo de conexión de PSC.
Campo de unión ports. Son los puertos del extremo expuesto. ports puede ser solo uno de los parámetros siguientes:
port

integer

Opcional. El puerto solo se establecerá para el extremo principal o de lectura, o de descubrimiento.

MaintenancePolicy

Representación JSON 
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
Campos
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó la política.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se actualizó la política.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Es opcional. Es el período de mantenimiento que se aplica a los recursos cubiertos por esta política. El mínimo es 1. Para la versión actual, se espera que la cantidad máxima de weekly_window sea uno.

WeeklyMaintenanceWindow

Representación JSON 
{
  "day": enum (google.type.DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
day

enum (google.type.DayOfWeek)

Es opcional. Permite definir una programación que se ejecute en un día específico de la semana.
startTime

object (TimeOfDay)

Es opcional. Hora de inicio del período en UTC.

TimeOfDay

Representación JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas de un día en formato de 24 horas. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de una hora. Debe ser mayor o igual que 0 y menor o igual que 59.
seconds

integer

Segundos de un minuto. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos, en nanosegundos. Debe ser mayor o igual que 0 y menor o igual que 999,999,999.

MaintenanceSchedule

Representación JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Solo salida. Es la hora de inicio de cualquier mantenimiento programado próximo para esta instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo salida. Es la hora de finalización de cualquier mantenimiento programado próximo para esta instancia.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

Representación JSON 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campos
instanceRole

enum (InstanceRole)

Obligatorio. Es el rol de la instancia en la replicación entre instancias.
primaryInstance

object (RemoteInstance)

Es opcional. Son los detalles de la instancia principal que se usa como fuente de replicación para esta instancia secundaria.

Este campo solo se establece para una instancia secundaria.
secondaryInstances[]

object (RemoteInstance)

Es opcional. Es la lista de instancias secundarias que replican desde esta instancia principal.

Este campo solo se establece para una instancia principal.
updateTime

string (Timestamp format)

Solo salida. Fecha y hora en que se actualizó por última vez la configuración de replicación entre instancias.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
membership

object (Membership)

Solo salida. Es una vista de solo salida de todas las instancias miembro que participan en la replicación entre instancias. Cada instancia de miembro proporcionará esta vista, independientemente de su rol de instancia(primario o secundario).

Una instancia principal puede proporcionar información sobre todas las instancias secundarias que se replican desde ella. Sin embargo, una instancia secundaria solo conoce la instancia principal desde la que se replica. Sin embargo, en situaciones en las que la instancia principal no está disponible(p.ej., una interrupción regional), se puede enviar una solicitud Getinstance a cualquier otra instancia miembro, y este campo mostrará todas las instancias miembro que participan en la replicación entre instancias.

RemoteInstance

Representación JSON 
{
  "instance": string,
  "uid": string
}
Campos
instance

string

Es opcional. Ruta de acceso completa del recurso de la instancia remota con el siguiente formato: projects//locations//instances/
uid

string

Solo salida. Es el identificador único de la instancia remota.

Membresía

Representación JSON 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Campos
primaryInstance

object (RemoteInstance)

Solo salida. Es la instancia principal que actúa como fuente de replicación para las instancias secundarias.
secondaryInstances[]

object (RemoteInstance)

Solo salida. Es la lista de instancias secundarias que se replican desde la instancia principal.

EncryptionInfo

Representación JSON 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Campos
encryptionType

enum (Type)

Solo salida. Tipo de encriptación.
kmsKeyVersions[]

string

Solo salida. Son las versiones de clave de KMS que se usan para proteger los datos en reposo.
kmsKeyPrimaryState

enum (KmsKeyState)

Solo salida. Es el estado de la versión principal de la clave de KMS que percibe el sistema. Este campo no se completa en las copias de seguridad.
lastUpdateTime

string (Timestamp format)

Solo salida. Es la fecha y hora más reciente en la que se actualizó la información de encriptación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AutomatedBackupConfig

Representación 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)

Es opcional. Es el modo de copia de seguridad automática. Si el modo está inhabilitado, se ignorarán los demás campos.
retention

string (Duration format)

Es opcional. Es el tiempo durante el que se conservan las copias de seguridad automáticas antes de que se borren. El valor debe estar entre 1 y 365 días. Si no se especifica, el valor predeterminado es 35 días.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
Campo de unión schedule. Es el programa de copias de seguridad automáticas. schedule puede ser solo uno de los parámetros siguientes:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Es opcional. Activa copias de seguridad automáticas con una frecuencia fija.

FixedFrequencySchedule

Representación JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
startTime

object (TimeOfDay)

Obligatorio. Es la hora de inicio de cada copia de seguridad automática en UTC. Debe establecerse al inicio de una hora. Este campo es obligatorio.

Duración

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Son los segundos firmados del período. Debe estar entre -315,576,000,000 y +315,576,000,000, inclusive. Nota: Estos límites se calculan de la siguiente manera: 60 s/min * 60 min/h * 24 h/día * 365.25 días/año * 10,000 años.
nanos

integer

Fracciones firmadas de un segundo con una resolución de nanosegundos del período. Las duraciones inferiores a un segundo se representan con un campo seconds igual a 0 y un campo nanos positivo o negativo. Para duraciones de un segundo o más, un valor distinto de cero para el campo nanos debe tener el mismo signo que el campo seconds. Debe ser un valor entre -999,999,999 y +999,999,999, inclusive.

MigrationConfig

Representación JSON 
{
  "state": enum (State),
  "forceFinishMigration": boolean,

  // Union field source can be only one of the following:
  "selfManagedSource": {
    object (SelfManagedSource)
  }
  // End of list of possible types for union field source.
}
Campos
state

enum (State)

Solo salida. Es el estado de migración de la instancia.
forceFinishMigration

boolean

Solo salida. Representa una marca booleana para forzar la finalización de la migración sin la validación de recuperación de la diferencia entre el origen y el destino antes de detener la replicación.
Campo de unión source. Son los detalles sobre la fuente de migración. source puede ser solo uno de los parámetros siguientes:
selfManagedSource

object (SelfManagedSource)

Solo salida. Configuración para migrar desde una instancia autoadministrada de Valkey o Redis

SelfManagedSource

Representación JSON 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
Campos
ipAddress

string

Obligatorio. Es la dirección IP de la instancia de origen. Esta dirección IP debe ser estable y la instancia de Memorystore debe poder acceder a ella durante todo el proceso de migración.
port

integer

Obligatorio. Es el puerto de la instancia de origen. Este puerto debe ser estable y la instancia de Memorystore debe poder acceder a él durante todo el proceso de migración.
networkAttachment

string

Obligatorio. Es el nombre del recurso del adjunto de red de Private Service Connect que se usa para establecer la conectividad con la instancia de origen. Este adjunto de red tiene los siguientes requisitos: 1. Debe estar en el mismo proyecto que la instancia de Memorystore. 2. Debe estar en la misma región que la instancia de Memorystore. 3. La subred adjunta al adjunto de red debe estar en la misma red de VPC que los nodos de la instancia de origen.

Formato: projects/{project}/regions/{region}/networkAttachments/{network_attachment}

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌