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

Group

class Group : KotlinCustomResource

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

Properties

containers

val containers: Output<List<GroupContainer>>

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<GroupDiagnostics>?

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

dnsConfig

val dnsConfig: Output<GroupDnsConfig>?

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

dnsNameLabel

val dnsNameLabel: Output<String>?

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

dnsNameLabelReusePolicy

val dnsNameLabelReusePolicy: Output<String>?

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

exposedPorts

val exposedPorts: Output<List<GroupExposedPort>>

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

fqdn

val fqdn: Output<String>

The FQDN of the container group derived from dns_name_label.

val id: Output<String>

identity

val identity: Output<GroupIdentity>?

An identity block as defined below.

imageRegistryCredentials

val imageRegistryCredentials: Output<List<GroupImageRegistryCredential>>?

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

initContainers

val initContainers: Output<List<GroupInitContainer>>?

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.

ipAddress

val ipAddress: Output<String>

The IP address allocated to the container group.

ipAddressType

val ipAddressType: Output<String>?

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>?

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

keyVaultUserAssignedIdentityId

val keyVaultUserAssignedIdentityId: Output<String>?

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>

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

name

val name: Output<String>

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

networkProfileId

val ~~networkProfileId~~: Output<String>

osType

val osType: Output<String>

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

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

resourceGroupName

val resourceGroupName: Output<String>

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>?

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>?

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>?

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