queued_resources

Creates, updates, deletes, gets or lists a queued_resources resource.

Overview

Name	queued_resources
Type	Resource
Id	google.tpu.queued_resources

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Output only. Immutable. The name of the QueuedResource.
createTime	string (google-datetime)	Output only. The time when the QueuedResource was created.
guaranteed	object	Optional. The Guaranteed tier (id: Guaranteed)
queueingPolicy	object	Optional. The queueing policy of the QueuedRequest. (id: QueueingPolicy)
reservationName	string	Optional. Name of the reservation in which the resource should be provisioned. Format: projects/{project}/locations/{zone}/reservations/{reservation}
spot	object	Optional. The Spot tier. (id: Spot)
state	object	Output only. State of the QueuedResource request. (id: QueuedResourceState)
tpu	object	Optional. Defines a TPU resource. (id: Tpu)

list

Name	Datatype	Description
name	string	Output only. Immutable. The name of the QueuedResource.
createTime	string (google-datetime)	Output only. The time when the QueuedResource was created.
guaranteed	object	Optional. The Guaranteed tier (id: Guaranteed)
queueingPolicy	object	Optional. The queueing policy of the QueuedRequest. (id: QueueingPolicy)
reservationName	string	Optional. Name of the reservation in which the resource should be provisioned. Format: projects/{project}/locations/{zone}/reservations/{reservation}
spot	object	Optional. The Spot tier. (id: Spot)
state	object	Output only. State of the QueuedResource request. (id: QueuedResourceState)
tpu	object	Optional. Defines a TPU resource. (id: Tpu)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, queuedResourcesId		Gets details of a queued resource.
list	select	projectsId, locationsId	pageToken, pageSize	Lists queued resources.
create	insert	projectsId, locationsId	requestId, queuedResourceId	Creates a QueuedResource TPU instance.
delete	delete	projectsId, locationsId, queuedResourcesId	force, requestId	Deletes a QueuedResource TPU instance.
reset	exec	projectsId, locationsId, queuedResourcesId		Resets a QueuedResource TPU instance

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
projectsId	string
queuedResourcesId	string
force	boolean
pageSize	integer (int32)
pageToken	string
queuedResourceId	string
requestId	string

SELECT examples

get

Gets details of a queued resource.

SELECT
name,
createTime,
guaranteed,
queueingPolicy,
reservationName,
spot,
state,
tpu
FROM google.tpu.queued_resources
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND queuedResourcesId = '{{ queuedResourcesId }}' -- required
;

list

Lists queued resources.

SELECT
name,
createTime,
guaranteed,
queueingPolicy,
reservationName,
spot,
state,
tpu
FROM google.tpu.queued_resources
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}'
;

INSERT examples

create

Creates a QueuedResource TPU instance.

INSERT INTO google.tpu.queued_resources (
data__tpu,
data__spot,
data__reservationName,
data__queueingPolicy,
data__guaranteed,
projectsId,
locationsId,
requestId,
queuedResourceId
)
SELECT 
'{{ tpu }}',
'{{ spot }}',
'{{ reservationName }}',
'{{ queueingPolicy }}',
'{{ guaranteed }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ requestId }}',
'{{ queuedResourceId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: queued_resources
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the queued_resources resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the queued_resources resource.
  - name: tpu
    description: |
      Optional. Defines a TPU resource.
    value:
      nodeSpec:
        - nodeId: "{{ nodeId }}"
          parent: "{{ parent }}"
          multisliceParams:
            nodeCount: {{ nodeCount }}
            nodeIdPrefix: "{{ nodeIdPrefix }}"
          node:
            upcomingMaintenance:
              maintenanceStatus: "{{ maintenanceStatus }}"
              canReschedule: {{ canReschedule }}
              windowStartTime: "{{ windowStartTime }}"
              type: "{{ type }}"
              windowEndTime: "{{ windowEndTime }}"
              latestWindowStartTime: "{{ latestWindowStartTime }}"
            name: "{{ name }}"
            schedulingConfig:
              preemptible: {{ preemptible }}
              reserved: {{ reserved }}
              spot: {{ spot }}
            cidrBlock: "{{ cidrBlock }}"
            health: "{{ health }}"
            runtimeVersion: "{{ runtimeVersion }}"
            metadata: "{{ metadata }}"
            shieldedInstanceConfig:
              enableSecureBoot: {{ enableSecureBoot }}
            networkEndpoints:
              - accessConfig:
                  externalIp: "{{ externalIp }}"
                ipAddress: "{{ ipAddress }}"
                port: {{ port }}
            queuedResource: "{{ queuedResource }}"
            state: "{{ state }}"
            networkConfigs:
              - subnetwork: "{{ subnetwork }}"
                enableExternalIps: {{ enableExternalIps }}
                network: "{{ network }}"
                queueCount: {{ queueCount }}
                canIpForward: {{ canIpForward }}
            labels: "{{ labels }}"
            tags:
              - "{{ tags }}"
            acceleratorConfig:
              type: "{{ type }}"
              topology: "{{ topology }}"
            multisliceNode: {{ multisliceNode }}
            id: "{{ id }}"
            description: "{{ description }}"
            acceleratorType: "{{ acceleratorType }}"
            createTime: "{{ createTime }}"
            symptoms:
              - createTime: "{{ createTime }}"
                details: "{{ details }}"
                symptomType: "{{ symptomType }}"
                workerId: "{{ workerId }}"
            apiVersion: "{{ apiVersion }}"
            networkConfig:
              subnetwork: "{{ subnetwork }}"
              enableExternalIps: {{ enableExternalIps }}
              network: "{{ network }}"
              queueCount: {{ queueCount }}
              canIpForward: {{ canIpForward }}
            bootDiskConfig:
              customerEncryptionKey:
                kmsKeyName: "{{ kmsKeyName }}"
            dataDisks:
              - sourceDisk: "{{ sourceDisk }}"
                mode: "{{ mode }}"
            healthDescription: "{{ healthDescription }}"
            serviceAccount:
              email: "{{ email }}"
              scope:
                - "{{ scope }}"
  - name: spot
    value: "{{ spot }}"
    description: |
      Optional. The Spot tier.
  - name: reservationName
    value: "{{ reservationName }}"
    description: |
      Optional. Name of the reservation in which the resource should be provisioned. Format: projects/{project}/locations/{zone}/reservations/{reservation}
  - name: queueingPolicy
    description: |
      Optional. The queueing policy of the QueuedRequest.
    value:
      validInterval:
        endTime: "{{ endTime }}"
        startTime: "{{ startTime }}"
      validUntilDuration: "{{ validUntilDuration }}"
      validUntilTime: "{{ validUntilTime }}"
      validAfterDuration: "{{ validAfterDuration }}"
      validAfterTime: "{{ validAfterTime }}"
  - name: guaranteed
    description: |
      Optional. The Guaranteed tier
    value:
      minDuration: "{{ minDuration }}"
  - name: requestId
    value: "{{ requestId }}"
  - name: queuedResourceId
    value: "{{ queuedResourceId }}"

DELETE examples

delete

Deletes a QueuedResource TPU instance.

DELETE FROM google.tpu.queued_resources
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND queuedResourcesId = '{{ queuedResourcesId }}' --required
AND force = '{{ force }}'
AND requestId = '{{ requestId }}'
;

Lifecycle Methods

reset

Resets a QueuedResource TPU instance

EXEC google.tpu.queued_resources.reset 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@queuedResourcesId='{{ queuedResourcesId }}' --required
;