# Batch v1 API - Class Runnable.Types.Container (2.15.0)

<button class="button button-with-icon cloud-select-dropdown__button " aria-haspopup="true">Version latest</button>

- [2.15.0 (latest)](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.14.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.14.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.13.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.13.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.12.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.12.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.11.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.11.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.10.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.10.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.9.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.9.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.8.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.8.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.7.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.7.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.6.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.6.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.5.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.5.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.4.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.4.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.3.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.3.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.2.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.2.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.1.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.1.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [2.0.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/2.0.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [1.3.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/1.3.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [1.2.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/1.2.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [1.1.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/1.1.0/Google.Cloud.Batch.V1.Runnable.Types.Container)
- [1.0.0](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/1.0.0/Google.Cloud.Batch.V1.Runnable.Types.Container)

    public sealed class Runnable.Types.Container : IMessage<Runnable.Types.Container>, IEquatable<Runnable.Types.Container>, IDeepCloneable<Runnable.Types.Container>, IBufferMessage, IMessage

Reference documentation and code samples for the Batch v1 API class Runnable.Types.Container.

Container runnable.

## Inheritance

[object](https://learn.microsoft.com/dotnet/api/system.object) \> Runnable.Types.Container

## Implements

[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[Runnable](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable)[Types](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types)[Container](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types.Container), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[Runnable](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable)[Types](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types)[Container](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types.Container), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[Runnable](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable)[Types](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types)[Container](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types.Container), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html)

## Inherited Members

[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) [object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) [object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)

## Namespace

[Google.Cloud.Batch.V1](https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1)

## Assembly

Google.Cloud.Batch.V1.dll

## Constructors

### Container()

    public Container()

### Container(Container)

    public Container(Runnable.Types.Container other)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `other` | `https://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnablehttps://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Typeshttps://docs.cloud.google.com/dotnet/docs/reference/Google.Cloud.Batch.V1/latest/Google.Cloud.Batch.V1.Runnable.Types.Container` |

## Properties

### BlockExternalNetwork

    public bool BlockExternalNetwork { get; set; }

If set to true, external network access to and from container will be
blocked, containers that are with block_external_network as true can
still communicate with each other, network cannot be specified in the
`container.options` field.

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.boolean` |   |

### Commands

    public RepeatedField<string> Commands { get; }

Required for some container images. Overrides the `CMD` specified in the
container. If there is an `ENTRYPOINT` (either in the container image or
with the `entrypoint` field below) then these commands are appended as
arguments to the `ENTRYPOINT`.

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.Collections.RepeatedField-1.htmlhttps://learn.microsoft.com/dotnet/api/system.string` |   |

### EnableImageStreaming

    public bool EnableImageStreaming { get; set; }

Optional. If set to true, this container runnable uses Image streaming.

Use Image streaming to allow the runnable to initialize without
waiting for the entire container image to download, which can
significantly reduce startup time for large container images.

When `enableImageStreaming` is set to true, the container
runtime is [containerd](https://containerd.io/) instead of Docker.
Additionally, this container runnable only supports the following
`container` subfields: `imageUri`,
`commands[]`, `entrypoint`, and
`volumes[]`; any other `container` subfields are ignored.

For more information about the requirements and limitations for using
Image streaming with Batch, see the [`image-streaming`
sample on
GitHub](https://github.com/GoogleCloudPlatform/batch-samples/tree/main/api-samples/image-streaming).

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.boolean` |   |

### Entrypoint

    public string Entrypoint { get; set; }

Required for some container images. Overrides the `ENTRYPOINT` specified
in the container.

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.string` |   |

### ImageUri

    public string ImageUri { get; set; }

Required. The URI to pull the container image from.

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.string` |   |

### Options

    public string Options { get; set; }

Required for some container images. Arbitrary additional options to
include in the `docker run` command when running this container\&mdash;for
example, `--network host`. For the `--volume` option, use the `volumes`
field for the container.

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.string` |   |

### Password

    public string Password { get; set; }

Required if the container image is from a private Docker registry. The
password to login to the Docker registry that contains the image.

For security, it is strongly recommended to specify an
encrypted password by using a Secret Manager secret:
`projects/*/secrets/*/versions/*`.

Warning: If you specify the password using plain text, you risk the
password being exposed to any users who can view the job or its logs.
To avoid this risk, specify a secret that contains the password instead.

Learn more about [Secret
Manager](https://cloud.google.com/secret-manager/docs/) and [using
Secret Manager with
Batch](https://cloud.google.com/batch/docs/create-run-job-secret-manager).

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.string` |   |

### Username

    public string Username { get; set; }

Required if the container image is from a private Docker registry. The
username to login to the Docker registry that contains the image.

You can either specify the username directly by using plain text or
specify an encrypted username by using a Secret Manager secret:
`projects/*/secrets/*/versions/*`. However, using a secret is
recommended for enhanced security.

Caution: If you specify the username using plain text, you risk the
username being exposed to any users who can view the job or its logs.
To avoid this risk, specify a secret that contains the username instead.

Learn more about [Secret
Manager](https://cloud.google.com/secret-manager/docs/) and [using
Secret Manager with
Batch](https://cloud.google.com/batch/docs/create-run-job-secret-manager).

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://learn.microsoft.com/dotnet/api/system.string` |   |

### Volumes

    public RepeatedField<string> Volumes { get; }

Volumes to mount (bind mount) from the host machine files or directories
into the container, formatted to match `--volume` option for the
`docker run` command\&mdash;for example, `/foo:/bar` or `/foo:/bar:ro`.

If the `TaskSpec.Volumes` field is specified but this field is not, Batch
will mount each volume from the host machine to the container with the
same mount path by default. In this case, the default mount option for
containers will be read-only (`ro`) for existing persistent disks and
read-write (`rw`) for other volume types, regardless of the original
mount options specified in `TaskSpec.Volumes`. If you need different
mount settings, you can explicitly configure them in this field.

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.Collections.RepeatedField-1.htmlhttps://learn.microsoft.com/dotnet/api/system.string` |   |