MCP Tools Reference: memorystore.googleapis.com

Strumento: create_instance

Crea un'istanza Memorystore for Valkey.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP create_instance.

Richiesta 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": "create_instance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per CreateInstance.

CreateInstanceRequest

Rappresentazione JSON 
{
  "parent": string,
  "instanceId": string,
  "instance": {
    object (Instance)
  },
  "requestId": string
}
Campi
parent

string

Obbligatorio. La risorsa padre in cui verrà creata questa istanza. Formato: projects/{project}/locations/{location}
instanceId

string

Obbligatorio. L'ID da utilizzare per l'istanza, che diventerà il componente finale del nome della risorsa dell'istanza.

Questo valore è soggetto alle seguenti limitazioni:

  • Deve avere una lunghezza compresa tra 4 e 63 caratteri
  • Deve iniziare con una lettera o una cifra
  • Deve contenere solo lettere minuscole, cifre e trattini
  • Non deve terminare con un trattino
  • Deve essere univoco all'interno di una località
instance

object (Instance)

Obbligatorio. L'istanza da creare.
requestId

string

Facoltativo. Un ID richiesta facoltativo per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi riprovare a inviare la richiesta, il server sappia che deve ignorarla se è già stata completata. Il server garantirà di ignorare la seconda richiesta per almeno 60 minuti dopo la prima.

Ad esempio, considera una situazione in cui effettui una richiesta iniziale e questa scade. Se effettui nuovamente la richiesta con lo stesso ID richiesta, il server può verificare se l'operazione originale con lo stesso ID richiesta è stata ricevuta e, in caso affermativo, ignorerà la seconda richiesta. In questo modo, i client non creano impegni duplicati per errore.

L'ID richiesta deve essere un UUID valido, ad eccezione dell'UUID zero, che non è supportato (00000000-0000-0000-0000-000000000000).

