REST Resource: reservationSlots

Resource: ReservationSlotsGetResponse

JSON representation
{"resource":{"kind":string,"id":string,"creationTimestamp":string,"name":string,"zone":string,"selfLink":string,"selfLinkWithId":string,"physicalTopology":{"cluster":string,"block":string,"subBlock":string,"host":string},"state":enum,"status":{"physicalTopology":{"cluster":string,"block":string,"subBlock":string,"host":string},"rdmaIpAddresses":[string],"runningInstances":[string]},"shareSettings":{"shareType":enum,"projectMap":{string:{"projectId":string},...}}}}
Fields
resource

object

resource.kind

string

Output only. The type of resource. Alwayscompute#reservationSlot for reservation slots.

resource.id

string (uint64 format)

Output only. The unique identifier for this resource. This identifier is defined by the server.

resource.creationTimestamp

string

Output only. The creation timestamp, formatted asRFC3339 text.

resource.name

string

Output only. The name of the reservation slot.

resource.zone

string

Output only. The zone in which the reservation slot resides.

resource.selfLink

string

Output only. A server-defined fully-qualified URL for this resource.

resource.selfLinkWithId

string

Output only. A server-defined URL for this resource with the resource ID.

resource.physicalTopology
(deprecated)

object

Output only. The physical topology of the reservation slot.

resource.physicalTopology
(deprecated).cluster

string

The cluster name of the reservation sub-block.

resource.physicalTopology
(deprecated).block

string

The unique identifier of the capacity block within the cluster.

resource.physicalTopology
(deprecated).subBlock

string

The unique identifier of the capacity sub-block within the capacity block.

resource.physicalTopology
(deprecated).host

string

The unique identifier of the capacity host within the capacity sub-block.

resource.state

enum

Output only. The state of the reservation slot.

resource.status

object

Output only. The status of the reservation slot.

resource.status.physicalTopology

object

Output only. The physical topology of the reservation sub-block.

resource.status.physicalTopology.cluster

string

The cluster name of the reservation sub-block.

resource.status.physicalTopology.block

string

The unique identifier of the capacity block within the cluster.

resource.status.physicalTopology.subBlock

string

The unique identifier of the capacity sub-block within the capacity block.

resource.status.physicalTopology.host

string

The unique identifier of the capacity host within the capacity sub-block.

resource.status.rdmaIpAddresses[]

string

Output only. The RDMA IP address of the physical host.

resource.status.runningInstances[]

string

Output only. The URIs of the instances currently running on this slot.

resource.shareSettings

object

Specify share settings to create a shared slot. Set to empty to inherit the share settings from a parent resource.

resource.shareSettings.shareType

enum

Type of sharing for this shared-reservation

resource.shareSettings.projectMap[]

map (key: string, value: object)

A map of project id and project config. This is only valid when shareType's value is SPECIFIC_PROJECTS.

resource.shareSettings.projectMap[].projectId

string

The project ID, should be same as the key of this project config in the parent map.

Methods

get

 Retrieves information about the specified reservation slot.

list

 Retrieves a list of reservation slots under a single reservation.

update

 Update a reservation slot in the specified sub-block.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-10 UTC.