MCP Tools Reference: memorystore.googleapis.com

Alat: update_instance

Memperbarui instance Memorystore for Valkey.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP update_instance.

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

Skema Input

Pesan permintaan untuk UpdateInstance.

UpdateInstanceRequest

Representasi JSON 
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "requestId": string
}
Kolom
updateMask

string (FieldMask format)

Opsional. Daftar kolom yang akan diperbarui di instance. Setidaknya satu kolom harus ditentukan.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
instance

object (Instance)

Wajib. Instance yang akan diupdate.
requestId

string

Opsional. ID permintaan opsional untuk mengidentifikasi permintaan. Tentukan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan tahu untuk mengabaikan permintaan jika sudah selesai. Server akan menjamin hal tersebut setidaknya selama 60 menit sejak permintaan pertama.

Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama telah diterima, dan jika iya, akan mengabaikan permintaan kedua. Tindakan ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid, kecuali UUID nol tidak didukung (00000000-0000-0000-0000-000000000000).

FieldMask

Representasi JSON 
{
  "paths": [
    string
  ]
}
Kolom
paths[]

string

Kumpulan jalur mask kolom.

Instance

Representasi 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.
}
Kolom
name

string

ID. Nama unik instance. Format: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

Hanya output. Stempel waktu pembuatan instance.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Stempel waktu update terbaru instance.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Opsional. Label untuk merepresentasikan metadata yang disediakan pengguna.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (State)

Hanya output. Status instance saat ini.
stateInfo

object (StateInfo)

Hanya output. Informasi tambahan tentang status instance.
uid

string

Hanya output. ID unik yang ditetapkan sistem untuk instance.
authorizationMode

enum (AuthorizationMode)

Opsional. Tidak dapat diubah. Mode otorisasi instance.
transitEncryptionMode

enum (TransitEncryptionMode)

Opsional. Tidak dapat diubah. Mode enkripsi dalam pengiriman instance.
shardCount

integer

Opsional. Jumlah shard untuk instance.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

Hanya output. Tidak digunakan lagi: Parameter discovery_endpoints tidak digunakan lagi. Akibatnya, kolom ini tidak akan diisi jika koneksi dibuat menggunakan parameter endpoint. Sebagai pengganti parameter ini, untuk penemuan, gunakan endpoints.connections.pscConnection dan endpoints.connections.pscAutoConnection dengan connectionType CONNECTION_TYPE_DISCOVERY.
nodeType

enum (NodeType)

Opsional. Jenis mesin untuk setiap node instance.
persistenceConfig

object (PersistenceConfig)

Opsional. Konfigurasi persistensi instance.
engineVersion

string

Opsional. Versi mesin instance.
engineConfigs

map (key: string, value: string)

Opsional. Konfigurasi mesin yang disediakan pengguna untuk instance.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
nodeConfig

object (NodeConfig)

Hanya output. Konfigurasi node individual instance.
zoneDistributionConfig

object (ZoneDistributionConfig)

Opsional. Tidak dapat diubah. Konfigurasi distribusi zona instance untuk alokasi node.
pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

Opsional. Tidak dapat diubah. Tidak digunakan lagi: Gunakan nilai endpoints.connections.psc_auto_connection sebagai gantinya.
pscAttachmentDetails[]

object (PscAttachmentDetail)

Hanya output. Detail lampiran layanan untuk mengonfigurasi koneksi PSC.
endpoints[]

object (InstanceEndpoint)

Opsional. Endpoint untuk instance.
mode

enum (Mode)

Opsional. Konfigurasi mode untuk instance.
maintenancePolicy

object (MaintenancePolicy)

Opsional. Kebijakan pemeliharaan untuk instance. Jika tidak diberikan, peristiwa pemeliharaan akan dilakukan berdasarkan jadwal peluncuran internal Memorystore.
maintenanceSchedule

object (MaintenanceSchedule)

Hanya output. Jadwal pemeliharaan yang dipublikasikan.
crossInstanceReplicationConfig

object (CrossInstanceReplicationConfig)