Istanza

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "stateInfo": {
    object (StateInfo)
  },
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "shardCount": integer,
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (PersistenceConfig)
  },
  "engineVersion": string,
  "engineConfigs": {
    string: string,
    ...
  },
  "nodeConfig": {
    object (NodeConfig)
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "pscAutoConnections": [
    {
      object (PscAutoConnection)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "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.
}
Campi
name

string

Identificatore. Nome univoco dell'istanza. Formato: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Solo output. Timestamp di creazione dell'istanza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento dell'istanza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Facoltativo. Etichette per rappresentare i metadati forniti dall'utente.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (State)

Solo output. Stato attuale dell'istanza.
stateInfo

object (StateInfo)

Solo output. Ulteriori informazioni sullo stato dell'istanza.
uid

string

Solo output. Identificatore univoco assegnato dal sistema per l'istanza.
authorizationMode

enum (AuthorizationMode)

Facoltativo. Immutabile. Modalità di autorizzazione dell'istanza.
transitEncryptionMode

enum (TransitEncryptionMode)

Facoltativo. Immutabile. Modalità di crittografia dei dati in transito dell'istanza.
shardCount

integer

Facoltativo. Numero di shard per l'istanza.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Solo output. Obsoleto: il parametro discovery_endpoints è obsoleto. Di conseguenza, non verrà compilato se le connessioni vengono create utilizzando il parametro degli endpoint. Anziché questo parametro, per l'individuazione, utilizza endpoints.connections.pscConnection e endpoints.connections.pscAutoConnection con connectionType CONNECTION_TYPE_DISCOVERY.
nodeType

enum (NodeType)

Facoltativo. Tipo di macchina per i singoli nodi dell'istanza.
persistenceConfig

object (PersistenceConfig)

Facoltativo. Configurazione della persistenza dell'istanza.
engineVersion

string

Facoltativo. Versione del motore dell'istanza.
engineConfigs

map (key: string, value: string)

Facoltativo. Configurazioni del motore fornite dall'utente per l'istanza.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
nodeConfig

object (NodeConfig)

Solo output. Configurazione dei singoli nodi dell'istanza.
zoneDistributionConfig

object (ZoneDistributionConfig)

Facoltativo. Immutabile. Configurazione della distribuzione delle zone dell'istanza per l'allocazione dei nodi.
pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

Facoltativo. Immutabile. Ritirato: utilizza invece il valore endpoints.connections.psc_auto_connection.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Solo output. Dettagli del collegamento al servizio per configurare le connessioni PSC.
endpoints[]

object (InstanceEndpoint)

Facoltativo. Endpoint per l'istanza.
mode

enum (Mode)

Facoltativo. La configurazione della modalità per l'istanza.
maintenancePolicy

object (MaintenancePolicy)

Facoltativo. La policy di manutenzione per l'istanza. Se non viene fornito, l'evento di manutenzione verrà eseguito in base alla pianificazione interna di implementazione di Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Solo output. Pianificazione della manutenzione pubblicata.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Facoltativo. La configurazione per la replica tra istanze.
encryptionInfo

object (EncryptionInfo)

Solo output. Informazioni sulla crittografia dei dati at-rest del cluster.
automatedBackupConfig

object (AutomatedBackupConfig)

Facoltativo. La configurazione del backup automatico per l'istanza.
availableMaintenanceVersions[]

string

Solo output. Questo campo viene utilizzato per determinare le versioni di manutenzione disponibili per l'aggiornamento self-service.
allowFewerZonesDeployment
(deprecated)

boolean

Facoltativo. Immutabile. Deprecato, non utilizzare.
migrationConfig

object (MigrationConfig)

Solo output. Configurazione della migrazione per l'istanza.
Campo unione import_sources. L'origine da cui importare. import_sources può essere solo uno dei seguenti tipi:
gcsSource

object (GcsBackupSource)

Facoltativo. Immutabile. Backup archiviati nei bucket Cloud Storage. I bucket Cloud Storage devono trovarsi nella stessa regione delle istanze. Per importare dagli oggetti Cloud Storage forniti è necessaria l'autorizzazione di lettura.
managedBackupSource

object (ManagedBackupSource)

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

Campo unione _replica_count.

_replica_count può essere solo uno dei seguenti tipi:
replicaCount

integer

Facoltativo. Numero di nodi di replica per shard. Se omesso, il valore predefinito è 0 repliche.

Campo unione _deletion_protection_enabled.

_deletion_protection_enabled può essere solo uno dei seguenti tipi:
deletionProtectionEnabled

boolean

Facoltativo. Se viene impostato su true, l'eliminazione dell'istanza non riuscirà.

Campo unione _simulate_maintenance_event.

_simulate_maintenance_event può essere solo uno dei seguenti tipi:
simulateMaintenanceEvent

boolean

Facoltativo. Solo input. Simula un evento di manutenzione.

Campo unione _ondemand_maintenance.

_ondemand_maintenance può essere solo uno dei seguenti tipi:
ondemandMaintenance
(deprecated)

boolean

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

Campo unione _satisfies_pzs.

_satisfies_pzs può essere solo uno dei seguenti tipi:
satisfiesPzs

boolean

Facoltativo. Solo output. Riservato per l'uso futuro.

Campo unione _satisfies_pzi.

_satisfies_pzi può essere solo uno dei seguenti tipi:
satisfiesPzi

boolean

Facoltativo. Solo output. Riservato per l'uso futuro.

Campo unione _async_instance_endpoints_deletion_enabled.

_async_instance_endpoints_deletion_enabled può essere solo uno dei seguenti tipi:
asyncInstanceEndpointsDeletionEnabled

boolean

Facoltativo. Se è true, gli endpoint delle istanze creati e registrati dai clienti possono essere eliminati in modo asincrono. ovvero, un endpoint di questo tipo può essere annullato prima dell'eliminazione delle regole di forwarding nell'endpoint dell'istanza.

Campo unione _kms_key.

_kms_key può essere solo uno dei seguenti tipi:
kmsKey

string

Facoltativo. La chiave KMS utilizzata per criptare i dati at-rest del cluster.

Campo unione _backup_collection.

_backup_collection può essere solo uno dei seguenti tipi:
backupCollection

string

Solo output. Il nome completo della risorsa della raccolta di backup. Esempio: projects/{project}/locations/{location}/backupCollections/{collection}

Campo unione _maintenance_version.

_maintenance_version può essere solo uno dei seguenti tipi:
maintenanceVersion

string

Facoltativo. Questo campo può essere utilizzato per attivare l'aggiornamento self-service per indicare la versione di manutenzione desiderata. L'input di questo campo può essere determinato dal campo available_maintenance_versions.

Campo unione _effective_maintenance_version.

_effective_maintenance_version può essere solo uno dei seguenti tipi:
effectiveMaintenanceVersion

string

Solo output. Questo campo rappresenta la versione di manutenzione effettiva dell'istanza.

Campo unione _server_ca_mode.

_server_ca_mode può essere solo uno dei seguenti tipi:
serverCaMode

enum (ServerCaMode)

Facoltativo. Immutabile. La modalità CA server per l'istanza.

Campo unione _server_ca_pool.

_server_ca_pool può essere solo uno dei seguenti tipi:
serverCaPool

string

Facoltativo. Immutabile. Il pool di CA gestito dal cliente per l'istanza. Applicabile solo se la modalità CA server è CUSTOMER_MANAGED_CAS_CA. Formato: "projects/{project}/locations/{region}/caPools/{ca_pool}".

Campo unione _rotate_server_certificate.

_rotate_server_certificate può essere solo uno dei seguenti tipi:
rotateServerCertificate

boolean

Facoltativo. Solo input. Ruota i certificati del server.

Campo unione _acl_policy.

_acl_policy può essere solo uno dei seguenti tipi:
aclPolicy

string

Facoltativo. La policy ACL per l'istanza. Formato: projects/{project}/locations/{location}/aclPolicies/{acl_policy}

Campo unione _acl_policy_in_sync.

_acl_policy_in_sync può essere solo uno dei seguenti tipi:
aclPolicyInSync

boolean

Solo output. Indica se le regole ACL applicate all'istanza sono sincronizzate con le regole dei criteri ACL più recenti. Questo campo è applicabile solo se il criterio ACL è impostato per l'istanza.

GcsBackupSource

Rappresentazione JSON 
{
  "uris": [
    string
  ]
}
Campi
uris[]

string

Facoltativo. Esempio: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Rappresentazione JSON 
{
  "backup": string
}
Campi
backup

string

Facoltativo. Esempio: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} È supportata anche una versione più breve (senza prefisso) del nome del backup, ad esempio projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup_id}. In questo caso, si presume che il backup si trovi in memorystore.googleapis.com.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi del tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

LabelsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

StateInfo

Rappresentazione JSON 
{

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

Campo unione info.

info può essere solo uno dei seguenti tipi:
updateInfo

object (UpdateInfo)

Solo output. Descrive l'aggiornamento in corso quando lo stato dell'istanza è UPDATING.

UpdateInfo

Rappresentazione 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.
}
Campi

Campo unione _target_shard_count.

_target_shard_count può essere solo uno dei seguenti tipi:
targetShardCount

integer

Solo output. Numero di shard di destinazione per l'istanza.

Campo unione _target_replica_count.

_target_replica_count può essere solo uno dei seguenti tipi:
targetReplicaCount

integer

Solo output. Numero target di nodi di replica per shard per l'istanza.

Campo unione _target_engine_version.

_target_engine_version può essere solo uno dei seguenti tipi:
targetEngineVersion

string

Solo output. Versione del motore di destinazione per l'istanza.

Campo unione _target_node_type.

_target_node_type può essere solo uno dei seguenti tipi:
targetNodeType

enum (NodeType)

Solo output. Tipo di nodo di destinazione per l'istanza.

DiscoveryEndpoint

Rappresentazione JSON 
{
  "address": string,
  "port": integer,
  "network": string
}
Campi
address

string

Solo output. L'indirizzo IP a cui si connettono i client dell'endpoint esposto.
port

