1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. ContainerEngine
  5. ContainerInstance
Oracle Cloud Infrastructure v2.32.0 published on Thursday, Apr 24, 2025 by Pulumi

oci.ContainerEngine.ContainerInstance

Explore with Pulumi AI

This resource provides the Container Instance resource in Oracle Cloud Infrastructure Container Instances service.

Creates a container instance and deploys the containers on it.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testContainerInstance = new oci.containerengine.ContainerInstance("test_container_instance", {
    availabilityDomain: containerInstanceAvailabilityDomain,
    compartmentId: compartmentId,
    containers: [{
        imageUrl: containerInstanceContainersImageUrl,
        arguments: containerInstanceContainersArguments,
        commands: containerInstanceContainersCommand,
        definedTags: containerInstanceContainersDefinedTags,
        displayName: containerInstanceContainersDisplayName,
        environmentVariables: containerInstanceContainersEnvironmentVariables,
        freeformTags: containerInstanceContainersFreeformTags,
        healthChecks: [{
            healthCheckType: containerInstanceContainersHealthChecksHealthCheckType,
            failureAction: containerInstanceContainersHealthChecksFailureAction,
            failureThreshold: containerInstanceContainersHealthChecksFailureThreshold,
            headers: [{
                name: containerInstanceContainersHealthChecksHeadersName,
                value: containerInstanceContainersHealthChecksHeadersValue,
            }],
            initialDelayInSeconds: containerInstanceContainersHealthChecksInitialDelayInSeconds,
            intervalInSeconds: containerInstanceContainersHealthChecksIntervalInSeconds,
            name: containerInstanceContainersHealthChecksName,
            path: containerInstanceContainersHealthChecksPath,
            port: containerInstanceContainersHealthChecksPort,
            successThreshold: containerInstanceContainersHealthChecksSuccessThreshold,
            timeoutInSeconds: containerInstanceContainersHealthChecksTimeoutInSeconds,
        }],
        isResourcePrincipalDisabled: containerInstanceContainersIsResourcePrincipalDisabled,
        resourceConfig: {
            memoryLimitInGbs: containerInstanceContainersResourceConfigMemoryLimitInGbs,
            vcpusLimit: containerInstanceContainersResourceConfigVcpusLimit,
        },
        securityContext: {
            capabilities: {
                addCapabilities: containerInstanceContainersSecurityContextCapabilitiesAddCapabilities,
                dropCapabilities: containerInstanceContainersSecurityContextCapabilitiesDropCapabilities,
            },
            isNonRootUserCheckEnabled: containerInstanceContainersSecurityContextIsNonRootUserCheckEnabled,
            isRootFileSystemReadonly: containerInstanceContainersSecurityContextIsRootFileSystemReadonly,
            runAsGroup: containerInstanceContainersSecurityContextRunAsGroup,
            runAsUser: containerInstanceContainersSecurityContextRunAsUser,
            securityContextType: containerInstanceContainersSecurityContextSecurityContextType,
        },
        volumeMounts: [{
            mountPath: containerInstanceContainersVolumeMountsMountPath,
            volumeName: containerInstanceContainersVolumeMountsVolumeName,
            isReadOnly: containerInstanceContainersVolumeMountsIsReadOnly,
            partition: containerInstanceContainersVolumeMountsPartition,
            subPath: containerInstanceContainersVolumeMountsSubPath,
        }],
        workingDirectory: containerInstanceContainersWorkingDirectory,
    }],
    shape: containerInstanceShape,
    shapeConfig: {
        ocpus: containerInstanceShapeConfigOcpus,
        memoryInGbs: containerInstanceShapeConfigMemoryInGbs,
    },
    vnics: [{
        subnetId: testSubnet.id,
        definedTags: containerInstanceVnicsDefinedTags,
        displayName: containerInstanceVnicsDisplayName,
        freeformTags: containerInstanceVnicsFreeformTags,
        hostnameLabel: containerInstanceVnicsHostnameLabel,
        isPublicIpAssigned: containerInstanceVnicsIsPublicIpAssigned,
        nsgIds: containerInstanceVnicsNsgIds,
        privateIp: containerInstanceVnicsPrivateIp,
        skipSourceDestCheck: containerInstanceVnicsSkipSourceDestCheck,
    }],
    containerRestartPolicy: containerInstanceContainerRestartPolicy,
    definedTags: {
        "foo-namespace.bar-key": "value",
    },
    displayName: containerInstanceDisplayName,
    dnsConfig: {
        nameservers: containerInstanceDnsConfigNameservers,
        options: containerInstanceDnsConfigOptions,
        searches: containerInstanceDnsConfigSearches,
    },
    faultDomain: containerInstanceFaultDomain,
    freeformTags: {
        "bar-key": "value",
    },
    gracefulShutdownTimeoutInSeconds: containerInstanceGracefulShutdownTimeoutInSeconds,
    imagePullSecrets: [{
        registryEndpoint: containerInstanceImagePullSecretsRegistryEndpoint,
        secretType: containerInstanceImagePullSecretsSecretType,
        password: containerInstanceImagePullSecretsPassword,
        secretId: testSecret.id,
        username: containerInstanceImagePullSecretsUsername,
    }],
    volumes: [{
        name: containerInstanceVolumesName,
        volumeType: containerInstanceVolumesVolumeType,
        backingStore: containerInstanceVolumesBackingStore,
        configs: [{
            data: containerInstanceVolumesConfigsData,
            fileName: containerInstanceVolumesConfigsFileName,
            path: containerInstanceVolumesConfigsPath,
        }],
    }],
});
Copy
import pulumi
import pulumi_oci as oci

test_container_instance = oci.container_engine.ContainerInstance("test_container_instance",
    availability_domain=container_instance_availability_domain,
    compartment_id=compartment_id,
    containers=[{
        "image_url": container_instance_containers_image_url,
        "arguments": container_instance_containers_arguments,
        "commands": container_instance_containers_command,
        "defined_tags": container_instance_containers_defined_tags,
        "display_name": container_instance_containers_display_name,
        "environment_variables": container_instance_containers_environment_variables,
        "freeform_tags": container_instance_containers_freeform_tags,
        "health_checks": [{
            "health_check_type": container_instance_containers_health_checks_health_check_type,
            "failure_action": container_instance_containers_health_checks_failure_action,
            "failure_threshold": container_instance_containers_health_checks_failure_threshold,
            "headers": [{
                "name": container_instance_containers_health_checks_headers_name,
                "value": container_instance_containers_health_checks_headers_value,
            }],
            "initial_delay_in_seconds": container_instance_containers_health_checks_initial_delay_in_seconds,
            "interval_in_seconds": container_instance_containers_health_checks_interval_in_seconds,
            "name": container_instance_containers_health_checks_name,
            "path": container_instance_containers_health_checks_path,
            "port": container_instance_containers_health_checks_port,
            "success_threshold": container_instance_containers_health_checks_success_threshold,
            "timeout_in_seconds": container_instance_containers_health_checks_timeout_in_seconds,
        }],
        "is_resource_principal_disabled": container_instance_containers_is_resource_principal_disabled,
        "resource_config": {
            "memory_limit_in_gbs": container_instance_containers_resource_config_memory_limit_in_gbs,
            "vcpus_limit": container_instance_containers_resource_config_vcpus_limit,
        },
        "security_context": {
            "capabilities": {
                "add_capabilities": container_instance_containers_security_context_capabilities_add_capabilities,
                "drop_capabilities": container_instance_containers_security_context_capabilities_drop_capabilities,
            },
            "is_non_root_user_check_enabled": container_instance_containers_security_context_is_non_root_user_check_enabled,
            "is_root_file_system_readonly": container_instance_containers_security_context_is_root_file_system_readonly,
            "run_as_group": container_instance_containers_security_context_run_as_group,
            "run_as_user": container_instance_containers_security_context_run_as_user,
            "security_context_type": container_instance_containers_security_context_security_context_type,
        },
        "volume_mounts": [{
            "mount_path": container_instance_containers_volume_mounts_mount_path,
            "volume_name": container_instance_containers_volume_mounts_volume_name,
            "is_read_only": container_instance_containers_volume_mounts_is_read_only,
            "partition": container_instance_containers_volume_mounts_partition,
            "sub_path": container_instance_containers_volume_mounts_sub_path,
        }],
        "working_directory": container_instance_containers_working_directory,
    }],
    shape=container_instance_shape,
    shape_config={
        "ocpus": container_instance_shape_config_ocpus,
        "memory_in_gbs": container_instance_shape_config_memory_in_gbs,
    },
    vnics=[{
        "subnet_id": test_subnet["id"],
        "defined_tags": container_instance_vnics_defined_tags,
        "display_name": container_instance_vnics_display_name,
        "freeform_tags": container_instance_vnics_freeform_tags,
        "hostname_label": container_instance_vnics_hostname_label,
        "is_public_ip_assigned": container_instance_vnics_is_public_ip_assigned,
        "nsg_ids": container_instance_vnics_nsg_ids,
        "private_ip": container_instance_vnics_private_ip,
        "skip_source_dest_check": container_instance_vnics_skip_source_dest_check,
    }],
    container_restart_policy=container_instance_container_restart_policy,
    defined_tags={
        "foo-namespace.bar-key": "value",
    },
    display_name=container_instance_display_name,
    dns_config={
        "nameservers": container_instance_dns_config_nameservers,
        "options": container_instance_dns_config_options,
        "searches": container_instance_dns_config_searches,
    },
    fault_domain=container_instance_fault_domain,
    freeform_tags={
        "bar-key": "value",
    },
    graceful_shutdown_timeout_in_seconds=container_instance_graceful_shutdown_timeout_in_seconds,
    image_pull_secrets=[{
        "registry_endpoint": container_instance_image_pull_secrets_registry_endpoint,
        "secret_type": container_instance_image_pull_secrets_secret_type,
        "password": container_instance_image_pull_secrets_password,
        "secret_id": test_secret["id"],
        "username": container_instance_image_pull_secrets_username,
    }],
    volumes=[{
        "name": container_instance_volumes_name,
        "volume_type": container_instance_volumes_volume_type,
        "backing_store": container_instance_volumes_backing_store,
        "configs": [{
            "data": container_instance_volumes_configs_data,
            "file_name": container_instance_volumes_configs_file_name,
            "path": container_instance_volumes_configs_path,
        }],
    }])
