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)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "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

Opsional. 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 engine 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.
endpoints[]

object (InstanceEndpoint)

Opsional. Endpoint untuk instance.
mode

enum (Mode)

Opsional. Konfigurasi mode untuk instance.
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.

Negara bagian/Provinsi

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. Setelan 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,
  "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/{forwardingRule}
projectId

string

Wajib. projectId konsumen tempat koneksi PSC dibuat. ProjectId ini harus sama dengan projectId tempat instance dibuat.
network

string

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

string

Hanya output. Lampiran layanan yang merupakan 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 ada lagi. Perhatikan 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. Hanya output. port hanya akan ditetapkan untuk endpoint Utama/Pembaca atau Discovery.

PscConnectionStatus

Status koneksi PSC.

Enum
PSC_CONNECTION_STATUS_UNSPECIFIED Status koneksi PSC tidak ditentukan.
ACTIVE Koneksi aktif
NOT_FOUND Koneksi tidak ditemukan

ConnectionType

Jenis koneksi PSC

Enum
CONNECTION_TYPE_UNSPECIFIED Jenis Koneksi tidak ditetapkan
CONNECTION_TYPE_DISCOVERY Koneksi yang akan digunakan untuk penemuan topologi.
CONNECTION_TYPE_PRIMARY Koneksi yang akan digunakan sebagai endpoint utama untuk mengakses utama.
CONNECTION_TYPE_READER Koneksi yang akan digunakan sebagai endpoint pembaca untuk mengakses replika.

InstanceEndpoint

InstanceEndpoint terdiri dari koneksi PSC yang dibuat sebagai grup di setiap jaringan VPC untuk mengakses instance. Di setiap grup, akan ada satu koneksi untuk setiap lampiran layanan di cluster.

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

object (ConnectionDetail)

Opsional. Sekelompok koneksi PSC. Keduanya dibuat di jaringan VPC yang sama, satu untuk setiap lampiran layanan di cluster.

ConnectionDetail

Informasi setiap koneksi PSC.

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 buatan pengguna). connection hanya ada berupa salah satu diantara berikut:
pscAutoConnection

object (PscAutoConnection)

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

object (PscConnection)

Informasi mendetail tentang koneksi PSC yang dibuat oleh pengguna.

PscConnection

Konfigurasi koneksi Psc yang dibuat pengguna.

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

string

Hanya output. 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/{forwardingRule}
projectId

string

Hanya output. projectId konsumen tempat aturan penerusan dibuat.
network

string

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

string

Wajib. Lampiran layanan yang merupakan 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 ada lagi. Perhatikan bahwa nilai ini diperbarui secara berkala. Gunakan Private Service Connect API untuk mengetahui status terbaru.
connectionType

enum (ConnectionType)

Hanya output. Jenis koneksi PSC.

Mode

Konfigurasi mode, yang digunakan untuk mengaktifkan/menonaktifkan mode cluster.

Enum
MODE_UNSPECIFIED Mode tidak ditentukan.
CLUSTER Instance dalam mode cluster.
CLUSTER_DISABLED Mode cluster dinonaktifkan untuk instance.

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.