integer

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

string

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

PersistenceConfig

Rappresentazione JSON 
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
Campi
mode

enum (PersistenceMode)

Facoltativo. Modalità di persistenza attuale.
rdbConfig

object (RDBConfig)

Facoltativo. Configurazione RDB. Questo campo verrà ignorato se la modalità non è RDB.
aofConfig

object (AOFConfig)

Facoltativo. Configurazione AOF. Questo campo verrà ignorato se la modalità non è AOF.

RDBConfig

Rappresentazione JSON 
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Campi
rdbSnapshotPeriod

enum (SnapshotPeriod)

Facoltativo. Periodo tra gli snapshot RDB.
rdbSnapshotStartTime

string (Timestamp format)

Facoltativo. Ora in cui è stato/verrà tentato il primo snapshot e a cui verranno allineati gli snapshot futuri. Se non viene specificato, verrà utilizzato l'orario attuale.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AOFConfig

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

enum (AppendFsync)

Facoltativo. Modalità fsync.

EngineConfigsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

NodeConfig

Rappresentazione JSON 
{
  "sizeGb": number
}
Campi
sizeGb

number

Solo output. Dimensioni della memoria del nodo in GB.

ZoneDistributionConfig

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

string

Facoltativo. Definisce la zona in cui verranno allocate tutte le risorse con la modalità SINGLE_ZONE. Ignorato per la modalità MULTI_ZONE.
mode

enum (ZoneDistributionMode)

Facoltativo. Modalità di distribuzione delle zone attuale. Il valore predefinito è MULTI_ZONE.

PscAutoConnection

Rappresentazione JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
Campi
pscConnectionId

string

Solo output. L'ID connessione PSC della regola di forwarding connessa al collegamento del servizio.
ipAddress

string

Solo output. L'IP allocato sulla rete consumer per la regola di forwarding PSC.
forwardingRule

string

Solo output. L'URI della regola di forwarding lato consumer. Formato: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
projectId

string

Obbligatorio. L'ID progetto consumer in cui vengono stabilite le connessioni PSC. Deve essere lo stesso project_id in cui viene creata l'istanza.
network

string

Obbligatorio. La rete in cui vengono creati gli endpoint PSC, nel formato projects/{project_id}/global/networks/{network_id}.
serviceAttachment

string

Solo output. Il collegamento del servizio che è la destinazione della connessione PSC, nel formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo output. Lo stato della connessione PSC: se esiste una connessione ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Utilizza le API Private Service Connect per lo stato più recente.
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC.
Campo unione ports. Porte dell'endpoint esposto. ports può essere solo uno dei seguenti tipi:
port

integer

Facoltativo. La porta verrà impostata solo per l'endpoint Primary/Reader o Discovery.

PscAttachmentDetail

Rappresentazione JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Campi
serviceAttachment

string

Solo output. L'URI del collegamento al servizio che la connessione PSC creata autonomamente deve utilizzare come target.
connectionType

enum (ConnectionType)

Solo output. Tipo di endpoint PSC.

InstanceEndpoint

Rappresentazione JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Campi
connections[]

object (ConnectionDetail)

Facoltativo. Un gruppo di connessioni PSC. Vengono creati nella stessa rete VPC, uno per ogni collegamento del servizio nel cluster.

ConnectionDetail