Copy
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/containerengine"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := containerengine.NewContainerInstance(ctx, "test_container_instance", &containerengine.ContainerInstanceArgs{
			AvailabilityDomain: pulumi.Any(containerInstanceAvailabilityDomain),
			CompartmentId:      pulumi.Any(compartmentId),
			Containers: containerengine.ContainerInstanceContainerArray{
				&containerengine.ContainerInstanceContainerArgs{
					ImageUrl:             pulumi.Any(containerInstanceContainersImageUrl),
					Arguments:            pulumi.Any(containerInstanceContainersArguments),
					Commands:             pulumi.Any(containerInstanceContainersCommand),
					DefinedTags:          pulumi.Any(containerInstanceContainersDefinedTags),
					DisplayName:          pulumi.Any(containerInstanceContainersDisplayName),
					EnvironmentVariables: pulumi.Any(containerInstanceContainersEnvironmentVariables),
					FreeformTags:         pulumi.Any(containerInstanceContainersFreeformTags),
					HealthChecks: containerengine.ContainerInstanceContainerHealthCheckArray{
						&containerengine.ContainerInstanceContainerHealthCheckArgs{
							HealthCheckType:  pulumi.Any(containerInstanceContainersHealthChecksHealthCheckType),
							FailureAction:    pulumi.Any(containerInstanceContainersHealthChecksFailureAction),
							FailureThreshold: pulumi.Any(containerInstanceContainersHealthChecksFailureThreshold),
							Headers: containerengine.ContainerInstanceContainerHealthCheckHeaderArray{
								&containerengine.ContainerInstanceContainerHealthCheckHeaderArgs{
									Name:  pulumi.Any(containerInstanceContainersHealthChecksHeadersName),
									Value: pulumi.Any(containerInstanceContainersHealthChecksHeadersValue),
								},
							},
							InitialDelayInSeconds: pulumi.Any(containerInstanceContainersHealthChecksInitialDelayInSeconds),
							IntervalInSeconds:     pulumi.Any(containerInstanceContainersHealthChecksIntervalInSeconds),
							Name:                  pulumi.Any(containerInstanceContainersHealthChecksName),
							Path:                  pulumi.Any(containerInstanceContainersHealthChecksPath),
							Port:                  pulumi.Any(containerInstanceContainersHealthChecksPort),
							SuccessThreshold:      pulumi.Any(containerInstanceContainersHealthChecksSuccessThreshold),
							TimeoutInSeconds:      pulumi.Any(containerInstanceContainersHealthChecksTimeoutInSeconds),
						},
					},
					IsResourcePrincipalDisabled: pulumi.Any(containerInstanceContainersIsResourcePrincipalDisabled),
					ResourceConfig: &containerengine.ContainerInstanceContainerResourceConfigArgs{
						MemoryLimitInGbs: pulumi.Any(containerInstanceContainersResourceConfigMemoryLimitInGbs),
						VcpusLimit:       pulumi.Any(containerInstanceContainersResourceConfigVcpusLimit),
					},
					SecurityContext: &containerengine.ContainerInstanceContainerSecurityContextArgs{
						Capabilities: &containerengine.ContainerInstanceContainerSecurityContextCapabilitiesArgs{
							AddCapabilities:  pulumi.Any(containerInstanceContainersSecurityContextCapabilitiesAddCapabilities),
							DropCapabilities: pulumi.Any(containerInstanceContainersSecurityContextCapabilitiesDropCapabilities),
						},
						IsNonRootUserCheckEnabled: pulumi.Any(containerInstanceContainersSecurityContextIsNonRootUserCheckEnabled),
						IsRootFileSystemReadonly:  pulumi.Any(containerInstanceContainersSecurityContextIsRootFileSystemReadonly),
						RunAsGroup:                pulumi.Any(containerInstanceContainersSecurityContextRunAsGroup),
						RunAsUser:                 pulumi.Any(containerInstanceContainersSecurityContextRunAsUser),
						SecurityContextType:       pulumi.Any(containerInstanceContainersSecurityContextSecurityContextType),
					},
					VolumeMounts: containerengine.ContainerInstanceContainerVolumeMountArray{
						&containerengine.ContainerInstanceContainerVolumeMountArgs{
							MountPath:  pulumi.Any(containerInstanceContainersVolumeMountsMountPath),
							VolumeName: pulumi.Any(containerInstanceContainersVolumeMountsVolumeName),
							IsReadOnly: pulumi.Any(containerInstanceContainersVolumeMountsIsReadOnly),
							Partition:  pulumi.Any(containerInstanceContainersVolumeMountsPartition),
							SubPath:    pulumi.Any(containerInstanceContainersVolumeMountsSubPath),
						},
					},
					WorkingDirectory: pulumi.Any(containerInstanceContainersWorkingDirectory),
				},
			},
			Shape: pulumi.Any(containerInstanceShape),
			ShapeConfig: &containerengine.ContainerInstanceShapeConfigArgs{
				Ocpus:       pulumi.Any(containerInstanceShapeConfigOcpus),
				MemoryInGbs: pulumi.Any(containerInstanceShapeConfigMemoryInGbs),
			},
			Vnics: containerengine.ContainerInstanceVnicArray{
				&containerengine.ContainerInstanceVnicArgs{
					SubnetId:            pulumi.Any(testSubnet.Id),
					DefinedTags:         pulumi.Any(containerInstanceVnicsDefinedTags),
					DisplayName:         pulumi.Any(containerInstanceVnicsDisplayName),
					FreeformTags:        pulumi.Any(containerInstanceVnicsFreeformTags),
					HostnameLabel:       pulumi.Any(containerInstanceVnicsHostnameLabel),
					IsPublicIpAssigned:  pulumi.Any(containerInstanceVnicsIsPublicIpAssigned),
					NsgIds:              pulumi.Any(containerInstanceVnicsNsgIds),
					PrivateIp:           pulumi.Any(containerInstanceVnicsPrivateIp),
					SkipSourceDestCheck: pulumi.Any(containerInstanceVnicsSkipSourceDestCheck),
				},
			},
			ContainerRestartPolicy: pulumi.Any(containerInstanceContainerRestartPolicy),
			DefinedTags: pulumi.StringMap{
				"foo-namespace.bar-key": pulumi.String("value"),
			},
			DisplayName: pulumi.Any(containerInstanceDisplayName),
			DnsConfig: &containerengine.ContainerInstanceDnsConfigArgs{
				Nameservers: pulumi.Any(containerInstanceDnsConfigNameservers),
				Options:     pulumi.Any(containerInstanceDnsConfigOptions),
				Searches:    pulumi.Any(containerInstanceDnsConfigSearches),
			},
			FaultDomain: pulumi.Any(containerInstanceFaultDomain),
			FreeformTags: pulumi.StringMap{
				"bar-key": pulumi.String("value"),
			},
			GracefulShutdownTimeoutInSeconds: pulumi.Any(containerInstanceGracefulShutdownTimeoutInSeconds),
			ImagePullSecrets: containerengine.ContainerInstanceImagePullSecretArray{
				&containerengine.ContainerInstanceImagePullSecretArgs{
					RegistryEndpoint: pulumi.Any(containerInstanceImagePullSecretsRegistryEndpoint),
					SecretType:       pulumi.Any(containerInstanceImagePullSecretsSecretType),
					Password:         pulumi.Any(containerInstanceImagePullSecretsPassword),
					SecretId:         pulumi.Any(testSecret.Id),
					Username:         pulumi.Any(containerInstanceImagePullSecretsUsername),
				},
			},
			Volumes: containerengine.ContainerInstanceVolumeArray{
				&containerengine.ContainerInstanceVolumeArgs{
					Name:         pulumi.Any(containerInstanceVolumesName),
					VolumeType:   pulumi.Any(containerInstanceVolumesVolumeType),
					BackingStore: pulumi.Any(containerInstanceVolumesBackingStore),
					Configs: containerengine.ContainerInstanceVolumeConfigArray{
						&containerengine.ContainerInstanceVolumeConfigArgs{
							Data:     pulumi.Any(containerInstanceVolumesConfigsData),
							FileName: pulumi.Any(containerInstanceVolumesConfigsFileName),
							Path:     pulumi.Any(containerInstanceVolumesConfigsPath),
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testContainerInstance = new Oci.ContainerEngine.ContainerInstance("test_container_instance", new()
    {
        AvailabilityDomain = containerInstanceAvailabilityDomain,
        CompartmentId = compartmentId,
        Containers = new[]
        {
            new Oci.ContainerEngine.Inputs.ContainerInstanceContainerArgs
            {
                ImageUrl = containerInstanceContainersImageUrl,
                Arguments = containerInstanceContainersArguments,
                Commands = containerInstanceContainersCommand,
                DefinedTags = containerInstanceContainersDefinedTags,
                DisplayName = containerInstanceContainersDisplayName,
                EnvironmentVariables = containerInstanceContainersEnvironmentVariables,
                FreeformTags = containerInstanceContainersFreeformTags,
                HealthChecks = new[]
                {
                    new Oci.ContainerEngine.Inputs.ContainerInstanceContainerHealthCheckArgs
                    {
                        HealthCheckType = containerInstanceContainersHealthChecksHealthCheckType,
                        FailureAction = containerInstanceContainersHealthChecksFailureAction,
                        FailureThreshold = containerInstanceContainersHealthChecksFailureThreshold,
                        Headers = new[]
                        {
                            new Oci.ContainerEngine.Inputs.ContainerInstanceContainerHealthCheckHeaderArgs
                            {
                                Name = containerInstanceContainersHealthChecksHeadersName,
                                Value = containerInstanceContainersHealthChecksHeadersValue,
                            },
                        },
                        InitialDelayInSeconds = containerInstanceContainersHealthChecksInitialDelayInSeconds,
                        IntervalInSeconds = containerInstanceContainersHealthChecksIntervalInSeconds,
                        Name = containerInstanceContainersHealthChecksName,
                        Path = containerInstanceContainersHealthChecksPath,
                        Port = containerInstanceContainersHealthChecksPort,
                        SuccessThreshold = containerInstanceContainersHealthChecksSuccessThreshold,
                        TimeoutInSeconds = containerInstanceContainersHealthChecksTimeoutInSeconds,
                    },
                },
                IsResourcePrincipalDisabled = containerInstanceContainersIsResourcePrincipalDisabled,
                ResourceConfig = new Oci.ContainerEngine.Inputs.ContainerInstanceContainerResourceConfigArgs
                {
                    MemoryLimitInGbs = containerInstanceContainersResourceConfigMemoryLimitInGbs,
                    VcpusLimit = containerInstanceContainersResourceConfigVcpusLimit,
                },
                SecurityContext = new Oci.ContainerEngine.Inputs.ContainerInstanceContainerSecurityContextArgs
                {
                    Capabilities = new Oci.ContainerEngine.Inputs.ContainerInstanceContainerSecurityContextCapabilitiesArgs
                    {
                        AddCapabilities = containerInstanceContainersSecurityContextCapabilitiesAddCapabilities,
                        DropCapabilities = containerInstanceContainersSecurityContextCapabilitiesDropCapabilities,
                    },
                    IsNonRootUserCheckEnabled = containerInstanceContainersSecurityContextIsNonRootUserCheckEnabled,
                    IsRootFileSystemReadonly = containerInstanceContainersSecurityContextIsRootFileSystemReadonly,
                    RunAsGroup = containerInstanceContainersSecurityContextRunAsGroup,
                    RunAsUser = containerInstanceContainersSecurityContextRunAsUser,
                    SecurityContextType = containerInstanceContainersSecurityContextSecurityContextType,
                },
                VolumeMounts = new[]
                {
                    new Oci.ContainerEngine.Inputs.ContainerInstanceContainerVolumeMountArgs
                    {
                        MountPath = containerInstanceContainersVolumeMountsMountPath,
                        VolumeName = containerInstanceContainersVolumeMountsVolumeName,
                        IsReadOnly = containerInstanceContainersVolumeMountsIsReadOnly,
                        Partition = containerInstanceContainersVolumeMountsPartition,
                        SubPath = containerInstanceContainersVolumeMountsSubPath,
                    },
                },
                WorkingDirectory = containerInstanceContainersWorkingDirectory,
            },
        },
        Shape = containerInstanceShape,
        ShapeConfig = new Oci.ContainerEngine.Inputs.ContainerInstanceShapeConfigArgs
        {
            Ocpus = containerInstanceShapeConfigOcpus,
            MemoryInGbs = containerInstanceShapeConfigMemoryInGbs,
        },
        Vnics = new[]
        {
            new Oci.ContainerEngine.Inputs.ContainerInstanceVnicArgs
            {
                SubnetId = testSubnet.Id,
                DefinedTags = containerInstanceVnicsDefinedTags,
                DisplayName = containerInstanceVnicsDisplayName,
                FreeformTags = containerInstanceVnicsFreeformTags,
                HostnameLabel = containerInstanceVnicsHostnameLabel,
                IsPublicIpAssigned = containerInstanceVnicsIsPublicIpAssigned,
                NsgIds = containerInstanceVnicsNsgIds,
                PrivateIp = containerInstanceVnicsPrivateIp,
                SkipSourceDestCheck = containerInstanceVnicsSkipSourceDestCheck,
            },
        },
        ContainerRestartPolicy = containerInstanceContainerRestartPolicy,
        DefinedTags = 
        {
            { "foo-namespace.bar-key", "value" },
        },
        DisplayName = containerInstanceDisplayName,
        DnsConfig = new Oci.ContainerEngine.Inputs.ContainerInstanceDnsConfigArgs
        {
            Nameservers = containerInstanceDnsConfigNameservers,
            Options = containerInstanceDnsConfigOptions,
            Searches = containerInstanceDnsConfigSearches,
        },
        FaultDomain = containerInstanceFaultDomain,
        FreeformTags = 
        {
            { "bar-key", "value" },
        },
        GracefulShutdownTimeoutInSeconds = containerInstanceGracefulShutdownTimeoutInSeconds,
        ImagePullSecrets = new[]
        {
            new Oci.ContainerEngine.Inputs.ContainerInstanceImagePullSecretArgs
            {
                RegistryEndpoint = containerInstanceImagePullSecretsRegistryEndpoint,
                SecretType = containerInstanceImagePullSecretsSecretType,
                Password = containerInstanceImagePullSecretsPassword,
                SecretId = testSecret.Id,
                Username = containerInstanceImagePullSecretsUsername,
            },
        },
        Volumes = new[]
        {
            new Oci.ContainerEngine.Inputs.ContainerInstanceVolumeArgs
            {
                Name = containerInstanceVolumesName,
                VolumeType = containerInstanceVolumesVolumeType,
                BackingStore = containerInstanceVolumesBackingStore,
                Configs = new[]
                {
                    new Oci.ContainerEngine.Inputs.ContainerInstanceVolumeConfigArgs
                    {
                        Data = containerInstanceVolumesConfigsData,
                        FileName = containerInstanceVolumesConfigsFileName,
                        Path = containerInstanceVolumesConfigsPath,
                    },
                },
            },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.ContainerEngine.ContainerInstance;
import com.pulumi.oci.ContainerEngine.ContainerInstanceArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceContainerArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceContainerResourceConfigArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceContainerSecurityContextArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceContainerSecurityContextCapabilitiesArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceShapeConfigArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceVnicArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceDnsConfigArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceImagePullSecretArgs;
import com.pulumi.oci.ContainerEngine.inputs.ContainerInstanceVolumeArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var testContainerInstance = new ContainerInstance("testContainerInstance", ContainerInstanceArgs.builder()
            .availabilityDomain(containerInstanceAvailabilityDomain)
            .compartmentId(compartmentId)
            .containers(ContainerInstanceContainerArgs.builder()
                .imageUrl(containerInstanceContainersImageUrl)
                .arguments(containerInstanceContainersArguments)
                .commands(containerInstanceContainersCommand)
                .definedTags(containerInstanceContainersDefinedTags)
                .displayName(containerInstanceContainersDisplayName)
                .environmentVariables(containerInstanceContainersEnvironmentVariables)
                .freeformTags(containerInstanceContainersFreeformTags)
                .healthChecks(ContainerInstanceContainerHealthCheckArgs.builder()
                    .healthCheckType(containerInstanceContainersHealthChecksHealthCheckType)
                    .failureAction(containerInstanceContainersHealthChecksFailureAction)
                    .failureThreshold(containerInstanceContainersHealthChecksFailureThreshold)
                    .headers(ContainerInstanceContainerHealthCheckHeaderArgs.builder()
                        .name(containerInstanceContainersHealthChecksHeadersName)
                        .value(containerInstanceContainersHealthChecksHeadersValue)
                        .build())
                    .initialDelayInSeconds(containerInstanceContainersHealthChecksInitialDelayInSeconds)
                    .intervalInSeconds(containerInstanceContainersHealthChecksIntervalInSeconds)
                    .name(containerInstanceContainersHealthChecksName)
                    .path(containerInstanceContainersHealthChecksPath)
                    .port(containerInstanceContainersHealthChecksPort)
                    .successThreshold(containerInstanceContainersHealthChecksSuccessThreshold)
                    .timeoutInSeconds(containerInstanceContainersHealthChecksTimeoutInSeconds)
                    .build())
                .isResourcePrincipalDisabled(containerInstanceContainersIsResourcePrincipalDisabled)
                .resourceConfig(ContainerInstanceContainerResourceConfigArgs.builder()
                    .memoryLimitInGbs(containerInstanceContainersResourceConfigMemoryLimitInGbs)
                    .vcpusLimit(containerInstanceContainersResourceConfigVcpusLimit)
                    .build())
                .securityContext(ContainerInstanceContainerSecurityContextArgs.builder()
                    .capabilities(ContainerInstanceContainerSecurityContextCapabilitiesArgs.builder()
                        .addCapabilities(containerInstanceContainersSecurityContextCapabilitiesAddCapabilities)
                        .dropCapabilities(containerInstanceContainersSecurityContextCapabilitiesDropCapabilities)
                        .build())
                    .isNonRootUserCheckEnabled(containerInstanceContainersSecurityContextIsNonRootUserCheckEnabled)
                    .isRootFileSystemReadonly(containerInstanceContainersSecurityContextIsRootFileSystemReadonly)
                    .runAsGroup(containerInstanceContainersSecurityContextRunAsGroup)
                    .runAsUser(containerInstanceContainersSecurityContextRunAsUser)
                    .securityContextType(containerInstanceContainersSecurityContextSecurityContextType)
                    .build())
                .volumeMounts(ContainerInstanceContainerVolumeMountArgs.builder()
                    .mountPath(containerInstanceContainersVolumeMountsMountPath)
                    .volumeName(containerInstanceContainersVolumeMountsVolumeName)
                    .isReadOnly(containerInstanceContainersVolumeMountsIsReadOnly)
                    .partition(containerInstanceContainersVolumeMountsPartition)
                    .subPath(containerInstanceContainersVolumeMountsSubPath)
                    .build())
                .workingDirectory(containerInstanceContainersWorkingDirectory)
                .build())
            .shape(containerInstanceShape)
            .shapeConfig(ContainerInstanceShapeConfigArgs.builder()
                .ocpus(containerInstanceShapeConfigOcpus)
                .memoryInGbs(containerInstanceShapeConfigMemoryInGbs)
                .build())
            .vnics(ContainerInstanceVnicArgs.builder()
                .subnetId(testSubnet.id())
                .definedTags(containerInstanceVnicsDefinedTags)
                .displayName(containerInstanceVnicsDisplayName)
                .freeformTags(containerInstanceVnicsFreeformTags)
                .hostnameLabel(containerInstanceVnicsHostnameLabel)
                .isPublicIpAssigned(containerInstanceVnicsIsPublicIpAssigned)
                .nsgIds(containerInstanceVnicsNsgIds)
                .privateIp(containerInstanceVnicsPrivateIp)
                .skipSourceDestCheck(containerInstanceVnicsSkipSourceDestCheck)
                .build())
            .containerRestartPolicy(containerInstanceContainerRestartPolicy)
            .definedTags(Map.of("foo-namespace.bar-key", "value"))
            .displayName(containerInstanceDisplayName)
            .dnsConfig(ContainerInstanceDnsConfigArgs.builder()
                .nameservers(containerInstanceDnsConfigNameservers)
                .options(containerInstanceDnsConfigOptions)
                .searches(containerInstanceDnsConfigSearches)
                .build())
            .faultDomain(containerInstanceFaultDomain)
            .freeformTags(Map.of("bar-key", "value"))
            .gracefulShutdownTimeoutInSeconds(containerInstanceGracefulShutdownTimeoutInSeconds)
            .imagePullSecrets(ContainerInstanceImagePullSecretArgs.builder()
                .registryEndpoint(containerInstanceImagePullSecretsRegistryEndpoint)
                .secretType(containerInstanceImagePullSecretsSecretType)
                .password(containerInstanceImagePullSecretsPassword)
                .secretId(testSecret.id())
                .username(containerInstanceImagePullSecretsUsername)
                .build())
            .volumes(ContainerInstanceVolumeArgs.builder()
                .name(containerInstanceVolumesName)
                .volumeType(containerInstanceVolumesVolumeType)
                .backingStore(containerInstanceVolumesBackingStore)
                .configs(ContainerInstanceVolumeConfigArgs.builder()
                    .data(containerInstanceVolumesConfigsData)
                    .fileName(containerInstanceVolumesConfigsFileName)
                    .path(containerInstanceVolumesConfigsPath)
                    .build())
                .build())
            .build());

    }
}
Copy
resources:
  testContainerInstance:
    type: oci:ContainerEngine:ContainerInstance
    name: test_container_instance
    properties:
      availabilityDomain: ${containerInstanceAvailabilityDomain}
      compartmentId: ${compartmentId}
      containers:
        - imageUrl: ${containerInstanceContainersImageUrl}
          arguments: ${containerInstanceContainersArguments}
          commands: ${containerInstanceContainersCommand}
          definedTags: ${containerInstanceContainersDefinedTags}
          displayName: ${containerInstanceContainersDisplayName}
          environmentVariables: ${containerInstanceContainersEnvironmentVariables}
          freeformTags: ${containerInstanceContainersFreeformTags}
          healthChecks:
            - healthCheckType: ${containerInstanceContainersHealthChecksHealthCheckType}
              failureAction: ${containerInstanceContainersHealthChecksFailureAction}
              failureThreshold: ${containerInstanceContainersHealthChecksFailureThreshold}
              headers:
                - name: ${containerInstanceContainersHealthChecksHeadersName}
                  value: ${containerInstanceContainersHealthChecksHeadersValue}
              initialDelayInSeconds: ${containerInstanceContainersHealthChecksInitialDelayInSeconds}
              intervalInSeconds: ${containerInstanceContainersHealthChecksIntervalInSeconds}
              name: ${containerInstanceContainersHealthChecksName}
              path: ${containerInstanceContainersHealthChecksPath}
              port: ${containerInstanceContainersHealthChecksPort}
              successThreshold: ${containerInstanceContainersHealthChecksSuccessThreshold}
              timeoutInSeconds: ${containerInstanceContainersHealthChecksTimeoutInSeconds}
          isResourcePrincipalDisabled: ${containerInstanceContainersIsResourcePrincipalDisabled}
          resourceConfig:
            memoryLimitInGbs: ${containerInstanceContainersResourceConfigMemoryLimitInGbs}
            vcpusLimit: ${containerInstanceContainersResourceConfigVcpusLimit}
          securityContext:
            capabilities:
              addCapabilities: ${containerInstanceContainersSecurityContextCapabilitiesAddCapabilities}
              dropCapabilities: ${containerInstanceContainersSecurityContextCapabilitiesDropCapabilities}
            isNonRootUserCheckEnabled: ${containerInstanceContainersSecurityContextIsNonRootUserCheckEnabled}
            isRootFileSystemReadonly: ${containerInstanceContainersSecurityContextIsRootFileSystemReadonly}
            runAsGroup: ${containerInstanceContainersSecurityContextRunAsGroup}
            runAsUser: ${containerInstanceContainersSecurityContextRunAsUser}
            securityContextType: ${containerInstanceContainersSecurityContextSecurityContextType}
          volumeMounts:
            - mountPath: ${containerInstanceContainersVolumeMountsMountPath}
              volumeName: ${containerInstanceContainersVolumeMountsVolumeName}
              isReadOnly: ${containerInstanceContainersVolumeMountsIsReadOnly}
              partition: ${containerInstanceContainersVolumeMountsPartition}
              subPath: ${containerInstanceContainersVolumeMountsSubPath}
          workingDirectory: ${containerInstanceContainersWorkingDirectory}
      shape: ${containerInstanceShape}
      shapeConfig:
        ocpus: ${containerInstanceShapeConfigOcpus}
        memoryInGbs: ${containerInstanceShapeConfigMemoryInGbs}
      vnics:
        - subnetId: ${testSubnet.id}
          definedTags: ${containerInstanceVnicsDefinedTags}
          displayName: ${containerInstanceVnicsDisplayName}
          freeformTags: ${containerInstanceVnicsFreeformTags}
          hostnameLabel: ${containerInstanceVnicsHostnameLabel}
          isPublicIpAssigned: ${containerInstanceVnicsIsPublicIpAssigned}
          nsgIds: ${containerInstanceVnicsNsgIds}
          privateIp: ${containerInstanceVnicsPrivateIp}
          skipSourceDestCheck: ${containerInstanceVnicsSkipSourceDestCheck}
      containerRestartPolicy: ${containerInstanceContainerRestartPolicy}
      definedTags:
        foo-namespace.bar-key: value
      displayName: ${containerInstanceDisplayName}
      dnsConfig:
        nameservers: ${containerInstanceDnsConfigNameservers}
        options: ${containerInstanceDnsConfigOptions}
        searches: ${containerInstanceDnsConfigSearches}
      faultDomain: ${containerInstanceFaultDomain}
      freeformTags:
        bar-key: value
      gracefulShutdownTimeoutInSeconds: ${containerInstanceGracefulShutdownTimeoutInSeconds}
      imagePullSecrets:
        - registryEndpoint: ${containerInstanceImagePullSecretsRegistryEndpoint}
          secretType: ${containerInstanceImagePullSecretsSecretType}
          password: ${containerInstanceImagePullSecretsPassword}
          secretId: ${testSecret.id}
          username: ${containerInstanceImagePullSecretsUsername}
      volumes:
        - name: ${containerInstanceVolumesName}
          volumeType: ${containerInstanceVolumesVolumeType}
          backingStore: ${containerInstanceVolumesBackingStore}
          configs:
            - data: ${containerInstanceVolumesConfigsData}
              fileName: ${containerInstanceVolumesConfigsFileName}
              path: ${containerInstanceVolumesConfigsPath}
Copy

Create ContainerInstance Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new ContainerInstance(name: string, args: ContainerInstanceArgs, opts?: CustomResourceOptions);
@overload
def ContainerInstance(resource_name: str,
                      args: ContainerInstanceArgs,
                      opts: Optional[ResourceOptions] = None)

@overload
def ContainerInstance(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      shape: Optional[str] = None,
                      compartment_id: Optional[str] = None,
                      vnics: Optional[Sequence[_containerengine.ContainerInstanceVnicArgs]] = None,
                      containers: Optional[Sequence[_containerengine.ContainerInstanceContainerArgs]] = None,
                      availability_domain: Optional[str] = None,
                      shape_config: Optional[_containerengine.ContainerInstanceShapeConfigArgs] = None,
                      defined_tags: Optional[Mapping[str, str]] = None,
                      fault_domain: Optional[str] = None,
                      freeform_tags: Optional[Mapping[str, str]] = None,
                      graceful_shutdown_timeout_in_seconds: Optional[str] = None,
                      image_pull_secrets: Optional[Sequence[_containerengine.ContainerInstanceImagePullSecretArgs]] = None,
                      dns_config: Optional[_containerengine.ContainerInstanceDnsConfigArgs] = None,
                      display_name: Optional[str] = None,
                      state: Optional[str] = None,
                      container_restart_policy: Optional[str] = None,
                      volumes: Optional[Sequence[_containerengine.ContainerInstanceVolumeArgs]] = None)
func NewContainerInstance(ctx *Context, name string, args ContainerInstanceArgs, opts ...ResourceOption) (*ContainerInstance, error)
public ContainerInstance(string name, ContainerInstanceArgs args, CustomResourceOptions? opts = null)
public ContainerInstance(String name, ContainerInstanceArgs args)
public ContainerInstance(String name, ContainerInstanceArgs args, CustomResourceOptions options)
type: oci:ContainerEngine:ContainerInstance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. ContainerInstanceArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. ContainerInstanceArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. ContainerInstanceArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. ContainerInstanceArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. ContainerInstanceArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var containerInstanceResource = new Oci.ContainerEngine.ContainerInstance("containerInstanceResource", new()
{
    Shape = "string",
    CompartmentId = "string",
    Vnics = new[]
    {
        new Oci.ContainerEngine.Inputs.ContainerInstanceVnicArgs
        {
            SubnetId = "string",
            DefinedTags = 
            {
                { "string", "string" },
            },
            DisplayName = "string",
            FreeformTags = 
            {
                { "string", "string" },
            },
            HostnameLabel = "string",
            IsPublicIpAssigned = false,
            NsgIds = new[]
            {
                "string",
            },
            PrivateIp = "string",
            SkipSourceDestCheck = false,
            VnicId = "string",
        },
    },
    Containers = new[]
    {
        new Oci.ContainerEngine.Inputs.ContainerInstanceContainerArgs
        {
            ImageUrl = "string",
            HealthChecks = new[]
            {
                new Oci.ContainerEngine.Inputs.ContainerInstanceContainerHealthCheckArgs
                {
                    HealthCheckType = "string",
                    Name = "string",
                    Headers = new[]
                    {
                        new Oci.ContainerEngine.Inputs.ContainerInstanceContainerHealthCheckHeaderArgs
                        {
                            Name = "string",
                            Value = "string",
                        },
                    },
                    FailureThreshold = 0,
                    InitialDelayInSeconds = 0,
                    IntervalInSeconds = 0,
                    FailureAction = "string",
                    Path = "string",
                    Port = 0,
                    Status = "string",
                    StatusDetails = "string",
                    SuccessThreshold = 0,
                    TimeoutInSeconds = 0,
                },
            },
            DisplayName = "string",
            CompartmentId = "string",
            ContainerId = "string",
            ContainerInstanceId = "string",
            DefinedTags = 
            {
                { "string", "string" },
            },
            Arguments = new[]
            {
                "string",
            },
            EnvironmentVariables = 
            {
                { "string", "string" },
            },
            ExitCode = 0,
            FaultDomain = "string",
            Commands = new[]
            {
                "string",
            },
            FreeformTags = 
            {
                { "string", "string" },
            },
            SecurityContext = new Oci.ContainerEngine.Inputs.ContainerInstanceContainerSecurityContextArgs
            {
                Capabilities = new Oci.ContainerEngine.Inputs.ContainerInstanceContainerSecurityContextCapabilitiesArgs
                {
                    AddCapabilities = new[]
                    {
                        "string",
                    },
                    DropCapabilities = new[]
                    {
                        "string",
                    },
                },
                IsNonRootUserCheckEnabled = false,
                IsRootFileSystemReadonly = false,
                RunAsGroup = 0,
                RunAsUser = 0,
                SecurityContextType = "string",
            },
            IsResourcePrincipalDisabled = false,
            LifecycleDetails = "string",
            ResourceConfig = new Oci.ContainerEngine.Inputs.ContainerInstanceContainerResourceConfigArgs
            {
                MemoryLimitInGbs = 0,
                VcpusLimit = 0,
            },
            AvailabilityDomain = "string",
            State = "string",
            SystemTags = 
            {
                { "string", "string" },
            },
            TimeCreated = "string",
            TimeTerminated = "string",
            TimeUpdated = "string",
            VolumeMounts = new[]
            {
                new Oci.ContainerEngine.Inputs.ContainerInstanceContainerVolumeMountArgs
                {
                    MountPath = "string",
                    VolumeName = "string",
                    IsReadOnly = false,
                    Partition = 0,
                    SubPath = "string",
                },
            },
            WorkingDirectory = "string",
        },
    },
    AvailabilityDomain = "string",
    ShapeConfig = new Oci.ContainerEngine.Inputs.ContainerInstanceShapeConfigArgs
    {
        Ocpus = 0,
        MemoryInGbs = 0,
        NetworkingBandwidthInGbps = 0,
        ProcessorDescription = "string",
    },
    DefinedTags = 
    {
        { "string", "string" },
    },
    FaultDomain = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
    GracefulShutdownTimeoutInSeconds = "string",
    ImagePullSecrets = new[]
    {
        new Oci.ContainerEngine.Inputs.ContainerInstanceImagePullSecretArgs
        {
            RegistryEndpoint = "string",
            SecretType = "string",
            Password = "string",
            SecretId = "string",
            Username = "string",
        },
    },
    DnsConfig = new Oci.ContainerEngine.Inputs.ContainerInstanceDnsConfigArgs
    {
        Nameservers = new[]
        {
            "string",
        },
        Options = new[]
        {
            "string",
        },
        Searches = new[]
        {
            "string",
        },
    },
    DisplayName = "string",
    State = "string",
    ContainerRestartPolicy = "string",
    Volumes = new[]
    {
        new Oci.ContainerEngine.Inputs.ContainerInstanceVolumeArgs
        {
            Name = "string",
            VolumeType = "string",
            BackingStore = "string",
            Configs = new[]
            {
                new Oci.ContainerEngine.Inputs.ContainerInstanceVolumeConfigArgs
                {
                    Data = "string",
                    FileName = "string",
                    Path = "string",
                },
            },
        },
    },
});
Copy
example, err := containerengine.NewContainerInstance(ctx, "containerInstanceResource", &containerengine.ContainerInstanceArgs{
	Shape:         pulumi.String("string"),
	CompartmentId: pulumi.String("string"),
	Vnics: containerengine.ContainerInstanceVnicArray{
		&containerengine.ContainerInstanceVnicArgs{
			SubnetId: pulumi.String("string"),
			DefinedTags: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			DisplayName: pulumi.String("string"),
			FreeformTags: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			HostnameLabel:      pulumi.String("string"),
			IsPublicIpAssigned: pulumi.Bool(false),
			NsgIds: pulumi.StringArray{
				pulumi.String("string"),
			},
			PrivateIp:           pulumi.String("string"),
			SkipSourceDestCheck: pulumi.Bool(false),
			VnicId:              pulumi.String("string"),
		},
	},
	Containers: containerengine.ContainerInstanceContainerArray{
		&containerengine.ContainerInstanceContainerArgs{
			ImageUrl: pulumi.String("string"),
			HealthChecks: containerengine.ContainerInstanceContainerHealthCheckArray{
				&containerengine.ContainerInstanceContainerHealthCheckArgs{
					HealthCheckType: pulumi.String("string"),
					Name:            pulumi.String("string"),
					Headers: containerengine.ContainerInstanceContainerHealthCheckHeaderArray{
						&containerengine.ContainerInstanceContainerHealthCheckHeaderArgs{
							Name:  pulumi.String("string"),
							Value: pulumi.String("string"),
						},
					},
					FailureThreshold:      pulumi.Int(0),
					InitialDelayInSeconds: pulumi.Int(0),
					IntervalInSeconds:     pulumi.Int(0),
					FailureAction:         pulumi.String("string"),
					Path:                  pulumi.String("string"),
					Port:                  pulumi.Int(0),
					Status:                pulumi.String("string"),
					StatusDetails:         pulumi.String("string"),
					SuccessThreshold:      pulumi.Int(0),
					TimeoutInSeconds:      pulumi.Int(0),
				},
			},
			DisplayName:         pulumi.String("string"),
			CompartmentId:       pulumi.String("string"),
			ContainerId:         pulumi.String("string"),
			ContainerInstanceId: pulumi.String("string"),
			DefinedTags: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			Arguments: pulumi.StringArray{
				pulumi.String("string"),
			},
			EnvironmentVariables: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			ExitCode:    pulumi.Int(0),
			FaultDomain: pulumi.String("string"),
			Commands: pulumi.StringArray{
				pulumi.String("string"),
			},
			FreeformTags: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			SecurityContext: &containerengine.ContainerInstanceContainerSecurityContextArgs{
				Capabilities: &containerengine.ContainerInstanceContainerSecurityContextCapabilitiesArgs{
					AddCapabilities: pulumi.StringArray{
						pulumi.String("string"),
					},
					DropCapabilities: pulumi.StringArray{
						pulumi.String("string"),
					},
				},
				IsNonRootUserCheckEnabled: pulumi.Bool(false),
				IsRootFileSystemReadonly:  pulumi.Bool(false),
				RunAsGroup:                pulumi.Int(0),
				RunAsUser:                 pulumi.Int(0),
				SecurityContextType:       pulumi.String("string"),
			},
			IsResourcePrincipalDisabled: pulumi.Bool(false),
			LifecycleDetails:            pulumi.String("string"),
			ResourceConfig: &containerengine.ContainerInstanceContainerResourceConfigArgs{
				MemoryLimitInGbs: pulumi.Float64(0),
				VcpusLimit:       pulumi.Float64(0),
			},
			AvailabilityDomain: pulumi.String("string"),
			State:              pulumi.String("string"),
			SystemTags: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			TimeCreated:    pulumi.String("string"),
			TimeTerminated: pulumi.String("string"),
			TimeUpdated:    pulumi.String("string"),
			VolumeMounts: containerengine.ContainerInstanceContainerVolumeMountArray{
				&containerengine.ContainerInstanceContainerVolumeMountArgs{
					MountPath:  pulumi.String("string"),
					VolumeName: pulumi.String("string"),
					IsReadOnly: pulumi.Bool(false),
					Partition:  pulumi.Int(0),
					SubPath:    pulumi.String("string"),
				},
			},
			WorkingDirectory: pulumi.String("string"),
		},
	},
	AvailabilityDomain: pulumi.String("string"),
	ShapeConfig: &containerengine.ContainerInstanceShapeConfigArgs{
		Ocpus:                     pulumi.Float64(0),
		MemoryInGbs:               pulumi.Float64(0),
		NetworkingBandwidthInGbps: pulumi.Float64(0),
		ProcessorDescription:      pulumi.String("string"),
	},
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	FaultDomain: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	GracefulShutdownTimeoutInSeconds: pulumi.String("string"),
	ImagePullSecrets: containerengine.ContainerInstanceImagePullSecretArray{
		&containerengine.ContainerInstanceImagePullSecretArgs{
			RegistryEndpoint: pulumi.String("string"),
			SecretType:       pulumi.String("string"),
			Password:         pulumi.String("string"),
			SecretId:         pulumi.String("string"),
			Username:         pulumi.String("string"),
		},
	},
	DnsConfig: &containerengine.ContainerInstanceDnsConfigArgs{
		Nameservers: pulumi.StringArray{
			pulumi.String("string"),
		},
		Options: pulumi.StringArray{
			pulumi.String("string"),
		},
		Searches: pulumi.StringArray{
			pulumi.String("string"),
		},
	},
	DisplayName:            pulumi.String("string"),
	State:                  pulumi.String("string"),
	ContainerRestartPolicy: pulumi.String("string"),
	Volumes: containerengine.ContainerInstanceVolumeArray{
		&containerengine.ContainerInstanceVolumeArgs{
			Name:         pulumi.String("string"),
			VolumeType:   pulumi.String("string"),
			BackingStore: pulumi.String("string"),
			Configs: containerengine.ContainerInstanceVolumeConfigArray{
				&containerengine.ContainerInstanceVolumeConfigArgs{
					Data:     pulumi.String("string"),
					FileName: pulumi.String("string"),
					Path:     pulumi.String("string"),
				},
			},
		},
	},
})
Copy
var containerInstanceResource = new ContainerInstance("containerInstanceResource", ContainerInstanceArgs.builder()
    .shape("string")
    .compartmentId("string")
    .vnics(ContainerInstanceVnicArgs.builder()
        .subnetId("string")
        .definedTags(Map.of("string", "string"))
        .displayName("string")
        .freeformTags(Map.of("string", "string"))
        .hostnameLabel("string")
        .isPublicIpAssigned(false)
        .nsgIds("string")
        .privateIp("string")
        .skipSourceDestCheck(false)
        .vnicId("string")
        .build())
    .containers(ContainerInstanceContainerArgs.builder()
        .imageUrl("string")
        .healthChecks(ContainerInstanceContainerHealthCheckArgs.builder()
            .healthCheckType("string")
            .name("string")
            .headers(ContainerInstanceContainerHealthCheckHeaderArgs.builder()
                .name("string")
                .value("string")
                .build())
            .failureThreshold(0)
            .initialDelayInSeconds(0)
            .intervalInSeconds(0)
            .failureAction("string")
            .path("string")
            .port(0)
            .status("string")
            .statusDetails("string")
            .successThreshold(0)
            .timeoutInSeconds(0)
            .build())
        .displayName("string")
        .compartmentId("string")
        .containerId("string")
        .containerInstanceId("string")
        .definedTags(Map.of("string", "string"))
        .arguments("string")
        .environmentVariables(Map.of("string", "string"))
        .exitCode(0)
        .faultDomain("string")
        .commands("string")
        .freeformTags(Map.of("string", "string"))
        .securityContext(ContainerInstanceContainerSecurityContextArgs.builder()
            .capabilities(ContainerInstanceContainerSecurityContextCapabilitiesArgs.builder()
                .addCapabilities("string")
                .dropCapabilities("string")
                .build())
            .isNonRootUserCheckEnabled(false)
            .isRootFileSystemReadonly(false)
            .runAsGroup(0)
            .runAsUser(0)
            .securityContextType("string")
            .build())
        .isResourcePrincipalDisabled(false)
        .lifecycleDetails("string")
        .resourceConfig(ContainerInstanceContainerResourceConfigArgs.builder()
            .memoryLimitInGbs(0)
            .vcpusLimit(0)
            .build())
        .availabilityDomain("string")
        .state("string")
        .systemTags(Map.of("string", "string"))
        .timeCreated("string")
        .timeTerminated("string")
        .timeUpdated("string")
        .volumeMounts(ContainerInstanceContainerVolumeMountArgs.builder()
            .mountPath("string")
            .volumeName("string")
            .isReadOnly(false)
            .partition(0)
            .subPath("string")
            .build())
        .workingDirectory("string")
        .build())
    .availabilityDomain("string")
    .shapeConfig(ContainerInstanceShapeConfigArgs.builder()
        .ocpus(0)
        .memoryInGbs(0)
        .networkingBandwidthInGbps(0)
        .processorDescription("string")
        .build())
    .definedTags(Map.of("string", "string"))
    .faultDomain("string")
    .freeformTags(Map.of("string", "string"))
    .gracefulShutdownTimeoutInSeconds("string")
    .imagePullSecrets(ContainerInstanceImagePullSecretArgs.builder()
        .registryEndpoint("string")
        .secretType("string")
        .password("string")
        .secretId("string")
        .username("string")
        .build())
    .dnsConfig(ContainerInstanceDnsConfigArgs.builder()
        .nameservers("string")
        .options("string")
        .searches("string")
        .build())
    .displayName("string")
    .state("string")
    .containerRestartPolicy("string")
    .volumes(ContainerInstanceVolumeArgs.builder()
        .name("string")
        .volumeType("string")
        .backingStore("string")
        .configs(ContainerInstanceVolumeConfigArgs.builder()
            .data("string")
            .fileName("string")
            .path("string")
            .build())
        .build())
    .build());
Copy
container_instance_resource = oci.container_engine.ContainerInstance("containerInstanceResource",
    shape="string",
    compartment_id="string",
    vnics=[{
        "subnet_id": "string",
        "defined_tags": {
            "string": "string",
        },
        "display_name": "string",
        "freeform_tags": {
            "string": "string",
        },
        "hostname_label": "string",
        "is_public_ip_assigned": False,
        "nsg_ids": ["string"],
        "private_ip": "string",
        "skip_source_dest_check": False,
        "vnic_id": "string",
    }],
    containers=[{
        "image_url": "string",
        "health_checks": [{
            "health_check_type": "string",
            "name": "string",
            "headers": [{
                "name": "string",
                "value": "string",
            }],
            "failure_threshold": 0,
            "initial_delay_in_seconds": 0,
            "interval_in_seconds": 0,
            "failure_action": "string",
            "path": "string",
            "port": 0,
            "status": "string",
            "status_details": "string",
            "success_threshold": 0,
            "timeout_in_seconds": 0,
        }],
        "display_name": "string",
        "compartment_id": "string",
        "container_id": "string",
        "container_instance_id": "string",
        "defined_tags": {
            "string": "string",
        },
        "arguments": ["string"],
        "environment_variables": {
            "string": "string",
        },
        "exit_code": 0,
        "fault_domain": "string",
        "commands": ["string"],
        "freeform_tags": {
            "string": "string",
        },
        "security_context": {
            "capabilities": {
                "add_capabilities": ["string"],
                "drop_capabilities": ["string"],
            },
            "is_non_root_user_check_enabled": False,
            "is_root_file_system_readonly": False,
            "run_as_group": 0,
            "run_as_user": 0,
            "security_context_type": "string",
        },
        "is_resource_principal_disabled": False,
        "lifecycle_details": "string",
        "resource_config": {
            "memory_limit_in_gbs": 0,
            "vcpus_limit": 0,
        },
        "availability_domain": "string",
        "state": "string",
        "system_tags": {
            "string": "string",
        },
        "time_created": "string",
        "time_terminated": "string",
        "time_updated": "string",
        "volume_mounts": [{
            "mount_path": "string",
            "volume_name": "string",
            "is_read_only": False,
            "partition": 0,
            "sub_path": "string",
        }],
        "working_directory": "string",
    }],
    availability_domain="string",
    shape_config={
        "ocpus": 0,
        "memory_in_gbs": 0,
        "networking_bandwidth_in_gbps": 0,
        "processor_description": "string",
    },
    defined_tags={
        "string": "string",
    },
    fault_domain="string",
    freeform_tags={
        "string": "string",
    },
    graceful_shutdown_timeout_in_seconds="string",
    image_pull_secrets=[{
        "registry_endpoint": "string",
        "secret_type": "string",
        "password": "string",
        "secret_id": "string",
        "username": "string",
    }],
    dns_config={
        "nameservers": ["string"],
        "options": ["string"],
        "searches": ["string"],
    },
    display_name="string",
    state="string",
    container_restart_policy="string",
    volumes=[{
        "name": "string",
        "volume_type": "string",
        "backing_store": "string",
        "configs": [{
            "data": "string",
            "file_name": "string",
            "path": "string",
        }],
    }])
Copy
const containerInstanceResource = new oci.containerengine.ContainerInstance("containerInstanceResource", {
    shape: "string",
    compartmentId: "string",
    vnics: [{
        subnetId: "string",
        definedTags: {
            string: "string",
        },
        displayName: "string",
        freeformTags: {
            string: "string",
        },
        hostnameLabel: "string",
        isPublicIpAssigned: false,
        nsgIds: ["string"],
        privateIp: "string",
        skipSourceDestCheck: false,
        vnicId: "string",
    }],
    containers: [{
        imageUrl: "string",
        healthChecks: [{
            healthCheckType: "string",
            name: "string",
            headers: [{
                name: "string",
                value: "string",
            }],
            failureThreshold: 0,
            initialDelayInSeconds: 0,
            intervalInSeconds: 0,
            failureAction: "string",
            path: "string",
            port: 0,
            status: "string",
            statusDetails: "string",
            successThreshold: 0,
            timeoutInSeconds: 0,
        }],
        displayName: "string",
        compartmentId: "string",
        containerId: "string",
        containerInstanceId: "string",
        definedTags: {
            string: "string",
        },
        arguments: ["string"],
        environmentVariables: {
            string: "string",
        },
        exitCode: 0,
        faultDomain: "string",
        commands: ["string"],
        freeformTags: {
            string: "string",
        },
        securityContext: {
            capabilities: {
                addCapabilities: ["string"],
                dropCapabilities: ["string"],
            },
            isNonRootUserCheckEnabled: false,
            isRootFileSystemReadonly: false,
            runAsGroup: 0,
            runAsUser: 0,
            securityContextType: "string",
        },
        isResourcePrincipalDisabled: false,
        lifecycleDetails: "string",
        resourceConfig: {
            memoryLimitInGbs: 0,
            vcpusLimit: 0,
        },
        availabilityDomain: "string",
        state: "string",
        systemTags: {
            string: "string",
        },
        timeCreated: "string",
        timeTerminated: "string",
        timeUpdated: "string",
        volumeMounts: [{
            mountPath: "string",
            volumeName: "string",
            isReadOnly: false,
            partition: 0,
            subPath: "string",
        }],
        workingDirectory: "string",
    }],
    availabilityDomain: "string",
    shapeConfig: {
        ocpus: 0,
        memoryInGbs: 0,
        networkingBandwidthInGbps: 0,
        processorDescription: "string",
    },
    definedTags: {
        string: "string",
    },
    faultDomain: "string",
    freeformTags: {
        string: "string",
    },
    gracefulShutdownTimeoutInSeconds: "string",
    imagePullSecrets: [{
        registryEndpoint: "string",
        secretType: "string",
        password: "string",
        secretId: "string",
        username: "string",
    }],
    dnsConfig: {
        nameservers: ["string"],
        options: ["string"],
        searches: ["string"],
    },
    displayName: "string",
    state: "string",
    containerRestartPolicy: "string",
    volumes: [{
        name: "string",
        volumeType: "string",
        backingStore: "string",
        configs: [{
            data: "string",
            fileName: "string",
            path: "string",
        }],
    }],
});
Copy
type: oci:ContainerEngine:ContainerInstance
properties:
    availabilityDomain: string
    compartmentId: string
    containerRestartPolicy: string
    containers:
        - arguments:
            - string
          availabilityDomain: string
          commands:
            - string
          compartmentId: string
          containerId: string
          containerInstanceId: string
          definedTags:
            string: string
          displayName: string
          environmentVariables:
            string: string
          exitCode: 0
          faultDomain: string
          freeformTags:
            string: string
          healthChecks:
            - failureAction: string
              failureThreshold: 0
              headers:
                - name: string
                  value: string
              healthCheckType: string
              initialDelayInSeconds: 0
              intervalInSeconds: 0
              name: string
              path: string
              port: 0
              status: string
              statusDetails: string
              successThreshold: 0
              timeoutInSeconds: 0
          imageUrl: string
          isResourcePrincipalDisabled: false
          lifecycleDetails: string
          resourceConfig:
            memoryLimitInGbs: 0
            vcpusLimit: 0
          securityContext:
            capabilities:
                addCapabilities:
                    - string
                dropCapabilities:
                    - string
            isNonRootUserCheckEnabled: false
            isRootFileSystemReadonly: false
            runAsGroup: 0
            runAsUser: 0
            securityContextType: string
          state: string
          systemTags:
            string: string
          timeCreated: string
          timeTerminated: string
          timeUpdated: string
          volumeMounts:
            - isReadOnly: false
              mountPath: string
              partition: 0
              subPath: string
              volumeName: string
          workingDirectory: string
    definedTags:
        string: string
    displayName: string
    dnsConfig:
        nameservers:
            - string
        options:
            - string
        searches:
            - string
    faultDomain: string
    freeformTags:
        string: string
    gracefulShutdownTimeoutInSeconds: string
    imagePullSecrets:
        - password: string
          registryEndpoint: string
          secretId: string
          secretType: string
          username: string
    shape: string
    shapeConfig:
        memoryInGbs: 0
        networkingBandwidthInGbps: 0
        ocpus: 0
        processorDescription: string
    state: string
    vnics:
        - definedTags:
            string: string
          displayName: string
          freeformTags:
            string: string
          hostnameLabel: string
          isPublicIpAssigned: false
          nsgIds:
            - string
          privateIp: string
          skipSourceDestCheck: false
          subnetId: string
          vnicId: string
    volumes:
        - backingStore: string
          configs:
            - data: string
              fileName: string
              path: string
          name: string
          volumeType: string
Copy

ContainerInstance Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The ContainerInstance resource accepts the following input properties:

AvailabilityDomain
This property is required.
Changes to this property will trigger replacement.
string
The availability domain where the container instance runs.
CompartmentId This property is required. string
(Updatable) The compartment OCID.
Containers
This property is required.
Changes to this property will trigger replacement.
List<ContainerInstanceContainer>
The containers to create on this container instance.
Shape
This property is required.
Changes to this property will trigger replacement.
string
The shape of the container instance. The shape determines the resources available to the container instance.
ShapeConfig
This property is required.
Changes to this property will trigger replacement.
ContainerInstanceShapeConfig
The size and amount of resources available to the container instance.
Vnics
This property is required.
Changes to this property will trigger replacement.
List<ContainerInstanceVnic>
The networks available to containers on this container instance.
ContainerRestartPolicy Changes to this property will trigger replacement. string
Container restart policy
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
DnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfig
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
FaultDomain Changes to this property will trigger replacement. string
The fault domain where the container instance runs.
FreeformTags Dictionary<string, string>
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
GracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. string
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
ImagePullSecrets Changes to this property will trigger replacement. List<ContainerInstanceImagePullSecret>
The image pulls secrets so you can access private registry to pull container images.
State string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Volumes Changes to this property will trigger replacement. List<ContainerInstanceVolume>

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

AvailabilityDomain
This property is required.
Changes to this property will trigger replacement.
string
The availability domain where the container instance runs.
CompartmentId This property is required. string
(Updatable) The compartment OCID.
Containers
This property is required.
Changes to this property will trigger replacement.
[]ContainerInstanceContainerArgs
The containers to create on this container instance.
Shape
This property is required.
Changes to this property will trigger replacement.
string
The shape of the container instance. The shape determines the resources available to the container instance.
ShapeConfig
This property is required.
Changes to this property will trigger replacement.
ContainerInstanceShapeConfigArgs
The size and amount of resources available to the container instance.
Vnics
This property is required.
Changes to this property will trigger replacement.
[]ContainerInstanceVnicArgs
The networks available to containers on this container instance.
ContainerRestartPolicy Changes to this property will trigger replacement. string
Container restart policy
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
DnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfigArgs
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
FaultDomain Changes to this property will trigger replacement. string
The fault domain where the container instance runs.
FreeformTags map[string]string
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
GracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. string
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
ImagePullSecrets Changes to this property will trigger replacement. []ContainerInstanceImagePullSecretArgs
The image pulls secrets so you can access private registry to pull container images.
State string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Volumes Changes to this property will trigger replacement. []ContainerInstanceVolumeArgs

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availabilityDomain
This property is required.
Changes to this property will trigger replacement.
String
The availability domain where the container instance runs.
compartmentId This property is required. String
(Updatable) The compartment OCID.
containers
This property is required.
Changes to this property will trigger replacement.
List<ContainerInstanceContainer>
The containers to create on this container instance.
shape
This property is required.
Changes to this property will trigger replacement.
String
The shape of the container instance. The shape determines the resources available to the container instance.
shapeConfig
This property is required.
Changes to this property will trigger replacement.
ContainerInstanceShapeConfig
The size and amount of resources available to the container instance.
vnics
This property is required.
Changes to this property will trigger replacement.
List<ContainerInstanceVnic>
The networks available to containers on this container instance.
containerRestartPolicy Changes to this property will trigger replacement. String
Container restart policy
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfig
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
faultDomain Changes to this property will trigger replacement. String
The fault domain where the container instance runs.
freeformTags Map<String,String>
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
gracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. String
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
imagePullSecrets Changes to this property will trigger replacement. List<ContainerInstanceImagePullSecret>
The image pulls secrets so you can access private registry to pull container images.
state String

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

volumes Changes to this property will trigger replacement. List<ContainerInstanceVolume>

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availabilityDomain
This property is required.
Changes to this property will trigger replacement.
string
The availability domain where the container instance runs.
compartmentId This property is required. string
(Updatable) The compartment OCID.
containers
This property is required.
Changes to this property will trigger replacement.
ContainerInstanceContainer[]
The containers to create on this container instance.
shape
This property is required.
Changes to this property will trigger replacement.
string
The shape of the container instance. The shape determines the resources available to the container instance.
shapeConfig
This property is required.
Changes to this property will trigger replacement.
ContainerInstanceShapeConfig
The size and amount of resources available to the container instance.
vnics
This property is required.
Changes to this property will trigger replacement.
ContainerInstanceVnic[]
The networks available to containers on this container instance.
containerRestartPolicy Changes to this property will trigger replacement. string
Container restart policy
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName string
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfig
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
faultDomain Changes to this property will trigger replacement. string
The fault domain where the container instance runs.
freeformTags {[key: string]: string}
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
gracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. string
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
imagePullSecrets Changes to this property will trigger replacement. ContainerInstanceImagePullSecret[]
The image pulls secrets so you can access private registry to pull container images.
state string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

volumes Changes to this property will trigger replacement. ContainerInstanceVolume[]

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availability_domain
This property is required.
Changes to this property will trigger replacement.
str
The availability domain where the container instance runs.
compartment_id This property is required. str
(Updatable) The compartment OCID.
containers
This property is required.
Changes to this property will trigger replacement.
Sequence[containerengine.ContainerInstanceContainerArgs]
The containers to create on this container instance.
shape
This property is required.
Changes to this property will trigger replacement.
str
The shape of the container instance. The shape determines the resources available to the container instance.
shape_config
This property is required.
Changes to this property will trigger replacement.
containerengine.ContainerInstanceShapeConfigArgs
The size and amount of resources available to the container instance.
vnics
This property is required.
Changes to this property will trigger replacement.
Sequence[containerengine.ContainerInstanceVnicArgs]
The networks available to containers on this container instance.
container_restart_policy Changes to this property will trigger replacement. str
Container restart policy
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
display_name str
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dns_config Changes to this property will trigger replacement. containerengine.ContainerInstanceDnsConfigArgs
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
fault_domain Changes to this property will trigger replacement. str
The fault domain where the container instance runs.
freeform_tags Mapping[str, str]
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
graceful_shutdown_timeout_in_seconds Changes to this property will trigger replacement. str
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
image_pull_secrets Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceImagePullSecretArgs]
The image pulls secrets so you can access private registry to pull container images.
state str

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

volumes Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceVolumeArgs]

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availabilityDomain
This property is required.
Changes to this property will trigger replacement.
String
The availability domain where the container instance runs.
compartmentId This property is required. String
(Updatable) The compartment OCID.
containers
This property is required.
Changes to this property will trigger replacement.
List<Property Map>
The containers to create on this container instance.
shape
This property is required.
Changes to this property will trigger replacement.
String
The shape of the container instance. The shape determines the resources available to the container instance.
shapeConfig
This property is required.
Changes to this property will trigger replacement.
Property Map
The size and amount of resources available to the container instance.
vnics
This property is required.
Changes to this property will trigger replacement.
List<Property Map>
The networks available to containers on this container instance.
containerRestartPolicy Changes to this property will trigger replacement. String
Container restart policy
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dnsConfig Changes to this property will trigger replacement. Property Map
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
faultDomain Changes to this property will trigger replacement. String
The fault domain where the container instance runs.
freeformTags Map<String>
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
gracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. String
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
imagePullSecrets Changes to this property will trigger replacement. List<Property Map>
The image pulls secrets so you can access private registry to pull container images.
state String

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

volumes Changes to this property will trigger replacement. List<Property Map>

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

Outputs

All input properties are implicitly available as output properties. Additionally, the ContainerInstance resource produces the following output properties:

ContainerCount int
The number of containers on the container instance.
Id string
The provider-assigned unique ID for this managed resource.
LifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
SystemTags Dictionary<string, string>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
TimeCreated string
The time the container instance was created, in the format defined by RFC 3339.
TimeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
VolumeCount int
The number of volumes that are attached to the container instance.
ContainerCount int
The number of containers on the container instance.
Id string
The provider-assigned unique ID for this managed resource.
LifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
SystemTags map[string]string
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
TimeCreated string
The time the container instance was created, in the format defined by RFC 3339.
TimeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
VolumeCount int
The number of volumes that are attached to the container instance.
containerCount Integer
The number of containers on the container instance.
id String
The provider-assigned unique ID for this managed resource.
lifecycleDetails String
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
systemTags Map<String,String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated String
The time the container instance was created, in the format defined by RFC 3339.
timeUpdated String
The time the container instance was updated, in the format defined by RFC 3339.
volumeCount Integer
The number of volumes that are attached to the container instance.
containerCount number
The number of containers on the container instance.
id string
The provider-assigned unique ID for this managed resource.
lifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
systemTags {[key: string]: string}
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated string
The time the container instance was created, in the format defined by RFC 3339.
timeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
volumeCount number
The number of volumes that are attached to the container instance.
container_count int
The number of containers on the container instance.
id str
The provider-assigned unique ID for this managed resource.
lifecycle_details str
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
system_tags Mapping[str, str]
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
time_created str
The time the container instance was created, in the format defined by RFC 3339.
time_updated str
The time the container instance was updated, in the format defined by RFC 3339.
volume_count int
The number of volumes that are attached to the container instance.
containerCount Number
The number of containers on the container instance.
id String
The provider-assigned unique ID for this managed resource.
lifecycleDetails String
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
systemTags Map<String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated String
The time the container instance was created, in the format defined by RFC 3339.
timeUpdated String
The time the container instance was updated, in the format defined by RFC 3339.
volumeCount Number
The number of volumes that are attached to the container instance.

Look up Existing ContainerInstance Resource

Get an existing ContainerInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ContainerInstanceState, opts?: CustomResourceOptions): ContainerInstance
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        availability_domain: Optional[str] = None,
        compartment_id: Optional[str] = None,
        container_count: Optional[int] = None,
        container_restart_policy: Optional[str] = None,
        containers: Optional[Sequence[_containerengine.ContainerInstanceContainerArgs]] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        dns_config: Optional[_containerengine.ContainerInstanceDnsConfigArgs] = None,
        fault_domain: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        graceful_shutdown_timeout_in_seconds: Optional[str] = None,
        image_pull_secrets: Optional[Sequence[_containerengine.ContainerInstanceImagePullSecretArgs]] = None,
        lifecycle_details: Optional[str] = None,
        shape: Optional[str] = None,
        shape_config: Optional[_containerengine.ContainerInstanceShapeConfigArgs] = None,
        state: Optional[str] = None,
        system_tags: Optional[Mapping[str, str]] = None,
        time_created: Optional[str] = None,
        time_updated: Optional[str] = None,
        vnics: Optional[Sequence[_containerengine.ContainerInstanceVnicArgs]] = None,
        volume_count: Optional[int] = None,
        volumes: Optional[Sequence[_containerengine.ContainerInstanceVolumeArgs]] = None) -> ContainerInstance
func GetContainerInstance(ctx *Context, name string, id IDInput, state *ContainerInstanceState, opts ...ResourceOption) (*ContainerInstance, error)
public static ContainerInstance Get(string name, Input<string> id, ContainerInstanceState? state, CustomResourceOptions? opts = null)
public static ContainerInstance get(String name, Output<String> id, ContainerInstanceState state, CustomResourceOptions options)
resources:  _:    type: oci:ContainerEngine:ContainerInstance    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
AvailabilityDomain Changes to this property will trigger replacement. string
The availability domain where the container instance runs.
CompartmentId string
(Updatable) The compartment OCID.
ContainerCount int
The number of containers on the container instance.
ContainerRestartPolicy Changes to this property will trigger replacement. string
Container restart policy
Containers Changes to this property will trigger replacement. List<ContainerInstanceContainer>
The containers to create on this container instance.
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
DnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfig
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
FaultDomain Changes to this property will trigger replacement. string
The fault domain where the container instance runs.
FreeformTags Dictionary<string, string>
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
GracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. string
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
ImagePullSecrets Changes to this property will trigger replacement. List<ContainerInstanceImagePullSecret>
The image pulls secrets so you can access private registry to pull container images.
LifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
Shape Changes to this property will trigger replacement. string
The shape of the container instance. The shape determines the resources available to the container instance.
ShapeConfig Changes to this property will trigger replacement. ContainerInstanceShapeConfig
The size and amount of resources available to the container instance.
State string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

SystemTags Dictionary<string, string>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
TimeCreated string
The time the container instance was created, in the format defined by RFC 3339.
TimeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
Vnics Changes to this property will trigger replacement. List<ContainerInstanceVnic>
The networks available to containers on this container instance.
VolumeCount int
The number of volumes that are attached to the container instance.
Volumes Changes to this property will trigger replacement. List<ContainerInstanceVolume>

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

AvailabilityDomain Changes to this property will trigger replacement. string
The availability domain where the container instance runs.
CompartmentId string
(Updatable) The compartment OCID.
ContainerCount int
The number of containers on the container instance.
ContainerRestartPolicy Changes to this property will trigger replacement. string
Container restart policy
Containers Changes to this property will trigger replacement. []ContainerInstanceContainerArgs
The containers to create on this container instance.
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
DnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfigArgs
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
FaultDomain Changes to this property will trigger replacement. string
The fault domain where the container instance runs.
FreeformTags map[string]string
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
GracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. string
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
ImagePullSecrets Changes to this property will trigger replacement. []ContainerInstanceImagePullSecretArgs
The image pulls secrets so you can access private registry to pull container images.
LifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
Shape Changes to this property will trigger replacement. string
The shape of the container instance. The shape determines the resources available to the container instance.
ShapeConfig Changes to this property will trigger replacement. ContainerInstanceShapeConfigArgs
The size and amount of resources available to the container instance.
State string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

SystemTags map[string]string
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
TimeCreated string
The time the container instance was created, in the format defined by RFC 3339.
TimeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
Vnics Changes to this property will trigger replacement. []ContainerInstanceVnicArgs
The networks available to containers on this container instance.
VolumeCount int
The number of volumes that are attached to the container instance.
Volumes Changes to this property will trigger replacement. []ContainerInstanceVolumeArgs

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availabilityDomain Changes to this property will trigger replacement. String
The availability domain where the container instance runs.
compartmentId String
(Updatable) The compartment OCID.
containerCount Integer
The number of containers on the container instance.
containerRestartPolicy Changes to this property will trigger replacement. String
Container restart policy
containers Changes to this property will trigger replacement. List<ContainerInstanceContainer>
The containers to create on this container instance.
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfig
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
faultDomain Changes to this property will trigger replacement. String
The fault domain where the container instance runs.
freeformTags Map<String,String>
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
gracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. String
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
imagePullSecrets Changes to this property will trigger replacement. List<ContainerInstanceImagePullSecret>
The image pulls secrets so you can access private registry to pull container images.
lifecycleDetails String
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
shape Changes to this property will trigger replacement. String
The shape of the container instance. The shape determines the resources available to the container instance.
shapeConfig Changes to this property will trigger replacement. ContainerInstanceShapeConfig
The size and amount of resources available to the container instance.
state String

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

systemTags Map<String,String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated String
The time the container instance was created, in the format defined by RFC 3339.
timeUpdated String
The time the container instance was updated, in the format defined by RFC 3339.
vnics Changes to this property will trigger replacement. List<ContainerInstanceVnic>
The networks available to containers on this container instance.
volumeCount Integer
The number of volumes that are attached to the container instance.
volumes Changes to this property will trigger replacement. List<ContainerInstanceVolume>

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availabilityDomain Changes to this property will trigger replacement. string
The availability domain where the container instance runs.
compartmentId string
(Updatable) The compartment OCID.
containerCount number
The number of containers on the container instance.
containerRestartPolicy Changes to this property will trigger replacement. string
Container restart policy
containers Changes to this property will trigger replacement. ContainerInstanceContainer[]
The containers to create on this container instance.
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName string
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dnsConfig Changes to this property will trigger replacement. ContainerInstanceDnsConfig
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
faultDomain Changes to this property will trigger replacement. string
The fault domain where the container instance runs.
freeformTags {[key: string]: string}
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
gracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. string
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
imagePullSecrets Changes to this property will trigger replacement. ContainerInstanceImagePullSecret[]
The image pulls secrets so you can access private registry to pull container images.
lifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
shape Changes to this property will trigger replacement. string
The shape of the container instance. The shape determines the resources available to the container instance.
shapeConfig Changes to this property will trigger replacement. ContainerInstanceShapeConfig
The size and amount of resources available to the container instance.
state string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

systemTags {[key: string]: string}
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated string
The time the container instance was created, in the format defined by RFC 3339.
timeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
vnics Changes to this property will trigger replacement. ContainerInstanceVnic[]
The networks available to containers on this container instance.
volumeCount number
The number of volumes that are attached to the container instance.
volumes Changes to this property will trigger replacement. ContainerInstanceVolume[]

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availability_domain Changes to this property will trigger replacement. str
The availability domain where the container instance runs.
compartment_id str
(Updatable) The compartment OCID.
container_count int
The number of containers on the container instance.
container_restart_policy Changes to this property will trigger replacement. str
Container restart policy
containers Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceContainerArgs]
The containers to create on this container instance.
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
display_name str
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dns_config Changes to this property will trigger replacement. containerengine.ContainerInstanceDnsConfigArgs
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
fault_domain Changes to this property will trigger replacement. str
The fault domain where the container instance runs.
freeform_tags Mapping[str, str]
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
graceful_shutdown_timeout_in_seconds Changes to this property will trigger replacement. str
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
image_pull_secrets Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceImagePullSecretArgs]
The image pulls secrets so you can access private registry to pull container images.
lifecycle_details str
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
shape Changes to this property will trigger replacement. str
The shape of the container instance. The shape determines the resources available to the container instance.
shape_config Changes to this property will trigger replacement. containerengine.ContainerInstanceShapeConfigArgs
The size and amount of resources available to the container instance.
state str

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

