H2h2o
SandboxEngineImageService

Creates a new SandboxEngineImage.

Authorization may require the following permission on the image's parent workspace:

  • actions/enginemanager/sandboxEngineImages/CREATE
post/v1/{parent}/sandboxEngineImages

Request

Path parameters

parentstring required

Required. The resource name of the workspace to associate with the SandboxEngineImage. Format is workspaces/*.

Query parameters

sandboxEngineImageIdstring

Optional. Specify the SandboxEngineImage ID, which will become a part of the SandboxEngineImage resource name. If not specified, the server will generate one.

It must:

  • contain 1-63 characters
  • contain only lowercase alphanumeric characters or hyphen ('-')
  • start with an alphabetic character
  • end with an alphanumeric character

This matches a regular expression: ^a-z?$

Request body

namestring

Identifier. Resource name. Format is workspaces/*/sandboxEngineImages/*.

displayNamestring

Optional. Human-readable name.

imagestring required
enabledboolean

Optional. Whether the SandboxEngineImage is enabled. Disabled SandboxEngineImage cannot be used for creating new SandboxEngine.

imagePullPolicy'IMAGE_PULL_POLICY_UNSPECIFIED' | 'IMAGE_PULL_POLICY_ALWAYS' | 'IMAGE_PULL_POLICY_NEVER' | 'IMAGE_PULL_POLICY_IF_NOT_PRESENT'

Policy for downloading an image in K8s.

  • IMAGE_PULL_POLICY_UNSPECIFIED: Unspecified image pull policy.
  • IMAGE_PULL_POLICY_ALWAYS: Every time the container is launched, the container image registry is queried to resolve the name to an image digest.
  • IMAGE_PULL_POLICY_NEVER: Do not try to fetch the image. If the image is already present locally, the container will start. If the image is not present, container startup will fail.
  • IMAGE_PULL_POLICY_IF_NOT_PRESENT: The image is pulled only if it is not already present locally.
imagePullSecretsstring[]

Optional. A list of Kubernetes secret references used for authenticating to private container registries or repositories. These secrets provide the necessary credentials to pull Docker images from private repositories. Each entry in this list should be the name of a Kubernetes secret configured in the cluster.

createTimestring date-time

Output only. Time when the SandboxEngineImage was created.

updateTimestring date-time nullable

Output only. Time when the SandboxEngineImage was last updated.

creatorstring

Output only. Name of entity that created the SandboxEngineImage.

updaterstring

Output only. Name of entity that last updated the SandboxEngineImage.

creatorDisplayNamestring

Output only. Human-readable name of entity that created the SandboxEngineImage.

updaterDisplayNamestring

Output only. Human-readable name of entity that last updated the SandboxEngineImage.

Response

A successful response.

Changes

No recorded changes to this operation across all 1 revision of this API.