Opsional. Konfigurasi untuk replikasi lintas instance.
encryptionInfo

object (EncryptionInfo)

Hanya output. Informasi enkripsi data dalam penyimpanan cluster.
automatedBackupConfig

object (AutomatedBackupConfig)

Opsional. Konfigurasi pencadangan otomatis untuk instance.
availableMaintenanceVersions[]

string

Hanya output. Kolom ini digunakan untuk menentukan versi pemeliharaan yang tersedia untuk update layanan mandiri.
allowFewerZonesDeployment
(deprecated)

boolean

Opsional. Tidak dapat diubah. Tidak digunakan lagi, jangan gunakan.
migrationConfig

object (MigrationConfig)

Hanya output. Konfigurasi migrasi untuk instance.
Kolom union import_sources. Sumber yang akan diimpor. import_sources hanya ada berupa salah satu diantara berikut:
gcsSource

object (GcsBackupSource)

Opsional. Tidak dapat diubah. Cadangan yang disimpan di bucket Cloud Storage. Bucket Cloud Storage harus berada di region yang sama dengan instance. Izin baca diperlukan untuk mengimpor dari Objek Cloud Storage yang disediakan.
managedBackupSource

object (ManagedBackupSource)

Opsional. Tidak dapat diubah. Pencadangan yang dibuat dan dikelola oleh layanan Memorystore.

Kolom union _replica_count.

_replica_count hanya dapat berupa salah satu dari hal berikut:
replicaCount

integer

Opsional. Jumlah node replika per shard. Jika dihilangkan, defaultnya adalah 0 replika.

Kolom union _deletion_protection_enabled.

_deletion_protection_enabled hanya dapat berupa salah satu dari hal berikut:
deletionProtectionEnabled

boolean

Opsional. Jika disetel ke benar (true), penghapusan instance akan gagal.

Kolom union _simulate_maintenance_event.

_simulate_maintenance_event hanya dapat berupa salah satu dari hal berikut:
simulateMaintenanceEvent

boolean

Opsional. Hanya input. Simulasikan peristiwa pemeliharaan.

Kolom union _ondemand_maintenance.

_ondemand_maintenance hanya dapat berupa salah satu dari hal berikut:
ondemandMaintenance
(deprecated)

boolean

Opsional. Hanya input. Pemeliharaan sesuai permintaan untuk instance.

Kolom union _satisfies_pzs.

_satisfies_pzs hanya dapat berupa salah satu dari hal berikut:
satisfiesPzs

boolean

Opsional. Hanya output. Dipesan untuk penggunaan di masa mendatang.

Kolom union _satisfies_pzi.

_satisfies_pzi hanya dapat berupa salah satu dari hal berikut:
satisfiesPzi

boolean

Opsional. Hanya output. Dipesan untuk penggunaan di masa mendatang.

Kolom union _async_instance_endpoints_deletion_enabled.

_async_instance_endpoints_deletion_enabled hanya dapat berupa salah satu dari hal berikut:
asyncInstanceEndpointsDeletionEnabled

boolean

Opsional. Jika benar, endpoint instance yang dibuat dan didaftarkan oleh pelanggan dapat dihapus secara asinkron. Artinya, endpoint instance tersebut dapat dibatalkan pendaftarannya sebelum aturan penerusan di endpoint instance dihapus.

Kolom union _kms_key.

_kms_key hanya dapat berupa salah satu dari hal berikut:
kmsKey

string

Opsional. Kunci KMS yang digunakan untuk mengenkripsi data dalam penyimpanan cluster.

Kolom union _backup_collection.

_backup_collection hanya dapat berupa salah satu dari hal berikut:
backupCollection

string

Hanya output. Nama lengkap resource koleksi cadangan. Contoh: projects/{project}/locations/{location}/backupCollections/{collection}

Kolom union _maintenance_version.

_maintenance_version hanya dapat berupa salah satu dari hal berikut:
maintenanceVersion

string

Opsional. Kolom ini dapat digunakan untuk memicu update layanan mandiri guna menunjukkan versi pemeliharaan yang diinginkan. Input ke kolom ini dapat ditentukan oleh kolom available_maintenance_versions.

