MCP Tools Reference: redis.googleapis.com

Strumento: create_cluster

Crea un cluster in Memorystore for Redis Cluster.

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

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

Schema di input

Richiesta per CreateCluster.

CreateClusterRequest

Rappresentazione JSON 
{
  "parent": string,
  "clusterId": string,
  "cluster": {
    object (Cluster)
  },
  "requestId": string
}
Campi
parent

string

Obbligatorio. Il nome della risorsa della località del cluster utilizzando il modulo: projects/{project_id}/locations/{location_id} dove location_id si riferisce a una regione Google Cloud.
clusterId

string

Obbligatorio. Il nome logico del cluster Redis nel progetto del cliente con le seguenti limitazioni:

  • Deve contenere solo lettere minuscole, numeri e trattini.
  • Deve iniziare con una lettera.
  • Deve avere una lunghezza compresa tra 1 e 63 caratteri.
  • Deve terminare con un numero o una lettera.
  • Deve essere univoco all'interno del progetto / della località del cliente
cluster

object (Cluster)

Obbligatorio. Il cluster da creare.
requestId

string

Facoltativo. UUID richiesta idempotente.

Cluster

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "state": enum (State),
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "pscConfigs": [
    {
      object (PscConfig)
    }
  ],
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "pscConnections": [
    {
      object (PscConnection)
    }
  ],
  "stateInfo": {
    object (StateInfo)
  },
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (ClusterPersistenceConfig)
  },
  "redisConfigs": {
    string: string,
    ...
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "crossClusterReplicationConfig": {
    object (CrossClusterReplicationConfig)
  },
  "pscServiceAttachments": [
    {
      object (PscServiceAttachment)
    }
  ],
  "clusterEndpoints": [
    {
      object (ClusterEndpoint)
    }
  ],
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "labels": {
    string: string,
    ...
  },
  "aclPolicy": string,

  // 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 _size_gb can be only one of the following:
  "sizeGb": integer
  // End of list of possible types for union field _size_gb.

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

  // Union field _precise_size_gb can be only one of the following:
  "preciseSizeGb": number
  // End of list of possible types for union field _precise_size_gb.

  // 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 _maintenance_policy can be only one of the following:
  "maintenancePolicy": {
    object (ClusterMaintenancePolicy)
  }
  // End of list of possible types for union field _maintenance_policy.

  // Union field _maintenance_schedule can be only one of the following:
  "maintenanceSchedule": {
    object (ClusterMaintenanceSchedule)
  }
  // End of list of possible types for union field _maintenance_schedule.

  // 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 _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 _backup_collection can be only one of the following:
  "backupCollection": string
  // End of list of possible types for union field _backup_collection.

  // 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 _ondemand_maintenance can be only one of the following:
  "ondemandMaintenance": boolean
  // End of list of possible types for union field _ondemand_maintenance.

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

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

Obbligatorio. Identificatore. Nome univoco della risorsa in questo ambito, inclusi progetto e località, nel formato: projects/{project_id}/locations/{location_id}/clusters/{cluster_id}
createTime

string (Timestamp format)

Solo output. Il timestamp associato alla richiesta di creazione del cluster.

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".
state

enum (State)

Solo output. Lo stato attuale di questo cluster. Può essere CREAZIONE IN CORSO, PRONTO, AGGIORNAMENTO IN CORSO, ELIMINAZIONE IN CORSO e SOSPESO
uid

string

Solo output. Identificatore univoco assegnato dal sistema per il cluster.
authorizationMode

enum (AuthorizationMode)

Facoltativo. La modalità di autorizzazione del cluster Redis. Se non viene fornita, la funzionalità di autenticazione è disabilitata per il cluster.
transitEncryptionMode

enum (TransitEncryptionMode)

Facoltativo. La crittografia in transito per il cluster Redis. Se non viene fornita, la crittografia è disabilitata per il cluster.
pscConfigs[]

object (PscConfig)

Facoltativo. Ogni PscConfig configura la rete consumer in cui gli IP verranno assegnati al cluster per l'accesso client tramite l'automazione di Private Service Connect. Al momento è supportato solo un PscConfig.
discoveryEndpoints[]

object (DiscoveryEndpoint)

Solo output. Endpoint creati su ogni rete specificata, per consentire ai client Redis di connettersi al cluster. Al momento è supportato un solo endpoint di rilevamento.
pscConnections[]

object (PscConnection)

Solo output. L'elenco delle connessioni PSC create automaticamente tramite l'automazione della connettività dei servizi.
stateInfo

object (StateInfo)

Solo output. Informazioni aggiuntive sullo stato attuale del cluster.
nodeType

enum (NodeType)

Facoltativo. Il tipo di nodo Redis nel cluster. NodeType determina il tipo di macchina sottostante di un nodo Redis.
persistenceConfig

object (ClusterPersistenceConfig)

Facoltativo. Configurazione della persistenza (RDB, AOF) per il cluster.
redisConfigs

map (key: string, value: string)

Facoltativo. Coppie chiave/valore di override del cliente per le configurazioni Redis modificabili

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

object (ZoneDistributionConfig)

Facoltativo. Questa configurazione verrà utilizzata per determinare in che modo il cliente vuole che distribuiamo le risorse del cluster all'interno della regione.
crossClusterReplicationConfig

object (CrossClusterReplicationConfig)

Facoltativo. Configurazione della replica tra cluster.
pscServiceAttachments[]

object (PscServiceAttachment)

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

object (ClusterEndpoint)

Facoltativo. Un elenco di endpoint del cluster.
automatedBackupConfig

object (AutomatedBackupConfig)

Facoltativo. La configurazione del backup automatico per il cluster.
encryptionInfo

object (EncryptionInfo)

Solo output. Informazioni sulla crittografia dei dati at-rest del cluster.
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.
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" }.
aclPolicy

string

Facoltativo. La policy ACL da applicare al cluster.
Campo unione import_sources. L'origine da cui importare. import_sources può essere solo uno dei seguenti tipi:
gcsSource

object (GcsBackupSource)

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

object (ManagedBackupSource)

Facoltativo. Backup generati e gestiti dal servizio Memorystore.

Campo unione _replica_count.

_replica_count può essere solo uno dei seguenti tipi:
replicaCount

integer

Facoltativo. Il numero di nodi di replica per shard.

Campo unione _size_gb.

_size_gb può essere solo uno dei seguenti tipi:
sizeGb

integer

Solo output. Dimensioni della memoria Redis in GB per l'intero cluster arrotondate all'intero successivo.

Campo unione _shard_count.

_shard_count può essere solo uno dei seguenti tipi:
shardCount

integer

Facoltativo. Numero di shard per il cluster Redis.

Campo unione _precise_size_gb.

_precise_size_gb può essere solo uno dei seguenti tipi:
preciseSizeGb

number

Solo output. Valore esatto delle dimensioni della memoria Redis in GB per l'intero cluster.

Campo unione _deletion_protection_enabled.

_deletion_protection_enabled può essere solo uno dei seguenti tipi:
deletionProtectionEnabled

boolean

Facoltativo. L'operazione di eliminazione non riuscirà quando il valore è impostato su true.

Campo unione _maintenance_policy.

_maintenance_policy può essere solo uno dei seguenti tipi:
maintenancePolicy

object (ClusterMaintenancePolicy)

Facoltativo. ClusterMaintenancePolicy determina quando consentire o negare gli aggiornamenti.

Campo unione _maintenance_schedule.

_maintenance_schedule può essere solo uno dei seguenti tipi:
maintenanceSchedule

object (ClusterMaintenanceSchedule)

Solo output. ClusterMaintenanceSchedule Solo output Programma di manutenzione pubblicato.

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 _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 _backup_collection.

_backup_collection può essere solo uno dei seguenti tipi:
backupCollection

string

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

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

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

boolean

Facoltativo. Solo input. Manutenzione on demand per il cluster. Questo campo può essere utilizzato per attivare l'aggiornamento critico on demand sul cluster.

Campo unione _async_cluster_endpoints_deletion_enabled.

_async_cluster_endpoints_deletion_enabled può essere solo uno dei seguenti tipi:
asyncClusterEndpointsDeletionEnabled

boolean

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

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 del cluster.

Campo unione _server_ca_mode.

_server_ca_mode può essere solo uno dei seguenti tipi:
serverCaMode

enum (ServerCaMode)

Facoltativo. Modalità CA server per il cluster.

Campo unione _server_ca_pool.

_server_ca_pool può essere solo uno dei seguenti tipi:
serverCaPool

string

Facoltativo. Pool di CA gestito dal cliente per il cluster. Applicabile solo per BYOCA, ovvero se server_ca_mode è SERVER_CA_MODE_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_in_sync.

_acl_policy_in_sync può essere solo uno dei seguenti tipi:
aclPolicyInSync

boolean

Facoltativo. Solo output. Indica se le regole ACL applicate al cluster sono sincronizzate con le regole dei criteri ACL più recenti. Questo campo è applicabile solo se il criterio ACL è impostato per il cluster.

GcsBackupSource

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

string

Facoltativo. URI degli oggetti Cloud Storage da importare. Esempio: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Rappresentazione JSON 
{
  "backup": string
}
Campi
backup

string

Facoltativo. Esempio: //redis.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 redis.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.

PscConfig

Rappresentazione JSON 
{
  "network": string
}
Campi
network

string

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

DiscoveryEndpoint

Rappresentazione JSON 
{
  "address": string,
  "port": integer,
  "pscConfig": {
    object (PscConfig)
  }
}
Campi
address

string

Solo output. Indirizzo dell'endpoint Redis esposto utilizzato dai client per connettersi al servizio. L'indirizzo può essere un indirizzo IP o un nome host.
port

integer

Solo output. Il numero di porta dell'endpoint Redis esposto.
pscConfig

object (PscConfig)

Solo output. Configurazione del cliente per la posizione da cui viene creato e a cui si accede all'endpoint.

PscConnection

Rappresentazione JSON 
{
  "pscConnectionId": string,
  "address": 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.
address

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. Esempio: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.
projectId

string

Facoltativo. ID progetto del progetto consumer in 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. Tieni presente che questo valore viene aggiornato periodicamente. Per ottenere lo stato più recente di una connessione PSC, segui la procedura descritta in https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.
connectionType

enum (ConnectionType)

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

integer

Solo output. La porta verrà impostata solo per l'endpoint primario/lettore o di rilevamento.

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)

Descrive l'aggiornamento in corso del cluster quando lo stato del cluster è 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_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

Numero di shard di destinazione per il cluster Redis

Campo unione _target_replica_count.

_target_replica_count può essere solo uno dei seguenti tipi:
targetReplicaCount

integer

Numero target di nodi di replica per shard.

Campo unione _target_node_type.

_target_node_type può essere solo uno dei seguenti tipi:
targetNodeType

enum (NodeType)

Tipo di nodo di destinazione per il cluster Redis.

ClusterPersistenceConfig

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

enum (PersistenceMode)

Facoltativo. La modalità di persistenza.
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. L'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) Configurazione fsync.

RedisConfigsEntry

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

string
value

string

ZoneDistributionConfig

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

enum (ZoneDistributionMode)

Facoltativo. La modalità di distribuzione delle zone. Se non specificato, il valore predefinito è MULTI_ZONE.
zone

string

Facoltativo. Quando viene selezionata la distribuzione SINGLE ZONE, il campo della zona viene utilizzato per allocare tutte le risorse in quella zona. Questo non è applicabile a MULTI_ZONE e verrà ignorato per i cluster MULTI_ZONE.

CrossClusterReplicationConfig

Rappresentazione JSON 
{
  "clusterRole": enum (ClusterRole),
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
Campi
clusterRole

enum (ClusterRole)

Solo output. Il ruolo del cluster nella replica cross-cluster.
primaryCluster

object (RemoteCluster)

Dettagli del cluster primario utilizzato come origine di replica per questo cluster secondario.

Questo campo è impostato solo per un cluster secondario.
secondaryClusters[]

object (RemoteCluster)

Elenco dei cluster secondari che eseguono la replica da questo cluster primario.

Questo campo è impostato solo per un cluster primario.
updateTime

string (Timestamp format)

Solo output. L'ultima volta che è stata aggiornata la configurazione della replica cross-cluster.

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 tutti i cluster membri che partecipano alla replica cross-cluster. Questa visualizzazione verrà fornita da ogni cluster membro indipendentemente dal suo ruolo(primario o secondario).

Un cluster primario può fornire informazioni su tutti i cluster secondari che lo replicano. Tuttavia, un cluster secondario conosce solo il cluster primario da cui esegue la replica. Tuttavia, per gli scenari in cui il cluster primario non è disponibile(ad es. interruzione regionale), è possibile inviare una richiesta GetCluster a qualsiasi altro cluster membro e questo campo elencherà tutti i cluster membri che partecipano alla replica tra cluster.

RemoteCluster

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

string

Solo output. Il percorso completo della risorsa del cluster remoto nel formato: projects//locations//clusters/
uid

string

Solo output. L'identificatore univoco del cluster remoto.

Appartenenza

Rappresentazione JSON 
{
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ]
}
Campi
primaryCluster

object (RemoteCluster)

Solo output. Il cluster primario che funge da origine della replica per i cluster secondari.
secondaryClusters[]

object (RemoteCluster)

Solo output. L'elenco dei cluster secondari che eseguono la replica dal cluster primario.

ClusterMaintenancePolicy

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

string (Timestamp format)

Solo output. L'ora in cui è stata creata la policy, ovvero è stato assegnato il periodo di manutenzione o il periodo in cui evitare la manutenzione.

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, ad esempio il periodo di manutenzione o il periodo di divieto.

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 (ClusterWeeklyMaintenanceWindow)

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

ClusterWeeklyMaintenanceWindow

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.

ClusterMaintenanceSchedule

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

PscServiceAttachment

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

string

Solo output. URI del collegamento al servizio che la PscConnection creata autonomamente deve utilizzare come destinazione
connectionType

enum (ConnectionType)

Solo output. Tipo di connessione PSC che ha come target questo collegamento del servizio.

ClusterEndpoint

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

object (ConnectionDetail)

Obbligatorio. 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 cluster può essere creata tramite l'automazione della connettività di servizio (connessione registrata automaticamente) durante la creazione del cluster oppure può essere creata direttamente dal cliente (connessione registrata dall'utente). connection può essere solo uno dei seguenti tipi:
pscAutoConnection

