REST Resource: projects.locations.instances

Resource: Instance

Instance Memorystore for Memcached

Representasi JSON
{
  "name": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "authorizedNetwork": string,
  "zones": [
    string
  ],
  "nodeCount": integer,
  "nodeConfig": {
    object (NodeConfig)
  },
  "memcacheVersion": enum (MemcacheVersion),
  "parameters": {
    object (MemcacheParameters)
  },
  "memcacheNodes": [
    {
      object (Node)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "memcacheFullVersion": string,
  "instanceMessages": [
    {
      object (InstanceMessage)
    }
  ],
  "discoveryEndpoint": string,
  "updateAvailable": boolean,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "reservedIpRangeId": [
    string
  ],
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean
}
Kolom
name

string

Wajib. Nama unik resource dalam cakupan ini, termasuk project dan lokasi, menggunakan formulir: projects/{projectId}/locations/{locationId}/instances/{instanceId}

Catatan: Instance Memcached dikelola dan diatasi di tingkat regional sehingga locationId di sini merujuk ke region Google Cloud; namun, pengguna dapat memilih zona tempat node Memcached harus disediakan dalam instance. Lihat kolom zones untuk mengetahui detail selengkapnya.

displayName

string

Nama yang diberikan pengguna untuk instance, yang hanya digunakan untuk tujuan tampilan. Tidak boleh lebih dari 80 karakter.

labels

map (key: string, value: string)

Label resource untuk merepresentasikan metadata yang disediakan pengguna. Lihat dokumentasi cloud tentang label untuk mengetahui detail selengkapnya. https://cloud.google.com/compute/docs/labeling-resources

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

authorizedNetwork

string

Nama lengkap jaringan Google Compute Engine yang terhubung ke instance. Jika tidak ditentukan, jaringan default akan digunakan.

zones[]

string

Zona tempat node Memcached harus disediakan. Node Memcached akan didistribusikan secara merata di seluruh zona ini. Jika tidak disediakan, layanan akan membuat node secara default di semua zona di region untuk instance.

nodeCount

integer

Wajib. Jumlah node dalam instance Memcached.

nodeConfig

object (NodeConfig)

Wajib. Konfigurasi untuk node Memcached.

memcacheVersion

enum (MemcacheVersion)

Versi utama software Memcached. Jika tidak disediakan, versi terbaru yang didukung akan digunakan. Saat ini, versi utama terbaru yang didukung adalah MEMCACHE_1_5. Versi minor akan ditentukan secara otomatis oleh sistem kami berdasarkan versi minor terbaru yang didukung.

parameters

object (MemcacheParameters)

Parameter yang ditentukan pengguna untuk diterapkan ke proses memcached di setiap node.

memcacheNodes[]

object (Node)

Hanya output. Daftar node Memcached. Lihat pesan Node untuk mengetahui detail selengkapnya.

createTime

string (Timestamp format)

Hanya output. Waktu pembuatan instance.

Menggunakan RFC 3339, dengan output yang dihasilkan 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 instance diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan 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".

state

enum (State)

Hanya output. Status instance Memcached ini.

memcacheFullVersion

string

Hanya output. Versi lengkap server memcached yang berjalan di instance ini. Sistem secara otomatis menentukan versi memcached lengkap untuk instance berdasarkan MemcacheVersion input. Format versi lengkapnya adalah "memcached-1.5.16".

instanceMessages[]

object (InstanceMessage)

Daftar pesan yang menjelaskan status instance Memcached saat ini.

discoveryEndpoint

string

Hanya output. Endpoint untuk Discovery API.

updateAvailable

boolean

Hanya output. Menampilkan benar (true) jika ada update yang menunggu untuk diterapkan

maintenancePolicy

object (MaintenancePolicy)

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.

reservedIpRangeId[]

string

Opsional. Berisi ID rentang alamat IP yang dialokasikan dan terkait dengan koneksi akses layanan pribadi, misalnya, "test-default" yang terkait dengan rentang IP 10.0.0.0/29.

satisfiesPzs

boolean

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

satisfiesPzi

boolean

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

NodeConfig

Konfigurasi untuk Node Memcached.

Representasi JSON
{
  "cpuCount": integer,
  "memorySizeMb": integer
}
Kolom
cpuCount

integer

Wajib. Jumlah CPU per node Memcached.

memorySizeMb

integer

Wajib. Ukuran memori dalam MiB untuk setiap node Memcached.

MemcacheVersion

Versi Memcached yang didukung oleh layanan kami.

Enum
MEMCACHE_VERSION_UNSPECIFIED Versi Memcache tidak ditentukan oleh pelanggan
MEMCACHE_1_5 Versi Memcached 1.5.
MEMCACHE_1_6_15 Versi Memcached 1.6.15.

MemcacheParameters

Representasi JSON
{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
Kolom
id

string

Hanya output. ID unik yang terkait dengan kumpulan parameter ini. Pengguna dapat menggunakan ID ini untuk menentukan apakah parameter yang terkait dengan instance berbeda dari parameter yang terkait dengan node. Perbedaan antara ID parameter dapat memberi tahu pengguna bahwa mereka mungkin perlu mengambil tindakan untuk menerapkan parameter pada node.

params

map (key: string, value: string)

Kumpulan parameter yang ditentukan pengguna untuk digunakan dalam proses memcached.

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

Node

Representasi JSON
{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  },
  "updateAvailable": boolean,
  "memcacheVersion": enum (MemcacheVersion),
  "memcacheFullVersion": string
}
Kolom
nodeId

string

Hanya output. ID node Memcached. ID node tidak menyertakan project atau lokasi seperti nama instance Memcached.

zone

string

Hanya output. Lokasi (Zona GCP) untuk node Memcached.

state

enum (State)

Hanya output. Status node Memcached saat ini.

host

string

Hanya output. Nama host atau alamat IP node Memcached yang digunakan oleh klien untuk terhubung ke server Memcached di node ini.

port

integer

Hanya output. Nomor port server Memcached di node ini.

parameters

object (MemcacheParameters)

Parameter buatan pengguna yang saat ini diterapkan ke node.

updateAvailable

boolean

Hanya output. Menampilkan benar (true) jika ada update yang menunggu untuk diterapkan

memcacheVersion

enum (MemcacheVersion)

Hanya output. Versi utama server memcached yang berjalan di node ini, misalnya MEMCACHE_1_5

memcacheFullVersion

string

Hanya output. Versi lengkap server memcached yang berjalan di node ini. misalnya - memcached-1.5.16

Negara bagian/Provinsi

Berbagai status node Memcached.

Enum
STATE_UNSPECIFIED Status node tidak ditetapkan.
CREATING Node sedang dibuat.
READY Node telah dibuat dan siap digunakan.
DELETING Node sedang dihapus.
UPDATING Node sedang diupdate.

Negara bagian/Provinsi

Berbagai status instance Memcached.

Enum
STATE_UNSPECIFIED Status belum ditetapkan.
CREATING Instance Memcached sedang dibuat.
READY Instance Memcached telah dibuat dan siap digunakan.
UPDATING Instance Memcached sedang mengupdate konfigurasi seperti kebijakan dan jadwal pemeliharaan.
DELETING Instance Memcached sedang dihapus.
PERFORMING_MAINTENANCE Instance Memcached sedang menjalani pemeliharaan, misalnya peluncuran bidang data.
MEMCACHE_VERSION_UPGRADING Instance Memcached sedang menjalani upgrade versi mesin memcached.

InstanceMessage

Representasi JSON
{
  "code": enum (Code),
  "message": string
}
Kolom
code

enum (Code)

Kode yang sesuai dengan salah satu jenis pesan yang ditampilkan kepada pengguna.

message

string

Pesan pada instance memcached yang akan ditampilkan kepada pengguna.

Kode

Enum
CODE_UNSPECIFIED Kode Pesan tidak ditetapkan.
ZONE_DISTRIBUTION_UNBALANCED Node Memcached tidak didistribusikan secara merata.

MaintenancePolicy

Kebijakan pemeliharaan per instance.

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

string (Timestamp format)

Hanya output. Waktu saat kebijakan dibuat.

Menggunakan RFC 3339, dengan output yang dihasilkan 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, dengan output yang dihasilkan 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".

description

string

Deskripsi tujuan kebijakan ini. Metode Create/Update menampilkan INVALID_ARGUMENT jika panjangnya lebih dari 512.

weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

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

WeeklyMaintenanceWindow

Jendela waktu yang ditentukan untuk operasi mingguan.

Representasi JSON
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Kolom
day

enum (DayOfWeek)

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

startTime

object (TimeOfDay)

Wajib. Waktu mulai jendela dalam UTC.

duration

string (Duration format)

Wajib. Durasi periode waktu.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

MaintenanceSchedule

Jadwal pemeliharaan mendatang.

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

string (Timestamp format)

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

Menggunakan RFC 3339, dengan output yang dihasilkan 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 pemeliharaan terjadwal yang akan datang untuk instance ini.

Menggunakan RFC 3339, dengan output yang dihasilkan 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".

scheduleDeadlineTime

string (Timestamp format)

Hanya output. Batas waktu yang tidak boleh dilampaui oleh waktu mulai jadwal pemeliharaan, termasuk penjadwalan ulang.

Menggunakan RFC 3339, dengan output yang dihasilkan 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".

Metode

applyParameters

ApplyParameters memulai ulang kumpulan node yang ditentukan untuk memperbaruinya ke kumpulan parameter saat ini untuk Instance Memcached.

applySoftwareUpdate

Mengupdate software di node yang dipilih pada Instance.

create

Membuat Instance baru di lokasi tertentu.

delete

Menghapus satu Instance.

get

Mendapatkan detail satu Instance.

list

Mencantumkan Instance di lokasi tertentu.

patch

Memperbarui Instance yang ada di project dan lokasi tertentu.

rescheduleMaintenance

Melakukan fase penerapan kata kerja RescheduleMaintenance.

updateParameters

Memperbarui parameter Memcached yang ditentukan untuk instance yang ada.

upgrade

Mengupgrade instance Memcache ke versi mesin memcached yang lebih baru yang ditentukan dalam permintaan.