Kolom union _effective_maintenance_version.

_effective_maintenance_version hanya dapat berupa salah satu dari hal berikut:
effectiveMaintenanceVersion

string

Hanya output. Kolom ini merepresentasikan versi pemeliharaan sebenarnya dari instance.

Kolom union _server_ca_mode.

_server_ca_mode hanya dapat berupa salah satu dari hal berikut:
serverCaMode

enum (ServerCaMode)

Opsional. Tidak dapat diubah. Mode CA Server untuk instance.

Kolom union _server_ca_pool.

_server_ca_pool hanya dapat berupa salah satu dari hal berikut:
serverCaPool

string

Opsional. Tidak dapat diubah. Kumpulan CA yang dikelola pelanggan untuk instance. Hanya berlaku jika mode CA Server adalah CUSTOMER_MANAGED_CAS_CA. Format: "projects/{project}/locations/{region}/caPools/{ca_pool}".

Kolom union _rotate_server_certificate.

_rotate_server_certificate hanya dapat berupa salah satu dari hal berikut:
rotateServerCertificate

boolean

Opsional. Hanya input. Rotasi sertifikat server.

Kolom union _acl_policy.

_acl_policy hanya dapat berupa salah satu dari hal berikut:
aclPolicy

string

Opsional. Kebijakan ACL untuk instance. Format: projects/{project}/locations/{location}/aclPolicies/{acl_policy}

Kolom union _acl_policy_in_sync.

_acl_policy_in_sync hanya dapat berupa salah satu dari hal berikut:
aclPolicyInSync

boolean

Hanya output. Apakah aturan ACL yang diterapkan ke instance disinkronkan dengan aturan kebijakan ACL terbaru. Kolom ini hanya berlaku jika kebijakan ACL ditetapkan untuk instance.

GcsBackupSource

Representasi JSON 
{
  "uris": [
    string
  ]
}
Kolom
uris[]

string

Opsional. Contoh: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Representasi JSON 
{
  "backup": string
}
Kolom
backup

string

Opsional. Contoh: //memorystore.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} Versi yang lebih pendek (tanpa awalan) dari nama cadangan juga didukung, seperti projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup_id} Dalam hal ini, diasumsikan bahwa cadangan berada di memorystore.googleapis.com.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

LabelsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

StateInfo

Representasi JSON 
{

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

Kolom union info.

info hanya dapat berupa salah satu dari hal berikut:
updateInfo

object (UpdateInfo)

Hanya output. Menjelaskan update yang sedang berlangsung saat status instance adalah UPDATING.

UpdateInfo

Representasi 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.
}
Kolom

Kolom union _target_shard_count.

_target_shard_count hanya dapat berupa salah satu dari hal berikut:
targetShardCount

integer

Hanya output. Jumlah target shard untuk instance.

Kolom union _target_replica_count.

_target_replica_count hanya dapat berupa salah satu dari hal berikut:
targetReplicaCount

integer

Hanya output. Jumlah target node replika per shard untuk instance.

Kolom union _target_engine_version.

_target_engine_version hanya dapat berupa salah satu dari hal berikut:
targetEngineVersion

string

Hanya output. Versi mesin target untuk instance.

Kolom union _target_node_type.

_target_node_type hanya dapat berupa salah satu dari hal berikut:
targetNodeType

enum (NodeType)

Hanya output. Jenis node target untuk instance.

DiscoveryEndpoint

Representasi JSON 
{
  "address": string,
  "port": integer,
  "network": string
}
Kolom
address

string

Hanya output. Alamat IP endpoint yang diekspos dan terhubung ke klien.
port

integer

Hanya output. Nomor port endpoint yang diekspos.
network

string

Hanya output. Jaringan tempat alamat IP endpoint penemuan akan dicadangkan, dalam bentuk projects/{network_project}/global/networks/{network_id}.

PersistenceConfig

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

enum (PersistenceMode)

Opsional. Mode persistensi saat ini.
rdbConfig

object (RDBConfig)