system_tags Mapping[str, str]
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
time_created str
The time the container instance was created, in the format defined by RFC 3339.
time_updated str
The time the container instance was updated, in the format defined by RFC 3339.
vnics Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceVnicArgs]
The networks available to containers on this container instance.
volume_count int
The number of volumes that are attached to the container instance.
volumes Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceVolumeArgs]

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

availabilityDomain Changes to this property will trigger replacement. String
The availability domain where the container instance runs.
compartmentId String
(Updatable) The compartment OCID.
containerCount Number
The number of containers on the container instance.
containerRestartPolicy Changes to this property will trigger replacement. String
Container restart policy
containers Changes to this property will trigger replacement. List<Property Map>
The containers to create on this container instance.
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
dnsConfig Changes to this property will trigger replacement. Property Map
Allow customers to define DNS settings for containers. If this is not provided, the containers use the default DNS settings of the subnet.
faultDomain Changes to this property will trigger replacement. String
The fault domain where the container instance runs.
freeformTags Map<String>
(Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
gracefulShutdownTimeoutInSeconds Changes to this property will trigger replacement. String
The amount of time that processes in a container have to gracefully end when the container must be stopped. For example, when you delete a container instance. After the timeout is reached, the processes are sent a signal to be deleted.
imagePullSecrets Changes to this property will trigger replacement. List<Property Map>
The image pulls secrets so you can access private registry to pull container images.
lifecycleDetails String
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
shape Changes to this property will trigger replacement. String
The shape of the container instance. The shape determines the resources available to the container instance.
shapeConfig Changes to this property will trigger replacement. Property Map
The size and amount of resources available to the container instance.
state String

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

systemTags Map<String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated String
The time the container instance was created, in the format defined by RFC 3339.
timeUpdated String
The time the container instance was updated, in the format defined by RFC 3339.
vnics Changes to this property will trigger replacement. List<Property Map>
The networks available to containers on this container instance.
volumeCount Number
The number of volumes that are attached to the container instance.
volumes Changes to this property will trigger replacement. List<Property Map>

A volume is a directory with data that is accessible across multiple containers in a container instance.

You can attach up to 32 volumes to single container instance.

Supporting Types

ContainerInstanceContainer
, ContainerInstanceContainerArgs

ImageUrl
This property is required.
Changes to this property will trigger replacement.
string

A URL identifying the image that the container runs in, such as docker.io/library/busybox:latest. If you do not provide a tag, the tag will default to latest.

If no registry is provided, will default the registry to public docker hub docker.io/library.

The registry used for container image must be reachable over the Container Instance's VNIC.

Arguments Changes to this property will trigger replacement. List<string>

A list of string arguments for a container's ENTRYPOINT process.

Many containers use an ENTRYPOINT process pointing to a shell (/bin/bash). For those containers, this argument list specifies the main command in the container process.

The total size of all arguments combined must be 64 KB or smaller.

AvailabilityDomain string
The availability domain where the container instance runs.
Commands Changes to this property will trigger replacement. List<string>
An optional command that overrides the ENTRYPOINT process. If you do not provide a value, the existing ENTRYPOINT process defined in the image is used.
CompartmentId string
(Updatable) The compartment OCID.
ContainerId string
The OCID of the container.
ContainerInstanceId string
DefinedTags Dictionary<string, string>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
EnvironmentVariables Changes to this property will trigger replacement. Dictionary<string, string>

A map of additional environment variables to set in the environment of the container's ENTRYPOINT process. These variables are in addition to any variables already defined in the container's image.

The total size of all environment variables combined, name and values, must be 64 KB or smaller.

ExitCode int
FaultDomain string
The fault domain where the container instance runs.
FreeformTags Dictionary<string, string>
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
HealthChecks Changes to this property will trigger replacement. List<ContainerInstanceContainerHealthCheck>
list of container health checks to check container status and take appropriate action if container status is failed. There are two types of health checks that we currently support HTTP and TCP.
IsResourcePrincipalDisabled Changes to this property will trigger replacement. bool

Determines if the container will have access to the container instance resource principal.

This method utilizes resource principal version 2.2. For information on how to use the exposed resource principal elements, see https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm#sdk_authentication_methods_resource_principal.

LifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
ResourceConfig Changes to this property will trigger replacement. ContainerInstanceContainerResourceConfig
The size and amount of resources available to the container.
SecurityContext Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContext
Security context for container.
State string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

SystemTags Dictionary<string, string>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
TimeCreated string
The time the container instance was created, in the format defined by RFC 3339.
TimeTerminated string
TimeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
VolumeMounts Changes to this property will trigger replacement. List<ContainerInstanceContainerVolumeMount>
List of the volume mounts.
WorkingDirectory Changes to this property will trigger replacement. string
The working directory within the container's filesystem for the container process. If not specified, the default working directory from the image is used.
ImageUrl
This property is required.
Changes to this property will trigger replacement.
string

A URL identifying the image that the container runs in, such as docker.io/library/busybox:latest. If you do not provide a tag, the tag will default to latest.

If no registry is provided, will default the registry to public docker hub docker.io/library.

The registry used for container image must be reachable over the Container Instance's VNIC.

Arguments Changes to this property will trigger replacement. []string

A list of string arguments for a container's ENTRYPOINT process.

Many containers use an ENTRYPOINT process pointing to a shell (/bin/bash). For those containers, this argument list specifies the main command in the container process.

The total size of all arguments combined must be 64 KB or smaller.

AvailabilityDomain string
The availability domain where the container instance runs.
Commands Changes to this property will trigger replacement. []string
An optional command that overrides the ENTRYPOINT process. If you do not provide a value, the existing ENTRYPOINT process defined in the image is used.
CompartmentId string
(Updatable) The compartment OCID.
ContainerId string
The OCID of the container.
ContainerInstanceId string
DefinedTags map[string]string
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
EnvironmentVariables Changes to this property will trigger replacement. map[string]string

A map of additional environment variables to set in the environment of the container's ENTRYPOINT process. These variables are in addition to any variables already defined in the container's image.

The total size of all environment variables combined, name and values, must be 64 KB or smaller.

ExitCode int
FaultDomain string
The fault domain where the container instance runs.
FreeformTags map[string]string
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
HealthChecks Changes to this property will trigger replacement. []ContainerInstanceContainerHealthCheck
list of container health checks to check container status and take appropriate action if container status is failed. There are two types of health checks that we currently support HTTP and TCP.
IsResourcePrincipalDisabled Changes to this property will trigger replacement. bool

Determines if the container will have access to the container instance resource principal.

This method utilizes resource principal version 2.2. For information on how to use the exposed resource principal elements, see https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm#sdk_authentication_methods_resource_principal.

LifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
ResourceConfig Changes to this property will trigger replacement. ContainerInstanceContainerResourceConfig
The size and amount of resources available to the container.
SecurityContext Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContext
Security context for container.
State string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

SystemTags map[string]string
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
TimeCreated string
The time the container instance was created, in the format defined by RFC 3339.
TimeTerminated string
TimeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
VolumeMounts Changes to this property will trigger replacement. []ContainerInstanceContainerVolumeMount
List of the volume mounts.
WorkingDirectory Changes to this property will trigger replacement. string
The working directory within the container's filesystem for the container process. If not specified, the default working directory from the image is used.
imageUrl
This property is required.
Changes to this property will trigger replacement.
String

A URL identifying the image that the container runs in, such as docker.io/library/busybox:latest. If you do not provide a tag, the tag will default to latest.

If no registry is provided, will default the registry to public docker hub docker.io/library.

The registry used for container image must be reachable over the Container Instance's VNIC.

arguments Changes to this property will trigger replacement. List<String>

A list of string arguments for a container's ENTRYPOINT process.

Many containers use an ENTRYPOINT process pointing to a shell (/bin/bash). For those containers, this argument list specifies the main command in the container process.

The total size of all arguments combined must be 64 KB or smaller.

availabilityDomain String
The availability domain where the container instance runs.
commands Changes to this property will trigger replacement. List<String>
An optional command that overrides the ENTRYPOINT process. If you do not provide a value, the existing ENTRYPOINT process defined in the image is used.
compartmentId String
(Updatable) The compartment OCID.
containerId String
The OCID of the container.
containerInstanceId String
definedTags Map<String,String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
environmentVariables Changes to this property will trigger replacement. Map<String,String>

A map of additional environment variables to set in the environment of the container's ENTRYPOINT process. These variables are in addition to any variables already defined in the container's image.

The total size of all environment variables combined, name and values, must be 64 KB or smaller.

exitCode Integer
faultDomain String
The fault domain where the container instance runs.
freeformTags Map<String,String>
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
healthChecks Changes to this property will trigger replacement. List<ContainerInstanceContainerHealthCheck>
list of container health checks to check container status and take appropriate action if container status is failed. There are two types of health checks that we currently support HTTP and TCP.
isResourcePrincipalDisabled Changes to this property will trigger replacement. Boolean

Determines if the container will have access to the container instance resource principal.

This method utilizes resource principal version 2.2. For information on how to use the exposed resource principal elements, see https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm#sdk_authentication_methods_resource_principal.

lifecycleDetails String
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
resourceConfig Changes to this property will trigger replacement. ContainerInstanceContainerResourceConfig
The size and amount of resources available to the container.
securityContext Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContext
Security context for container.
state String

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

systemTags Map<String,String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated String
The time the container instance was created, in the format defined by RFC 3339.
timeTerminated String
timeUpdated String
The time the container instance was updated, in the format defined by RFC 3339.
volumeMounts Changes to this property will trigger replacement. List<ContainerInstanceContainerVolumeMount>
List of the volume mounts.
workingDirectory Changes to this property will trigger replacement. String
The working directory within the container's filesystem for the container process. If not specified, the default working directory from the image is used.
imageUrl
This property is required.
Changes to this property will trigger replacement.
string

A URL identifying the image that the container runs in, such as docker.io/library/busybox:latest. If you do not provide a tag, the tag will default to latest.

If no registry is provided, will default the registry to public docker hub docker.io/library.

The registry used for container image must be reachable over the Container Instance's VNIC.

arguments Changes to this property will trigger replacement. string[]

A list of string arguments for a container's ENTRYPOINT process.

Many containers use an ENTRYPOINT process pointing to a shell (/bin/bash). For those containers, this argument list specifies the main command in the container process.

The total size of all arguments combined must be 64 KB or smaller.

availabilityDomain string
The availability domain where the container instance runs.
commands Changes to this property will trigger replacement. string[]
An optional command that overrides the ENTRYPOINT process. If you do not provide a value, the existing ENTRYPOINT process defined in the image is used.
compartmentId string
(Updatable) The compartment OCID.
containerId string
The OCID of the container.
containerInstanceId string
definedTags {[key: string]: string}
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName string
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
environmentVariables Changes to this property will trigger replacement. {[key: string]: string}

A map of additional environment variables to set in the environment of the container's ENTRYPOINT process. These variables are in addition to any variables already defined in the container's image.

The total size of all environment variables combined, name and values, must be 64 KB or smaller.

exitCode number
faultDomain string
The fault domain where the container instance runs.
freeformTags {[key: string]: string}
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
healthChecks Changes to this property will trigger replacement. ContainerInstanceContainerHealthCheck[]
list of container health checks to check container status and take appropriate action if container status is failed. There are two types of health checks that we currently support HTTP and TCP.
isResourcePrincipalDisabled Changes to this property will trigger replacement. boolean

Determines if the container will have access to the container instance resource principal.

This method utilizes resource principal version 2.2. For information on how to use the exposed resource principal elements, see https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm#sdk_authentication_methods_resource_principal.

lifecycleDetails string
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
resourceConfig Changes to this property will trigger replacement. ContainerInstanceContainerResourceConfig
The size and amount of resources available to the container.
securityContext Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContext
Security context for container.
state string

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

systemTags {[key: string]: string}
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated string
The time the container instance was created, in the format defined by RFC 3339.
timeTerminated string
timeUpdated string
The time the container instance was updated, in the format defined by RFC 3339.
volumeMounts Changes to this property will trigger replacement. ContainerInstanceContainerVolumeMount[]
List of the volume mounts.
workingDirectory Changes to this property will trigger replacement. string
The working directory within the container's filesystem for the container process. If not specified, the default working directory from the image is used.
image_url
This property is required.
Changes to this property will trigger replacement.
str

A URL identifying the image that the container runs in, such as docker.io/library/busybox:latest. If you do not provide a tag, the tag will default to latest.

If no registry is provided, will default the registry to public docker hub docker.io/library.

The registry used for container image must be reachable over the Container Instance's VNIC.

arguments Changes to this property will trigger replacement. Sequence[str]

A list of string arguments for a container's ENTRYPOINT process.

Many containers use an ENTRYPOINT process pointing to a shell (/bin/bash). For those containers, this argument list specifies the main command in the container process.

The total size of all arguments combined must be 64 KB or smaller.

availability_domain str
The availability domain where the container instance runs.
commands Changes to this property will trigger replacement. Sequence[str]
An optional command that overrides the ENTRYPOINT process. If you do not provide a value, the existing ENTRYPOINT process defined in the image is used.
compartment_id str
(Updatable) The compartment OCID.
container_id str
The OCID of the container.
container_instance_id str
defined_tags Mapping[str, str]
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
display_name str
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
environment_variables Changes to this property will trigger replacement. Mapping[str, str]

A map of additional environment variables to set in the environment of the container's ENTRYPOINT process. These variables are in addition to any variables already defined in the container's image.

The total size of all environment variables combined, name and values, must be 64 KB or smaller.

exit_code int
fault_domain str
The fault domain where the container instance runs.
freeform_tags Mapping[str, str]
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
health_checks Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceContainerHealthCheck]
list of container health checks to check container status and take appropriate action if container status is failed. There are two types of health checks that we currently support HTTP and TCP.
is_resource_principal_disabled Changes to this property will trigger replacement. bool

