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
  ]
}
Kolom
name

string

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

Catatan: Instance Memcache dikelola dan ditangani di tingkat regional, sehingga locationId di sini mengacu pada region Google Cloud; Namun, pengguna dapat memilih zona mana node Memcached harus disediakan dalam sebuah instance. Lihat kolom zones untuk 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 terkait 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 dengan instance. Jika tidak ditentukan, jaringan default akan digunakan.

zones[]

string

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

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 diberikan, 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 memcache di setiap node.

memcacheNodes[]

object (Node)

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

createTime

string (Timestamp format)

Hanya output. Waktu instance dibuat.

Stempel waktu dalam 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. Waktu instance diupdate.

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

state

enum (State)

Hanya output. Status instance Memcached ini.

memcacheFullVersion

string

Hanya output. Versi lengkap dari server memcache yang berjalan pada instance ini. Sistem secara otomatis menentukan versi memcache lengkap untuk sebuah 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 true (benar) 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 yang terkait dengan koneksi akses layanan pribadi, misalnya, "test-default" yang terkait dengan rentang IP 10.0.0.0/29.

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 Memcached versi 1.5.
MEMCACHE_1_6_15 Memcached versi 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 dengan 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 memcache.

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 mencakup 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 pada node ini.

port

integer

Hanya output. Nomor port server Memcached pada node ini.

parameters

object (MemcacheParameters)

Parameter buatan pengguna yang saat ini diterapkan ke node.

updateAvailable

boolean

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

memcacheVersion

enum (MemcacheVersion)

Hanya output. Versi utama server memcache yang berjalan pada node ini, misalnya MEMCACHE_1_5

memcacheFullVersion

string

Hanya output. Versi lengkap dari server memcache yang berjalan pada node ini. mis. - memcached-1.5.16

Status

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.

Status

Berbagai status instance Memcached.

Enum
STATE_UNSPECIFIED Status tidak ditetapkan.
CREATING Instance Memcached sedang dibuat.
READY Instance Memcached telah dibuat dan siap digunakan.
UPDATING Instance Memcached memperbarui konfigurasi seperti kebijakan pemeliharaan dan jadwal.
DELETING Instance Memcached sedang dihapus.
PERFORMING_MAINTENANCE Instance Memcached sedang menjalani pemeliharaan, mis. peluncuran bidang data.
MEMCACHE_VERSION_UPGRADING Instance Memcache sedang menjalani upgrade versi mesin memcache.

InstanceMessage

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

enum (Code)

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

message

string

Pesan pada instance memcache yang akan ditampilkan kepada pengguna.

Kode

Enum
CODE_UNSPECIFIED Kode Pesan belum ditetapkan.
ZONE_DISTRIBUTION_UNBALANCED Node Memcache didistribusikan secara tidak 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 kebijakan dibuat.

Stempel waktu dalam 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. Waktu saat kebijakan diperbarui.

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

description

string

Deskripsi tentang tujuan kebijakan ini. Metode buat/Perbarui menampilkan INVALID_ARGUMENT jika panjangnya lebih besar dari 512.

weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

Wajib. Masa pemeliharaan yang diterapkan pada resource yang dicakup oleh kebijakan ini. Minimum 1. Untuk versi saat ini, jumlah maksimum mingguan_maintenance_windows diperkirakan sebesar satu.

WeeklyMaintenanceWindow

Periode 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 menjalankan 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 mendatang untuk instance ini.

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

endTime

string (Timestamp format)

Hanya output. Waktu berakhir pemeliharaan terjadwal mendatang untuk instance ini.

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

scheduleDeadlineTime

string (Timestamp format)

Hanya output. Tenggat waktu untuk jadwal pemeliharaan tidak bisa dilampaui, termasuk penjadwalan ulang.

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

Metode

applyParameters

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

applySoftwareUpdate

Mengupdate software pada node Instance yang dipilih.

create

Membuat Instance baru di lokasi tertentu.

delete

Menghapus satu Instance.

get

Mendapatkan detail dari satu Instance.

list

Mencantumkan Instance di lokasi tertentu.

patch

Mengupdate Instance yang ada dalam project dan lokasi tertentu.

rescheduleMaintenance

Melakukan fase penerapan dari kata kerja ReschedulePemeliharaan.

updateParameters

Memperbarui parameter Memcached yang ditentukan untuk instance yang ada.

upgrade

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