Opsional. Konfigurasi RDB. Kolom ini akan diabaikan jika mode bukan RDB.
aofConfig

object (AOFConfig)

Opsional. Konfigurasi AOF. Kolom ini akan diabaikan jika mode bukan AOF.

RDBConfig

Representasi JSON 
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
Kolom
rdbSnapshotPeriod

enum (SnapshotPeriod)

Opsional. Periode antara snapshot RDB.
rdbSnapshotStartTime

string (Timestamp format)

Opsional. Waktu saat snapshot pertama dicoba/akan dicoba, dan snapshot masa depan akan diselaraskan dengan snapshot ini. Jika tidak diberikan, waktu saat ini akan digunakan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

AOFConfig

Representasi JSON 
{
  "appendFsync": enum (AppendFsync)
}
Kolom
appendFsync

enum (AppendFsync)

Opsional. Mode fsync.

EngineConfigsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

NodeConfig

Representasi JSON 
{
  "sizeGb": number
}
Kolom
sizeGb

number

Hanya output. Ukuran memori node dalam GB.

ZoneDistributionConfig

Representasi JSON 
{
  "zone": string,
  "mode": enum (ZoneDistributionMode)
}
Kolom
zone

string

Opsional. Menentukan zona tempat semua resource akan dialokasikan dengan mode SINGLE_ZONE. Diabaikan untuk mode MULTI_ZONE.
mode

enum (ZoneDistributionMode)

Opsional. Mode distribusi zona saat ini. Default-nya adalah MULTI_ZONE.

PscAutoConnection

Representasi 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.
}
Kolom
pscConnectionId

string

Hanya output. ID koneksi PSC dari aturan penerusan yang terhubung ke lampiran layanan.
ipAddress

string

Hanya output. IP yang dialokasikan di jaringan konsumen untuk aturan penerusan PSC.
forwardingRule

string

Hanya output. URI aturan penerusan sisi konsumen. Format: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
projectId

string

Wajib. project_id konsumen tempat koneksi PSC dibuat. Ini harus berupa project_id yang sama dengan project tempat instance dibuat.
network

string

Wajib. Jaringan tempat endpoint PSC dibuat, dalam bentuk projects/{project_id}/global/networks/{network_id}.
serviceAttachment

string

Hanya output. Lampiran layanan yang menjadi target koneksi PSC, dalam bentuk projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Hanya output. Status koneksi PSC: apakah koneksi ada dan AKTIF atau tidak lagi ada. Perlu diketahui bahwa nilai ini diperbarui secara berkala. Gunakan Private Service Connect API untuk mengetahui status terbaru.
connectionType

enum (ConnectionType)

Hanya output. Jenis koneksi PSC.
Kolom union ports. Port endpoint yang diekspos. ports hanya ada berupa salah satu diantara berikut:
port

integer

Opsional. Port hanya akan ditetapkan untuk endpoint Primary/Reader atau Discovery.

PscAttachmentDetail

Representasi JSON 
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
Kolom
serviceAttachment

string

Hanya output. URI lampiran layanan yang harus digunakan PscConnection yang Anda buat sendiri sebagai target.
connectionType

enum (ConnectionType)

Hanya output. Jenis endpoint PSC.

InstanceEndpoint

Representasi JSON 
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
Kolom
connections[]

object (ConnectionDetail)

Opsional. Grup koneksi PSC. Load balancer dibuat di jaringan VPC yang sama, satu untuk setiap lampiran layanan di cluster.

ConnectionDetail

Representasi 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.
}
Kolom
Kolom union connection. Koneksi PSC ke instance dapat dibuat melalui Otomatisasi Konektivitas Layanan (koneksi otomatis) selama pembuatan cluster, atau dapat dibuat oleh pelanggan sendiri (koneksi yang dibuat pengguna). connection hanya ada berupa salah satu diantara berikut:
pscAutoConnection

object (PscAutoConnection)

Tidak dapat diubah. Informasi mendetail tentang koneksi PSC yang dibuat melalui otomatisasi konektivitas layanan.
pscConnection

object (PscConnection)

