Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class RaySpec.
Configuration information for the Ray cluster.
For experimental launch, Ray cluster creation and Persistent
cluster creation are 1:1 mapping: We will provision all the nodes within the
Persistent cluster as Ray nodes.
Generated from protobuf message google.cloud.aiplatform.v1.RaySpec
Namespace
Google \ Cloud \ AIPlatform \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ image_uri
string
Optional. Default image for user to choose a preferred ML framework (for example, TensorFlow or Pytorch) by choosing from Vertex prebuilt images. Either this or the resource_pool_images is required. Use this field if you need all the resource pools to have the same Ray image. Otherwise, use the {@code resource_pool_images} field.
Optional. Required if image_uri isn't set. A map of resource_pool_id to prebuild Ray image if user need to use different images for different head/worker pools. This map needs to cover all the resource pool ids. Example: { "ray_head_node_pool": "head image" "ray_worker_node_pool1": "worker image" "ray_worker_node_pool2": "another worker image" }
↳ head_node_resource_pool_id
string
Optional. This will be used to indicate which resource pool will serve as the Ray head node(the first node within that pool). Will use the machine from the first workerpool as the head node by default if this field isn't set.
Optional. Default image for user to choose a preferred ML framework
(for example, TensorFlow or Pytorch) by choosing from Vertex prebuilt
images.
Either this or the resource_pool_images is required. Use this field if
you need all the resource pools to have the same Ray image. Otherwise, use
the {@code resource_pool_images} field.
Returns
Type
Description
string
setImageUri
Optional. Default image for user to choose a preferred ML framework
(for example, TensorFlow or Pytorch) by choosing from Vertex prebuilt
images.
Either this or the resource_pool_images is required. Use this field if
you need all the resource pools to have the same Ray image. Otherwise, use
the {@code resource_pool_images} field.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getResourcePoolImages
Optional. Required if image_uri isn't set. A map of resource_pool_id to
prebuild Ray image if user need to use different images for different
head/worker pools. This map needs to cover all the resource pool ids.
Optional. Required if image_uri isn't set. A map of resource_pool_id to
prebuild Ray image if user need to use different images for different
head/worker pools. This map needs to cover all the resource pool ids.
Optional. This will be used to indicate which resource pool will serve as
the Ray head node(the first node within that pool). Will use the machine
from the first workerpool as the head node by default if this field isn't
set.
Returns
Type
Description
string
setHeadNodeResourcePoolId
Optional. This will be used to indicate which resource pool will serve as
the Ray head node(the first node within that pool). Will use the machine
from the first workerpool as the head node by default if this field isn't
set.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Google Cloud Ai Platform V1 Client - Class RaySpec (1.35.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.35.0 (latest)](/php/docs/reference/cloud-ai-platform/latest/V1.RaySpec)\n- [1.34.0](/php/docs/reference/cloud-ai-platform/1.34.0/V1.RaySpec)\n- [1.33.0](/php/docs/reference/cloud-ai-platform/1.33.0/V1.RaySpec)\n- [1.32.1](/php/docs/reference/cloud-ai-platform/1.32.1/V1.RaySpec)\n- [1.31.0](/php/docs/reference/cloud-ai-platform/1.31.0/V1.RaySpec)\n- [1.30.0](/php/docs/reference/cloud-ai-platform/1.30.0/V1.RaySpec)\n- [1.26.0](/php/docs/reference/cloud-ai-platform/1.26.0/V1.RaySpec)\n- [1.23.0](/php/docs/reference/cloud-ai-platform/1.23.0/V1.RaySpec)\n- [1.22.0](/php/docs/reference/cloud-ai-platform/1.22.0/V1.RaySpec)\n- [1.21.0](/php/docs/reference/cloud-ai-platform/1.21.0/V1.RaySpec)\n- [1.20.0](/php/docs/reference/cloud-ai-platform/1.20.0/V1.RaySpec)\n- [1.19.0](/php/docs/reference/cloud-ai-platform/1.19.0/V1.RaySpec)\n- [1.18.0](/php/docs/reference/cloud-ai-platform/1.18.0/V1.RaySpec)\n- [1.17.0](/php/docs/reference/cloud-ai-platform/1.17.0/V1.RaySpec)\n- [1.16.0](/php/docs/reference/cloud-ai-platform/1.16.0/V1.RaySpec)\n- [1.15.0](/php/docs/reference/cloud-ai-platform/1.15.0/V1.RaySpec)\n- [1.14.0](/php/docs/reference/cloud-ai-platform/1.14.0/V1.RaySpec)\n- [1.13.1](/php/docs/reference/cloud-ai-platform/1.13.1/V1.RaySpec)\n- [1.12.0](/php/docs/reference/cloud-ai-platform/1.12.0/V1.RaySpec)\n- [1.11.0](/php/docs/reference/cloud-ai-platform/1.11.0/V1.RaySpec)\n- [1.10.0](/php/docs/reference/cloud-ai-platform/1.10.0/V1.RaySpec)\n- [1.9.0](/php/docs/reference/cloud-ai-platform/1.9.0/V1.RaySpec)\n- [1.8.0](/php/docs/reference/cloud-ai-platform/1.8.0/V1.RaySpec)\n- [1.7.0](/php/docs/reference/cloud-ai-platform/1.7.0/V1.RaySpec)\n- [1.6.0](/php/docs/reference/cloud-ai-platform/1.6.0/V1.RaySpec)\n- [1.5.0](/php/docs/reference/cloud-ai-platform/1.5.0/V1.RaySpec)\n- [1.4.0](/php/docs/reference/cloud-ai-platform/1.4.0/V1.RaySpec)\n- [1.3.0](/php/docs/reference/cloud-ai-platform/1.3.0/V1.RaySpec)\n- [1.2.0](/php/docs/reference/cloud-ai-platform/1.2.0/V1.RaySpec)\n- [1.1.0](/php/docs/reference/cloud-ai-platform/1.1.0/V1.RaySpec)\n- [1.0.0](/php/docs/reference/cloud-ai-platform/1.0.0/V1.RaySpec)\n- [0.39.0](/php/docs/reference/cloud-ai-platform/0.39.0/V1.RaySpec)\n- [0.38.0](/php/docs/reference/cloud-ai-platform/0.38.0/V1.RaySpec)\n- [0.37.1](/php/docs/reference/cloud-ai-platform/0.37.1/V1.RaySpec)\n- [0.32.0](/php/docs/reference/cloud-ai-platform/0.32.0/V1.RaySpec)\n- [0.31.0](/php/docs/reference/cloud-ai-platform/0.31.0/V1.RaySpec)\n- [0.30.0](/php/docs/reference/cloud-ai-platform/0.30.0/V1.RaySpec)\n- [0.29.0](/php/docs/reference/cloud-ai-platform/0.29.0/V1.RaySpec)\n- [0.28.0](/php/docs/reference/cloud-ai-platform/0.28.0/V1.RaySpec)\n- [0.27.0](/php/docs/reference/cloud-ai-platform/0.27.0/V1.RaySpec)\n- [0.26.2](/php/docs/reference/cloud-ai-platform/0.26.2/V1.RaySpec)\n- [0.25.0](/php/docs/reference/cloud-ai-platform/0.25.0/V1.RaySpec)\n- [0.24.0](/php/docs/reference/cloud-ai-platform/0.24.0/V1.RaySpec)\n- [0.23.0](/php/docs/reference/cloud-ai-platform/0.23.0/V1.RaySpec)\n- [0.22.0](/php/docs/reference/cloud-ai-platform/0.22.0/V1.RaySpec)\n- [0.21.0](/php/docs/reference/cloud-ai-platform/0.21.0/V1.RaySpec)\n- [0.20.0](/php/docs/reference/cloud-ai-platform/0.20.0/V1.RaySpec)\n- [0.19.0](/php/docs/reference/cloud-ai-platform/0.19.0/V1.RaySpec)\n- [0.18.0](/php/docs/reference/cloud-ai-platform/0.18.0/V1.RaySpec)\n- [0.17.0](/php/docs/reference/cloud-ai-platform/0.17.0/V1.RaySpec)\n- [0.16.0](/php/docs/reference/cloud-ai-platform/0.16.0/V1.RaySpec)\n- [0.15.0](/php/docs/reference/cloud-ai-platform/0.15.0/V1.RaySpec)\n- [0.13.0](/php/docs/reference/cloud-ai-platform/0.13.0/V1.RaySpec)\n- [0.12.0](/php/docs/reference/cloud-ai-platform/0.12.0/V1.RaySpec)\n- [0.11.1](/php/docs/reference/cloud-ai-platform/0.11.1/V1.RaySpec)\n- [0.10.0](/php/docs/reference/cloud-ai-platform/0.10.0/V1.RaySpec) \nReference documentation and code samples for the Google Cloud Ai Platform V1 Client class RaySpec.\n\nConfiguration information for the Ray cluster.\n\nFor experimental launch, Ray cluster creation and Persistent\ncluster creation are 1:1 mapping: We will provision all the nodes within the\nPersistent cluster as Ray nodes.\n\nGenerated from protobuf message `google.cloud.aiplatform.v1.RaySpec`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ AIPlatform \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getImageUri\n\nOptional. Default image for user to choose a preferred ML framework\n(for example, TensorFlow or Pytorch) by choosing from [Vertex prebuilt\nimages](https://cloud.google.com/vertex-ai/docs/training/pre-built-containers).\n\nEither this or the resource_pool_images is required. Use this field if\nyou need all the resource pools to have the same Ray image. Otherwise, use\nthe {@code resource_pool_images} field.\n\n### setImageUri\n\nOptional. Default image for user to choose a preferred ML framework\n(for example, TensorFlow or Pytorch) by choosing from [Vertex prebuilt\nimages](https://cloud.google.com/vertex-ai/docs/training/pre-built-containers).\n\nEither this or the resource_pool_images is required. Use this field if\nyou need all the resource pools to have the same Ray image. Otherwise, use\nthe {@code resource_pool_images} field.\n\n### getResourcePoolImages\n\nOptional. Required if image_uri isn't set. A map of resource_pool_id to\nprebuild Ray image if user need to use different images for different\nhead/worker pools. This map needs to cover all the resource pool ids.\n\nExample:\n{\n\"ray_head_node_pool\": \"head image\"\n\"ray_worker_node_pool1\": \"worker image\"\n\"ray_worker_node_pool2\": \"another worker image\"\n}\n\n### setResourcePoolImages\n\nOptional. Required if image_uri isn't set. A map of resource_pool_id to\nprebuild Ray image if user need to use different images for different\nhead/worker pools. This map needs to cover all the resource pool ids.\n\nExample:\n{\n\"ray_head_node_pool\": \"head image\"\n\"ray_worker_node_pool1\": \"worker image\"\n\"ray_worker_node_pool2\": \"another worker image\"\n}\n\n### getHeadNodeResourcePoolId\n\nOptional. This will be used to indicate which resource pool will serve as\nthe Ray head node(the first node within that pool). Will use the machine\nfrom the first workerpool as the head node by default if this field isn't\nset.\n\n### setHeadNodeResourcePoolId\n\nOptional. This will be used to indicate which resource pool will serve as\nthe Ray head node(the first node within that pool). Will use the machine\nfrom the first workerpool as the head node by default if this field isn't\nset.\n\n### getRayMetricSpec\n\nOptional. Ray metrics configurations.\n\n### hasRayMetricSpec\n\n### clearRayMetricSpec\n\n### setRayMetricSpec\n\nOptional. Ray metrics configurations.\n\n### getRayLogsSpec\n\nOptional. OSS Ray logging configurations.\n\n### hasRayLogsSpec\n\n### clearRayLogsSpec\n\n### setRayLogsSpec\n\nOptional. OSS Ray logging configurations."]]