Determines if the container will have access to the container instance resource principal.

This method utilizes resource principal version 2.2. For information on how to use the exposed resource principal elements, see https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm#sdk_authentication_methods_resource_principal.

lifecycle_details str
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
resource_config Changes to this property will trigger replacement. containerengine.ContainerInstanceContainerResourceConfig
The size and amount of resources available to the container.
security_context Changes to this property will trigger replacement. containerengine.ContainerInstanceContainerSecurityContext
Security context for container.
state str

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

system_tags Mapping[str, str]
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
time_created str
The time the container instance was created, in the format defined by RFC 3339.
time_terminated str
time_updated str
The time the container instance was updated, in the format defined by RFC 3339.
volume_mounts Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceContainerVolumeMount]
List of the volume mounts.
working_directory Changes to this property will trigger replacement. str
The working directory within the container's filesystem for the container process. If not specified, the default working directory from the image is used.
imageUrl
This property is required.
Changes to this property will trigger replacement.
String

A URL identifying the image that the container runs in, such as docker.io/library/busybox:latest. If you do not provide a tag, the tag will default to latest.

If no registry is provided, will default the registry to public docker hub docker.io/library.

The registry used for container image must be reachable over the Container Instance's VNIC.

arguments Changes to this property will trigger replacement. List<String>