Informasi mendetail tentang koneksi PSC yang dibuat oleh pengguna.

PscConnection

Representasi 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.
}
Kolom
pscConnectionId

string

Wajib. ID koneksi PSC dari aturan penerusan yang terhubung ke lampiran layanan.
ipAddress

string

Wajib. IP yang dialokasikan di jaringan konsumen untuk aturan penerusan PSC.
forwardingRule

string

Wajib. URI aturan penerusan sisi konsumen. Format: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
projectId

string

Hanya output. project_id konsumen tempat aturan penerusan dibuat.
network

string

Wajib. Jaringan konsumen tempat alamat IP berada, dalam bentuk projects/{project_id}/global/networks/{network_id}.
serviceAttachment

string

Wajib. Lampiran layanan yang menjadi target koneksi PSC, dalam bentuk projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
pscConnectionStatus

enum (PscConnectionStatus)

Hanya output. Status koneksi PSC: apakah koneksi ada dan AKTIF atau tidak lagi ada. Perlu diketahui bahwa nilai ini diperbarui secara berkala. Gunakan Private Service Connect API untuk mengetahui status terbaru.
connectionType

enum (ConnectionType)

Hanya output. Jenis koneksi PSC.
Kolom union ports. Port endpoint yang diekspos. ports hanya ada berupa salah satu diantara berikut:
port

integer

Opsional. Port hanya akan ditetapkan untuk endpoint Primary/Reader atau Discovery.

MaintenancePolicy

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

string (Timestamp format)

Hanya output. Waktu saat kebijakan dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu saat kebijakan diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Opsional. Periode pemeliharaan yang diterapkan pada resource yang tercakup dalam kebijakan ini. Minimum 1. Untuk versi saat ini, jumlah maksimum weekly_window adalah satu.

WeeklyMaintenanceWindow

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

enum (google.type.DayOfWeek)

Opsional. Memungkinkan untuk menentukan jadwal yang berjalan pada hari tertentu dalam seminggu.
startTime

object (TimeOfDay)

Opsional. Waktu mulai jendela dalam UTC.

TimeOfDay

Representasi JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Kolom
hours

integer

Jam dalam format 24 jam. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam satu jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59.
seconds

integer

Detik dalam satu menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999.

MaintenanceSchedule

Representasi JSON 
{
  "startTime": string,
  "endTime": string
}
Kolom
startTime

string (Timestamp format)

Hanya output. Waktu mulai pemeliharaan terjadwal yang akan datang untuk instance ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Hanya output. Waktu berakhir dari pemeliharaan terjadwal yang akan datang untuk instance ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

CrossInstanceReplicationConfig

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

enum (InstanceRole)

Wajib. Peran instance dalam replikasi antar-instance.
primaryInstance

object (RemoteInstance)

Opsional. Detail instance utama yang digunakan sebagai sumber replikasi untuk instance sekunder ini.

Kolom ini hanya ditetapkan untuk instance sekunder.
secondaryInstances[]

object (RemoteInstance)

Opsional. Daftar instance sekunder yang mereplikasi dari instance utama ini.

Kolom ini hanya ditetapkan untuk instance utama.
updateTime

string (Timestamp format)

Hanya output. Terakhir kali konfigurasi replikasi lintas instance diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
membership

object (Membership)

Hanya output. Tampilan hanya output dari semua instance anggota yang berpartisipasi dalam replikasi lintas instance. Tampilan ini akan disediakan oleh setiap instance anggota, terlepas dari peran instancenya(primer atau sekunder).

Instance utama dapat memberikan informasi tentang semua instance sekunder yang mereplikasi dari instance utama. Namun, instance sekunder hanya mengetahui instance utama tempatnya mereplikasi. Namun, untuk skenario saat instance utama tidak tersedia(misalnya, pemadaman layanan regional), permintaan Getinstance dapat dikirim ke instance anggota lain dan kolom ini akan mencantumkan semua instance anggota yang berpartisipasi dalam replikasi lintas instance.

RemoteInstance

Representasi JSON 
{
  "instance": string,
  "uid": string
}
Kolom
instance

