REST Resource: projects.locations.instances

Resource: Instance

Instance Memorystore.

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

string

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

createTime

string (Timestamp format)

Hanya output. Stempel waktu pembuatan instance.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu update terbaru instance.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

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 saat transit untuk instance.

shardCount

integer

Wajib. Jumlah shard untuk instance.

discoveryEndpoints[]

object (DiscoveryEndpoint)

Hanya output. Endpoint yang dapat digunakan klien untuk terhubung ke instance. Saat ini, hanya satu endpoint penemuan yang didukung.

nodeType

enum (NodeType)

Opsional. Tidak dapat diubah. Jenis mesin untuk setiap node instance.

persistenceConfig

object (PersistenceConfig)

Opsional. Konfigurasi persistensi instance.

engineVersion

string

Opsional. Tidak dapat diubah. 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 setiap node instance.

zoneDistributionConfig

object (ZoneDistributionConfig)

Opsional. Tidak dapat diubah. Konfigurasi distribusi zona instance untuk alokasi node.

pscAutoConnections[]

object (PscAutoConnection)

Wajib. Tidak dapat diubah. Input pengguna dan detail resource koneksi PSC yang dibuat otomatis.

replicaCount

integer

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

deletionProtectionEnabled

boolean

Opsional. Jika disetel ke true, penghapusan instance akan gagal.

Status

Kemungkinan status instance.

Enum
STATE_UNSPECIFIED Belum ditetapkan.
CREATING Instance sedang dibuat.
ACTIVE Instance telah dibuat dan dapat digunakan.
UPDATING Instance sedang diupdate.
DELETING Instance sedang dihapus.

StateInfo

Informasi tambahan tentang status instance.

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

Menampilkan informasi tentang instance dengan status UPDATING.

Representasi JSON
{
  "targetShardCount": integer,
  "targetReplicaCount": integer
}
Kolom
targetShardCount

integer

Hanya output. Jumlah target shard untuk instance.

targetReplicaCount

integer

Hanya output. Target jumlah node replika per shard untuk instance.

AuthorizationMode

Kemungkinan mode otorisasi instance.

Enum
AUTHORIZATION_MODE_UNSPECIFIED Belum ditetapkan.
AUTH_DISABLED Otorisasi dinonaktifkan.
IAM_AUTH Otorisasi dasar IAM.

TransitEncryptionMode

Kemungkinan mode enkripsi dalam pengiriman instance.

Enum
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED Belum ditetapkan.
TRANSIT_ENCRYPTION_DISABLED Enkripsi saat transit dinonaktifkan.
SERVER_AUTHENTICATION Enkripsi yang dikelola server digunakan untuk enkripsi saat proses pengiriman.

DiscoveryEndpoint

Merepresentasikan endpoint bagi klien untuk terhubung ke instance.

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

string

Hanya output. Alamat IP endpoint yang diekspos yang 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/{networkProject}/global/networks/{network_id}.

NodeType

Kemungkinan jenis node instance. Lihat https://cloud.google.com/memorystore/docs/valkey/instance-node-specification untuk mengetahui informasi selengkapnya.

Enum
NODE_TYPE_UNSPECIFIED Belum ditetapkan.
SHARED_CORE_NANO Nano inti bersama.
HIGHMEM_MEDIUM Media memori tinggi.
HIGHMEM_XLARGE Memori tinggi ekstra besar.
STANDARD_SMALL Standar kecil.

PersistenceConfig

Merepresentasikan konfigurasi persistensi untuk instance.

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 modenya bukan RDB.

aofConfig

object (AOFConfig)

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

PersistenceMode

Kemungkinan mode persistensi.

Enum
PERSISTENCE_MODE_UNSPECIFIED Belum ditetapkan.
DISABLED Persistensi dinonaktifkan, dan semua data snapshot akan dihapus.
RDB Persistensi berbasis RDB diaktifkan.
AOF Persistensi berbasis AOF diaktifkan.

RDBConfig

Konfigurasi untuk persistensi berbasis RDB.

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

enum (SnapshotPeriod)

Opsional. Periode antara snapshot RDB.

rdbSnapshotStartTime

string (Timestamp format)

Opsional. Waktu snapshot pertama telah/akan dicoba, dan waktu snapshot mendatang akan disesuaikan. Jika tidak diberikan, waktu saat ini akan digunakan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

SnapshotPeriod

Kemungkinan periode snapshot.

Enum
SNAPSHOT_PERIOD_UNSPECIFIED Belum ditetapkan.
ONE_HOUR Satu jam.
SIX_HOURS Enam jam.
TWELVE_HOURS Dua belas jam.
TWENTY_FOUR_HOURS Dua puluh empat jam.

AOFConfig

Konfigurasi untuk persistensi berbasis AOF.

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

enum (AppendFsync)

Opsional. Mode fsync.

AppendFsync

Kemungkinan mode fsync.

Enum
APPEND_FSYNC_UNSPECIFIED Belum ditetapkan. Default: EVERY_SEC
NEVER Jangan pernah fsync. Biasanya, Linux akan menghapus data setiap 30 detik dengan konfigurasi ini, tetapi hal ini bergantung pada penyesuaian kernel yang tepat.
EVERY_SEC Fsync setiap detik. Anda mungkin kehilangan data selama 1 detik jika terjadi bencana.
ALWAYS Fsync setiap kali perintah tulis baru ditambahkan ke AOF. Perlindungan terbaik terhadap kehilangan data dengan mengorbankan performa.

NodeConfig

Merepresentasikan konfigurasi untuk node instance.

Representasi JSON
{
  "sizeGb": number
}
Kolom
sizeGb

number

Hanya output. Ukuran memori dalam GB node.

ZoneDistributionConfig

Konfigurasi distribusi zona untuk alokasi resource instance.

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. Defaultnya adalah MULTI_ZONE.

ZoneDistributionMode

Kemungkinan mode distribusi zona.

Enum
ZONE_DISTRIBUTION_MODE_UNSPECIFIED Belum Ditetapkan. Default: MULTI_ZONE
MULTI_ZONE Mendistribusikan resource ke 3 zona yang dipilih secara acak dalam region.
SINGLE_ZONE Menyediakan resource di satu zona. Kolom zona harus ditentukan.

PscAutoConnection

Detail resource konsumen dalam koneksi PSC.

Representasi JSON
{
  "pscConnectionId": string,
  "ipAddress": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string
}
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/{forwardingRule}

projectId

string

Wajib. projectId konsumen tempat aturan penerusan dibuat.

network

string

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

Metode

create

Membuat Instance baru di project dan lokasi tertentu.

delete

Menghapus satu Instance.

get

Mendapatkan detail satu Instance.

getCertificateAuthority

Mendapatkan detail tentang certificate authority untuk Instance.

list

Mencantumkan Instance di project dan lokasi tertentu.

patch

Memperbarui parameter satu Instance.