sandbox_environment_templates

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

Overview

Name	sandbox_environment_templates
Type	Resource
Id	google.aiplatform.sandbox_environment_templates

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. The resource name of the SandboxEnvironmentTemplate. Format: projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}
createTime	string (google-datetime)	Output only. The timestamp when this SandboxEnvironmentTemplate was created.
customContainerEnvironment	object	The sandbox environment for custom container workloads. (id: GoogleCloudAiplatformV1SandboxEnvironmentTemplateCustomContainerEnvironment)
defaultContainerEnvironment	object	The sandbox environment for default container workloads. (id: GoogleCloudAiplatformV1SandboxEnvironmentTemplateDefaultContainerEnvironment)
displayName	string	Required. The display name of the SandboxEnvironmentTemplate.
egressControlConfig	object	Optional. The configuration for egress control of this template. (id: GoogleCloudAiplatformV1SandboxEnvironmentTemplateEgressControlConfig)
state	string	Output only. The state of the sandbox environment template. (UNSPECIFIED, PROVISIONING, ACTIVE, DEPROVISIONING, DELETED, FAILED)
updateTime	string (google-datetime)	Output only. The timestamp when this SandboxEnvironmentTemplate was most recently updated.

list

Name	Datatype	Description
name	string	Identifier. The resource name of the SandboxEnvironmentTemplate. Format: projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}
createTime	string (google-datetime)	Output only. The timestamp when this SandboxEnvironmentTemplate was created.
customContainerEnvironment	object	The sandbox environment for custom container workloads. (id: GoogleCloudAiplatformV1SandboxEnvironmentTemplateCustomContainerEnvironment)
defaultContainerEnvironment	object	The sandbox environment for default container workloads. (id: GoogleCloudAiplatformV1SandboxEnvironmentTemplateDefaultContainerEnvironment)
displayName	string	Required. The display name of the SandboxEnvironmentTemplate.
egressControlConfig	object	Optional. The configuration for egress control of this template. (id: GoogleCloudAiplatformV1SandboxEnvironmentTemplateEgressControlConfig)
state	string	Output only. The state of the sandbox environment template. (UNSPECIFIED, PROVISIONING, ACTIVE, DEPROVISIONING, DELETED, FAILED)
updateTime	string (google-datetime)	Output only. The timestamp when this SandboxEnvironmentTemplate was most recently updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	reasoningEnginesId, sandboxEnvironmentTemplatesId		Gets details of the specific SandboxEnvironmentTemplate.
list	select	reasoningEnginesId	pageToken, filter, pageSize	Lists SandboxEnvironmentTemplates in a given reasoning engine.
create	insert	reasoningEnginesId		Creates a SandboxEnvironmentTemplate in a given reasoning engine.
delete	delete	reasoningEnginesId, sandboxEnvironmentTemplatesId		Deletes the specific SandboxEnvironmentTemplate.

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
reasoningEnginesId	string
sandboxEnvironmentTemplatesId	string
filter	string
pageSize	integer (int32)
pageToken	string

SELECT examples

get

Gets details of the specific SandboxEnvironmentTemplate.

SELECT
name,
createTime,
customContainerEnvironment,
defaultContainerEnvironment,
displayName,
egressControlConfig,
state,
updateTime
FROM google.aiplatform.sandbox_environment_templates
WHERE reasoningEnginesId = '{{ reasoningEnginesId }}' -- required
AND sandboxEnvironmentTemplatesId = '{{ sandboxEnvironmentTemplatesId }}' -- required
;

list

Lists SandboxEnvironmentTemplates in a given reasoning engine.

SELECT
name,
createTime,
customContainerEnvironment,
defaultContainerEnvironment,
displayName,
egressControlConfig,
state,
updateTime
FROM google.aiplatform.sandbox_environment_templates
WHERE reasoningEnginesId = '{{ reasoningEnginesId }}' -- required
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
;

INSERT examples

create

Creates a SandboxEnvironmentTemplate in a given reasoning engine.

INSERT INTO google.aiplatform.sandbox_environment_templates (
data__displayName,
data__egressControlConfig,
data__defaultContainerEnvironment,
data__name,
data__customContainerEnvironment,
reasoningEnginesId
)
SELECT 
'{{ displayName }}',
'{{ egressControlConfig }}',
'{{ defaultContainerEnvironment }}',
'{{ name }}',
'{{ customContainerEnvironment }}',
'{{ reasoningEnginesId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: sandbox_environment_templates
props:
  - name: reasoningEnginesId
    value: "{{ reasoningEnginesId }}"
    description: Required parameter for the sandbox_environment_templates resource.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Required. The display name of the SandboxEnvironmentTemplate.
  - name: egressControlConfig
    description: |
      Optional. The configuration for egress control of this template.
    value:
      customerVpcNetwork: "{{ customerVpcNetwork }}"
      internetAccess: {{ internetAccess }}
      networkAttachment: "{{ networkAttachment }}"
      dnsPeeringConfigs:
        - domain: "{{ domain }}"
          targetProject: "{{ targetProject }}"
          targetNetwork: "{{ targetNetwork }}"
  - name: defaultContainerEnvironment
    description: |
      The sandbox environment for default container workloads.
    value:
      defaultContainerCategory: "{{ defaultContainerCategory }}"
      resources:
        requests: "{{ requests }}"
        limits: "{{ limits }}"
  - name: name
    value: "{{ name }}"
    description: |
      Identifier. The resource name of the SandboxEnvironmentTemplate. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}`
  - name: customContainerEnvironment
    description: |
      The sandbox environment for custom container workloads.
    value:
      resources:
        requests: "{{ requests }}"
        limits: "{{ limits }}"
      customContainerSpec:
        imageUri: "{{ imageUri }}"
      ports:
        - port: {{ port }}
          protocol: "{{ protocol }}"

DELETE examples

delete

Deletes the specific SandboxEnvironmentTemplate.

DELETE FROM google.aiplatform.sandbox_environment_templates
WHERE reasoningEnginesId = '{{ reasoningEnginesId }}' --required
AND sandboxEnvironmentTemplatesId = '{{ sandboxEnvironmentTemplatesId }}' --required
;