string

Opsional. Jalur resource lengkap instance jarak jauh dalam format: projects//locations//instances/
uid

string

Hanya output. ID unik instance jarak jauh.

Langganan

Representasi JSON 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
Kolom
primaryInstance

object (RemoteInstance)

Hanya output. Instance utama yang berfungsi sebagai sumber replikasi untuk instance sekunder.
secondaryInstances[]

object (RemoteInstance)

Hanya output. Daftar instance sekunder yang mereplikasi dari instance utama.

EncryptionInfo

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

enum (Type)

Hanya output. Jenis enkripsi.
kmsKeyVersions[]

string

Hanya output. Versi kunci KMS yang digunakan untuk melindungi data dalam penyimpanan.
kmsKeyPrimaryState

enum (KmsKeyState)

Hanya output. Status versi utama kunci KMS yang dirasakan oleh sistem. Kolom ini tidak diisi dalam cadangan.
lastUpdateTime

string (Timestamp format)

Hanya output. Waktu terakhir kali info enkripsi diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

AutomatedBackupConfig

Representasi 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.
}
Kolom
automatedBackupMode

enum (AutomatedBackupMode)

Opsional. Mode pencadangan otomatis. Jika mode dinonaktifkan, kolom lainnya akan diabaikan.
retention

string (Duration format)

Opsional. Durasi penyimpanan cadangan otomatis sebelum cadangan dihapus. Nilainya harus antara 1 hari dan 365 hari. Jika tidak ditentukan, nilai defaultnya adalah 35 hari.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
Kolom union schedule. Jadwal pencadangan otomatis. schedule hanya ada berupa salah satu diantara berikut:
fixedFrequencySchedule

object (FixedFrequencySchedule)

Opsional. Memicu pencadangan otomatis pada frekuensi tetap.

FixedFrequencySchedule

Representasi JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Kolom
startTime

object (TimeOfDay)

Wajib. Waktu mulai setiap pencadangan otomatis dalam UTC. Waktu harus disetel ke awal jam. Kolom ini wajib diisi.

Durasi

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/j * 24 j/hr * 365,25 hr/thn * 10.000 thn
nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

MigrationConfig

Representasi 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.
}
Kolom
state

enum (State)

Hanya output. Status migrasi instance.
forceFinishMigration

boolean

Hanya output. Mewakili tanda boolean untuk memaksa penyelesaian migrasi tanpa validasi penyesuaian offset antara sumber dan target sebelum menghentikan replikasi.
Kolom union source. Detail tentang sumber migrasi. source hanya ada berupa salah satu diantara berikut:
selfManagedSource

object (SelfManagedSource)

Hanya output. Konfigurasi untuk bermigrasi dari instance Valkey/Redis yang dikelola sendiri

SelfManagedSource

Representasi JSON 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
Kolom
ipAddress

string

Wajib. Alamat IP instance sumber. Alamat IP ini harus berupa alamat IP stabil yang dapat diakses oleh instance Memorystore selama proses migrasi.
port

integer

Wajib. Port instance sumber. Port ini harus berupa port stabil yang dapat diakses oleh instance Memorystore selama proses migrasi.
networkAttachment

string

Wajib. Nama resource Lampiran Jaringan Private Service Connect yang digunakan untuk membuat konektivitas ke instance sumber. Lampiran jaringan ini memiliki persyaratan berikut: 1. File ini harus berada dalam project yang sama dengan instance Memorystore. 2. Instance ini harus berada di region yang sama dengan instance Memorystore. 3. Subnet yang terpasang ke lampiran jaringan harus berada di jaringan VPC yang sama dengan node instance sumber.

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

Skema Output

Resource ini mewakili operasi yang berjalan lama yang merupakan hasil dari panggilan API jaringan.

Operasi

Representasi 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.
}
Kolom
name

string

Nama server yang ditetapkan, yang hanya bersifat unik dalam layanan yang sama yang awalnya menampilkannya. Jika Anda menggunakan pemetaan HTTP default, name harus berupa nama resource yang diakhiri dengan operations/{unique_id}.
metadata