object (PscAutoConnection)

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

object (PscConnection)

Informazioni dettagliate su una connessione PSC creata dal cliente proprietario del cluster.

PscAutoConnection

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

string

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

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. Esempio: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.
projectId

string

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

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

AutomatedBackupConfig

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

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

  // Union field _retention can be only one of the following:
  "retention": string
  // End of list of possible types for union field _retention.
}
Campi
automatedBackupMode

enum (AutomatedBackupMode)

Facoltativo. La modalità di backup automatico. Se la modalità è disattivata, gli altri campi verranno ignorati.
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.

Campo unione _retention.

_retention può essere solo uno dei seguenti tipi:
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".

FixedFrequencySchedule

Rappresentazione JSON 
{

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

Campo unione _start_time.

_start_time può essere solo uno dei seguenti tipi:
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.

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

LabelsEntry

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

string
value

string

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

{

createTime: l'ora in cui è stata creata l'operazione.

endTime: l'ora in cui è terminata l'esecuzione dell'operazione.

target: il percorso della risorsa definito dal server per la destinazione dell'operazione.

verb: il nome del verbo eseguito dall'operazione.

statusDetail: lo stato dell'operazione leggibile, se presente.

cancelRequested: indica se l'utente ha richiesto l'annullamento dell'operazione. Le operazioni annullate correttamente hanno un valore Operation.error con un google.rpc.Status.code pari a 1, corrispondente a Code.CANCELLED.

apiVersion: versione dell'API utilizzata per avviare l'operazione.

}

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: ❌