Rappresentazione JSON 
{

  // Union field connection can be only one of the following:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of list of possible types for union field connection.
}
Campi
Campo unione connection. Una connessione PSC a un'istanza può essere creata tramite l'automazione della connettività di servizio (connessione automatica) durante la creazione del cluster oppure può essere creata direttamente dal cliente (connessione creata dall'utente). connection può essere solo uno dei seguenti tipi:
pscAutoConnection

object (PscAutoConnection)

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

object (PscConnection)

Informazioni dettagliate di una connessione PSC creata dall'utente.

PscConnection

Rappresentazione JSON 
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
Campi
pscConnectionId

string

Obbligatorio. L'ID connessione PSC della regola di forwarding connessa al collegamento del servizio.
ipAddress

string

Obbligatorio. L'IP allocato sulla rete consumer per la regola di forwarding PSC.
forwardingRule

string

Obbligatorio. L'URI della regola di forwarding lato consumer. Formato: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
projectId

string

Solo output. L'ID progetto consumer da cui viene creata la regola di forwarding.
network

string

Obbligatorio. La rete consumer in cui risiede l'indirizzo IP, nel formato projects/{project_id}/global/networks/{network_id}.
serviceAttachment

string

Obbligatorio. Il collegamento del servizio che è la destinazione della connessione PSC, nel formato projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Solo output. Lo stato della connessione PSC: se esiste una connessione ATTIVA o se non esiste più. Tieni presente che questo valore viene aggiornato periodicamente. Utilizza le API Private Service Connect per lo stato più recente.
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC.
Campo unione ports. Porte dell'endpoint esposto. ports può essere solo uno dei seguenti tipi:
port

integer

Facoltativo. La porta verrà impostata solo per l'endpoint Primary/Reader o Discovery.

MaintenancePolicy

Rappresentazione JSON 
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
Campi
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata la policy.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora in cui è stata aggiornata la policy.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Facoltativo. Periodo di manutenzione applicato alle risorse coperte da questa policy. Minimo 1. Per la versione attuale, il numero massimo di weekly_window previsto è uno.

WeeklyMaintenanceWindow

Rappresentazione JSON 
{
  "day": enum (google.type.DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
Campi
day

enum (google.type.DayOfWeek)

Facoltativo. Consente di definire una pianificazione da eseguire in un giorno specifico della settimana.
startTime

object (TimeOfDay)

Facoltativo. Ora di inizio della finestra in UTC.

TimeOfDay

Rappresentazione JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Ore di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59.
seconds

integer

Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere minore o uguale a 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondi, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999.

MaintenanceSchedule

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

Solo output. L'ora di inizio di qualsiasi manutenzione pianificata imminente per questa istanza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo output. L'ora di fine di qualsiasi manutenzione pianificata imminente per questa istanza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

Rappresentazione JSON 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campi
instanceRole

enum (InstanceRole)

Obbligatorio. Il ruolo dell'istanza nella replica tra istanze.
primaryInstance

object (RemoteInstance)

Facoltativo. Dettagli dell'istanza primaria utilizzata come origine di replica per questa istanza secondaria.

Questo campo è impostato solo per un'istanza secondaria.
secondaryInstances[]

object (RemoteInstance)

Facoltativo. Elenco delle istanze secondarie che eseguono la replica da questa istanza principale.

Questo campo viene impostato solo per un'istanza principale.
updateTime

string (Timestamp format)

Solo output. L'ultima volta che è stata aggiornata la configurazione della replica tra istanze.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
membership

object (Membership)

Solo output. Una visualizzazione di sola uscita di tutte le istanze membro che partecipano alla replica tra istanze. Questa visualizzazione verrà fornita da ogni istanza membro indipendentemente dal ruolo dell'istanza(principale o secondaria).

Un'istanza principale può fornire informazioni su tutte le istanze secondarie che vengono replicate. Tuttavia, un'istanza secondaria conosce solo l'istanza principale da cui esegue la replica. Tuttavia, per gli scenari in cui l'istanza principale non è disponibile(ad es. interruzione regionale), è possibile inviare una richiesta Getinstance a qualsiasi altra istanza membro e questo campo elencherà tutte le istanze membro che partecipano alla replica tra istanze.

RemoteInstance

Rappresentazione JSON 
{
  "instance": string,
  "uid": string
}
Campi
instance

string

Facoltativo. Il percorso completo della risorsa dell'istanza remota nel formato: projects//locations//instances/
uid

string

Solo output. L'identificatore univoco dell'istanza remota.

Appartenenza

Rappresentazione JSON 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Campi
primaryInstance

object (RemoteInstance)

Solo output. L'istanza principale che funge da origine della replica per le istanze secondarie.
secondaryInstances[]

object (RemoteInstance)

Solo output. L'elenco delle istanze secondarie che eseguono la replica dall'istanza principale.

EncryptionInfo

Rappresentazione JSON 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Campi
encryptionType

enum (Type)

Solo output. Tipo di crittografia.
kmsKeyVersions[]

string

Solo output. Versioni delle chiavi KMS utilizzate per proteggere i dati inattivi.
kmsKeyPrimaryState

enum (KmsKeyState)

Solo output. Lo stato della versione primaria della chiave KMS percepito dal sistema. Questo campo non viene compilato nei backup.
lastUpdateTime

string (Timestamp format)

Solo output. L'ora più recente in cui sono state aggiornate le informazioni di crittografia.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AutomatedBackupConfig

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

  // Union field schedule can be only one of the following:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of list of possible types for union field schedule.
}
Campi
automatedBackupMode

enum (AutomatedBackupMode)

Facoltativo. La modalità di backup automatico. Se la modalità è disattivata, gli altri campi verranno ignorati.
retention

string (Duration format)

Facoltativo. Per quanto tempo conservare i backup automatici prima che vengano eliminati. Il valore deve essere compreso tra 1 e 365 giorni. Se non è specificato, il valore predefinito è 35 giorni.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
Campo unione schedule. La pianificazione dei backup automatici. schedule può essere solo uno dei seguenti tipi:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Facoltativo. Attiva i backup automatici a una frequenza fissa.

FixedFrequencySchedule

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

object (TimeOfDay)

Obbligatorio. L'ora di inizio di ogni backup automatico nel fuso orario UTC. Deve essere impostata all'inizio di un'ora. Questo campo è obbligatorio.

Durata

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni
nanos

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

MigrationConfig

Rappresentazione 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.
}
Campi
state

enum (State)

Solo output. Stato della migrazione dell'istanza.
forceFinishMigration

boolean

Solo output. Rappresenta un flag booleano per forzare il completamento della migrazione senza la convalida del recupero dell'offset tra l'origine e la destinazione prima di interrompere la replica.
Campo unione source. Dettagli sull'origine della migrazione. source può essere solo uno dei seguenti tipi:
selfManagedSource

object (SelfManagedSource)

Solo output. Configurazione per la migrazione da un'istanza Valkey/Redis autogestita

SelfManagedSource

Rappresentazione JSON 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
Campi
ipAddress

string

Obbligatorio. L'indirizzo IP dell'istanza di origine. Questo indirizzo IP deve essere un indirizzo IP stabile a cui l'istanza Memorystore può accedere durante l'intero processo di migrazione.
port

integer

Obbligatorio. La porta dell'istanza di origine. Questa porta deve essere una porta stabile a cui l'istanza Memorystore può accedere durante l'intero processo di migrazione.
networkAttachment

string

Obbligatorio. Il nome della risorsa del collegamento di rete Private Service Connect utilizzato per stabilire la connettività all'istanza di origine. Questo collegamento di rete presenta i seguenti requisiti: 1. Deve trovarsi nello stesso progetto dell'istanza Memorystore. 2. Deve trovarsi nella stessa regione dell'istanza Memorystore. 3. La subnet collegata al collegamento di rete deve trovarsi nella stessa rete VPC dei nodi dell'istanza di origine.

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

Schema di output

Questa risorsa rappresenta un'operazione a lunga esecuzione che è il risultato di una chiamata API di rete.

Operazione

Rappresentazione JSON 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
Campi
name

string

Il nome assegnato dal server, che è univoco solo all'interno dello stesso servizio che lo restituisce originariamente. Se utilizzi la mappatura HTTP predefinita, name deve essere un nome risorsa che termina con operations/{unique_id}.
metadata

object

Metadati specifici del servizio associati all'operazione. In genere contengono informazioni sullo stato di avanzamento e metadati comuni come l'ora di creazione. Alcuni servizi potrebbero non fornire questi metadati. Qualsiasi metodo che restituisce un'operazione a lunga esecuzione deve documentare il tipo di metadati, se presenti.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.
done

boolean

Se il valore è false, significa che l'operazione è ancora in corso. Se è true, l'operazione viene completata ed è disponibile error o response.
Campo unione result. Il risultato dell'operazione, che può essere un error o una response valida. Se done == false, né error né response vengono impostati. Se done == true, è possibile impostare esattamente uno tra error e response. Alcuni servizi potrebbero non fornire il risultato. result può essere solo uno dei seguenti tipi:
error

object (Status)

Il risultato di errore dell'operazione in caso di errore o annullamento.
response

object

La risposta normale e con esito positivo dell'operazione. Se il metodo originale non restituisce dati in caso di esito positivo, ad esempio Delete, la risposta è google.protobuf.Empty. Se il metodo originale è Get/Create/Update standard, la risposta deve essere la risorsa. Per gli altri metodi, la risposta deve avere il tipo XxxResponse, dove Xxx è il nome del metodo originale. Ad esempio, se il nome del metodo originale è TakeSnapshot(), il tipo di risposta dedotto è TakeSnapshotResponse.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

Qualsiasi

Rappresentazione JSON 
{
  "typeUrl": string,
  "value": string
}
Campi
typeUrl

string

Identifica il tipo di messaggio Protobuf serializzato con un riferimento URI costituito da un prefisso che termina con una barra e il nome del tipo completo.

Esempio: type.googleapis.com/google.protobuf.StringValue

Questa stringa deve contenere almeno un carattere / e il contenuto dopo l'ultimo / deve essere il nome completo del tipo in forma canonica, senza un punto iniziale. Non scrivere uno schema su questi riferimenti URI in modo che i client non tentino di contattarli.

Il prefisso è arbitrario e le implementazioni di Protobuf devono semplicemente rimuovere tutto fino all'ultimo / incluso per identificare il tipo. type.googleapis.com/ è un prefisso predefinito comune richiesto da alcune implementazioni legacy. Questo prefisso non indica l'origine del tipo e non è previsto che gli URI che lo contengono rispondano a richieste.

Tutte le stringhe URL di tipo devono essere riferimenti URI validi con l'ulteriore limitazione (per il formato di testo) che il contenuto del riferimento deve essere costituito solo da caratteri alfanumerici, sequenze di escape codificate in percentuale e caratteri del seguente insieme (esclusi i backtick esterni): /-.~_!$&()*+,;=. Nonostante consentiamo le codifiche in percentuale, le implementazioni non devono eseguirne l'escape per evitare confusione con i parser esistenti. Ad esempio, type.googleapis.com%2FFoo deve essere rifiutato.

Nella progettazione originale di Any, è stata presa in considerazione la possibilità di avviare un servizio di risoluzione dei tipi in questi URL di tipo, ma Protobuf non ne ha mai implementato uno e considera il contatto con questi URL problematico e un potenziale problema di sicurezza. Non tentare di contattare gli URL di tipo.
value

string (bytes format)

Contiene una serializzazione Protobuf del tipo descritto da type_url.

Una stringa con codifica in base64.

Stato

Rappresentazione JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campi
code

integer

Il codice di stato, che deve essere un valore enum di google.rpc.Code.
message

string

Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo google.rpc.Status.details o localizzato dal client.
details[]

object

Un elenco di messaggi contenenti i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi da utilizzare per le API.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