A list of string arguments for a container's ENTRYPOINT process.

Many containers use an ENTRYPOINT process pointing to a shell (/bin/bash). For those containers, this argument list specifies the main command in the container process.

The total size of all arguments combined must be 64 KB or smaller.

availabilityDomain String
The availability domain where the container instance runs.
commands Changes to this property will trigger replacement. List<String>
An optional command that overrides the ENTRYPOINT process. If you do not provide a value, the existing ENTRYPOINT process defined in the image is used.
compartmentId String
(Updatable) The compartment OCID.
containerId String
The OCID of the container.
containerInstanceId String
definedTags Map<String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. If you don't provide a name, a name is generated automatically.
environmentVariables Changes to this property will trigger replacement. Map<String>

A map of additional environment variables to set in the environment of the container's ENTRYPOINT process. These variables are in addition to any variables already defined in the container's image.

The total size of all environment variables combined, name and values, must be 64 KB or smaller.

exitCode Number
faultDomain String
The fault domain where the container instance runs.
freeformTags Map<String>
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
healthChecks Changes to this property will trigger replacement. List<Property Map>
list of container health checks to check container status and take appropriate action if container status is failed. There are two types of health checks that we currently support HTTP and TCP.
isResourcePrincipalDisabled Changes to this property will trigger replacement. Boolean