object

Metadata khusus layanan yang terkait dengan operasi. Biasanya berisi informasi kemajuan dan metadata umum, seperti membuat waktu. Beberapa layanan mungkin tidak menyediakan metadata semacam itu. Setiap metode yang menampilkan operasi yang berjalan lama harus mendokumentasikan tipe metadata, jika ada.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.
done

boolean

Jika nilainya adalah false, artinya operasi masih berlangsung. Jika true, artinya operasi sudah selesai, dan error atau response tersedia.
Kolom union result. Hasil operasi, yang dapat berupa error atau response yang valid. Jika done == false, error atau response tidak ditetapkan. Jika done == true, hanya salah satu dari error atau response yang dapat ditetapkan. Beberapa layanan mungkin tidak memberikan hasil. result hanya dapat berupa salah satu dari berikut:
error

object (Status)

Hasil error operasi jika terjadi kegagalan atau pembatalan.
response

object

Respons normal dan berhasil dari operasi. Jika metode asli tidak menampilkan data saat berhasil, seperti Delete, responsnya adalah google.protobuf.Empty. Jika metode asli adalah Get/Create/Update standar, responsnya harus berupa resource. Untuk metode lain, respons harus memiliki jenis XxxResponse, dengan Xxx yang merupakan nama metode asli. Misalnya, jika nama metode asli adalah TakeSnapshot(), jenis respons yang disimpulkan adalah TakeSnapshotResponse.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Semua

Representasi JSON 
{
  "typeUrl": string,
  "value": string
}
Kolom
typeUrl

string

Mengidentifikasi jenis pesan Protobuf berserial dengan referensi URI yang terdiri dari awalan yang diakhiri dengan garis miring dan nama jenis yang sepenuhnya memenuhi syarat.

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

String ini harus berisi setidaknya satu karakter /, dan konten setelah / terakhir harus berupa nama yang sepenuhnya memenuhi syarat dari jenis dalam bentuk kanonis, tanpa titik di depannya. Jangan tulis skema pada referensi URI ini agar klien tidak mencoba menghubungi mereka.

Awalan bersifat arbitrer dan implementasi Protobuf diharapkan cukup menghapus semua yang ada hingga dan termasuk / terakhir untuk mengidentifikasi jenisnya. type.googleapis.com/ adalah awalan default umum yang diperlukan oleh beberapa penerapan lama. Awalan ini tidak menunjukkan asal jenis, dan URI yang memuatnya tidak diharapkan merespons permintaan apa pun.

Semua string URL jenis harus berupa referensi URI yang valid dengan batasan tambahan (untuk format teks) bahwa konten referensi hanya boleh terdiri dari karakter alfanumerik, escape yang dienkode persen, dan karakter dalam set berikut (tidak termasuk tanda petik terbalik luar): /-.~_!$&()*+,;=. Meskipun kami mengizinkan encoding persen, implementasi tidak boleh meng-unescape-nya untuk mencegah kebingungan dengan parser yang ada. Misalnya, type.googleapis.com%2FFoo harus ditolak.

Dalam desain asli Any, kemungkinan meluncurkan layanan penyelesaian jenis di URL jenis ini dipertimbangkan, tetapi Protobuf tidak pernah mengimplementasikannya dan menganggap menghubungi URL ini bermasalah dan berpotensi menimbulkan masalah keamanan. Jangan mencoba menghubungi URL jenis kontak.
value

string (bytes format)

Berisi serialisasi Protobuf dari jenis yang dijelaskan oleh type_url.

String berenkode base64.

Status

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

integer

Kode status, harus berupa nilai enum dari google.rpc.Code.
message

string

Pesan error yang ditampilkan ke developer dan seharusnya dalam bahasa Inggris. Setiap pesan error yang ditampilkan kepada pengguna harus dilokalkan dan dikirim di kolom google.rpc.Status.details, atau dilokalkan oleh klien.
details[]

object

Daftar pesan yang membawa detail error. Ada seperangkat jenis pesan umum untuk digunakan API.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