persistent_resources

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

Overview

Name	persistent_resources
Type	Resource
Id	google.aiplatform.persistent_resources

Fields

Name	Datatype	Description
name	string	Immutable. Resource name of a PersistentResource.
createTime	string	Output only. Time when the PersistentResource was created.
displayName	string	Optional. The display name of the PersistentResource. The name can be up to 128 characters long and can consist of any UTF-8 characters.
encryptionSpec	object	Represents a customer-managed encryption key spec that can be applied to a top-level resource.
error	object	The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.
labels	object	Optional. The labels with user-defined metadata to organize PersistentResource. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.
network	string	Optional. The full name of the Compute Engine network to peered with Vertex AI to host the persistent resources. For example, projects/12345/global/networks/myVPC. Format is of the form projects/{project}/global/networks/{network}. Where {project} is a project number, as in 12345, and {network} is a network name. To specify this field, you must have already configured VPC Network Peering for Vertex AI. If this field is left unspecified, the resources aren't peered with any network.
reservedIpRanges	array	Optional. A list of names for the reserved IP ranges under the VPC network that can be used for this persistent resource. If set, we will deploy the persistent resource within the provided IP ranges. Otherwise, the persistent resource is deployed to any IP ranges under the provided VPC network. Example: ['vertex-ai-ip-range'].
resourcePools	array	Required. The spec of the pools of different resources.
resourceRuntime	object	Persistent Cluster runtime information as output
resourceRuntimeSpec	object	Configuration for the runtime on a PersistentResource instance, including but not limited to: Service accounts used to run the workloads. Whether to make it a dedicated Ray Cluster.
satisfiesPzi	boolean	Output only. Reserved for future use.
satisfiesPzs	boolean	Output only. Reserved for future use.
startTime	string	Output only. Time when the PersistentResource for the first time entered the RUNNING state.
state	string	Output only. The detailed state of a Study.
updateTime	string	Output only. Time when the PersistentResource was most recently updated.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	locationsId, persistentResourcesId, projectsId	Gets a PersistentResource.
list	SELECT	locationsId, projectsId	Lists PersistentResources in a Location.
create	INSERT	locationsId, projectsId	Creates a PersistentResource.
delete	DELETE	locationsId, persistentResourcesId, projectsId	Deletes a PersistentResource.
patch	UPDATE	locationsId, persistentResourcesId, projectsId	Updates a PersistentResource.
reboot	EXEC	locationsId, persistentResourcesId, projectsId	Reboots a PersistentResource.

SELECT examples

Lists PersistentResources in a Location.

SELECT
name,
createTime,
displayName,
encryptionSpec,
error,
labels,
network,
reservedIpRanges,
resourcePools,
resourceRuntime,
resourceRuntimeSpec,
satisfiesPzi,
satisfiesPzs,
startTime,
state,
updateTime
FROM google.aiplatform.persistent_resources
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}'; 

INSERT example

Use the following StackQL query and manifest file to create a new persistent_resources resource.

All Properties

/*+ create */
INSERT INTO google.aiplatform.persistent_resources (
locationsId,
projectsId,
resourcePools,
displayName,
network,
resourceRuntimeSpec,
labels,
reservedIpRanges,
name,
encryptionSpec
)
SELECT 
'{{ locationsId }}',
'{{ projectsId }}',
'{{ resourcePools }}',
'{{ displayName }}',
'{{ network }}',
'{{ resourceRuntimeSpec }}',
'{{ labels }}',
'{{ reservedIpRanges }}',
'{{ name }}',
'{{ encryptionSpec }}'
;

Manifest

updateTime: string
resourcePools:
  - usedReplicaCount: string
    replicaCount: string
    id: string
    diskSpec:
      bootDiskType: string
      bootDiskSizeGb: integer
    machineSpec:
      acceleratorCount: integer
      reservationAffinity:
        key: string
        reservationAffinityType: string
        values:
          - type: string
      tpuTopology: string
      acceleratorType: string
      machineType: string
    autoscalingSpec:
      minReplicaCount: string
      maxReplicaCount: string
error:
  message: string
  code: integer
  details:
    - additionalProperties: any
      type: string
satisfiesPzs: boolean
displayName: string
network: string
resourceRuntimeSpec:
  serviceAccountSpec:
    enableCustomServiceAccount: boolean
    serviceAccount: string
  raySpec:
    resourcePoolImages: object
    rayMetricSpec:
      disabled: boolean
    imageUri: string
    rayLogsSpec:
      disabled: boolean
    headNodeResourcePoolId: string
createTime: string
resourceRuntime:
  accessUris: object
state: string
satisfiesPzi: boolean
startTime: string
labels: object
reservedIpRanges:
  - type: string
name: string
encryptionSpec:
  kmsKeyName: string

UPDATE example

Updates a persistent_resources resource.

/*+ update */
UPDATE google.aiplatform.persistent_resources
SET 
resourcePools = '{{ resourcePools }}',
displayName = '{{ displayName }}',
network = '{{ network }}',
resourceRuntimeSpec = '{{ resourceRuntimeSpec }}',
labels = '{{ labels }}',
reservedIpRanges = '{{ reservedIpRanges }}',
name = '{{ name }}',
encryptionSpec = '{{ encryptionSpec }}'
WHERE 
locationsId = '{{ locationsId }}'
AND persistentResourcesId = '{{ persistentResourcesId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified persistent_resources resource.

/*+ delete */
DELETE FROM google.aiplatform.persistent_resources
WHERE locationsId = '{{ locationsId }}'
AND persistentResourcesId = '{{ persistentResourcesId }}'
AND projectsId = '{{ projectsId }}';