Determines if the container will have access to the container instance resource principal.

This method utilizes resource principal version 2.2. For information on how to use the exposed resource principal elements, see https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm#sdk_authentication_methods_resource_principal.

lifecycleDetails String
A message that describes the current state of the container in more detail. Can be used to provide actionable information.
resourceConfig Changes to this property will trigger replacement. Property Map
The size and amount of resources available to the container.
securityContext Changes to this property will trigger replacement. Property Map
Security context for container.
state String

(Updatable) The target state for the Container Instance. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

systemTags Map<String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}.
timeCreated String
The time the container instance was created, in the format defined by RFC 3339.
timeTerminated String
timeUpdated String
The time the container instance was updated, in the format defined by RFC 3339.
volumeMounts Changes to this property will trigger replacement. List<Property Map>
List of the volume mounts.
workingDirectory Changes to this property will trigger replacement. String
The working directory within the container's filesystem for the container process. If not specified, the default working directory from the image is used.

ContainerInstanceContainerHealthCheck
, ContainerInstanceContainerHealthCheckArgs

HealthCheckType
This property is required.
Changes to this property will trigger replacement.
string
Container health check type.
FailureAction Changes to this property will trigger replacement. string
The action will be triggered when the container health check fails. There are two types of action: KILL or NONE. The default action is KILL. If failure action is KILL, the container will be subject to the container restart policy.
FailureThreshold Changes to this property will trigger replacement. int
Number of consecutive failures at which we consider the check failed.
Headers Changes to this property will trigger replacement. List<ContainerInstanceContainerHealthCheckHeader>
Container health check HTTP headers.
InitialDelayInSeconds Changes to this property will trigger replacement. int
The initial delay in seconds before start checking container health status.
IntervalInSeconds Changes to this property will trigger replacement. int
Number of seconds between two consecutive runs for checking container health.
Name Changes to this property will trigger replacement. string
Health check name.
Path Changes to this property will trigger replacement. string
Container health check HTTP path.
Port Changes to this property will trigger replacement. int
Container health check HTTP port.
Status string
StatusDetails string
SuccessThreshold Changes to this property will trigger replacement. int
Number of consecutive successes at which we consider the check succeeded again after it was in failure state.
TimeoutInSeconds Changes to this property will trigger replacement. int
Length of waiting time in seconds before marking health check failed.
HealthCheckType
This property is required.
Changes to this property will trigger replacement.
string
Container health check type.
FailureAction Changes to this property will trigger replacement. string
The action will be triggered when the container health check fails. There are two types of action: KILL or NONE. The default action is KILL. If failure action is KILL, the container will be subject to the container restart policy.
FailureThreshold Changes to this property will trigger replacement. int
Number of consecutive failures at which we consider the check failed.
Headers Changes to this property will trigger replacement. []ContainerInstanceContainerHealthCheckHeader
Container health check HTTP headers.
InitialDelayInSeconds Changes to this property will trigger replacement. int
The initial delay in seconds before start checking container health status.
IntervalInSeconds Changes to this property will trigger replacement. int
Number of seconds between two consecutive runs for checking container health.
Name Changes to this property will trigger replacement. string
Health check name.
Path Changes to this property will trigger replacement. string
Container health check HTTP path.
Port Changes to this property will trigger replacement. int
Container health check HTTP port.
Status string
StatusDetails string
SuccessThreshold Changes to this property will trigger replacement. int
Number of consecutive successes at which we consider the check succeeded again after it was in failure state.
TimeoutInSeconds Changes to this property will trigger replacement. int
Length of waiting time in seconds before marking health check failed.
healthCheckType
This property is required.
Changes to this property will trigger replacement.
String
Container health check type.
failureAction Changes to this property will trigger replacement. String
The action will be triggered when the container health check fails. There are two types of action: KILL or NONE. The default action is KILL. If failure action is KILL, the container will be subject to the container restart policy.
failureThreshold Changes to this property will trigger replacement. Integer
Number of consecutive failures at which we consider the check failed.
headers Changes to this property will trigger replacement. List<ContainerInstanceContainerHealthCheckHeader>
Container health check HTTP headers.
initialDelayInSeconds Changes to this property will trigger replacement. Integer
The initial delay in seconds before start checking container health status.
intervalInSeconds Changes to this property will trigger replacement. Integer
Number of seconds between two consecutive runs for checking container health.
name Changes to this property will trigger replacement. String
Health check name.
path Changes to this property will trigger replacement. String
Container health check HTTP path.
port Changes to this property will trigger replacement. Integer
Container health check HTTP port.
status String
statusDetails String
successThreshold Changes to this property will trigger replacement. Integer
Number of consecutive successes at which we consider the check succeeded again after it was in failure state.
timeoutInSeconds Changes to this property will trigger replacement. Integer
Length of waiting time in seconds before marking health check failed.
healthCheckType
This property is required.
Changes to this property will trigger replacement.
string
Container health check type.
failureAction Changes to this property will trigger replacement. string
The action will be triggered when the container health check fails. There are two types of action: KILL or NONE. The default action is KILL. If failure action is KILL, the container will be subject to the container restart policy.
failureThreshold Changes to this property will trigger replacement. number
Number of consecutive failures at which we consider the check failed.
headers Changes to this property will trigger replacement. ContainerInstanceContainerHealthCheckHeader[]
Container health check HTTP headers.
initialDelayInSeconds Changes to this property will trigger replacement. number
The initial delay in seconds before start checking container health status.
intervalInSeconds Changes to this property will trigger replacement. number
Number of seconds between two consecutive runs for checking container health.
name Changes to this property will trigger replacement. string
Health check name.
path Changes to this property will trigger replacement. string
Container health check HTTP path.
port Changes to this property will trigger replacement. number
Container health check HTTP port.
status string
statusDetails string
successThreshold Changes to this property will trigger replacement. number
Number of consecutive successes at which we consider the check succeeded again after it was in failure state.
timeoutInSeconds Changes to this property will trigger replacement. number
Length of waiting time in seconds before marking health check failed.
health_check_type
This property is required.
Changes to this property will trigger replacement.
str
Container health check type.
failure_action Changes to this property will trigger replacement. str
The action will be triggered when the container health check fails. There are two types of action: KILL or NONE. The default action is KILL. If failure action is KILL, the container will be subject to the container restart policy.
failure_threshold Changes to this property will trigger replacement. int
Number of consecutive failures at which we consider the check failed.
headers Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceContainerHealthCheckHeader]
Container health check HTTP headers.
initial_delay_in_seconds Changes to this property will trigger replacement. int
The initial delay in seconds before start checking container health status.
interval_in_seconds Changes to this property will trigger replacement. int
Number of seconds between two consecutive runs for checking container health.
name Changes to this property will trigger replacement. str
Health check name.
path Changes to this property will trigger replacement. str
Container health check HTTP path.
port Changes to this property will trigger replacement. int
Container health check HTTP port.
status str
status_details str
success_threshold Changes to this property will trigger replacement. int
Number of consecutive successes at which we consider the check succeeded again after it was in failure state.
timeout_in_seconds Changes to this property will trigger replacement. int
Length of waiting time in seconds before marking health check failed.
healthCheckType
This property is required.
Changes to this property will trigger replacement.
String
Container health check type.
failureAction Changes to this property will trigger replacement. String
The action will be triggered when the container health check fails. There are two types of action: KILL or NONE. The default action is KILL. If failure action is KILL, the container will be subject to the container restart policy.
failureThreshold Changes to this property will trigger replacement. Number
Number of consecutive failures at which we consider the check failed.
headers Changes to this property will trigger replacement. List<Property Map>
Container health check HTTP headers.
initialDelayInSeconds Changes to this property will trigger replacement. Number
The initial delay in seconds before start checking container health status.
intervalInSeconds Changes to this property will trigger replacement. Number
Number of seconds between two consecutive runs for checking container health.
name Changes to this property will trigger replacement. String
Health check name.
path Changes to this property will trigger replacement. String
Container health check HTTP path.
port Changes to this property will trigger replacement. Number
Container health check HTTP port.
status String
statusDetails String
successThreshold Changes to this property will trigger replacement. Number
Number of consecutive successes at which we consider the check succeeded again after it was in failure state.
timeoutInSeconds Changes to this property will trigger replacement. Number
Length of waiting time in seconds before marking health check failed.

ContainerInstanceContainerHealthCheckHeader
, ContainerInstanceContainerHealthCheckHeaderArgs

Name Changes to this property will trigger replacement. string
Container HTTP header Key.
Value Changes to this property will trigger replacement. string
Container HTTP header value.
Name Changes to this property will trigger replacement. string
Container HTTP header Key.
Value Changes to this property will trigger replacement. string
Container HTTP header value.
name Changes to this property will trigger replacement. String
Container HTTP header Key.
value Changes to this property will trigger replacement. String
Container HTTP header value.
name Changes to this property will trigger replacement. string
Container HTTP header Key.
value Changes to this property will trigger replacement. string
Container HTTP header value.
name Changes to this property will trigger replacement. str
Container HTTP header Key.
value Changes to this property will trigger replacement. str
Container HTTP header value.
name Changes to this property will trigger replacement. String
Container HTTP header Key.
value Changes to this property will trigger replacement. String
Container HTTP header value.

ContainerInstanceContainerResourceConfig
, ContainerInstanceContainerResourceConfigArgs

MemoryLimitInGbs Changes to this property will trigger replacement. double

The maximum amount of memory that can be consumed by the container's process.

If you do not set a value, then the process may use all available memory on the instance.

VcpusLimit Changes to this property will trigger replacement. double

The maximum amount of CPUs that can be consumed by the container's process.

