Container Apps - Create Or Update

Reference

Service:: Azure Container Apps

API Version:: 2024-03-01

Create or update a Container App.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}?api-version=2024-03-01

URI Parameters

Name	In	Required	Type	Description
containerAppName	path	True	string	Name of the Container App.
resourceGroupName	path	True	string	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string	The ID of the target subscription.
api-version	query	True	string	The API version to use for this operation.

Request Body

Name	Required	Type	Description
location	True	string	The geo-location where the resource lives
extendedLocation		ExtendedLocation	The complex type of the extended location.
identity		ManagedServiceIdentity	managed identities for the Container App to interact with other Azure services without maintaining any secrets or credentials in code.
managedBy		string	The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource.
properties.configuration		Configuration	Non versioned Container App configuration properties.
properties.environmentId		string	Resource ID of environment.
properties.managedEnvironmentId		string	Deprecated. Resource ID of the Container App's environment.
properties.template		Template	Container App versioned application definition.
properties.workloadProfileName		string	Workload profile name to pin for container app execution.
tags		object	Resource tags.

Responses

Name	Type	Description
200 OK	ContainerApp	No change performed on the Container App.
201 Created	ContainerApp	Container App create or update has been started.
Other Status Codes	DefaultErrorResponse	Common error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Create or Update Container App

Create or Update ManagedBy App

Create or Update Tcp App

Create or Update Container App

Sample request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0?api-version=2024-03-01

