pulumi-azure-kotlin/com.pulumi.azure.containerservice.kotlin/GroupArgs

GroupArgs

data class GroupArgs(val containers: Output<List<GroupContainerArgs>>? = null, val diagnostics: Output<GroupDiagnosticsArgs>? = null, val dnsConfig: Output<GroupDnsConfigArgs>? = null, val dnsNameLabel: Output<String>? = null, val dnsNameLabelReusePolicy: Output<String>? = null, val exposedPorts: Output<List<GroupExposedPortArgs>>? = null, val identity: Output<GroupIdentityArgs>? = null, val imageRegistryCredentials: Output<List<GroupImageRegistryCredentialArgs>>? = null, val initContainers: Output<List<GroupInitContainerArgs>>? = null, val ipAddressType: Output<String>? = null, val keyVaultKeyId: Output<String>? = null, val keyVaultUserAssignedIdentityId: Output<String>? = null, val location: Output<String>? = null, val name: Output<String>? = null, val networkProfileId: Output<String>? = null, val osType: Output<String>? = null, val resourceGroupName: Output<String>? = null, val restartPolicy: Output<String>? = null, val sku: Output<String>? = null, val subnetIds: Output<String>? = null, val tags: Output<Map<String, String>>? = null, val zones: Output<List<String>>? = null) : ConvertibleToJava<GroupArgs>

Manages as an Azure Container Group instance.

Note network_profile_id is deprecated by Azure. For users who want to continue to manage existing azure.containerservice.Group that rely on network_profile_id, please stay on provider versions prior to v3.16.0. Otherwise, use subnet_ids instead.

Example Usage

This example provisions a Basic Container.

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.containerservice.Group;
import com.pulumi.azure.containerservice.GroupArgs;
import com.pulumi.azure.containerservice.inputs.GroupContainerArgs;
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 exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()
            .location("West Europe")
            .build());
        var exampleGroup = new Group("exampleGroup", GroupArgs.builder()
            .location(exampleResourceGroup.location())
            .resourceGroupName(exampleResourceGroup.name())
            .ipAddressType("Public")
            .dnsNameLabel("aci-label")
            .osType("Linux")
            .containers(
                GroupContainerArgs.builder()
                    .name("hello-world")
                    .image("mcr.microsoft.com/azuredocs/aci-helloworld:latest")
                    .cpu("0.5")
                    .memory("1.5")
                    .ports(GroupContainerPortArgs.builder()
                        .port(443)
                        .protocol("TCP")
                        .build())
                    .build(),
                GroupContainerArgs.builder()
                    .name("sidecar")
                    .image("mcr.microsoft.com/azuredocs/aci-tutorial-sidecar")
                    .cpu("0.5")
                    .memory("1.5")
                    .build())
            .tags(Map.of("environment", "testing"))
            .build());
    }
}

Import

Container Group's can be imported using the resource id, e.g.

$ pulumi import azure:containerservice/group:Group containerGroup1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.ContainerInstance/containerGroups/myContainerGroup1

Constructors

GroupArgs

fun GroupArgs(containers: Output<List<GroupContainerArgs>>? = null, diagnostics: Output<GroupDiagnosticsArgs>? = null, dnsConfig: Output<GroupDnsConfigArgs>? = null, dnsNameLabel: Output<String>? = null, dnsNameLabelReusePolicy: Output<String>? = null, exposedPorts: Output<List<GroupExposedPortArgs>>? = null, identity: Output<GroupIdentityArgs>? = null, imageRegistryCredentials: Output<List<GroupImageRegistryCredentialArgs>>? = null, initContainers: Output<List<GroupInitContainerArgs>>? = null, ipAddressType: Output<String>? = null, keyVaultKeyId: Output<String>? = null, keyVaultUserAssignedIdentityId: Output<String>? = null, location: Output<String>? = null, name: Output<String>? = null, networkProfileId: Output<String>? = null, osType: Output<String>? = null, resourceGroupName: Output<String>? = null, restartPolicy: Output<String>? = null, sku: Output<String>? = null, subnetIds: Output<String>? = null, tags: Output<Map<String, String>>? = null, zones: Output<List<String>>? = null)

Functions

toJava

open override fun toJava(): GroupArgs

Properties

containers

val containers: Output<List<GroupContainerArgs>>? = null

The definition of a container that is part of the group as documented in the container block below. Changing this forces a new resource to be created.

diagnostics

val diagnostics: Output<GroupDiagnosticsArgs>? = null

A diagnostics block as documented below. Changing this forces a new resource to be created.

dnsConfig

val dnsConfig: Output<GroupDnsConfigArgs>? = null

A dns_config block as documented below. Changing this forces a new resource to be created.

dnsNameLabel

val dnsNameLabel: Output<String>? = null

The DNS label/name for the container group's IP. Changing this forces a new resource to be created.

dnsNameLabelReusePolicy

val dnsNameLabelReusePolicy: Output<String>? = null

The value representing the security enum. Noreuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse or Unsecure. Defaults to Unsecure.

exposedPorts

val exposedPorts: Output<List<GroupExposedPortArgs>>? = null

Zero or more exposed_port blocks as defined below. Changing this forces a new resource to be created.

identity

val identity: Output<GroupIdentityArgs>? = null

An identity block as defined below.

imageRegistryCredentials

val imageRegistryCredentials: Output<List<GroupImageRegistryCredentialArgs>>? = null

An image_registry_credential block as documented below. Changing this forces a new resource to be created.

initContainers

val initContainers: Output<List<GroupInitContainerArgs>>? = null

The definition of an init container that is part of the group as documented in the init_container block below. Changing this forces a new resource to be created.

ipAddressType

val ipAddressType: Output<String>? = null

Specifies the IP address type of the container. Public, Private or None. Changing this forces a new resource to be created. If set to Private, subnet_ids also needs to be set.

keyVaultKeyId

val keyVaultKeyId: Output<String>? = null

The Key Vault key URI for CMK encryption. Changing this forces a new resource to be created.

keyVaultUserAssignedIdentityId

val keyVaultUserAssignedIdentityId: Output<String>? = null

The user assigned identity that has access to the Key Vault Key. If not specified, the RP principal named "Azure Container Instance Service" will be used instead. Make sure the identity has the proper key_permissions set, at least with Get, UnwrapKey, WrapKey and GetRotationPolicy.

location

val location: Output<String>? = null

Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name

val name: Output<String>? = null

Specifies the name of the Container Group. Changing this forces a new resource to be created.

networkProfileId

val ~~networkProfileId~~: Output<String>? = null

osType

val osType: Output<String>? = null

The OS for the container group. Allowed values are Linux and Windows. Changing this forces a new resource to be created.

resourceGroupName

val resourceGroupName: Output<String>? = null

The name of the resource group in which to create the Container Group. Changing this forces a new resource to be created.

restartPolicy

val restartPolicy: Output<String>? = null

Restart policy for the container group. Allowed values are Always, Never, OnFailure. Defaults to Always. Changing this forces a new resource to be created.

sku

val sku: Output<String>? = null

Specifies the sku of the Container Group. Possible values are Confidential, Dedicated and Standard. Defaults to Standard. Changing this forces a new resource to be created.

subnetIds

val subnetIds: Output<String>? = null

The subnet resource IDs for a container group. Changing this forces a new resource to be created.