If you do not set a value, then the process can use all available CPU resources on the instance.

CPU usage is defined in terms of logical CPUs. This means that the maximum possible value on an E3 ContainerInstance with 1 OCPU is 2.0.

A container with a 2.0 vcpusLimit could consume up to 100% of the CPU resources available on the container instance. Values can be fractional. A value of "1.5" means that the container can consume at most the equivalent of 1 and a half logical CPUs worth of CPU capacity.

MemoryLimitInGbs Changes to this property will trigger replacement. float64

The maximum amount of memory that can be consumed by the container's process.

If you do not set a value, then the process may use all available memory on the instance.

VcpusLimit Changes to this property will trigger replacement. float64

The maximum amount of CPUs that can be consumed by the container's process.

If you do not set a value, then the process can use all available CPU resources on the instance.

CPU usage is defined in terms of logical CPUs. This means that the maximum possible value on an E3 ContainerInstance with 1 OCPU is 2.0.

A container with a 2.0 vcpusLimit could consume up to 100% of the CPU resources available on the container instance. Values can be fractional. A value of "1.5" means that the container can consume at most the equivalent of 1 and a half logical CPUs worth of CPU capacity.

memoryLimitInGbs Changes to this property will trigger replacement. Double

The maximum amount of memory that can be consumed by the container's process.

If you do not set a value, then the process may use all available memory on the instance.

vcpusLimit Changes to this property will trigger replacement. Double

The maximum amount of CPUs that can be consumed by the container's process.

If you do not set a value, then the process can use all available CPU resources on the instance.

CPU usage is defined in terms of logical CPUs. This means that the maximum possible value on an E3 ContainerInstance with 1 OCPU is 2.0.

A container with a 2.0 vcpusLimit could consume up to 100% of the CPU resources available on the container instance. Values can be fractional. A value of "1.5" means that the container can consume at most the equivalent of 1 and a half logical CPUs worth of CPU capacity.

memoryLimitInGbs Changes to this property will trigger replacement. number

The maximum amount of memory that can be consumed by the container's process.

If you do not set a value, then the process may use all available memory on the instance.

vcpusLimit Changes to this property will trigger replacement. number

The maximum amount of CPUs that can be consumed by the container's process.

If you do not set a value, then the process can use all available CPU resources on the instance.

CPU usage is defined in terms of logical CPUs. This means that the maximum possible value on an E3 ContainerInstance with 1 OCPU is 2.0.

A container with a 2.0 vcpusLimit could consume up to 100% of the CPU resources available on the container instance. Values can be fractional. A value of "1.5" means that the container can consume at most the equivalent of 1 and a half logical CPUs worth of CPU capacity.

memory_limit_in_gbs Changes to this property will trigger replacement. float

The maximum amount of memory that can be consumed by the container's process.

If you do not set a value, then the process may use all available memory on the instance.

vcpus_limit Changes to this property will trigger replacement. float

The maximum amount of CPUs that can be consumed by the container's process.

If you do not set a value, then the process can use all available CPU resources on the instance.

CPU usage is defined in terms of logical CPUs. This means that the maximum possible value on an E3 ContainerInstance with 1 OCPU is 2.0.

A container with a 2.0 vcpusLimit could consume up to 100% of the CPU resources available on the container instance. Values can be fractional. A value of "1.5" means that the container can consume at most the equivalent of 1 and a half logical CPUs worth of CPU capacity.

memoryLimitInGbs Changes to this property will trigger replacement. Number

The maximum amount of memory that can be consumed by the container's process.

If you do not set a value, then the process may use all available memory on the instance.

vcpusLimit Changes to this property will trigger replacement. Number

The maximum amount of CPUs that can be consumed by the container's process.

If you do not set a value, then the process can use all available CPU resources on the instance.

CPU usage is defined in terms of logical CPUs. This means that the maximum possible value on an E3 ContainerInstance with 1 OCPU is 2.0.

A container with a 2.0 vcpusLimit could consume up to 100% of the CPU resources available on the container instance. Values can be fractional. A value of "1.5" means that the container can consume at most the equivalent of 1 and a half logical CPUs worth of CPU capacity.

ContainerInstanceContainerSecurityContext
, ContainerInstanceContainerSecurityContextArgs

Capabilities Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContextCapabilities
Linux Container capabilities to configure capabilities of container.
IsNonRootUserCheckEnabled Changes to this property will trigger replacement. bool
Indicates if the container must run as a non-root user. If true, the service validates the container image at runtime to ensure that it is not going to run with UID 0 (root) and fails the container instance creation if the validation fails.
IsRootFileSystemReadonly Changes to this property will trigger replacement. bool
Determines if the container will have a read-only root file system. Default value is false.
RunAsGroup Changes to this property will trigger replacement. int
The group ID (GID) to run the entrypoint process of the container. Uses runtime default if not provided.
RunAsUser Changes to this property will trigger replacement. int
The user ID (UID) to run the entrypoint process of the container. Defaults to user specified UID in container image metadata if not provided. This must be provided if runAsGroup is provided.
SecurityContextType Changes to this property will trigger replacement. string
The type of security context
Capabilities Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContextCapabilities
Linux Container capabilities to configure capabilities of container.
IsNonRootUserCheckEnabled Changes to this property will trigger replacement. bool
Indicates if the container must run as a non-root user. If true, the service validates the container image at runtime to ensure that it is not going to run with UID 0 (root) and fails the container instance creation if the validation fails.
IsRootFileSystemReadonly Changes to this property will trigger replacement. bool
Determines if the container will have a read-only root file system. Default value is false.
RunAsGroup Changes to this property will trigger replacement. int
The group ID (GID) to run the entrypoint process of the container. Uses runtime default if not provided.
RunAsUser Changes to this property will trigger replacement. int
The user ID (UID) to run the entrypoint process of the container. Defaults to user specified UID in container image metadata if not provided. This must be provided if runAsGroup is provided.
SecurityContextType Changes to this property will trigger replacement. string
The type of security context
capabilities Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContextCapabilities
Linux Container capabilities to configure capabilities of container.
isNonRootUserCheckEnabled Changes to this property will trigger replacement. Boolean
Indicates if the container must run as a non-root user. If true, the service validates the container image at runtime to ensure that it is not going to run with UID 0 (root) and fails the container instance creation if the validation fails.
isRootFileSystemReadonly Changes to this property will trigger replacement. Boolean
Determines if the container will have a read-only root file system. Default value is false.
runAsGroup Changes to this property will trigger replacement. Integer
The group ID (GID) to run the entrypoint process of the container. Uses runtime default if not provided.
runAsUser Changes to this property will trigger replacement. Integer
The user ID (UID) to run the entrypoint process of the container. Defaults to user specified UID in container image metadata if not provided. This must be provided if runAsGroup is provided.
securityContextType Changes to this property will trigger replacement. String
The type of security context
capabilities Changes to this property will trigger replacement. ContainerInstanceContainerSecurityContextCapabilities
Linux Container capabilities to configure capabilities of container.
isNonRootUserCheckEnabled Changes to this property will trigger replacement. boolean
Indicates if the container must run as a non-root user. If true, the service validates the container image at runtime to ensure that it is not going to run with UID 0 (root) and fails the container instance creation if the validation fails.
isRootFileSystemReadonly Changes to this property will trigger replacement. boolean
Determines if the container will have a read-only root file system. Default value is false.
runAsGroup Changes to this property will trigger replacement. number
The group ID (GID) to run the entrypoint process of the container. Uses runtime default if not provided.
runAsUser Changes to this property will trigger replacement. number
The user ID (UID) to run the entrypoint process of the container. Defaults to user specified UID in container image metadata if not provided. This must be provided if runAsGroup is provided.
securityContextType Changes to this property will trigger replacement. string
The type of security context
capabilities Changes to this property will trigger replacement. containerengine.ContainerInstanceContainerSecurityContextCapabilities
Linux Container capabilities to configure capabilities of container.
is_non_root_user_check_enabled Changes to this property will trigger replacement. bool
Indicates if the container must run as a non-root user. If true, the service validates the container image at runtime to ensure that it is not going to run with UID 0 (root) and fails the container instance creation if the validation fails.
is_root_file_system_readonly Changes to this property will trigger replacement. bool
Determines if the container will have a read-only root file system. Default value is false.
run_as_group Changes to this property will trigger replacement. int
The group ID (GID) to run the entrypoint process of the container. Uses runtime default if not provided.
run_as_user Changes to this property will trigger replacement. int
The user ID (UID) to run the entrypoint process of the container. Defaults to user specified UID in container image metadata if not provided. This must be provided if runAsGroup is provided.
security_context_type Changes to this property will trigger replacement. str
The type of security context
capabilities Changes to this property will trigger replacement. Property Map
Linux Container capabilities to configure capabilities of container.
isNonRootUserCheckEnabled Changes to this property will trigger replacement. Boolean
Indicates if the container must run as a non-root user. If true, the service validates the container image at runtime to ensure that it is not going to run with UID 0 (root) and fails the container instance creation if the validation fails.
isRootFileSystemReadonly Changes to this property will trigger replacement. Boolean
Determines if the container will have a read-only root file system. Default value is false.
runAsGroup Changes to this property will trigger replacement. Number
The group ID (GID) to run the entrypoint process of the container. Uses runtime default if not provided.
runAsUser Changes to this property will trigger replacement. Number
The user ID (UID) to run the entrypoint process of the container. Defaults to user specified UID in container image metadata if not provided. This must be provided if runAsGroup is provided.
securityContextType Changes to this property will trigger replacement. String
The type of security context

ContainerInstanceContainerSecurityContextCapabilities
, ContainerInstanceContainerSecurityContextCapabilitiesArgs

AddCapabilities Changes to this property will trigger replacement. List<string>
A list of additional configurable container capabilities.
DropCapabilities Changes to this property will trigger replacement. List<string>
A list of container capabilities that can be dropped.
AddCapabilities Changes to this property will trigger replacement. []string
A list of additional configurable container capabilities.
DropCapabilities Changes to this property will trigger replacement. []string
A list of container capabilities that can be dropped.
addCapabilities Changes to this property will trigger replacement. List<String>
A list of additional configurable container capabilities.
dropCapabilities Changes to this property will trigger replacement. List<String>
A list of container capabilities that can be dropped.
addCapabilities Changes to this property will trigger replacement. string[]
A list of additional configurable container capabilities.
dropCapabilities Changes to this property will trigger replacement. string[]
A list of container capabilities that can be dropped.
add_capabilities Changes to this property will trigger replacement. Sequence[str]
A list of additional configurable container capabilities.
drop_capabilities Changes to this property will trigger replacement. Sequence[str]
A list of container capabilities that can be dropped.
addCapabilities Changes to this property will trigger replacement. List<String>
A list of additional configurable container capabilities.
dropCapabilities Changes to this property will trigger replacement. List<String>
A list of container capabilities that can be dropped.

ContainerInstanceContainerVolumeMount
, ContainerInstanceContainerVolumeMountArgs

MountPath
This property is required.
Changes to this property will trigger replacement.
string
The volume access path.
VolumeName
This property is required.
Changes to this property will trigger replacement.
string
The name of the volume. Avoid entering confidential information.
IsReadOnly Changes to this property will trigger replacement. bool
Whether the volume was mounted in read-only mode. By default, the volume is not read-only.
Partition Changes to this property will trigger replacement. int
If there is more than one partition in the volume, reference this number of partitions. Here is an example: Number Start End Size File system Name Flags 1 1049kB 106MB 105MB fat16 EFI System Partition boot, esp 2 106MB 1180MB 1074MB xfs 3 1180MB 50.0GB 48.8GB lvm
SubPath Changes to this property will trigger replacement. string
A subpath inside the referenced volume.
MountPath
This property is required.
Changes to this property will trigger replacement.
string
The volume access path.
VolumeName
This property is required.
Changes to this property will trigger replacement.
string
The name of the volume. Avoid entering confidential information.
IsReadOnly Changes to this property will trigger replacement. bool
Whether the volume was mounted in read-only mode. By default, the volume is not read-only.
Partition Changes to this property will trigger replacement. int
If there is more than one partition in the volume, reference this number of partitions. Here is an example: Number Start End Size File system Name Flags 1 1049kB 106MB 105MB fat16 EFI System Partition boot, esp 2 106MB 1180MB 1074MB xfs 3 1180MB 50.0GB 48.8GB lvm
SubPath Changes to this property will trigger replacement. string
A subpath inside the referenced volume.
mountPath
This property is required.
Changes to this property will trigger replacement.
String
The volume access path.
volumeName
This property is required.
Changes to this property will trigger replacement.
String
The name of the volume. Avoid entering confidential information.
isReadOnly Changes to this property will trigger replacement. Boolean
Whether the volume was mounted in read-only mode. By default, the volume is not read-only.
partition Changes to this property will trigger replacement. Integer
If there is more than one partition in the volume, reference this number of partitions. Here is an example: Number Start End Size File system Name Flags 1 1049kB 106MB 105MB fat16 EFI System Partition boot, esp 2 106MB 1180MB 1074MB xfs 3 1180MB 50.0GB 48.8GB lvm
subPath Changes to this property will trigger replacement. String
A subpath inside the referenced volume.
mountPath
This property is required.
Changes to this property will trigger replacement.
string
The volume access path.
volumeName
This property is required.
Changes to this property will trigger replacement.
string
The name of the volume. Avoid entering confidential information.
isReadOnly Changes to this property will trigger replacement. boolean
Whether the volume was mounted in read-only mode. By default, the volume is not read-only.
partition Changes to this property will trigger replacement. number
If there is more than one partition in the volume, reference this number of partitions. Here is an example: Number Start End Size File system Name Flags 1 1049kB 106MB 105MB fat16 EFI System Partition boot, esp 2 106MB 1180MB 1074MB xfs 3 1180MB 50.0GB 48.8GB lvm
subPath Changes to this property will trigger replacement. string
A subpath inside the referenced volume.
mount_path
This property is required.
Changes to this property will trigger replacement.
str
The volume access path.
volume_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the volume. Avoid entering confidential information.
is_read_only Changes to this property will trigger replacement. bool
Whether the volume was mounted in read-only mode. By default, the volume is not read-only.
partition Changes to this property will trigger replacement. int
If there is more than one partition in the volume, reference this number of partitions. Here is an example: Number Start End Size File system Name Flags 1 1049kB 106MB 105MB fat16 EFI System Partition boot, esp 2 106MB 1180MB 1074MB xfs 3 1180MB 50.0GB 48.8GB lvm
sub_path Changes to this property will trigger replacement. str
A subpath inside the referenced volume.
mountPath
This property is required.
Changes to this property will trigger replacement.
String
The volume access path.
volumeName
This property is required.
Changes to this property will trigger replacement.
String
The name of the volume. Avoid entering confidential information.
isReadOnly Changes to this property will trigger replacement. Boolean
Whether the volume was mounted in read-only mode. By default, the volume is not read-only.
partition Changes to this property will trigger replacement. Number
If there is more than one partition in the volume, reference this number of partitions. Here is an example: Number Start End Size File system Name Flags 1 1049kB 106MB 105MB fat16 EFI System Partition boot, esp 2 106MB 1180MB 1074MB xfs 3 1180MB 50.0GB 48.8GB lvm
subPath Changes to this property will trigger replacement. String
A subpath inside the referenced volume.

ContainerInstanceDnsConfig
, ContainerInstanceDnsConfigArgs

Nameservers Changes to this property will trigger replacement. List<string>
IP address of a name server that the resolver should query, either an IPv4 address (in dot notation), or an IPv6 address in colon (and possibly dot) notation. If null, uses nameservers from subnet dhcpDnsOptions.
Options Changes to this property will trigger replacement. List<string>
Options allows certain internal resolver variables to be modified. Options are a list of objects in https://man7.org/linux/man-pages/man5/resolv.conf.5.html. Examples: ["ndots:n", "edns0"].
Searches Changes to this property will trigger replacement. List<string>
Search list for host-name lookup. If null, we will use searches from subnet dhcpDnsOptios.
Nameservers Changes to this property will trigger replacement. []string
IP address of a name server that the resolver should query, either an IPv4 address (in dot notation), or an IPv6 address in colon (and possibly dot) notation. If null, uses nameservers from subnet dhcpDnsOptions.
Options Changes to this property will trigger replacement. []string
Options allows certain internal resolver variables to be modified. Options are a list of objects in https://man7.org/linux/man-pages/man5/resolv.conf.5.html. Examples: ["ndots:n", "edns0"].
Searches Changes to this property will trigger replacement. []string
Search list for host-name lookup. If null, we will use searches from subnet dhcpDnsOptios.
nameservers Changes to this property will trigger replacement. List<String>
IP address of a name server that the resolver should query, either an IPv4 address (in dot notation), or an IPv6 address in colon (and possibly dot) notation. If null, uses nameservers from subnet dhcpDnsOptions.
options Changes to this property will trigger replacement. List<String>
Options allows certain internal resolver variables to be modified. Options are a list of objects in https://man7.org/linux/man-pages/man5/resolv.conf.5.html. Examples: ["ndots:n", "edns0"].
searches Changes to this property will trigger replacement. List<String>
Search list for host-name lookup. If null, we will use searches from subnet dhcpDnsOptios.
nameservers Changes to this property will trigger replacement. string[]
IP address of a name server that the resolver should query, either an IPv4 address (in dot notation), or an IPv6 address in colon (and possibly dot) notation. If null, uses nameservers from subnet dhcpDnsOptions.
options Changes to this property will trigger replacement. string[]
Options allows certain internal resolver variables to be modified. Options are a list of objects in https://man7.org/linux/man-pages/man5/resolv.conf.5.html. Examples: ["ndots:n", "edns0"].
searches Changes to this property will trigger replacement. string[]
Search list for host-name lookup. If null, we will use searches from subnet dhcpDnsOptios.
nameservers Changes to this property will trigger replacement. Sequence[str]
IP address of a name server that the resolver should query, either an IPv4 address (in dot notation), or an IPv6 address in colon (and possibly dot) notation. If null, uses nameservers from subnet dhcpDnsOptions.
options Changes to this property will trigger replacement. Sequence[str]
Options allows certain internal resolver variables to be modified. Options are a list of objects in https://man7.org/linux/man-pages/man5/resolv.conf.5.html. Examples: ["ndots:n", "edns0"].
searches Changes to this property will trigger replacement. Sequence[str]
Search list for host-name lookup. If null, we will use searches from subnet dhcpDnsOptios.
nameservers Changes to this property will trigger replacement. List<String>
IP address of a name server that the resolver should query, either an IPv4 address (in dot notation), or an IPv6 address in colon (and possibly dot) notation. If null, uses nameservers from subnet dhcpDnsOptions.
options Changes to this property will trigger replacement. List<String>
Options allows certain internal resolver variables to be modified. Options are a list of objects in https://man7.org/linux/man-pages/man5/resolv.conf.5.html. Examples: ["ndots:n", "edns0"].
searches Changes to this property will trigger replacement. List<String>
Search list for host-name lookup. If null, we will use searches from subnet dhcpDnsOptios.