{
  "location": "East US",
  "properties": {
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "workloadProfileName": "My-GP-01",
    "configuration": {
      "ingress": {
        "external": true,
        "targetPort": 3000,
        "customDomains": [
          {
            "name": "www.my-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
          },
          {
            "name": "www.my-other-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
          }
        ],
        "traffic": [
          {
            "weight": 100,
            "revisionName": "testcontainerapp0-ab1234",
            "label": "production"
          }
        ],
        "ipSecurityRestrictions": [
          {
            "name": "Allow work IP A subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/32",
            "action": "Allow"
          },
          {
            "name": "Allow work IP B subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/8",
            "action": "Allow"
          }
        ],
        "stickySessions": {
          "affinity": "sticky"
        },
        "clientCertificateMode": "accept",
        "corsPolicy": {
          "allowedOrigins": [
            "https://a.test.com",
            "https://b.test.com"
          ],
          "allowedMethods": [
            "GET",
            "POST"
          ],
          "allowedHeaders": [
            "HEADER1",
            "HEADER2"
          ],
          "exposeHeaders": [
            "HEADER3",
            "HEADER4"
          ],
          "maxAge": 1234,
          "allowCredentials": true
        },
        "additionalPortMappings": [
          {
            "external": true,
            "targetPort": 1234
          },
          {
            "external": false,
            "targetPort": 2345,
            "exposedPort": 3456
          }
        ]
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30,
        "httpMaxRequestSize": 10,
        "logLevel": "debug",
        "enableApiLogging": true
      },
      "maxInactiveRevisions": 10,
      "service": {
        "type": "redis"
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v1",
          "name": "testcontainerapp0",
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080,
                "httpHeaders": [
                  {
                    "name": "Custom-Header",
                    "value": "Awesome"
                  }
                ]
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "command": [
            "/bin/sh"
          ],
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "custom": {
              "type": "http",
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      },
      "serviceBinds": [
        {
          "serviceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/redisService",
          "name": "redisService"
        }
      ]
    }
  }
}


import com.azure.resourcemanager.appcontainers.models.Action;
import com.azure.resourcemanager.appcontainers.models.Affinity;
import com.azure.resourcemanager.appcontainers.models.AppProtocol;
import com.azure.resourcemanager.appcontainers.models.BindingType;
import com.azure.resourcemanager.appcontainers.models.Configuration;
import com.azure.resourcemanager.appcontainers.models.Container;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbe;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbeHttpGet;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbeHttpGetHttpHeadersItem;
import com.azure.resourcemanager.appcontainers.models.ContainerResources;
import com.azure.resourcemanager.appcontainers.models.CorsPolicy;
import com.azure.resourcemanager.appcontainers.models.CustomDomain;
import com.azure.resourcemanager.appcontainers.models.CustomScaleRule;
import com.azure.resourcemanager.appcontainers.models.Dapr;
import com.azure.resourcemanager.appcontainers.models.Ingress;
import com.azure.resourcemanager.appcontainers.models.IngressClientCertificateMode;
import com.azure.resourcemanager.appcontainers.models.IngressPortMapping;
import com.azure.resourcemanager.appcontainers.models.IngressStickySessions;
import com.azure.resourcemanager.appcontainers.models.InitContainer;
import com.azure.resourcemanager.appcontainers.models.IpSecurityRestrictionRule;
import com.azure.resourcemanager.appcontainers.models.LogLevel;
import com.azure.resourcemanager.appcontainers.models.Scale;
import com.azure.resourcemanager.appcontainers.models.ScaleRule;
import com.azure.resourcemanager.appcontainers.models.Service;
import com.azure.resourcemanager.appcontainers.models.ServiceBind;
import com.azure.resourcemanager.appcontainers.models.Template;
import com.azure.resourcemanager.appcontainers.models.TrafficWeight;
import com.azure.resourcemanager.appcontainers.models.Type;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ContainerApps CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or Update Container App.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void
        createOrUpdateContainerApp(com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.containerApps().define("testcontainerapp0").withRegion("East US").withExistingResourceGroup("rg")
            .withEnvironmentId(
                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube")
            .withWorkloadProfileName(
                "My-GP-01")
            .withConfiguration(new Configuration()
                .withIngress(new Ingress().withExternal(true).withTargetPort(3000)
                    .withTraffic(
                        Arrays.asList(new TrafficWeight().withRevisionName("testcontainerapp0-ab1234").withWeight(100)
                            .withLabel("production")))
                    .withCustomDomains(Arrays.asList(new CustomDomain()
                        .withName("www.my-name.com").withBindingType(BindingType.SNI_ENABLED)
                        .withCertificateId(
                            "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"),
                        new CustomDomain().withName("www.my-other-name.com").withBindingType(BindingType.SNI_ENABLED)
                            .withCertificateId(
                                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com")))
                    .withIpSecurityRestrictions(Arrays
                        .asList(new IpSecurityRestrictionRule().withName("Allow work IP A subnet")
                            .withDescription("Allowing all IP's within the subnet below to access containerapp")
                            .withIpAddressRange("192.168.1.1/32").withAction(Action.ALLOW),
                            new IpSecurityRestrictionRule().withName("Allow work IP B subnet")
                                .withDescription("Allowing all IP's within the subnet below to access containerapp")
                                .withIpAddressRange("192.168.1.1/8").withAction(Action.ALLOW)))
                    .withStickySessions(new IngressStickySessions().withAffinity(Affinity.STICKY))
                    .withClientCertificateMode(IngressClientCertificateMode.ACCEPT).withCorsPolicy(new CorsPolicy()
                        .withAllowedOrigins(Arrays.asList("https://a.test.com", "https://b.test.com"))
                        .withAllowedMethods(Arrays.asList("GET", "POST")).withAllowedHeaders(Arrays.asList("HEADER1",
                            "HEADER2"))
                        .withExposeHeaders(Arrays.asList("HEADER3", "HEADER4")).withMaxAge(1234)
                        .withAllowCredentials(true))
                    .withAdditionalPortMappings(
                        Arrays.asList(new IngressPortMapping().withExternal(true).withTargetPort(1234),
                            new IngressPortMapping().withExternal(false).withTargetPort(2345).withExposedPort(3456))))
                .withDapr(new Dapr().withEnabled(true).withAppProtocol(AppProtocol.HTTP).withAppPort(3000)
                    .withHttpReadBufferSize(30).withHttpMaxRequestSize(10).withLogLevel(LogLevel.DEBUG)
                    .withEnableApiLogging(true))
                .withMaxInactiveRevisions(10).withService(new Service().withType("redis")))
            .withTemplate(new Template()
                .withInitContainers(Arrays.asList(new InitContainer().withImage("repo/testcontainerapp0:v4")
                    .withName("testinitcontainerApp0").withCommand(Arrays.asList("/bin/sh"))
                    .withArgs(Arrays.asList("-c", "while true; do echo hello; sleep 10;done"))
                    .withResources(new ContainerResources().withCpu(0.5D).withMemory("1Gi"))))
                .withContainers(
                    Arrays
                        .asList(new Container().withImage("repo/testcontainerapp0:v1").withName("testcontainerapp0")
                            .withProbes(Arrays.asList(new ContainerAppProbe()
                                .withHttpGet(new ContainerAppProbeHttpGet()
                                    .withHttpHeaders(Arrays.asList(new ContainerAppProbeHttpGetHttpHeadersItem()
                                        .withName("Custom-Header").withValue("Awesome")))
                                    .withPath("/health").withPort(8080))
                                .withInitialDelaySeconds(3).withPeriodSeconds(3).withType(Type.LIVENESS)))))
                .withScale(new Scale().withMinReplicas(1).withMaxReplicas(5)
                    .withRules(Arrays.asList(new ScaleRule().withName("httpscalingrule").withCustom(
                        new CustomScaleRule().withType("http").withMetadata(mapOf("concurrentRequests", "50"))))))
                .withServiceBinds(Arrays.asList(new ServiceBind().withServiceId(
                    "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/redisService")
                    .withName("redisService"))))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python container_apps_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
    )

    response = client.container_apps.begin_create_or_update(
        resource_group_name="rg",
        container_app_name="testcontainerapp0",
        container_app_envelope={
            "location": "East US",
            "properties": {
                "configuration": {
                    "dapr": {
                        "appPort": 3000,
                        "appProtocol": "http",
                        "enableApiLogging": True,
                        "enabled": True,
                        "httpMaxRequestSize": 10,
                        "httpReadBufferSize": 30,
                        "logLevel": "debug",
                    },
                    "ingress": {
                        "additionalPortMappings": [
                            {"external": True, "targetPort": 1234},
                            {"exposedPort": 3456, "external": False, "targetPort": 2345},
                        ],
                        "clientCertificateMode": "accept",
                        "corsPolicy": {
                            "allowCredentials": True,
                            "allowedHeaders": ["HEADER1", "HEADER2"],
                            "allowedMethods": ["GET", "POST"],
                            "allowedOrigins": ["https://a.test.com", "https://b.test.com"],
                            "exposeHeaders": ["HEADER3", "HEADER4"],
                            "maxAge": 1234,
                        },
                        "customDomains": [
                            {
                                "bindingType": "SniEnabled",
                                "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com",
                                "name": "www.my-name.com",
                            },
                            {
                                "bindingType": "SniEnabled",
                                "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com",
                                "name": "www.my-other-name.com",
                            },
                        ],
                        "external": True,
                        "ipSecurityRestrictions": [
                            {
                                "action": "Allow",
                                "description": "Allowing all IP's within the subnet below to access containerapp",
                                "ipAddressRange": "192.168.1.1/32",
                                "name": "Allow work IP A subnet",
                            },
                            {
                                "action": "Allow",
                                "description": "Allowing all IP's within the subnet below to access containerapp",
                                "ipAddressRange": "192.168.1.1/8",
                                "name": "Allow work IP B subnet",
                            },
                        ],
                        "stickySessions": {"affinity": "sticky"},
                        "targetPort": 3000,
                        "traffic": [{"label": "production", "revisionName": "testcontainerapp0-ab1234", "weight": 100}],
                    },
                    "maxInactiveRevisions": 10,
                    "service": {"type": "redis"},
                },
                "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
                "template": {
                    "containers": [
                        {
                            "image": "repo/testcontainerapp0:v1",
                            "name": "testcontainerapp0",
                            "probes": [
                                {
                                    "httpGet": {
                                        "httpHeaders": [{"name": "Custom-Header", "value": "Awesome"}],
                                        "path": "/health",
                                        "port": 8080,
                                    },
                                    "initialDelaySeconds": 3,
                                    "periodSeconds": 3,
                                    "type": "Liveness",
                                }
                            ],
                        }
                    ],
                    "initContainers": [
                        {
                            "args": ["-c", "while true; do echo hello; sleep 10;done"],
                            "command": ["/bin/sh"],
                            "image": "repo/testcontainerapp0:v4",
                            "name": "testinitcontainerApp0",
                            "resources": {"cpu": 0.5, "memory": "1Gi"},
                        }
                    ],
                    "scale": {
                        "maxReplicas": 5,
                        "minReplicas": 1,
                        "rules": [
                            {
                                "custom": {"metadata": {"concurrentRequests": "50"}, "type": "http"},
                                "name": "httpscalingrule",
                            }
                        ],
                    },
                    "serviceBinds": [
                        {
                            "name": "redisService",
                            "serviceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/redisService",
                        }
                    ],
                },
                "workloadProfileName": "My-GP-01",
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/edf14cc0a577f6b9c4e3ce018cec0c383e64b7b0/specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_CreateOrUpdate.json
func ExampleContainerAppsClient_BeginCreateOrUpdate_createOrUpdateContainerApp() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContainerAppsClient().BeginCreateOrUpdate(ctx, "rg", "testcontainerapp0", armappcontainers.ContainerApp{
		Location: to.Ptr("East US"),
		Properties: &armappcontainers.ContainerAppProperties{
			Configuration: &armappcontainers.Configuration{
				Dapr: &armappcontainers.Dapr{
					AppPort:            to.Ptr[int32](3000),
					AppProtocol:        to.Ptr(armappcontainers.AppProtocolHTTP),
					EnableAPILogging:   to.Ptr(true),
					Enabled:            to.Ptr(true),
					HTTPMaxRequestSize: to.Ptr[int32](10),
					HTTPReadBufferSize: to.Ptr[int32](30),
					LogLevel:           to.Ptr(armappcontainers.LogLevelDebug),
				},
				Ingress: &armappcontainers.Ingress{
					AdditionalPortMappings: []*armappcontainers.IngressPortMapping{
						{
							External:   to.Ptr(true),
							TargetPort: to.Ptr[int32](1234),
						},
						{
							ExposedPort: to.Ptr[int32](3456),
							External:    to.Ptr(false),
							TargetPort:  to.Ptr[int32](2345),
						}},
					ClientCertificateMode: to.Ptr(armappcontainers.IngressClientCertificateModeAccept),
					CorsPolicy: &armappcontainers.CorsPolicy{
						AllowCredentials: to.Ptr(true),
						AllowedHeaders: []*string{
							to.Ptr("HEADER1"),
							to.Ptr("HEADER2")},
						AllowedMethods: []*string{
							to.Ptr("GET"),
							to.Ptr("POST")},
						AllowedOrigins: []*string{
							to.Ptr("https://a.test.com"),
							to.Ptr("https://b.test.com")},
						ExposeHeaders: []*string{
							to.Ptr("HEADER3"),
							to.Ptr("HEADER4")},
						MaxAge: to.Ptr[int32](1234),
					},
					CustomDomains: []*armappcontainers.CustomDomain{
						{
							Name:          to.Ptr("www.my-name.com"),
							BindingType:   to.Ptr(armappcontainers.BindingTypeSniEnabled),
							CertificateID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"),
						},
						{
							Name:          to.Ptr("www.my-other-name.com"),
							BindingType:   to.Ptr(armappcontainers.BindingTypeSniEnabled),
							CertificateID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"),
						}},
					External: to.Ptr(true),
					IPSecurityRestrictions: []*armappcontainers.IPSecurityRestrictionRule{
						{
							Name:           to.Ptr("Allow work IP A subnet"),
							Description:    to.Ptr("Allowing all IP's within the subnet below to access containerapp"),
							Action:         to.Ptr(armappcontainers.ActionAllow),
							IPAddressRange: to.Ptr("192.168.1.1/32"),
						},
						{
							Name:           to.Ptr("Allow work IP B subnet"),
							Description:    to.Ptr("Allowing all IP's within the subnet below to access containerapp"),
							Action:         to.Ptr(armappcontainers.ActionAllow),
							IPAddressRange: to.Ptr("192.168.1.1/8"),
						}},
					StickySessions: &armappcontainers.IngressStickySessions{
						Affinity: to.Ptr(armappcontainers.AffinitySticky),
					},
					TargetPort: to.Ptr[int32](3000),
					Traffic: []*armappcontainers.TrafficWeight{
						{
							Label:        to.Ptr("production"),
							RevisionName: to.Ptr("testcontainerapp0-ab1234"),
							Weight:       to.Ptr[int32](100),
						}},
				},
				MaxInactiveRevisions: to.Ptr[int32](10),
				Service: &armappcontainers.Service{
					Type: to.Ptr("redis"),
				},
			},
			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
			Template: &armappcontainers.Template{
				Containers: []*armappcontainers.Container{
					{
						Name:  to.Ptr("testcontainerapp0"),
						Image: to.Ptr("repo/testcontainerapp0:v1"),
						Probes: []*armappcontainers.ContainerAppProbe{
							{
								Type: to.Ptr(armappcontainers.TypeLiveness),
								HTTPGet: &armappcontainers.ContainerAppProbeHTTPGet{
									Path: to.Ptr("/health"),
									HTTPHeaders: []*armappcontainers.ContainerAppProbeHTTPGetHTTPHeadersItem{
										{
											Name:  to.Ptr("Custom-Header"),
											Value: to.Ptr("Awesome"),
										}},
									Port: to.Ptr[int32](8080),
								},
								InitialDelaySeconds: to.Ptr[int32](3),
								PeriodSeconds:       to.Ptr[int32](3),
							}},
					}},
				InitContainers: []*armappcontainers.InitContainer{
					{
						Name: to.Ptr("testinitcontainerApp0"),
						Args: []*string{
							to.Ptr("-c"),
							to.Ptr("while true; do echo hello; sleep 10;done")},
						Command: []*string{
							to.Ptr("/bin/sh")},
						Image: to.Ptr("repo/testcontainerapp0:v4"),
						Resources: &armappcontainers.ContainerResources{
							CPU:    to.Ptr[float64](0.5),
							Memory: to.Ptr("1Gi"),
						},
					}},
				Scale: &armappcontainers.Scale{
					MaxReplicas: to.Ptr[int32](5),
					MinReplicas: to.Ptr[int32](1),
					Rules: []*armappcontainers.ScaleRule{
						{
							Name: to.Ptr("httpscalingrule"),
							Custom: &armappcontainers.CustomScaleRule{
								Type: to.Ptr("http"),
								Metadata: map[string]*string{
									"concurrentRequests": to.Ptr("50"),
								},
							},
						}},
				},
				ServiceBinds: []*armappcontainers.ServiceBind{
					{
						Name:      to.Ptr("redisService"),
						ServiceID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/redisService"),
					}},
			},
			WorkloadProfileName: to.Ptr("My-GP-01"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ContainerApp = armappcontainers.ContainerApp{
	// 	Name: to.Ptr("testcontainerapp0"),
	// 	Type: to.Ptr("Microsoft.App/containerApps"),
	// 	ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0"),
	// 	Location: to.Ptr("East US"),
	// 	Properties: &armappcontainers.ContainerAppProperties{
	// 		Configuration: &armappcontainers.Configuration{
	// 			Dapr: &armappcontainers.Dapr{
	// 				AppPort: to.Ptr[int32](3000),
	// 				AppProtocol: to.Ptr(armappcontainers.AppProtocolHTTP),
	// 				Enabled: to.Ptr(true),
	// 				HTTPReadBufferSize: to.Ptr[int32](30),
	// 			},
	// 			Ingress: &armappcontainers.Ingress{
	// 				CustomDomains: []*armappcontainers.CustomDomain{
	// 					{
	// 						Name: to.Ptr("www.my-name.com"),
	// 						BindingType: to.Ptr(armappcontainers.BindingTypeSniEnabled),
	// 						CertificateID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"),
	// 					},
	// 					{
	// 						Name: to.Ptr("www.my-other-name.com"),
	// 						BindingType: to.Ptr(armappcontainers.BindingTypeSniEnabled),
	// 						CertificateID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"),
	// 				}},
	// 				External: to.Ptr(true),
	// 				Fqdn: to.Ptr("testcontainerapp0.demokube-t24clv0g.eastus.containerApps.k4apps.io"),
	// 				IPSecurityRestrictions: []*armappcontainers.IPSecurityRestrictionRule{
	// 					{
	// 						Name: to.Ptr("Allow work IP A subnet"),
	// 						Description: to.Ptr("Allowing all IP's within the subnet below to access containerapp"),
	// 						Action: to.Ptr(armappcontainers.ActionAllow),
	// 						IPAddressRange: to.Ptr("192.168.1.1/32"),
	// 					},
	// 					{
	// 						Name: to.Ptr("Allow work IP B subnet"),
	// 						Description: to.Ptr("Allowing all IP's within the subnet below to access containerapp"),
	// 						Action: to.Ptr(armappcontainers.ActionAllow),
	// 						IPAddressRange: to.Ptr("192.168.1.1/8"),
	// 				}},
	// 				StickySessions: &armappcontainers.IngressStickySessions{
	// 					Affinity: to.Ptr(armappcontainers.AffinitySticky),
	// 				},
	// 				TargetPort: to.Ptr[int32](3000),
	// 				Traffic: []*armappcontainers.TrafficWeight{
	// 					{
	// 						RevisionName: to.Ptr("testcontainerapp0-ab1234"),
	// 						Weight: to.Ptr[int32](80),
	// 					},
	// 					{
	// 						Label: to.Ptr("staging"),
	// 						RevisionName: to.Ptr("testcontainerapp0-ab4321"),
	// 						Weight: to.Ptr[int32](20),
	// 				}},
	// 				Transport: to.Ptr(armappcontainers.IngressTransportMethodAuto),
	// 			},
	// 		},
	// 		EventStreamEndpoint: to.Ptr("testEndpoint"),
	// 		LatestReadyRevisionName: to.Ptr("testcontainerapp0-pjxhsye"),
	// 		LatestRevisionFqdn: to.Ptr("testcontainerapp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io"),
	// 		ManagedEnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
	// 		ProvisioningState: to.Ptr(armappcontainers.ContainerAppProvisioningStateSucceeded),
	// 		Template: &armappcontainers.Template{
	// 			Containers: []*armappcontainers.Container{
	// 				{
	// 					Name: to.Ptr("testcontainerapp0"),
	// 					Image: to.Ptr("repo/testcontainerapp0:v4"),
	// 					Resources: &armappcontainers.ContainerResources{
	// 						CPU: to.Ptr[float64](0.5),
	// 						Memory: to.Ptr("1Gi"),
	// 					},
	// 					Probes: []*armappcontainers.ContainerAppProbe{
	// 						{
	// 							Type: to.Ptr(armappcontainers.TypeLiveness),
	// 							HTTPGet: &armappcontainers.ContainerAppProbeHTTPGet{
	// 								Path: to.Ptr("/health"),
	// 								HTTPHeaders: []*armappcontainers.ContainerAppProbeHTTPGetHTTPHeadersItem{
	// 									{
	// 										Name: to.Ptr("Custom-Header"),
	// 										Value: to.Ptr("Awesome"),
	// 								}},
	// 								Port: to.Ptr[int32](8080),
	// 							},
	// 							InitialDelaySeconds: to.Ptr[int32](3),
	// 							PeriodSeconds: to.Ptr[int32](3),
	// 					}},
	// 			}},
	// 			InitContainers: []*armappcontainers.InitContainer{
	// 				{
	// 					Name: to.Ptr("testinitcontainerApp0"),
	// 					Args: []*string{
	// 						to.Ptr("-c"),
	// 						to.Ptr("while true; do echo hello; sleep 10;done")},
	// 						Command: []*string{
	// 							to.Ptr("/bin/sh")},
	// 							Image: to.Ptr("repo/testcontainerapp0:v4"),
	// 							Resources: &armappcontainers.ContainerResources{
	// 								CPU: to.Ptr[float64](0.5),
	// 								Memory: to.Ptr("1Gi"),
	// 							},
	// 					}},
	// 					Scale: &armappcontainers.Scale{
	// 						MaxReplicas: to.Ptr[int32](5),
	// 						MinReplicas: to.Ptr[int32](1),
	// 						Rules: []*armappcontainers.ScaleRule{
	// 							{
	// 								Name: to.Ptr("httpscalingrule"),
	// 								HTTP: &armappcontainers.HTTPScaleRule{
	// 									Metadata: map[string]*string{
	// 										"concurrentRequests": to.Ptr("50"),
	// 									},
	// 								},
	// 						}},
	// 					},
	// 				},
	// 				WorkloadProfileName: to.Ptr("My-GP-01"),
	// 			},
	// 		}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create or update a Container App.
 *
 * @summary Create or update a Container App.
 * x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_CreateOrUpdate.json
 */
async function createOrUpdateContainerApp() {
  const subscriptionId =
    process.env["APPCONTAINERS_SUBSCRIPTION_ID"] || "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const resourceGroupName = process.env["APPCONTAINERS_RESOURCE_GROUP"] || "rg";
  const containerAppName = "testcontainerapp0";
  const containerAppEnvelope = {
    configuration: {
      dapr: {
        appPort: 3000,
        appProtocol: "http",
        enableApiLogging: true,
        enabled: true,
        httpMaxRequestSize: 10,
        httpReadBufferSize: 30,
        logLevel: "debug",
      },
      ingress: {
        additionalPortMappings: [
          { external: true, targetPort: 1234 },
          { exposedPort: 3456, external: false, targetPort: 2345 },
        ],
        clientCertificateMode: "accept",
        corsPolicy: {
          allowCredentials: true,
          allowedHeaders: ["HEADER1", "HEADER2"],
          allowedMethods: ["GET", "POST"],
          allowedOrigins: ["https://a.test.com", "https://b.test.com"],
          exposeHeaders: ["HEADER3", "HEADER4"],
          maxAge: 1234,
        },
        customDomains: [
          {
            name: "www.my-name.com",
            bindingType: "SniEnabled",
            certificateId:
              "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com",
          },
          {
            name: "www.my-other-name.com",
            bindingType: "SniEnabled",
            certificateId:
              "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com",
          },
        ],
        external: true,
        ipSecurityRestrictions: [
          {
            name: "Allow work IP A subnet",
            description: "Allowing all IP's within the subnet below to access containerapp",
            action: "Allow",
            ipAddressRange: "192.168.1.1/32",
          },
          {
            name: "Allow work IP B subnet",
            description: "Allowing all IP's within the subnet below to access containerapp",
            action: "Allow",
            ipAddressRange: "192.168.1.1/8",
          },
        ],
        stickySessions: { affinity: "sticky" },
        targetPort: 3000,
        traffic: [
          {
            label: "production",
            revisionName: "testcontainerapp0-ab1234",
            weight: 100,
          },
        ],
      },
      maxInactiveRevisions: 10,
      service: { type: "redis" },
    },
    environmentId:
      "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    location: "East US",
    template: {
      containers: [
        {
          name: "testcontainerapp0",
          image: "repo/testcontainerapp0:v1",
          probes: [
            {
              type: "Liveness",
              httpGet: {
                path: "/health",
                httpHeaders: [{ name: "Custom-Header", value: "Awesome" }],
                port: 8080,
              },
              initialDelaySeconds: 3,
              periodSeconds: 3,
            },
          ],
        },
      ],
      initContainers: [
        {
          name: "testinitcontainerApp0",
          args: ["-c", "while true; do echo hello; sleep 10;done"],
          command: ["/bin/sh"],
          image: "repo/testcontainerapp0:v4",
          resources: { cpu: 0.5, memory: "1Gi" },
        },
      ],
      scale: {
        maxReplicas: 5,
        minReplicas: 1,
        rules: [
          {
            name: "httpscalingrule",
            custom: { type: "http", metadata: { concurrentRequests: "50" } },
          },
        ],
      },
      serviceBinds: [
        {
          name: "redisService",
          serviceId:
            "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/redisService",
        },
      ],
    },
    workloadProfileName: "My-GP-01",
  };
  const credential = new DefaultAzureCredential();
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerApps.beginCreateOrUpdateAndWait(
    resourceGroupName,
    containerAppName,
    containerAppEnvelope,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppContainers.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppContainers;

// Generated from example definition: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_CreateOrUpdate.json
// this example is just showing the usage of "ContainerApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ContainerAppResource
ContainerAppCollection collection = resourceGroupResource.GetContainerApps();

// invoke the operation
string containerAppName = "testcontainerapp0";
ContainerAppData data = new ContainerAppData(new AzureLocation("East US"))
{
    EnvironmentId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
    WorkloadProfileName = "My-GP-01",
    Configuration = new ContainerAppConfiguration()
    {
        Ingress = new ContainerAppIngressConfiguration()
        {
            External = true,
            TargetPort = 3000,
            Traffic =
            {
            new ContainerAppRevisionTrafficWeight()
            {
            RevisionName = "testcontainerapp0-ab1234",
            Weight = 100,
            Label = "production",
            }
            },
            CustomDomains =
            {
            new ContainerAppCustomDomain("www.my-name.com")
            {
            BindingType = ContainerAppCustomDomainBindingType.SniEnabled,
            CertificateId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"),
            },new ContainerAppCustomDomain("www.my-other-name.com")
            {
            BindingType = ContainerAppCustomDomainBindingType.SniEnabled,
            CertificateId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"),
            }
            },
            IPSecurityRestrictions =
            {
            new ContainerAppIPSecurityRestrictionRule("Allow work IP A subnet","192.168.1.1/32",ContainerAppIPRuleAction.Allow)
            {
            Description = "Allowing all IP's within the subnet below to access containerapp",
            },new ContainerAppIPSecurityRestrictionRule("Allow work IP B subnet","192.168.1.1/8",ContainerAppIPRuleAction.Allow)
            {
            Description = "Allowing all IP's within the subnet below to access containerapp",
            }
            },
            StickySessionsAffinity = Affinity.Sticky,
            ClientCertificateMode = ContainerAppIngressClientCertificateMode.Accept,
            CorsPolicy = new ContainerAppCorsPolicy(new string[]
{
"https://a.test.com","https://b.test.com"
})
            {
                AllowedMethods =
                {
                "GET","POST"
                },
                AllowedHeaders =
                {
                "HEADER1","HEADER2"
                },
                ExposeHeaders =
                {
                "HEADER3","HEADER4"
                },
                MaxAge = 1234,
                AllowCredentials = true,
            },
            AdditionalPortMappings =
            {
            new IngressPortMapping(true,1234),new IngressPortMapping(false,2345)
            {
            ExposedPort = 3456,
            }
            },
        },
        Dapr = new ContainerAppDaprConfiguration()
        {
            IsEnabled = true,
            AppProtocol = ContainerAppProtocol.Http,
            AppPort = 3000,
            HttpReadBufferSize = 30,
            HttpMaxRequestSize = 10,
            LogLevel = ContainerAppDaprLogLevel.Debug,
            IsApiLoggingEnabled = true,
        },
        MaxInactiveRevisions = 10,
        ServiceType = "redis",
    },
    Template = new ContainerAppTemplate()
    {
        InitContainers =
        {
        new ContainerAppInitContainer()
        {
        Image = "repo/testcontainerapp0:v4",
        Name = "testinitcontainerApp0",
        Command =
        {
        "/bin/sh"
        },
        Args =
        {
        "-c","while true; do echo hello; sleep 10;done"
        },
        Resources = new AppContainerResources()
        {
        Cpu = 0.5,
        Memory = "1Gi",
        },
        }
        },
        Containers =
        {
        new ContainerAppContainer()
        {
        Probes =
        {
        new ContainerAppProbe()
        {
        HttpGet = new ContainerAppHttpRequestInfo(8080)
        {
        HttpHeaders =
        {
        new ContainerAppHttpHeaderInfo("Custom-Header","Awesome")
        },
        Path = "/health",
        },
        InitialDelaySeconds = 3,
        PeriodSeconds = 3,
        ProbeType = ContainerAppProbeType.Liveness,
        }
        },
        Image = "repo/testcontainerapp0:v1",
        Name = "testcontainerapp0",
        }
        },
        Scale = new ContainerAppScale()
        {
            MinReplicas = 1,
            MaxReplicas = 5,
            Rules =
            {
            new ContainerAppScaleRule()
            {
            Name = "httpscalingrule",
            Custom = new ContainerAppCustomScaleRule()
            {
            CustomScaleRuleType = "http",
            Metadata =
            {
            ["concurrentRequests"] = "50",
            },
            },
            }
            },
        },
        ServiceBinds =
        {
        new ContainerAppServiceBind()
        {
        ServiceId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/redisService"),
        Name = "redisService",
        }
        },
    },
};
ArmOperation<ContainerAppResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, containerAppName, data);
ContainerAppResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ContainerAppData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0",
  "name": "testcontainerapp0",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "properties": {
    "provisioningState": "Succeeded",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "workloadProfileName": "My-GP-01",
    "latestRevisionFqdn": "testcontainerapp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "latestReadyRevisionName": "testcontainerapp0-pjxhsye",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerapp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "transport": "auto",
        "customDomains": [
          {
            "name": "www.my-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
          },
          {
            "name": "www.my-other-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
          }
        ],
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerapp0-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerapp0-ab4321",
            "label": "staging"
          }
        ],
        "ipSecurityRestrictions": [
          {
            "name": "Allow work IP A subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/32",
            "action": "Allow"
          },
          {
            "name": "Allow work IP B subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/8",
            "action": "Allow"
          }
        ],
        "stickySessions": {
          "affinity": "sticky"
        }
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testcontainerapp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080,
                "httpHeaders": [
                  {
                    "name": "Custom-Header",
                    "value": "Awesome"
                  }
                ]
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "command": [
            "/bin/sh"
          ],
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "http": {
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      }
    },
    "eventStreamEndpoint": "testEndpoint"
  }
}

Status code:: 201

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0",
  "name": "testcontainerapp0",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "properties": {
    "provisioningState": "InProgress",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "latestRevisionFqdn": "testcontainerapp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerapp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "transport": "auto",
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerapp0-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerapp0-ab4321",
            "label": "staging"
          }
        ]
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testcontainerapp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080,
                "httpHeaders": [
                  {
                    "name": "Custom-Header",
                    "value": "Awesome"
                  }
                ]
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "command": [
            "/bin/sh"
          ],
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "http": {
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      }
    },
    "eventStreamEndpoint": "testEndpoint"
  }
}

Create or Update ManagedBy App

Sample request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerappmanagedby?api-version=2024-03-01

{
  "location": "East US",
  "managedBy": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp",
  "properties": {
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "configuration": {
      "ingress": {
        "external": true,
        "targetPort": 3000,
        "exposedPort": 4000,
        "transport": "tcp",
        "traffic": [
          {
            "weight": 100,
            "revisionName": "testcontainerappmanagedby-ab1234"
          }
        ]
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerappmanagedby:v1",
          "name": "testcontainerappmanagedby",
          "probes": [
            {
              "type": "Liveness",
              "tcpSocket": {
                "port": 8080
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "tcpscalingrule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "50"
              }
            }
          }
        ]
      }
    }
  }
}


import com.azure.resourcemanager.appcontainers.models.Configuration;
import com.azure.resourcemanager.appcontainers.models.Container;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbe;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbeTcpSocket;
import com.azure.resourcemanager.appcontainers.models.Ingress;
import com.azure.resourcemanager.appcontainers.models.IngressTransportMethod;
import com.azure.resourcemanager.appcontainers.models.Scale;
import com.azure.resourcemanager.appcontainers.models.ScaleRule;
import com.azure.resourcemanager.appcontainers.models.TcpScaleRule;
import com.azure.resourcemanager.appcontainers.models.Template;
import com.azure.resourcemanager.appcontainers.models.TrafficWeight;
import com.azure.resourcemanager.appcontainers.models.Type;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ContainerApps CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/
     * ContainerApps_ManagedBy_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or Update ManagedBy App.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void
        createOrUpdateManagedByApp(com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.containerApps().define("testcontainerappmanagedby").withRegion("East US")
            .withExistingResourceGroup("rg")
            .withManagedBy(
                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp")
            .withEnvironmentId(
                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube")
            .withConfiguration(
                new Configuration()
                    .withIngress(
                        new Ingress().withExternal(true).withTargetPort(3000).withExposedPort(4000)
                            .withTransport(IngressTransportMethod.TCP).withTraffic(
                                Arrays
                                    .asList(
                                        new TrafficWeight().withRevisionName("testcontainerappmanagedby-ab1234")
                                            .withWeight(100)))))
            .withTemplate(new Template()
                .withContainers(Arrays.asList(new Container().withImage("repo/testcontainerappmanagedby:v1")
                    .withName("testcontainerappmanagedby")
                    .withProbes(Arrays.asList(new ContainerAppProbe().withInitialDelaySeconds(3).withPeriodSeconds(3)
                        .withTcpSocket(new ContainerAppProbeTcpSocket().withPort(8080)).withType(Type.LIVENESS)))))
                .withScale(
                    new Scale().withMinReplicas(1).withMaxReplicas(5)
                        .withRules(Arrays.asList(new ScaleRule().withName("tcpscalingrule")
                            .withTcp(new TcpScaleRule().withMetadata(mapOf("concurrentConnections", "50")))))))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python container_apps_managed_by_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
    )

    response = client.container_apps.begin_create_or_update(
        resource_group_name="rg",
        container_app_name="testcontainerappmanagedby",
        container_app_envelope={
            "location": "East US",
            "managedBy": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp",
            "properties": {
                "configuration": {
                    "ingress": {
                        "exposedPort": 4000,
                        "external": True,
                        "targetPort": 3000,
                        "traffic": [{"revisionName": "testcontainerappmanagedby-ab1234", "weight": 100}],
                        "transport": "tcp",
                    }
                },
                "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
                "template": {
                    "containers": [
                        {
                            "image": "repo/testcontainerappmanagedby:v1",
                            "name": "testcontainerappmanagedby",
                            "probes": [
                                {
                                    "initialDelaySeconds": 3,
                                    "periodSeconds": 3,
                                    "tcpSocket": {"port": 8080},
                                    "type": "Liveness",
                                }
                            ],
                        }
                    ],
                    "scale": {
                        "maxReplicas": 5,
                        "minReplicas": 1,
                        "rules": [{"name": "tcpscalingrule", "tcp": {"metadata": {"concurrentConnections": "50"}}}],
                    },
                },
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_ManagedBy_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/edf14cc0a577f6b9c4e3ce018cec0c383e64b7b0/specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_ManagedBy_CreateOrUpdate.json
func ExampleContainerAppsClient_BeginCreateOrUpdate_createOrUpdateManagedByApp() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContainerAppsClient().BeginCreateOrUpdate(ctx, "rg", "testcontainerappmanagedby", armappcontainers.ContainerApp{
		Location:  to.Ptr("East US"),
		ManagedBy: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp"),
		Properties: &armappcontainers.ContainerAppProperties{
			Configuration: &armappcontainers.Configuration{
				Ingress: &armappcontainers.Ingress{
					ExposedPort: to.Ptr[int32](4000),
					External:    to.Ptr(true),
					TargetPort:  to.Ptr[int32](3000),
					Traffic: []*armappcontainers.TrafficWeight{
						{
							RevisionName: to.Ptr("testcontainerappmanagedby-ab1234"),
							Weight:       to.Ptr[int32](100),
						}},
					Transport: to.Ptr(armappcontainers.IngressTransportMethodTCP),
				},
			},
			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
			Template: &armappcontainers.Template{
				Containers: []*armappcontainers.Container{
					{
						Name:  to.Ptr("testcontainerappmanagedby"),
						Image: to.Ptr("repo/testcontainerappmanagedby:v1"),
						Probes: []*armappcontainers.ContainerAppProbe{
							{
								Type:                to.Ptr(armappcontainers.TypeLiveness),
								InitialDelaySeconds: to.Ptr[int32](3),
								PeriodSeconds:       to.Ptr[int32](3),
								TCPSocket: &armappcontainers.ContainerAppProbeTCPSocket{
									Port: to.Ptr[int32](8080),
								},
							}},
					}},
				Scale: &armappcontainers.Scale{
					MaxReplicas: to.Ptr[int32](5),
					MinReplicas: to.Ptr[int32](1),
					Rules: []*armappcontainers.ScaleRule{
						{
							Name: to.Ptr("tcpscalingrule"),
							TCP: &armappcontainers.TCPScaleRule{
								Metadata: map[string]*string{
									"concurrentConnections": to.Ptr("50"),
								},
							},
						}},
				},
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ContainerApp = armappcontainers.ContainerApp{
	// 	Name: to.Ptr("testcontainerappmanagedby"),
	// 	Type: to.Ptr("Microsoft.App/containerApps"),
	// 	ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerappmanagedby"),
	// 	Location: to.Ptr("East US"),
	// 	ManagedBy: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp"),
	// 	Properties: &armappcontainers.ContainerAppProperties{
	// 		Configuration: &armappcontainers.Configuration{
	// 			Ingress: &armappcontainers.Ingress{
	// 				ExposedPort: to.Ptr[int32](4000),
	// 				External: to.Ptr(true),
	// 				Fqdn: to.Ptr("testcontainerappmanagedby.demokube-t24clv0g.eastus.containerApps.k4apps.io"),
	// 				TargetPort: to.Ptr[int32](3000),
	// 				Traffic: []*armappcontainers.TrafficWeight{
	// 					{
	// 						RevisionName: to.Ptr("testcontainerappmanagedby-ab1234"),
	// 						Weight: to.Ptr[int32](80),
	// 					},
	// 					{
	// 						RevisionName: to.Ptr("testcontainerappmanagedby-ab4321"),
	// 						Weight: to.Ptr[int32](20),
	// 				}},
	// 				Transport: to.Ptr(armappcontainers.IngressTransportMethodTCP),
	// 			},
	// 		},
	// 		LatestReadyRevisionName: to.Ptr("testcontainerappmanagedby-pjxhsye"),
	// 		LatestRevisionFqdn: to.Ptr("testcontainerappmanagedby-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io"),
	// 		ManagedEnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
	// 		ProvisioningState: to.Ptr(armappcontainers.ContainerAppProvisioningStateSucceeded),
	// 		Template: &armappcontainers.Template{
	// 			Containers: []*armappcontainers.Container{
	// 				{
	// 					Name: to.Ptr("testcontainerappmanagedby"),
	// 					Image: to.Ptr("repo/testcontainerappmanagedby:v4"),
	// 					Resources: &armappcontainers.ContainerResources{
	// 						CPU: to.Ptr[float64](0.5),
	// 						Memory: to.Ptr("1Gi"),
	// 					},
	// 					Probes: []*armappcontainers.ContainerAppProbe{
	// 						{
	// 							Type: to.Ptr(armappcontainers.TypeLiveness),
	// 							InitialDelaySeconds: to.Ptr[int32](3),
	// 							PeriodSeconds: to.Ptr[int32](3),
	// 							TCPSocket: &armappcontainers.ContainerAppProbeTCPSocket{
	// 								Port: to.Ptr[int32](8080),
	// 							},
	// 					}},
	// 			}},
	// 			Scale: &armappcontainers.Scale{
	// 				MaxReplicas: to.Ptr[int32](5),
	// 				MinReplicas: to.Ptr[int32](1),
	// 				Rules: []*armappcontainers.ScaleRule{
	// 					{
	// 						Name: to.Ptr("tcpscalingrule"),
	// 						TCP: &armappcontainers.TCPScaleRule{
	// 							Metadata: map[string]*string{
	// 								"concurrentConnections": to.Ptr("50"),
	// 							},
	// 						},
	// 				}},
	// 			},
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create or update a Container App.
 *
 * @summary Create or update a Container App.
 * x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_ManagedBy_CreateOrUpdate.json
 */
async function createOrUpdateManagedByApp() {
  const subscriptionId =
    process.env["APPCONTAINERS_SUBSCRIPTION_ID"] || "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const resourceGroupName = process.env["APPCONTAINERS_RESOURCE_GROUP"] || "rg";
  const containerAppName = "testcontainerappmanagedby";
  const containerAppEnvelope = {
    configuration: {
      ingress: {
        exposedPort: 4000,
        external: true,
        targetPort: 3000,
        traffic: [{ revisionName: "testcontainerappmanagedby-ab1234", weight: 100 }],
        transport: "tcp",
      },
    },
    environmentId:
      "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    location: "East US",
    managedBy:
      "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp",
    template: {
      containers: [
        {
          name: "testcontainerappmanagedby",
          image: "repo/testcontainerappmanagedby:v1",
          probes: [
            {
              type: "Liveness",
              initialDelaySeconds: 3,
              periodSeconds: 3,
              tcpSocket: { port: 8080 },
            },
          ],
        },
      ],
      scale: {
        maxReplicas: 5,
        minReplicas: 1,
        rules: [
          {
            name: "tcpscalingrule",
            tcp: { metadata: { concurrentConnections: "50" } },
          },
        ],
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerApps.beginCreateOrUpdateAndWait(
    resourceGroupName,
    containerAppName,
    containerAppEnvelope,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppContainers.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppContainers;

// Generated from example definition: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_ManagedBy_CreateOrUpdate.json
// this example is just showing the usage of "ContainerApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ContainerAppResource
ContainerAppCollection collection = resourceGroupResource.GetContainerApps();

// invoke the operation
string containerAppName = "testcontainerappmanagedby";
ContainerAppData data = new ContainerAppData(new AzureLocation("East US"))
{
    ManagedBy = "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp",
    EnvironmentId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
    Configuration = new ContainerAppConfiguration()
    {
        Ingress = new ContainerAppIngressConfiguration()
        {
            External = true,
            TargetPort = 3000,
            ExposedPort = 4000,
            Transport = ContainerAppIngressTransportMethod.Tcp,
            Traffic =
            {
            new ContainerAppRevisionTrafficWeight()
            {
            RevisionName = "testcontainerappmanagedby-ab1234",
            Weight = 100,
            }
            },
        },
    },
    Template = new ContainerAppTemplate()
    {
        Containers =
        {
        new ContainerAppContainer()
        {
        Probes =
        {
        new ContainerAppProbe()
        {
        InitialDelaySeconds = 3,
        PeriodSeconds = 3,
        TcpSocket = new ContainerAppTcpSocketRequestInfo(8080),
        ProbeType = ContainerAppProbeType.Liveness,
        }
        },
        Image = "repo/testcontainerappmanagedby:v1",
        Name = "testcontainerappmanagedby",
        }
        },
        Scale = new ContainerAppScale()
        {
            MinReplicas = 1,
            MaxReplicas = 5,
            Rules =
            {
            new ContainerAppScaleRule()
            {
            Name = "tcpscalingrule",
            Tcp = new ContainerAppTcpScaleRule()
            {
            Metadata =
            {
            ["concurrentConnections"] = "50",
            },
            },
            }
            },
        },
    },
};
ArmOperation<ContainerAppResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, containerAppName, data);
ContainerAppResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ContainerAppData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerappmanagedby",
  "name": "testcontainerappmanagedby",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "managedBy": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp",
  "properties": {
    "provisioningState": "Succeeded",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "latestRevisionFqdn": "testcontainerappmanagedby-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "latestReadyRevisionName": "testcontainerappmanagedby-pjxhsye",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerappmanagedby.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "exposedPort": 4000,
        "transport": "tcp",
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerappmanagedby-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerappmanagedby-ab4321"
          }
        ]
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerappmanagedby:v4",
          "name": "testcontainerappmanagedby",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "probes": [
            {
              "type": "Liveness",
              "tcpSocket": {
                "port": 8080
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "tcpscalingrule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "50"
              }
            }
          }
        ]
      }
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerappmanagedby",
  "name": "testcontainerappmanagedby",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "managedBy": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppPlatform/Spring/springapp",
  "properties": {
    "provisioningState": "InProgress",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "latestRevisionFqdn": "testcontainerappmanagedby-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerappmanagedby.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "exposedPort": 4000,
        "transport": "tcp",
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerappmanagedby-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerappmanagedby-ab4321"
          }
        ]
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerappmanagedby:v4",
          "name": "testcontainerappmanagedby",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "probes": [
            {
              "type": "Liveness",
              "tcpSocket": {
                "port": 8080
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "tcpscalingrule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "50"
              }
            }
          }
        ]
      }
    }
  }
}

Create or Update Tcp App

Sample request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapptcp?api-version=2024-03-01

{
  "location": "East US",
  "properties": {
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "configuration": {
      "ingress": {
        "external": true,
        "targetPort": 3000,
        "exposedPort": 4000,
        "transport": "tcp",
        "traffic": [
          {
            "weight": 100,
            "revisionName": "testcontainerapptcp-ab1234"
          }
        ]
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapptcp:v1",
          "name": "testcontainerapptcp",
          "probes": [
            {
              "type": "Liveness",
              "tcpSocket": {
                "port": 8080
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "tcpscalingrule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "50"
              }
            }
          }
        ]
      }
    }
  }
}


import com.azure.resourcemanager.appcontainers.models.Configuration;
import com.azure.resourcemanager.appcontainers.models.Container;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbe;
import com.azure.resourcemanager.appcontainers.models.ContainerAppProbeTcpSocket;
import com.azure.resourcemanager.appcontainers.models.Ingress;
import com.azure.resourcemanager.appcontainers.models.IngressTransportMethod;
import com.azure.resourcemanager.appcontainers.models.Scale;
import com.azure.resourcemanager.appcontainers.models.ScaleRule;
import com.azure.resourcemanager.appcontainers.models.TcpScaleRule;
import com.azure.resourcemanager.appcontainers.models.Template;
import com.azure.resourcemanager.appcontainers.models.TrafficWeight;
import com.azure.resourcemanager.appcontainers.models.Type;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ContainerApps CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_TcpApp_CreateOrUpdate.
     * json
     */
    /**
     * Sample code: Create or Update Tcp App.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void createOrUpdateTcpApp(com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.containerApps().define("testcontainerapptcp").withRegion("East US").withExistingResourceGroup("rg")
            .withEnvironmentId(
                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube")
            .withConfiguration(
                new Configuration()
                    .withIngress(
                        new Ingress().withExternal(true).withTargetPort(3000).withExposedPort(4000)
                            .withTransport(
                                IngressTransportMethod.TCP)
                            .withTraffic(
                                Arrays
                                    .asList(
                                        new TrafficWeight().withRevisionName(
                                            "testcontainerapptcp-ab1234").withWeight(
                                                100)))))
            .withTemplate(new Template()
                .withContainers(Arrays.asList(new Container().withImage("repo/testcontainerapptcp:v1")
                    .withName("testcontainerapptcp")
                    .withProbes(Arrays.asList(new ContainerAppProbe().withInitialDelaySeconds(3).withPeriodSeconds(3)
                        .withTcpSocket(new ContainerAppProbeTcpSocket().withPort(8080)).withType(Type.LIVENESS)))))
                .withScale(
                    new Scale().withMinReplicas(1).withMaxReplicas(5)
                        .withRules(Arrays.asList(new ScaleRule().withName("tcpscalingrule")
                            .withTcp(new TcpScaleRule().withMetadata(mapOf("concurrentConnections", "50")))))))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python container_apps_tcp_app_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
    )

    response = client.container_apps.begin_create_or_update(
        resource_group_name="rg",
        container_app_name="testcontainerapptcp",
        container_app_envelope={
            "location": "East US",
            "properties": {
                "configuration": {
                    "ingress": {
                        "exposedPort": 4000,
                        "external": True,
                        "targetPort": 3000,
                        "traffic": [{"revisionName": "testcontainerapptcp-ab1234", "weight": 100}],
                        "transport": "tcp",
                    }
                },
                "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
                "template": {
                    "containers": [
                        {
                            "image": "repo/testcontainerapptcp:v1",
                            "name": "testcontainerapptcp",
                            "probes": [
                                {
                                    "initialDelaySeconds": 3,
                                    "periodSeconds": 3,
                                    "tcpSocket": {"port": 8080},
                                    "type": "Liveness",
                                }
                            ],
                        }
                    ],
                    "scale": {
                        "maxReplicas": 5,
                        "minReplicas": 1,
                        "rules": [{"name": "tcpscalingrule", "tcp": {"metadata": {"concurrentConnections": "50"}}}],
                    },
                },
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_TcpApp_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/edf14cc0a577f6b9c4e3ce018cec0c383e64b7b0/specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_TcpApp_CreateOrUpdate.json
func ExampleContainerAppsClient_BeginCreateOrUpdate_createOrUpdateTcpApp() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContainerAppsClient().BeginCreateOrUpdate(ctx, "rg", "testcontainerapptcp", armappcontainers.ContainerApp{
		Location: to.Ptr("East US"),
		Properties: &armappcontainers.ContainerAppProperties{
			Configuration: &armappcontainers.Configuration{
				Ingress: &armappcontainers.Ingress{
					ExposedPort: to.Ptr[int32](4000),
					External:    to.Ptr(true),
					TargetPort:  to.Ptr[int32](3000),
					Traffic: []*armappcontainers.TrafficWeight{
						{
							RevisionName: to.Ptr("testcontainerapptcp-ab1234"),
							Weight:       to.Ptr[int32](100),
						}},
					Transport: to.Ptr(armappcontainers.IngressTransportMethodTCP),
				},
			},
			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
			Template: &armappcontainers.Template{
				Containers: []*armappcontainers.Container{
					{
						Name:  to.Ptr("testcontainerapptcp"),
						Image: to.Ptr("repo/testcontainerapptcp:v1"),
						Probes: []*armappcontainers.ContainerAppProbe{
							{
								Type:                to.Ptr(armappcontainers.TypeLiveness),
								InitialDelaySeconds: to.Ptr[int32](3),
								PeriodSeconds:       to.Ptr[int32](3),
								TCPSocket: &armappcontainers.ContainerAppProbeTCPSocket{
									Port: to.Ptr[int32](8080),
								},
							}},
					}},
				Scale: &armappcontainers.Scale{
					MaxReplicas: to.Ptr[int32](5),
					MinReplicas: to.Ptr[int32](1),
					Rules: []*armappcontainers.ScaleRule{
						{
							Name: to.Ptr("tcpscalingrule"),
							TCP: &armappcontainers.TCPScaleRule{
								Metadata: map[string]*string{
									"concurrentConnections": to.Ptr("50"),
								},
							},
						}},
				},
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ContainerApp = armappcontainers.ContainerApp{
	// 	Name: to.Ptr("testcontainerapptcp"),
	// 	Type: to.Ptr("Microsoft.App/containerApps"),
	// 	ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapptcp"),
	// 	Location: to.Ptr("East US"),
	// 	Properties: &armappcontainers.ContainerAppProperties{
	// 		Configuration: &armappcontainers.Configuration{
	// 			Ingress: &armappcontainers.Ingress{
	// 				ExposedPort: to.Ptr[int32](4000),
	// 				External: to.Ptr(true),
	// 				Fqdn: to.Ptr("testcontainerapptcp.demokube-t24clv0g.eastus.containerApps.k4apps.io"),
	// 				TargetPort: to.Ptr[int32](3000),
	// 				Traffic: []*armappcontainers.TrafficWeight{
	// 					{
	// 						RevisionName: to.Ptr("testcontainerapptcp-ab1234"),
	// 						Weight: to.Ptr[int32](80),
	// 					},
	// 					{
	// 						RevisionName: to.Ptr("testcontainerapptcp-ab4321"),
	// 						Weight: to.Ptr[int32](20),
	// 				}},
	// 				Transport: to.Ptr(armappcontainers.IngressTransportMethodTCP),
	// 			},
	// 		},
	// 		LatestReadyRevisionName: to.Ptr("testcontainerapptcp-pjxhsye"),
	// 		LatestRevisionFqdn: to.Ptr("testcontainerapptcp-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io"),
	// 		ManagedEnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
	// 		ProvisioningState: to.Ptr(armappcontainers.ContainerAppProvisioningStateSucceeded),
	// 		Template: &armappcontainers.Template{
	// 			Containers: []*armappcontainers.Container{
	// 				{
	// 					Name: to.Ptr("testcontainerapptcp"),
	// 					Image: to.Ptr("repo/testcontainerapptcp:v4"),
	// 					Resources: &armappcontainers.ContainerResources{
	// 						CPU: to.Ptr[float64](0.5),
	// 						Memory: to.Ptr("1Gi"),
	// 					},
	// 					Probes: []*armappcontainers.ContainerAppProbe{
	// 						{
	// 							Type: to.Ptr(armappcontainers.TypeLiveness),
	// 							InitialDelaySeconds: to.Ptr[int32](3),
	// 							PeriodSeconds: to.Ptr[int32](3),
	// 							TCPSocket: &armappcontainers.ContainerAppProbeTCPSocket{
	// 								Port: to.Ptr[int32](8080),
	// 							},
	// 					}},
	// 			}},
	// 			Scale: &armappcontainers.Scale{
	// 				MaxReplicas: to.Ptr[int32](5),
	// 				MinReplicas: to.Ptr[int32](1),
	// 				Rules: []*armappcontainers.ScaleRule{
	// 					{
	// 						Name: to.Ptr("tcpscalingrule"),
	// 						TCP: &armappcontainers.TCPScaleRule{
	// 							Metadata: map[string]*string{
	// 								"concurrentConnections": to.Ptr("50"),
	// 							},
	// 						},
	// 				}},
	// 			},
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create or update a Container App.
 *
 * @summary Create or update a Container App.
 * x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_TcpApp_CreateOrUpdate.json
 */
async function createOrUpdateTcpApp() {
  const subscriptionId =
    process.env["APPCONTAINERS_SUBSCRIPTION_ID"] || "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const resourceGroupName = process.env["APPCONTAINERS_RESOURCE_GROUP"] || "rg";
  const containerAppName = "testcontainerapptcp";
  const containerAppEnvelope = {
    configuration: {
      ingress: {
        exposedPort: 4000,
        external: true,
        targetPort: 3000,
        traffic: [{ revisionName: "testcontainerapptcp-ab1234", weight: 100 }],
        transport: "tcp",
      },
    },
    environmentId:
      "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    location: "East US",
    template: {
      containers: [
        {
          name: "testcontainerapptcp",
          image: "repo/testcontainerapptcp:v1",
          probes: [
            {
              type: "Liveness",
              initialDelaySeconds: 3,
              periodSeconds: 3,
              tcpSocket: { port: 8080 },
            },
          ],
        },
      ],
      scale: {
        maxReplicas: 5,
        minReplicas: 1,
        rules: [
          {
            name: "tcpscalingrule",
            tcp: { metadata: { concurrentConnections: "50" } },
          },
        ],
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerApps.beginCreateOrUpdateAndWait(
    resourceGroupName,
    containerAppName,
    containerAppEnvelope,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppContainers.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppContainers;

// Generated from example definition: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_TcpApp_CreateOrUpdate.json
// this example is just showing the usage of "ContainerApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ContainerAppResource
ContainerAppCollection collection = resourceGroupResource.GetContainerApps();

// invoke the operation
string containerAppName = "testcontainerapptcp";
ContainerAppData data = new ContainerAppData(new AzureLocation("East US"))
{
    EnvironmentId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
    Configuration = new ContainerAppConfiguration()
    {
        Ingress = new ContainerAppIngressConfiguration()
        {
            External = true,
            TargetPort = 3000,
            ExposedPort = 4000,
            Transport = ContainerAppIngressTransportMethod.Tcp,
            Traffic =
            {
            new ContainerAppRevisionTrafficWeight()
            {
            RevisionName = "testcontainerapptcp-ab1234",
            Weight = 100,
            }
            },
        },
    },
    Template = new ContainerAppTemplate()
    {
        Containers =
        {
        new ContainerAppContainer()
        {
        Probes =
        {
        new ContainerAppProbe()
        {
        InitialDelaySeconds = 3,
        PeriodSeconds = 3,
        TcpSocket = new ContainerAppTcpSocketRequestInfo(8080),
        ProbeType = ContainerAppProbeType.Liveness,
        }
        },
        Image = "repo/testcontainerapptcp:v1",
        Name = "testcontainerapptcp",
        }
        },
        Scale = new ContainerAppScale()
        {
            MinReplicas = 1,
            MaxReplicas = 5,
            Rules =
            {
            new ContainerAppScaleRule()
            {
            Name = "tcpscalingrule",
            Tcp = new ContainerAppTcpScaleRule()
            {
            Metadata =
            {
            ["concurrentConnections"] = "50",
            },
            },
            }
            },
        },
    },
};
ArmOperation<ContainerAppResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, containerAppName, data);
ContainerAppResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ContainerAppData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapptcp",
  "name": "testcontainerapptcp",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "properties": {
    "provisioningState": "Succeeded",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "latestRevisionFqdn": "testcontainerapptcp-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "latestReadyRevisionName": "testcontainerapptcp-pjxhsye",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerapptcp.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "exposedPort": 4000,
        "transport": "tcp",
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerapptcp-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerapptcp-ab4321"
          }
        ]
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapptcp:v4",
          "name": "testcontainerapptcp",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "probes": [
            {
              "type": "Liveness",
              "tcpSocket": {
                "port": 8080
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "tcpscalingrule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "50"
              }
            }
          }
        ]
      }
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapptcp",
  "name": "testcontainerapptcp",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "properties": {
    "provisioningState": "InProgress",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "latestRevisionFqdn": "testcontainerapptcp-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerapptcp.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "exposedPort": 4000,
        "transport": "tcp",
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerapptcp-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerapptcp-ab4321"
          }
        ]
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapptcp:v4",
          "name": "testcontainerapptcp",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "probes": [
            {
              "type": "Liveness",
              "tcpSocket": {
                "port": 8080
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "tcpscalingrule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "50"
              }
            }
          }
        ]
      }
    }
  }
}

Definitions

Name	Description
action	Allow or Deny rules to determine for incoming IP. Note: Rules can only consist of ALL Allow or ALL Deny
ActiveRevisionsMode	ActiveRevisionsMode controls how active revisions are handled for the Container app: Multiple: multiple revisions can be active.Single: Only one revision can be active at a time. Revision weights can not be used in this mode. If no value if provided, this is the default.
affinity	Sticky Session Affinity
appProtocol	Tells Dapr which protocol your application is using. Valid options are http and grpc. Default is http
bindingType	Custom Domain binding type.
Configuration	Non versioned Container App configuration properties that define the mutable settings of a Container app
Container	Container App container definition
ContainerApp	Container App.
ContainerAppProbe	Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.
ContainerAppProvisioningState	Provisioning state of the Container App.
ContainerResources	Container App container resource requirements.
CorsPolicy	Cross-Origin-Resource-Sharing policy
createdByType	The type of identity that created the resource.
CustomDomain	Custom Domain of a Container App
CustomScaleRule	Container App container Custom scaling rule.
Dapr	Container App Dapr configuration.
DefaultErrorResponse	App Service error response.
Details	Details or the error
EnvironmentVar	Container App container environment variable.
Error	Error model.
ExtendedLocation	The complex type of the extended location.
ExtendedLocationTypes	The type of the extended location.
HttpGet	HTTPGet specifies the http request to perform.
HttpHeaders	Custom headers to set in the request. HTTP allows repeated headers.
HttpScaleRule	Container App container Http scaling rule.
Ingress	Container App Ingress configuration.
IngressClientCertificateMode	Client certificate mode for mTLS authentication. Ignore indicates server drops client certificate on forwarding. Accept indicates server forwards client certificate but does not require a client certificate. Require indicates server requires a client certificate.
IngressPortMapping	Port mappings of container app ingress
IngressTransportMethod	Ingress transport protocol
InitContainer	Container App init container definition
IpSecurityRestrictionRule	Rule to restrict incoming IP address.
logLevel	Sets the log level for the Dapr sidecar. Allowed values are debug, info, warn, error. Default is info.
ManagedServiceIdentity	Managed service identity (system assigned and/or user assigned identities)
ManagedServiceIdentityType	Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
QueueScaleRule	Container App container Azure Queue based scaling rule.
RegistryCredentials	Container App Private Registry
Scale	Container App scaling configurations.
ScaleRule	Container App container scaling rule.
ScaleRuleAuth	Auth Secrets for Scale Rule
Scheme	Scheme to use for connecting to the host. Defaults to HTTP.
Secret	Secret definition.
SecretVolumeItem	Secret to be added to volume.
Service	Container App to be a dev service
ServiceBind	Configuration to bind a ContainerApp to a dev ContainerApp Service
StickySessions	Sticky Sessions for Single Revision Mode
StorageType	Storage type for the volume. If not provided, use EmptyDir.
systemData	Metadata pertaining to creation and last modification of the resource.
TcpScaleRule	Container App container Tcp scaling rule.
TcpSocket	TCPSocket specifies an action involving a TCP port. TCP hooks not yet supported.
Template	Container App versioned application definition. Defines the desired state of an immutable revision. Any changes to this section Will result in a new revision being created
TrafficWeight	Traffic weight assigned to a revision
Type	The type of probe.
UserAssignedIdentity	User assigned identity properties
Volume	Volume definitions for the Container App.
VolumeMount	Volume mount for the Container App.

action

Allow or Deny rules to determine for incoming IP. Note: Rules can only consist of ALL Allow or ALL Deny

Name	Type	Description
Allow	string
Deny	string

ActiveRevisionsMode

ActiveRevisionsMode controls how active revisions are handled for the Container app: Multiple: multiple revisions can be active.Single: Only one revision can be active at a time. Revision weights can not be used in this mode. If no value if provided, this is the default.

Name	Type	Description
Multiple	string
Single	string

affinity

Sticky Session Affinity

Name	Type	Description
none	string
sticky	string

appProtocol

Tells Dapr which protocol your application is using. Valid options are http and grpc. Default is http

Name	Type	Description
grpc	string
http	string

bindingType

Custom Domain binding type.

Name	Type	Description
Disabled	string
SniEnabled	string

Configuration

Non versioned Container App configuration properties that define the mutable settings of a Container app

Name	Type	Default value	Description
activeRevisionsMode	ActiveRevisionsMode	Single	ActiveRevisionsMode controls how active revisions are handled for the Container app: Multiple: multiple revisions can be active.Single: Only one revision can be active at a time. Revision weights can not be used in this mode. If no value if provided, this is the default.
dapr	Dapr		Dapr configuration for the Container App.
ingress	Ingress		Ingress configurations.
maxInactiveRevisions	integer		Optional. Max inactive revisions a Container App can have.
registries	RegistryCredentials[]		Collection of private container registry credentials for containers used by the Container app
secrets	Secret[]		Collection of secrets used by a Container app
service	Service		Container App to be a dev Container App Service

Container

Container App container definition

Name	Type	Description
args	string[]	Container start command arguments.
command	string[]	Container start command.
env	EnvironmentVar[]	Container environment variables.
image	string	Container image tag.
name	string	Custom container name.
probes	ContainerAppProbe[]	List of probes for the container.
resources	ContainerResources	Container resource requirements.
volumeMounts	VolumeMount[]	Container volume mounts.

ContainerApp

Container App.

Name	Type	Description
extendedLocation	ExtendedLocation	The complex type of the extended location.
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	managed identities for the Container App to interact with other Azure services without maintaining any secrets or credentials in code.
location	string	The geo-location where the resource lives
managedBy	string	The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource.
name	string	The name of the resource
properties.configuration	Configuration	Non versioned Container App configuration properties.
properties.customDomainVerificationId	string	Id used to verify domain name ownership
properties.environmentId	string	Resource ID of environment.
properties.eventStreamEndpoint	string	The endpoint of the eventstream of the container app.
properties.latestReadyRevisionName	string	Name of the latest ready revision of the Container App.
properties.latestRevisionFqdn	string	Fully Qualified Domain Name of the latest revision of the Container App.
properties.latestRevisionName	string	Name of the latest revision of the Container App.
properties.managedEnvironmentId	string	Deprecated. Resource ID of the Container App's environment.
properties.outboundIpAddresses	string[]	Outbound IP Addresses for container app.
properties.provisioningState	ContainerAppProvisioningState	Provisioning state of the Container App.
properties.template	Template	Container App versioned application definition.
properties.workloadProfileName	string	Workload profile name to pin for container app execution.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	Resource tags.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

ContainerAppProbe

Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.

Name	Type	Description
failureThreshold	integer	Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1. Maximum value is 10.
httpGet	HttpGet	HTTPGet specifies the http request to perform.
initialDelaySeconds	integer	Number of seconds after the container has started before liveness probes are initiated. Minimum value is 1. Maximum value is 60.
periodSeconds	integer	How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Maximum value is 240.
successThreshold	integer	Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1. Maximum value is 10.
tcpSocket	TcpSocket	TCPSocket specifies an action involving a TCP port. TCP hooks not yet supported.
terminationGracePeriodSeconds	integer	Optional duration in seconds the pod needs to terminate gracefully upon probe failure. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. If this value is nil, the pod's terminationGracePeriodSeconds will be used. Otherwise, this value overrides the value provided by the pod spec. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). This is an alpha field and requires enabling ProbeTerminationGracePeriod feature gate. Maximum value is 3600 seconds (1 hour)
timeoutSeconds	integer	Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Maximum value is 240.
type	Type	The type of probe.

ContainerAppProvisioningState

Provisioning state of the Container App.

Name	Type	Description
Canceled	string
Deleting	string
Failed	string
InProgress	string
Succeeded	string

ContainerResources

Container App container resource requirements.

Name	Type	Description
cpu	number	Required CPU in cores, e.g. 0.5
ephemeralStorage	string	Ephemeral Storage, e.g. "1Gi"
memory	string	Required memory, e.g. "250Mb"

CorsPolicy

Cross-Origin-Resource-Sharing policy

Name	Type	Description
allowCredentials	boolean	Specifies whether the resource allows credentials
allowedHeaders	string[]	Specifies the content for the access-control-allow-headers header
allowedMethods	string[]	Specifies the content for the access-control-allow-methods header
allowedOrigins	string[]	Specifies the content for the access-control-allow-origins header
exposeHeaders	string[]	Specifies the content for the access-control-expose-headers header
maxAge	integer	Specifies the content for the access-control-max-age header

createdByType

The type of identity that created the resource.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CustomDomain

Custom Domain of a Container App

Name	Type	Description
bindingType	bindingType	Custom Domain binding type.
certificateId	string	Resource Id of the Certificate to be bound to this hostname. Must exist in the Managed Environment.
name	string	Hostname.

CustomScaleRule

Container App container Custom scaling rule.

Name	Type	Description
auth	ScaleRuleAuth[]	Authentication secrets for the custom scale rule.
metadata	object	Metadata properties to describe custom scale rule.
type	string	Type of the custom scale rule eg: azure-servicebus, redis etc.

Dapr

Container App Dapr configuration.

Name	Type	Default value	Description
appId	string		Dapr application identifier
appPort	integer		Tells Dapr which port your application is listening on
appProtocol	appProtocol	http	Tells Dapr which protocol your application is using. Valid options are http and grpc. Default is http
enableApiLogging	boolean		Enables API logging for the Dapr sidecar
enabled	boolean	False	Boolean indicating if the Dapr side car is enabled
httpMaxRequestSize	integer		Increasing max size of request body http and grpc servers parameter in MB to handle uploading of big files. Default is 4 MB.
httpReadBufferSize	integer		Dapr max size of http header read buffer in KB to handle when sending multi-KB headers. Default is 65KB.
logLevel	logLevel		Sets the log level for the Dapr sidecar. Allowed values are debug, info, warn, error. Default is info.

DefaultErrorResponse

App Service error response.

Name	Type	Description
error	Error	Error model.

Details

Details or the error

Name	Type	Description
code	string	Standardized string to programmatically identify the error.
message	string	Detailed error description and debugging information.
target	string	Detailed error description and debugging information.

EnvironmentVar

Container App container environment variable.

Name	Type	Description
name	string	Environment variable name.
secretRef	string	Name of the Container App secret from which to pull the environment variable value.
value	string	Non-secret environment variable value.

Error

Error model.

Name	Type	Description
code	string	Standardized string to programmatically identify the error.
details	Details[]	Details or the error
innererror	string	More information to debug error.
message	string	Detailed error description and debugging information.
target	string	Detailed error description and debugging information.

ExtendedLocation

The complex type of the extended location.

Name	Type	Description
name	string	The name of the extended location.
type	ExtendedLocationTypes	The type of the extended location.

ExtendedLocationTypes

The type of the extended location.

Name	Type	Description
CustomLocation	string

HttpGet

HTTPGet specifies the http request to perform.

Name	Type	Description
host	string	Host name to connect to, defaults to the pod IP. You probably want to set "Host" in httpHeaders instead.
httpHeaders	HttpHeaders[]	Custom headers to set in the request. HTTP allows repeated headers.
path	string	Path to access on the HTTP server.
port	integer	Name or number of the port to access on the container. Number must be in the range 1 to 65535. Name must be an IANA_SVC_NAME.
scheme	Scheme	Scheme to use for connecting to the host. Defaults to HTTP.

HttpHeaders

Custom headers to set in the request. HTTP allows repeated headers.

Name	Type	Description
name	string	The header field name
value	string	The header field value

HttpScaleRule

Container App container Http scaling rule.

Name	Type	Description
auth	ScaleRuleAuth[]	Authentication secrets for the custom scale rule.
metadata	object	Metadata properties to describe http scale rule.

Ingress

Container App Ingress configuration.

Name	Type	Default value	Description
additionalPortMappings	IngressPortMapping[]		Settings to expose additional ports on container app
allowInsecure	boolean	False	Bool indicating if HTTP connections to is allowed. If set to false HTTP connections are automatically redirected to HTTPS connections
clientCertificateMode	IngressClientCertificateMode		Client certificate mode for mTLS authentication. Ignore indicates server drops client certificate on forwarding. Accept indicates server forwards client certificate but does not require a client certificate. Require indicates server requires a client certificate.
corsPolicy	CorsPolicy		CORS policy for container app
customDomains	CustomDomain[]		custom domain bindings for Container Apps' hostnames.
exposedPort	integer		Exposed Port in containers for TCP traffic from ingress
external	boolean	False	Bool indicating if app exposes an external http endpoint
fqdn	string		Hostname.
ipSecurityRestrictions	IpSecurityRestrictionRule[]		Rules to restrict incoming IP address.
stickySessions	StickySessions		Sticky Sessions for Single Revision Mode
targetPort	integer		Target Port in containers for traffic from ingress
traffic	TrafficWeight[]		Traffic weights for app's revisions
transport	IngressTransportMethod	auto	Ingress transport protocol

IngressClientCertificateMode

Client certificate mode for mTLS authentication. Ignore indicates server drops client certificate on forwarding. Accept indicates server forwards client certificate but does not require a client certificate. Require indicates server requires a client certificate.

Name	Type	Description
accept	string
ignore	string
require	string

IngressPortMapping

Port mappings of container app ingress

Name	Type	Description
exposedPort	integer	Specifies the exposed port for the target port. If not specified, it defaults to target port
external	boolean	Specifies whether the app port is accessible outside of the environment
targetPort	integer	Specifies the port user's container listens on

IngressTransportMethod

Ingress transport protocol

Name	Type	Description
auto	string
http	string
http2	string
tcp	string

InitContainer

Container App init container definition

Name	Type	Description
args	string[]	Container start command arguments.
command	string[]	Container start command.
env	EnvironmentVar[]	Container environment variables.
image	string	Container image tag.
name	string	Custom container name.
resources	ContainerResources	Container resource requirements.
volumeMounts	VolumeMount[]	Container volume mounts.

IpSecurityRestrictionRule

Rule to restrict incoming IP address.

Name	Type	Description
action	action	Allow or Deny rules to determine for incoming IP. Note: Rules can only consist of ALL Allow or ALL Deny
description	string	Describe the IP restriction rule that is being sent to the container-app. This is an optional field.
ipAddressRange	string	CIDR notation to match incoming IP address
name	string	Name for the IP restriction rule.

logLevel

Sets the log level for the Dapr sidecar. Allowed values are debug, info, warn, error. Default is info.

Name	Type	Description
debug	string
error	string
info	string
warn	string

ManagedServiceIdentity

Managed service identity (system assigned and/or user assigned identities)

Name	Type	Description
principalId	string	The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
tenantId	string	The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
type	ManagedServiceIdentityType	Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.

ManagedServiceIdentityType

Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).

Name	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

QueueScaleRule

Container App container Azure Queue based scaling rule.

Name	Type	Description
auth	ScaleRuleAuth[]	Authentication secrets for the queue scale rule.
queueLength	integer	Queue length.
queueName	string	Queue name.

RegistryCredentials

Container App Private Registry

Name	Type	Description
identity	string	A Managed Identity to use to authenticate with Azure Container Registry. For user-assigned identities, use the full user-assigned identity Resource ID. For system-assigned identities, use 'system'
passwordSecretRef	string	The name of the Secret that contains the registry login password
server	string	Container Registry Server
username	string	Container Registry Username

Scale

Container App scaling configurations.

Name	Type	Default value	Description
maxReplicas	integer	10	Optional. Maximum number of container replicas. Defaults to 10 if not set.
minReplicas	integer		Optional. Minimum number of container replicas.
rules	ScaleRule[]		Scaling rules.

ScaleRule

Container App container scaling rule.

Name	Type	Description
azureQueue	QueueScaleRule	Azure Queue based scaling.
custom	CustomScaleRule	Custom scale rule.
http	HttpScaleRule	HTTP requests based scaling.
name	string	Scale Rule Name
tcp	TcpScaleRule	Tcp requests based scaling.

ScaleRuleAuth

Auth Secrets for Scale Rule

Name	Type	Description
secretRef	string	Name of the secret from which to pull the auth params.
triggerParameter	string	Trigger Parameter that uses the secret

Scheme

Scheme to use for connecting to the host. Defaults to HTTP.

Name	Type	Description
HTTP	string
HTTPS	string

Secret

Secret definition.

Name	Type	Description
identity	string	Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity.
keyVaultUrl	string	Azure Key Vault URL pointing to the secret referenced by the container app.
name	string	Secret Name.
value	string	Secret Value.

SecretVolumeItem

Secret to be added to volume.

Name	Type	Description
path	string	Path to project secret to. If no path is provided, path defaults to name of secret listed in secretRef.
secretRef	string	Name of the Container App secret from which to pull the secret value.

Service

Container App to be a dev service

Name	Type	Description
type	string	Dev ContainerApp service type

ServiceBind

Configuration to bind a ContainerApp to a dev ContainerApp Service

Name	Type	Description
name	string	Name of the service bind
serviceId	string	Resource id of the target service

StickySessions

Sticky Sessions for Single Revision Mode

Name	Type	Description
affinity	affinity	Sticky Session Affinity

StorageType

Storage type for the volume. If not provided, use EmptyDir.

Name	Type	Description
AzureFile	string
EmptyDir	string
Secret	string

systemData

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

TcpScaleRule

Container App container Tcp scaling rule.

Name	Type	Description
auth	ScaleRuleAuth[]	Authentication secrets for the tcp scale rule.
metadata	object	Metadata properties to describe tcp scale rule.

TcpSocket

TCPSocket specifies an action involving a TCP port. TCP hooks not yet supported.

Name	Type	Description
host	string	Optional: Host name to connect to, defaults to the pod IP.
port	integer	Number or name of the port to access on the container. Number must be in the range 1 to 65535. Name must be an IANA_SVC_NAME.

Template

Container App versioned application definition. Defines the desired state of an immutable revision. Any changes to this section Will result in a new revision being created

Name	Type	Description
containers	Container[]	List of container definitions for the Container App.
initContainers	InitContainer[]	List of specialized containers that run before app containers.
revisionSuffix	string	User friendly suffix that is appended to the revision name
scale	Scale	Scaling properties for the Container App.
serviceBinds	ServiceBind[]	List of container app services bound to the app
terminationGracePeriodSeconds	integer	Optional duration in seconds the Container App Instance needs to terminate gracefully. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. Set this value longer than the expected cleanup time for your process. Defaults to 30 seconds.
volumes	Volume[]	List of volume definitions for the Container App.

TrafficWeight

Traffic weight assigned to a revision

Name	Type	Default value	Description
label	string		Associates a traffic label with a revision
latestRevision	boolean	False	Indicates that the traffic weight belongs to a latest stable revision
revisionName	string		Name of a revision
weight	integer		Traffic weight assigned to a revision

Type

The type of probe.

Name	Type	Description
Liveness	string
Readiness	string
Startup	string

UserAssignedIdentity

User assigned identity properties

Name	Type	Description
clientId	string	The client ID of the assigned identity.
principalId	string	The principal ID of the assigned identity.

Volume

Volume definitions for the Container App.

Name	Type	Description
mountOptions	string	Mount options used while mounting the AzureFile. Must be a comma-separated string.
name	string	Volume name.
secrets	SecretVolumeItem[]	List of secrets to be added in volume. If no secrets are provided, all secrets in collection will be added to volume.
storageName	string	Name of storage resource. No need to provide for EmptyDir and Secret.
storageType	StorageType	Storage type for the volume. If not provided, use EmptyDir.

VolumeMount

Volume mount for the Container App.

Name	Type	Description
mountPath	string	Path within the container at which the volume should be mounted.Must not contain ':'.
subPath	string	Path within the volume from which the container's volume should be mounted. Defaults to "" (volume's root).
volumeName	string	This must match the Name of a Volume.

Share via

Container Apps - Create Or Update

URI Parameters

Request Body

Responses

Security

azure_auth

Scopes

Examples

Create or Update Container App

Sample request

Sample response

Create or Update ManagedBy App

Sample request

Sample response

Create or Update Tcp App

Sample request

Sample response

Definitions

action

ActiveRevisionsMode

affinity

appProtocol

bindingType

Configuration

Container

ContainerApp

ContainerAppProbe

ContainerAppProvisioningState

ContainerResources

CorsPolicy

createdByType

CustomDomain

CustomScaleRule

Dapr

DefaultErrorResponse

Details

EnvironmentVar

Error

ExtendedLocation

ExtendedLocationTypes

HttpGet

HttpHeaders

HttpScaleRule

Ingress

IngressClientCertificateMode

IngressPortMapping

IngressTransportMethod

InitContainer

IpSecurityRestrictionRule

logLevel

ManagedServiceIdentity

ManagedServiceIdentityType

QueueScaleRule

RegistryCredentials

Scale

ScaleRule

ScaleRuleAuth

Scheme

Secret

SecretVolumeItem

Service

ServiceBind

StickySessions

StorageType

systemData

TcpScaleRule

TcpSocket

Template

TrafficWeight

Type

UserAssignedIdentity

Volume

VolumeMount

Additional resources