REST Resource: projects.deviceSessions

Resource: DeviceSession

Pesan Protobuf yang menjelaskan pesan perangkat, yang digunakan dari beberapa RPC.

Representasi JSON
{
  "name": string,
  "displayName": string,
  "state": enum (SessionState),
  "stateHistories": [
    {
      object (SessionStateEvent)
    }
  ],
  "inactivityTimeout": string,
  "createTime": string,
  "activeStartTime": string,
  "androidDevice": {
    object (AndroidDevice)
  },

  // Union field expiration can be only one of the following:
  "ttl": string,
  "expireTime": string
  // End of list of possible types for union field expiration.
}
Kolom
name

string

Opsional. Nama DeviceSession, mis. "projects/{projectId}/deviceSessions/{session_id}"

displayName

string

Hanya output. Judul DeviceSession yang akan ditampilkan di UI.

state

enum (SessionState)

Hanya output. Status DeviceSession saat ini.

stateHistories[]

object (SessionStateEvent)

Hanya output. Transisi status historis pesan sessionState termasuk status sesi saat ini.

inactivityTimeout

string (Duration format)

Hanya output. Interval waktu saat perangkat ini harus berinteraksi sebelum beralih dari ACTIVE ke TIMEOUT_INACTIVITY.

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

createTime

string (Timestamp format)

Hanya output. Waktu Sesi 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".

activeStartTime

string (Timestamp format)

Hanya output. Stempel waktu saat sesi pertama kali menjadi AKTIF.

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".

androidDevice

object (AndroidDevice)

Wajib diisi. Perangkat yang diminta

Kolom union expiration.

expiration hanya dapat berupa salah satu dari yang berikut:

ttl

string (Duration format)

Opsional. Jumlah waktu yang akan dialokasikan untuk perangkat pertama kali. Pada akhirnya, opsi ini dapat diperpanjang dengan RPC deviceSessions.patch. Default: 15 menit.

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

expireTime

string (Timestamp format)

Opsional. Jika perangkat masih digunakan saat ini, koneksi akan diakhiri dan SessionState akan bertransisi dari ACTIVE menjadi FINISHED.

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".

Status Sesi

Status tempat sesi perangkat berada.

Enum
SESSION_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
REQUESTED Status awal permintaan sesi. Sesi sedang divalidasi untuk memastikan keakuratannya dan perangkat belum diminta.
PENDING Sesi telah divalidasi dan berada dalam antrean untuk perangkat.
ACTIVE Sesi telah diberikan dan perangkat menerima koneksi.
EXPIRED Durasi sesi melebihi jangka waktu reservasi perangkat dan waktunya otomatis habis.
FINISHED Pengguna selesai mengerjakan sesi dan dibatalkan oleh pengguna saat permintaan masih dialokasikan atau setelah alokasi dan selama periode penggunaan perangkat.
UNAVAILABLE Tidak dapat menyelesaikan sesi karena perangkat tidak tersedia dan gagal dialokasikan melalui penjadwal. Misalnya, perangkat yang tidak ada dalam katalog diminta atau permintaan kedaluwarsa dalam antrean alokasi.
ERROR Tidak dapat menyelesaikan sesi karena alasan internal, seperti kegagalan infrastruktur.

SessionStateEvent

Pesan yang merangkum serangkaian status Sesi dan waktu saat DeviceSession pertama kali memasuki status tersebut.

Representasi JSON
{
  "sessionState": enum (SessionState),
  "eventTime": string,
  "stateMessage": string
}
Kolom
sessionState

enum (SessionState)

Hanya output. sessionState yang dilacak oleh peristiwa ini

eventTime

string (Timestamp format)

Hanya output. Waktu sessionState pertama kali menemukan status tersebut.

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".

stateMessage

string

Hanya output. Pesan yang dapat dibaca manusia untuk menjelaskan status.

Metode

cancel

POST /v1/projects/{project_id}/deviceSessions/{device_session_id}:cancel Mengubah DeviceSession untuk menyatakan FINISHED dan menghentikan semua koneksi.

create

POST /v1/projects/{project_id}/deviceSessions

get

GET /v1/projects/{project_id}/deviceSessions/{device_session_id} Menampilkan DeviceSession, yang mendokumentasikan status alokasi dan apakah perangkat dialokasikan atau tidak.

list

GET /v1/projects/{project_id}/deviceSessions Mencantumkan Sesi perangkat yang dimiliki pengguna project.

patch

PATCH /v1/projects/{projectId}/deviceSessions/deviceSessionId}:updateDeviceSession Memperbarui sesi perangkat saat ini ke kolom yang dijelaskan oleh update_mask.