ContainerInstanceImagePullSecret
, ContainerInstanceImagePullSecretArgs

RegistryEndpoint
This property is required.
Changes to this property will trigger replacement.
string
The registry endpoint of the container image.
SecretType
This property is required.
Changes to this property will trigger replacement.
string
The type of ImagePullSecret.
Password Changes to this property will trigger replacement. string
The password which should be used with the registry for authentication. The value is expected in base64 format.
SecretId Changes to this property will trigger replacement. string
The OCID of the secret for registry credentials.
Username Changes to this property will trigger replacement. string
The username which should be used with the registry for authentication. The value is expected in base64 format.
RegistryEndpoint
This property is required.
Changes to this property will trigger replacement.
string
The registry endpoint of the container image.
SecretType
This property is required.
Changes to this property will trigger replacement.
string
The type of ImagePullSecret.
Password Changes to this property will trigger replacement. string
The password which should be used with the registry for authentication. The value is expected in base64 format.
SecretId Changes to this property will trigger replacement. string
The OCID of the secret for registry credentials.
Username Changes to this property will trigger replacement. string
The username which should be used with the registry for authentication. The value is expected in base64 format.
registryEndpoint
This property is required.
Changes to this property will trigger replacement.
String
The registry endpoint of the container image.
secretType
This property is required.
Changes to this property will trigger replacement.
String
The type of ImagePullSecret.
password Changes to this property will trigger replacement. String
The password which should be used with the registry for authentication. The value is expected in base64 format.
secretId Changes to this property will trigger replacement. String
The OCID of the secret for registry credentials.
username Changes to this property will trigger replacement. String
The username which should be used with the registry for authentication. The value is expected in base64 format.
registryEndpoint
This property is required.
Changes to this property will trigger replacement.
string
The registry endpoint of the container image.
secretType
This property is required.
Changes to this property will trigger replacement.
string
The type of ImagePullSecret.
password Changes to this property will trigger replacement. string
The password which should be used with the registry for authentication. The value is expected in base64 format.
secretId Changes to this property will trigger replacement. string
The OCID of the secret for registry credentials.
username Changes to this property will trigger replacement. string
The username which should be used with the registry for authentication. The value is expected in base64 format.
registry_endpoint
This property is required.
Changes to this property will trigger replacement.
str
The registry endpoint of the container image.
secret_type
This property is required.
Changes to this property will trigger replacement.
str
The type of ImagePullSecret.
password Changes to this property will trigger replacement. str
The password which should be used with the registry for authentication. The value is expected in base64 format.
secret_id Changes to this property will trigger replacement. str
The OCID of the secret for registry credentials.
username Changes to this property will trigger replacement. str
The username which should be used with the registry for authentication. The value is expected in base64 format.
registryEndpoint
This property is required.
Changes to this property will trigger replacement.
String
The registry endpoint of the container image.
secretType
This property is required.
Changes to this property will trigger replacement.
String
The type of ImagePullSecret.
password Changes to this property will trigger replacement. String
The password which should be used with the registry for authentication. The value is expected in base64 format.
secretId Changes to this property will trigger replacement. String
The OCID of the secret for registry credentials.
username Changes to this property will trigger replacement. String
The username which should be used with the registry for authentication. The value is expected in base64 format.

ContainerInstanceShapeConfig
, ContainerInstanceShapeConfigArgs

Ocpus
This property is required.
Changes to this property will trigger replacement.
double
The total number of OCPUs available to the container instance.
MemoryInGbs Changes to this property will trigger replacement. double
The total amount of memory available to the container instance (GB).
NetworkingBandwidthInGbps double
The networking bandwidth available to the container instance, in gigabits per second.
ProcessorDescription string
A short description of the container instance's processor (CPU).
Ocpus
This property is required.
Changes to this property will trigger replacement.
float64
The total number of OCPUs available to the container instance.
MemoryInGbs Changes to this property will trigger replacement. float64
The total amount of memory available to the container instance (GB).
NetworkingBandwidthInGbps float64
The networking bandwidth available to the container instance, in gigabits per second.
ProcessorDescription string
A short description of the container instance's processor (CPU).
ocpus
This property is required.
Changes to this property will trigger replacement.
Double
The total number of OCPUs available to the container instance.
memoryInGbs Changes to this property will trigger replacement. Double
The total amount of memory available to the container instance (GB).
networkingBandwidthInGbps Double
The networking bandwidth available to the container instance, in gigabits per second.
processorDescription String
A short description of the container instance's processor (CPU).
ocpus
This property is required.
Changes to this property will trigger replacement.
number
The total number of OCPUs available to the container instance.
memoryInGbs Changes to this property will trigger replacement. number
The total amount of memory available to the container instance (GB).
networkingBandwidthInGbps number
The networking bandwidth available to the container instance, in gigabits per second.
processorDescription string
A short description of the container instance's processor (CPU).
ocpus
This property is required.
Changes to this property will trigger replacement.
float
The total number of OCPUs available to the container instance.
memory_in_gbs Changes to this property will trigger replacement. float
The total amount of memory available to the container instance (GB).
networking_bandwidth_in_gbps float
The networking bandwidth available to the container instance, in gigabits per second.
processor_description str
A short description of the container instance's processor (CPU).
ocpus
This property is required.
Changes to this property will trigger replacement.
Number
The total number of OCPUs available to the container instance.
memoryInGbs Changes to this property will trigger replacement. Number
The total amount of memory available to the container instance (GB).
networkingBandwidthInGbps Number
The networking bandwidth available to the container instance, in gigabits per second.
processorDescription String
A short description of the container instance's processor (CPU).

ContainerInstanceVnic
, ContainerInstanceVnicArgs

SubnetId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the subnet to create the VNIC in.
DefinedTags Dictionary<string, string>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.
FreeformTags Dictionary<string, string>
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
HostnameLabel string
The hostname for the VNIC's primary private IP. Used for DNS.
IsPublicIpAssigned Changes to this property will trigger replacement. bool
Whether the VNIC should be assigned a public IP address.
NsgIds Changes to this property will trigger replacement. List<string>
A list of the OCIDs of the network security groups (NSGs) to add the VNIC to.
PrivateIp Changes to this property will trigger replacement. string
A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR.
SkipSourceDestCheck Changes to this property will trigger replacement. bool
Whether the source/destination check is disabled on the VNIC.
VnicId string
The identifier of the virtual network interface card (VNIC) over which the containers accessing this network can communicate with the larger virtual cloud network.
SubnetId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the subnet to create the VNIC in.
DefinedTags map[string]string
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
DisplayName string
A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.
FreeformTags map[string]string
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
HostnameLabel string
The hostname for the VNIC's primary private IP. Used for DNS.
IsPublicIpAssigned Changes to this property will trigger replacement. bool
Whether the VNIC should be assigned a public IP address.
NsgIds Changes to this property will trigger replacement. []string
A list of the OCIDs of the network security groups (NSGs) to add the VNIC to.
PrivateIp Changes to this property will trigger replacement. string
A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR.
SkipSourceDestCheck Changes to this property will trigger replacement. bool
Whether the source/destination check is disabled on the VNIC.
VnicId string
The identifier of the virtual network interface card (VNIC) over which the containers accessing this network can communicate with the larger virtual cloud network.
subnetId
This property is required.
Changes to this property will trigger replacement.
String
The OCID of the subnet to create the VNIC in.
definedTags Map<String,String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.
freeformTags Map<String,String>
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
hostnameLabel String
The hostname for the VNIC's primary private IP. Used for DNS.
isPublicIpAssigned Changes to this property will trigger replacement. Boolean
Whether the VNIC should be assigned a public IP address.
nsgIds Changes to this property will trigger replacement. List<String>
A list of the OCIDs of the network security groups (NSGs) to add the VNIC to.
privateIp Changes to this property will trigger replacement. String
A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR.
skipSourceDestCheck Changes to this property will trigger replacement. Boolean
Whether the source/destination check is disabled on the VNIC.
vnicId String
The identifier of the virtual network interface card (VNIC) over which the containers accessing this network can communicate with the larger virtual cloud network.
subnetId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the subnet to create the VNIC in.
definedTags {[key: string]: string}
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName string
A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.
freeformTags {[key: string]: string}
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
hostnameLabel string
The hostname for the VNIC's primary private IP. Used for DNS.
isPublicIpAssigned Changes to this property will trigger replacement. boolean
Whether the VNIC should be assigned a public IP address.
nsgIds Changes to this property will trigger replacement. string[]
A list of the OCIDs of the network security groups (NSGs) to add the VNIC to.
privateIp Changes to this property will trigger replacement. string
A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR.
skipSourceDestCheck Changes to this property will trigger replacement. boolean
Whether the source/destination check is disabled on the VNIC.
vnicId string
The identifier of the virtual network interface card (VNIC) over which the containers accessing this network can communicate with the larger virtual cloud network.
subnet_id
This property is required.
Changes to this property will trigger replacement.
str
The OCID of the subnet to create the VNIC in.
defined_tags Mapping[str, str]
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
display_name str
A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.
freeform_tags Mapping[str, str]
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
hostname_label str
The hostname for the VNIC's primary private IP. Used for DNS.
is_public_ip_assigned Changes to this property will trigger replacement. bool
Whether the VNIC should be assigned a public IP address.
nsg_ids Changes to this property will trigger replacement. Sequence[str]
A list of the OCIDs of the network security groups (NSGs) to add the VNIC to.
private_ip Changes to this property will trigger replacement. str
A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR.
skip_source_dest_check Changes to this property will trigger replacement. bool
Whether the source/destination check is disabled on the VNIC.
vnic_id str
The identifier of the virtual network interface card (VNIC) over which the containers accessing this network can communicate with the larger virtual cloud network.
subnetId
This property is required.
Changes to this property will trigger replacement.
String
The OCID of the subnet to create the VNIC in.
definedTags Map<String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}.
displayName String
A user-friendly name for the VNIC. Does not have to be unique. Avoid entering confidential information.
freeformTags Map<String>
Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
hostnameLabel String
The hostname for the VNIC's primary private IP. Used for DNS.
isPublicIpAssigned Changes to this property will trigger replacement. Boolean
Whether the VNIC should be assigned a public IP address.
nsgIds Changes to this property will trigger replacement. List<String>
A list of the OCIDs of the network security groups (NSGs) to add the VNIC to.
privateIp Changes to this property will trigger replacement. String
A private IP address of your choice to assign to the VNIC. Must be an available IP address within the subnet's CIDR.
skipSourceDestCheck Changes to this property will trigger replacement. Boolean
Whether the source/destination check is disabled on the VNIC.
vnicId String
The identifier of the virtual network interface card (VNIC) over which the containers accessing this network can communicate with the larger virtual cloud network.

ContainerInstanceVolume
, ContainerInstanceVolumeArgs

Name
This property is required.
Changes to this property will trigger replacement.
string
The name of the volume. This must be unique within a single container instance.
VolumeType
This property is required.
Changes to this property will trigger replacement.
string
The type of volume.
BackingStore Changes to this property will trigger replacement. string
The volume type of the empty directory, can be either File Storage or Memory.
Configs Changes to this property will trigger replacement. List<ContainerInstanceVolumeConfig>
Contains key value pairs which can be mounted as individual files inside the container. The value needs to be base64 encoded. It is decoded to plain text before the mount.
Name
This property is required.
Changes to this property will trigger replacement.
string
The name of the volume. This must be unique within a single container instance.
VolumeType
This property is required.
Changes to this property will trigger replacement.
string
The type of volume.
BackingStore Changes to this property will trigger replacement. string
The volume type of the empty directory, can be either File Storage or Memory.
Configs Changes to this property will trigger replacement. []ContainerInstanceVolumeConfig
Contains key value pairs which can be mounted as individual files inside the container. The value needs to be base64 encoded. It is decoded to plain text before the mount.
name
This property is required.
Changes to this property will trigger replacement.
String
The name of the volume. This must be unique within a single container instance.
volumeType
This property is required.
Changes to this property will trigger replacement.
String
The type of volume.
backingStore Changes to this property will trigger replacement. String
The volume type of the empty directory, can be either File Storage or Memory.
configs Changes to this property will trigger replacement. List<ContainerInstanceVolumeConfig>
Contains key value pairs which can be mounted as individual files inside the container. The value needs to be base64 encoded. It is decoded to plain text before the mount.
name
This property is required.
Changes to this property will trigger replacement.
string
The name of the volume. This must be unique within a single container instance.
volumeType
This property is required.
Changes to this property will trigger replacement.
string
The type of volume.
backingStore Changes to this property will trigger replacement. string
The volume type of the empty directory, can be either File Storage or Memory.
configs Changes to this property will trigger replacement. ContainerInstanceVolumeConfig[]
Contains key value pairs which can be mounted as individual files inside the container. The value needs to be base64 encoded. It is decoded to plain text before the mount.
name
This property is required.
Changes to this property will trigger replacement.
str
The name of the volume. This must be unique within a single container instance.
volume_type
This property is required.
Changes to this property will trigger replacement.
str
The type of volume.
backing_store Changes to this property will trigger replacement. str
The volume type of the empty directory, can be either File Storage or Memory.
configs Changes to this property will trigger replacement. Sequence[containerengine.ContainerInstanceVolumeConfig]
Contains key value pairs which can be mounted as individual files inside the container. The value needs to be base64 encoded. It is decoded to plain text before the mount.
name
This property is required.
Changes to this property will trigger replacement.
String
The name of the volume. This must be unique within a single container instance.
volumeType
This property is required.
Changes to this property will trigger replacement.
String
The type of volume.
backingStore Changes to this property will trigger replacement. String
The volume type of the empty directory, can be either File Storage or Memory.
configs Changes to this property will trigger replacement. List<Property Map>
Contains key value pairs which can be mounted as individual files inside the container. The value needs to be base64 encoded. It is decoded to plain text before the mount.

ContainerInstanceVolumeConfig
, ContainerInstanceVolumeConfigArgs

Data Changes to this property will trigger replacement. string
The base64 encoded contents of the file. The contents are decoded to plain text before mounted as a file to a container inside container instance.
FileName Changes to this property will trigger replacement. string
The name of the file. The fileName should be unique across the volume.
Path Changes to this property will trigger replacement. string
(Optional) Relative path for this file inside the volume mount directory. By default, the file is presented at the root of the volume mount path.
Data Changes to this property will trigger replacement. string
The base64 encoded contents of the file. The contents are decoded to plain text before mounted as a file to a container inside container instance.
FileName Changes to this property will trigger replacement. string
The name of the file. The fileName should be unique across the volume.
Path Changes to this property will trigger replacement. string
(Optional) Relative path for this file inside the volume mount directory. By default, the file is presented at the root of the volume mount path.
data Changes to this property will trigger replacement. String
The base64 encoded contents of the file. The contents are decoded to plain text before mounted as a file to a container inside container instance.
fileName Changes to this property will trigger replacement. String
The name of the file. The fileName should be unique across the volume.
path Changes to this property will trigger replacement. String
(Optional) Relative path for this file inside the volume mount directory. By default, the file is presented at the root of the volume mount path.
data Changes to this property will trigger replacement. string
The base64 encoded contents of the file. The contents are decoded to plain text before mounted as a file to a container inside container instance.
fileName Changes to this property will trigger replacement. string
The name of the file. The fileName should be unique across the volume.
path Changes to this property will trigger replacement. string
(Optional) Relative path for this file inside the volume mount directory. By default, the file is presented at the root of the volume mount path.
data Changes to this property will trigger replacement. str
The base64 encoded contents of the file. The contents are decoded to plain text before mounted as a file to a container inside container instance.
file_name Changes to this property will trigger replacement. str
The name of the file. The fileName should be unique across the volume.
path Changes to this property will trigger replacement. str
(Optional) Relative path for this file inside the volume mount directory. By default, the file is presented at the root of the volume mount path.
data Changes to this property will trigger replacement. String
The base64 encoded contents of the file. The contents are decoded to plain text before mounted as a file to a container inside container instance.
fileName Changes to this property will trigger replacement. String
The name of the file. The fileName should be unique across the volume.
path Changes to this property will trigger replacement. String
(Optional) Relative path for this file inside the volume mount directory. By default, the file is presented at the root of the volume mount path.

Import

ContainerInstances can be imported using the id, e.g.

$ pulumi import oci:ContainerEngine/containerInstance:ContainerInstance test_container_instance "id"
Copy

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes
This Pulumi package is based on the oci Terraform Provider.