Container Apps - Update

服務:

Azure Container Apps

API 版本:

2024-03-01

更新容器應用程式的屬性
使用 JSON 合併修補程式修補來修補容器應用程式

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

URI 參數

名稱	位於	必要	類型	Description
containerAppName	path	True	string	容器應用程式的名稱。
resourceGroupName	path	True	string	資源群組的名稱。 名稱不區分大小寫。
subscriptionId	path	True	string	目標訂用帳戶的標識碼。
api-version	query	True	string	用於此作業的 API 版本。

要求本文

名稱	必要	類型	Description
location	True	string	資源所在的地理位置
extendedLocation		ExtendedLocation	擴充位置的複雜類型。
identity		ManagedServiceIdentity	容器應用程式的受控識別可與其他 Azure 服務互動，而不需維護程式代碼中的任何秘密或認證。
managedBy		string	管理此資源之資源的完整資源標識碼。 指出此資源是否由另一個 Azure 資源管理。 如果存在，如果從範本中移除，則完整模式部署將不會刪除資源，因為該資源是由另一個資源所管理。
properties.configuration		Configuration	非已建立版本的容器應用程式組態屬性。
properties.environmentId		string	環境的資源標識碼。
properties.managedEnvironmentId		string	已取代。 容器應用程式環境的資源標識碼。
properties.template		Template	容器應用程式已建立版本的應用程式定義。
properties.workloadProfileName		string	要釘選以進行容器應用程式執行的工作負載配置檔名稱。
tags		object	資源標籤。

回應

名稱	類型	Description
200 OK	ContainerApp	確定
202 Accepted		修補作業正在進行中。 標題 Location: string
Other Status Codes	DefaultErrorResponse	常見的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Patch Container App

範例要求

HTTP

PATCH 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",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "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"
        }
      },
      "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"
          }
        }
      ],
      "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/service",
          "name": "service"
        }
      ]
    }
  }
}

Java

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.ContainerApp;
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.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.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 Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_Patch.json
     */
    /**
     * Sample code: Patch Container App.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void patchContainerApp(com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        ContainerApp resource = manager.containerApps()
            .getByResourceGroupWithResponse("rg", "testcontainerapp0", com.azure.core.util.Context.NONE).getValue();
        resource
            .update().withTags(
                mapOf("tag1", "value1", "tag2", "value2"))
            .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)))
                .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")
                            .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/service")
                        .withName("service"))))
            .apply();
    }

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

Python

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_patch.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_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": {
                        "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"},
                },
                "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": [
                        {
                            "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": "service",
                            "serviceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/service",
                        }
                    ],
                },
            },
            "tags": {"tag1": "value1", "tag2": "value2"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_Patch.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

Go

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_Patch.json
func ExampleContainerAppsClient_BeginUpdate() {
	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().BeginUpdate(ctx, "rg", "testcontainerapp0", armappcontainers.ContainerApp{
		Location: to.Ptr("East US"),
		Tags: map[string]*string{
			"tag1": to.Ptr("value1"),
			"tag2": to.Ptr("value2"),
		},
		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{
					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"),
				},
			},
			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"),
						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("service"),
						ServiceID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/service"),
					}},
			},
		},
	}, 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),
	// 				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{
	// 				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"),
	// 				}},
	// 				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),
	// 			},
	// 			MaxInactiveRevisions: to.Ptr[int32](10),
	// 		},
	// 		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"),
	// 					},
	// 			}},
	// 			InitContainers: []*armappcontainers.InitContainer{
	// 				{
	// 					Name: to.Ptr("testinitcontainerApp0"),
	// 					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

JavaScript

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

/**
 * This sample demonstrates how to Patches a Container App using JSON Merge Patch
 *
 * @summary Patches a Container App using JSON Merge Patch
 * x-ms-original-file: specification/app/resource-manager/Microsoft.App/stable/2024-03-01/examples/ContainerApps_Patch.json
 */
async function patchContainerApp() {
  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: {
        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" },
    },
    location: "East US",
    tags: { tag1: "value1", tag2: "value2" },
    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",
          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: "service",
          serviceId:
            "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/service",
        },
      ],
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerApps.beginUpdateAndWait(
    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

dotnet

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_Patch.json
// this example is just showing the usage of "ContainerApps_Update" 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 ContainerAppResource created on azure
// for more information of creating ContainerAppResource, please refer to the document of ContainerAppResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "rg";
string containerAppName = "testcontainerapp0";
ResourceIdentifier containerAppResourceId = ContainerAppResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, containerAppName);
ContainerAppResource containerApp = client.GetContainerAppResource(containerAppResourceId);

// invoke the operation
ContainerAppData data = new ContainerAppData(new AzureLocation("East US"))
{
    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,
        },
        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",
        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/service"),
        Name = "service",
        }
        },
    },
    Tags =
    {
    ["tag1"] = "value1",
    ["tag2"] = "value2",
    },
};
ArmOperation<ContainerAppResource> lro = await containerApp.UpdateAsync(WaitUntil.Completed, 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

範例回覆

狀態碼:

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"
          }
        ]
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30,
        "httpMaxRequestSize": 10,
        "logLevel": "debug",
        "enableApiLogging": true
      },
      "maxInactiveRevisions": 10
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testcontainerapp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "http": {
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      }
    },
    "eventStreamEndpoint": "testEndpoint"
  }
}

狀態碼:

202

azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.App/locations/eastus/containerappOperationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-03-01

定義

名稱	Description
action	允許或拒絕規則來判斷傳入IP。 注意：規則只能包含 ALL 允許或 ALL 拒絕
ActiveRevisionsMode	ActiveRevisionsMode 控制容器應用程式的作用中修訂處理方式：多個修訂可以作用中。單一：一次只能有一個修訂作用中。 修訂權數不能在此模式中使用。 如果未提供任何值，則為預設值。
affinity	黏性會話親和性
appProtocol	告知 Dapr 您的應用程式正在使用的通訊協定。 有效的選項為 HTTP 和 grpc。 預設值為 HTTP
bindingType	Custom Domain 系結類型。
Configuration	未設定版本的容器應用程式組態屬性，可定義容器應用程式的可變動設定
Container	容器應用程式容器定義
ContainerApp	容器應用程式。
ContainerAppProbe	探查描述要針對容器執行的健全狀況檢查，以判斷它是否運作或準備好接收流量。
ContainerAppProvisioningState	容器應用程式的布建狀態。
ContainerResources	容器應用程式容器資源需求。
CorsPolicy	跨原始來源資源分享原則
createdByType	建立資源的身分識別類型。
CustomDomain	容器應用程式的 Custom Domain
CustomScaleRule	容器應用程式容器 自定義調整規則。
Dapr	容器應用程式 Dapr 設定。
DefaultErrorResponse	App Service 錯誤回應。
Details	詳細數據或錯誤
EnvironmentVar	容器應用程式容器環境變數。
Error	錯誤模型。
ExtendedLocation	擴充位置的複雜類型。
ExtendedLocationTypes	擴充位置的類型。
HttpGet	HTTPGet 會指定要執行的 HTTP 要求。
HttpHeaders	在要求中設定的自定義標頭。 HTTP 允許重複的標頭。
HttpScaleRule	容器應用程式容器 Http 調整規則。
Ingress	容器應用程式輸入組態。
IngressClientCertificateMode	mTLS 驗證的客戶端憑證模式。 Ignore 表示伺服器在轉送時卸除客戶端憑證。 Accept 表示伺服器轉送客戶端憑證，但不需要客戶端憑證。 需要表示伺服器需要客戶端憑證。
IngressPortMapping	容器應用程式輸入的埠對應
IngressTransportMethod	輸入傳輸通訊協定
InitContainer	容器應用程式init容器定義
IpSecurityRestrictionRule	限制傳入IP位址的規則。
logLevel	設定 Dapr sidecar 的記錄層級。 允許的值是偵錯、資訊、警告、錯誤。 預設值為資訊。
ManagedServiceIdentity	受控服務識別 (系統指派和/或使用者指派的身分識別)
ManagedServiceIdentityType	(允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。
QueueScaleRule	容器應用程式容器 Azure 佇列型調整規則。
RegistryCredentials	容器應用程式私人登錄
Scale	容器應用程式調整設定。
ScaleRule	容器應用程式容器調整規則。
ScaleRuleAuth	調整規則的驗證秘密
Scheme	用於連線到主機的配置。 默認為 HTTP。
Secret	秘密定義。
SecretVolumeItem	要新增至磁碟區的秘密。
Service	容器應用程式成為開發人員服務
ServiceBind	將 ContainerApp 系結至 dev ContainerApp Service 的組態
StickySessions	單一修訂模式的黏性會話
StorageType	磁碟區的儲存類型。 如果未提供，請使用 EmptyDir。
systemData	與建立和上次修改資源相關的元數據。
TcpScaleRule	容器應用程式容器 Tcp 調整規則。
TcpSocket	TCPSocket 會指定涉及 TCP 連接埠的動作。 尚不支援 TCP 勾點。
Template	容器應用程式已建立版本的應用程式定義。 定義不可變修訂的預期狀態。 本節的任何變更將會導致建立新的修訂
TrafficWeight	指派給修訂的流量權數
Type	探查的類型。
UserAssignedIdentity	使用者指派的身分識別屬性
Volume	容器應用程式的磁碟區定義。
VolumeMount	容器應用程式的磁碟區掛接。

action

允許或拒絕規則來判斷傳入IP。 注意：規則只能包含 ALL 允許或 ALL 拒絕

名稱	類型	Description
Allow	string
Deny	string

ActiveRevisionsMode

ActiveRevisionsMode 控制容器應用程式的作用中修訂處理方式：多個修訂可以作用中。單一：一次只能有一個修訂作用中。 修訂權數不能在此模式中使用。 如果未提供任何值，則為預設值。

名稱	類型	Description
Multiple	string
Single	string

affinity

黏性會話親和性

名稱	類型	Description
none	string
sticky	string

appProtocol

告知 Dapr 您的應用程式正在使用的通訊協定。 有效的選項為 HTTP 和 grpc。 預設值為 HTTP

名稱	類型	Description
grpc	string
http	string

bindingType

Custom Domain 系結類型。

名稱	類型	Description
Disabled	string
SniEnabled	string

Configuration

未設定版本的容器應用程式組態屬性，可定義容器應用程式的可變動設定

名稱	類型	預設值	Description
activeRevisionsMode	ActiveRevisionsMode	Single	ActiveRevisionsMode 控制容器應用程式的作用中修訂處理方式：多個修訂可以作用中。單一：一次只能有一個修訂作用中。 修訂權數不能在此模式中使用。 如果未提供任何值，則為預設值。
dapr	Dapr		容器應用程式的 Dapr 設定。
ingress	Ingress		輸入組態。
maxInactiveRevisions	integer		選擇性。 容器應用程式可以擁有的最大非使用中修訂。
registries	RegistryCredentials[]		容器應用程式所使用的容器的私人容器登錄認證集合
secrets	Secret[]		容器應用程式所使用的秘密集合
service	Service		容器應用程式成為開發容器 App Service

Container

容器應用程式容器定義

名稱	類型	Description
args	string[]	容器啟動命令自變數。
command	string[]	容器啟動命令。
env	EnvironmentVar[]	容器環境變數。
image	string	容器映像標籤。
name	string	自訂容器名稱。
probes	ContainerAppProbe[]	容器的探查清單。
resources	ContainerResources	容器資源需求。
volumeMounts	VolumeMount[]	容器磁碟區掛接。

ContainerApp

容器應用程式。

名稱	類型	Description
extendedLocation	ExtendedLocation	擴充位置的複雜類型。
id	string	資源的完整資源識別碼。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	容器應用程式的受控識別可與其他 Azure 服務互動，而不需在程式碼中維護任何秘密或認證。
location	string	資源所在的地理位置
managedBy	string	管理此資源之資源的完整資源標識碼。 指出此資源是否由另一個 Azure 資源管理。 如果存在，如果從範本中移除，則完整模式部署將不會刪除該資源，因為該資源是由另一個資源管理。
name	string	資源的名稱
properties.configuration	Configuration	非版本設定的容器應用程式組態屬性。
properties.customDomainVerificationId	string	用來驗證功能變數名稱擁有權的標識碼
properties.environmentId	string	環境的資源標識碼。
properties.eventStreamEndpoint	string	容器應用程式之 eventstream 的端點。
properties.latestReadyRevisionName	string	容器應用程式的最新就緒修訂名稱。
properties.latestRevisionFqdn	string	容器應用程式最新修訂的完整功能變數名稱。
properties.latestRevisionName	string	容器應用程式的最新修訂名稱。
properties.managedEnvironmentId	string	已取代。 容器應用程式環境的資源標識碼。
properties.outboundIpAddresses	string[]	容器應用程式的輸出IP位址。
properties.provisioningState	ContainerAppProvisioningState	容器應用程式的布建狀態。
properties.template	Template	容器應用程式已建立版本的應用程式定義。
properties.workloadProfileName	string	要釘選以進行容器應用程式執行的工作負載配置檔名稱。
systemData	systemData	Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。
tags	object	資源標籤。
type	string	資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

ContainerAppProbe

探查描述要針對容器執行的健全狀況檢查，以判斷它是否運作或準備好接收流量。

名稱	類型	Description
failureThreshold	integer	探查在成功之後視為失敗的最小連續失敗。 預設值為 3。 最小值為 1。 最大值為 10。
httpGet	HttpGet	HTTPGet 會指定要執行的 HTTP 要求。
initialDelaySeconds	integer	在起始活躍度探查之前，容器啟動後的秒數。 最小值為 1。 最大值為 60。
periodSeconds	integer	執行探查的頻率 (以秒為單位)。 預設值為 10 秒。 最小值為 1。 最大值為 240。
successThreshold	integer	探查在失敗后視為成功的最小連續成功。 預設值為 1。 必須是 1，才能進行實時和啟動。 最小值為 1。 最大值為 10。
tcpSocket	TcpSocket	TCPSocket 會指定涉及 TCP 連接埠的動作。 尚不支援 TCP 勾點。
terminationGracePeriodSeconds	integer	Pod 必須在探查失敗時正常終止，以秒為單位的選擇性持續時間。 寬限期是在 Pod 中執行的進程傳送終止訊號後，以秒為單位的持續時間，以及當進程強制終止並出現終止訊號的時間。 將此值設為超過程序的預期清除時間。 如果此值為 nil，將會使用 Pod 的終止GracePeriodSeconds。 否則，此值會覆寫Pod規格所提供的值。值必須是非負整數。 零值表示透過終止訊號立即停止， (沒有機會關閉) 。 這是Alpha字段，需要啟用 ProbeTerminationGracePeriod 功能閘道。 最大值為3600秒 (1小時)
timeoutSeconds	integer	探查逾時後的秒數。預設值為 1 秒。 最小值為 1。 最大值為 240。
type	Type	探查的類型。

ContainerAppProvisioningState

容器應用程式的布建狀態。

名稱	類型	Description
Canceled	string
Deleting	string
Failed	string
InProgress	string
Succeeded	string

ContainerResources

容器應用程式容器資源需求。

名稱	類型	Description
cpu	number	核心中必要的 CPU，例如 0.5
ephemeralStorage	string	暫時記憶體，例如 “1Gi”
memory	string	必要的記憶體，例如 “250Mb”

CorsPolicy

跨原始來源資源分享原則

名稱	類型	Description
allowCredentials	boolean	指定資源是否允許認證
allowedHeaders	string[]	指定訪問控制-allow-headers 標頭的內容
allowedMethods	string[]	指定 access-control-allow-methods 標頭的內容
allowedOrigins	string[]	指定訪問控制允許來源標頭的內容
exposeHeaders	string[]	指定 access-control-public-headers 標頭的內容
maxAge	integer	指定 access-control-max-age 標頭的內容

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CustomDomain

容器應用程式的 Custom Domain

名稱	類型	Description
bindingType	bindingType	Custom Domain 系結類型。
certificateId	string	要系結至此主機名之憑證的資源標識符。 必須存在於受控環境中。
name	string	主機名稱。

CustomScaleRule

容器應用程式容器 自定義調整規則。

名稱	類型	Description
auth	ScaleRuleAuth[]	自訂調整規則的驗證秘密。
metadata	object	描述自定義縮放規則的元數據屬性。
type	string	自定義調整規則的類型，例如：azure-servicebus、redis 等。

Dapr

容器應用程式 Dapr 設定。

名稱	類型	預設值	Description
appId	string		Dapr 應用程式識別碼
appPort	integer		告訴 Dapr 您的應用程式正在接聽哪個埠
appProtocol	appProtocol	http	告知 Dapr 您的應用程式正在使用的通訊協定。 有效的選項為 HTTP 和 grpc。 預設值為 HTTP
enableApiLogging	boolean		啟用 Dapr sidecar 的 API 記錄
enabled	boolean	False	布爾值，指出是否已啟用 Dapr 側車
httpMaxRequestSize	integer		增加 MB 中要求本文 HTTP 和 grpc 伺服器參數的大小上限，以處理大型檔案的上傳。 預設值為 4 MB。
httpReadBufferSize	integer		傳送多 KB 標頭時，在 KB 中要處理的 HTTP 標頭讀取緩衝區大小上限。 預設值為 65KB。
logLevel	logLevel		設定 Dapr sidecar 的記錄層級。 允許的值是偵錯、資訊、警告、錯誤。 預設值為資訊。

DefaultErrorResponse

App Service 錯誤回應。

名稱	類型	Description
error	Error	錯誤模型。

Details

詳細數據或錯誤

名稱	類型	Description
code	string	標準化字串，以程序設計方式識別錯誤。
message	string	詳細的錯誤描述和偵錯資訊。
target	string	詳細的錯誤描述和偵錯資訊。

EnvironmentVar

容器應用程式容器環境變數。

名稱	類型	Description
name	string	環境變數名稱。
secretRef	string	要從中提取環境變數值的容器應用程式秘密名稱。
value	string	非秘密環境變數值。

Error

錯誤模型。

名稱	類型	Description
code	string	標準化字串，以程序設計方式識別錯誤。
details	Details[]	詳細數據或錯誤
innererror	string	偵錯錯誤的詳細資訊。
message	string	詳細的錯誤描述和偵錯資訊。
target	string	詳細的錯誤描述和偵錯資訊。

ExtendedLocation

擴充位置的複雜類型。

名稱	類型	Description
name	string	擴充位置的名稱。
type	ExtendedLocationTypes	擴充位置的類型。

ExtendedLocationTypes

擴充位置的類型。

名稱	類型	Description
CustomLocation	string

HttpGet

HTTPGet 會指定要執行的 HTTP 要求。

名稱	類型	Description
host	string	要連線的主機名，預設為 Pod IP。 您可能想要改為在 HTTPHeaders 中設定「主機」。
httpHeaders	HttpHeaders[]	在要求中設定的自定義標頭。 HTTP 允許重複的標頭。
path	string	HTTP 伺服器上存取的路徑。
port	integer	要存取容器的埠名稱或號碼。 數位的範圍必須介於 1 到 65535 之間。 名稱必須是IANA_SVC_NAME。
scheme	Scheme	用於連線至主機的配置。 默認為 HTTP。

HttpHeaders

在要求中設定的自定義標頭。 HTTP 允許重複的標頭。

名稱	類型	Description
name	string	標頭功能變數名稱
value	string	標頭域值

HttpScaleRule

容器應用程式容器 Http 調整規則。

名稱	類型	Description
auth	ScaleRuleAuth[]	自訂調整規則的驗證秘密。
metadata	object	用來描述 HTTP 縮放規則的元資料屬性。

Ingress

容器應用程式輸入組態。

名稱	類型	預設值	Description
additionalPortMappings	IngressPortMapping[]		在容器應用程式上公開其他埠的設定
allowInsecure	boolean	False	布爾值，指出是否允許 HTTP 連線。 如果設定為 false HTTP 連線，則會自動重新導向至 HTTPS 連線
clientCertificateMode	IngressClientCertificateMode		mTLS 驗證的客戶端憑證模式。 Ignore 表示伺服器在轉送時卸除客戶端憑證。 Accept 表示伺服器轉送客戶端憑證，但不需要客戶端憑證。 需要表示伺服器需要客戶端憑證。
corsPolicy	CorsPolicy		容器應用程式的 CORS 原則
customDomains	CustomDomain[]		Container Apps 主機名的自定義網域系結。
exposedPort	integer		來自輸入之 TCP 流量的容器中公開埠
external	boolean	False	指出應用程式是否公開外部 HTTP 端點的 Bool
fqdn	string		主機名稱。
ipSecurityRestrictions	IpSecurityRestrictionRule[]		限制傳入IP位址的規則。
stickySessions	StickySessions		單一修訂模式的黏性會話
targetPort	integer		來自輸入流量的容器中目標埠
traffic	TrafficWeight[]		應用程式修訂的流量權數
transport	IngressTransportMethod	auto	輸入傳輸通訊協定

IngressClientCertificateMode

mTLS 驗證的客戶端憑證模式。 Ignore 表示伺服器在轉送時卸除客戶端憑證。 Accept 表示伺服器轉送客戶端憑證，但不需要客戶端憑證。 需要表示伺服器需要客戶端憑證。

名稱	類型	Description
accept	string
ignore	string
require	string

IngressPortMapping

容器應用程式輸入的埠對應

名稱	類型	Description
exposedPort	integer	指定目標埠的公開埠。 如果未指定，則預設為目標埠
external	boolean	指定應用程式埠是否可在環境外部存取
targetPort	integer	指定埠使用者的容器接聽

IngressTransportMethod

輸入傳輸通訊協定

名稱	類型	Description
auto	string
http	string
http2	string
tcp	string

InitContainer

容器應用程式init容器定義

名稱	類型	Description
args	string[]	容器啟動命令自變數。
command	string[]	容器啟動命令。
env	EnvironmentVar[]	容器環境變數。
image	string	容器映像標籤。
name	string	自訂容器名稱。
resources	ContainerResources	容器資源需求。
volumeMounts	VolumeMount[]	容器磁碟區掛接。

IpSecurityRestrictionRule

限制傳入IP位址的規則。

名稱	類型	Description
action	action	允許或拒絕規則來判斷傳入IP。 注意：規則只能包含 ALL 允許或 ALL 拒絕
description	string	描述要傳送至 container-app 的IP限制規則。 這是選擇性欄位。
ipAddressRange	string	符合傳入IP位址的CIDR表示法
name	string	IP 限制規則的名稱。

logLevel

設定 Dapr sidecar 的記錄層級。 允許的值是偵錯、資訊、警告、錯誤。 預設值為資訊。

名稱	類型	Description
debug	string
error	string
info	string
warn	string

ManagedServiceIdentity

受控服務識別 (系統指派和/或使用者指派的身分識別)

名稱	類型	Description
principalId	string	系統指派身分識別的服務主體標識碼。 此屬性只會針對系統指派的身分識別提供。
tenantId	string	系統指派身分識別的租用戶標識碼。 此屬性只會針對系統指派的身分識別提供。
type	ManagedServiceIdentityType	(允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。
userAssignedIdentities	<string,  UserAssignedIdentity>	User-Assigned 身分識別 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中 () 的空白物件 {} 。

ManagedServiceIdentityType

(允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。

名稱	類型	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

QueueScaleRule

容器應用程式容器 Azure 佇列型調整規則。

名稱	類型	Description
auth	ScaleRuleAuth[]	佇列調整規則的驗證秘密。
queueLength	integer	佇列長度。
queueName	string	佇列名稱。

RegistryCredentials

容器應用程式私人登錄

名稱	類型	Description
identity	string	用來向 Azure Container Registry 進行驗證的受控識別。 針對使用者指派的身分識別，請使用完整的使用者指派身分識別資源標識碼。 針對系統指派的身分識別，請使用 'system'
passwordSecretRef	string	包含登錄登入密碼的秘密名稱
server	string	Container Registry Server
username	string	Container Registry 用戶名稱

Scale

容器應用程式調整設定。

名稱	類型	預設值	Description
maxReplicas	integer	10	選擇性。 容器復本的數目上限。 如果未設定，則預設為10。
minReplicas	integer		選擇性。 容器復本數目下限。
rules	ScaleRule[]		調整規則。

ScaleRule

容器應用程式容器調整規則。

名稱	類型	Description
azureQueue	QueueScaleRule	以 Azure 隊列為基礎的調整。
custom	CustomScaleRule	自定義縮放規則。
http	HttpScaleRule	HTTP 要求型調整。
name	string	調整規則名稱
tcp	TcpScaleRule	Tcp 要求型調整。

ScaleRuleAuth

調整規則的驗證秘密

名稱	類型	Description
secretRef	string	要從中提取驗證參數的秘密名稱。
triggerParameter	string	使用秘密的觸發程序參數

Scheme

用於連線到主機的配置。 默認為 HTTP。

名稱	類型	Description
HTTP	string
HTTPS	string

Secret

秘密定義。

名稱	類型	Description
identity	string	使用 Azure 金鑰保存庫 驗證的受控識別資源識別碼，或使用系統指派的身分識別。
keyVaultUrl	string	Azure 金鑰保存庫 URL，指向容器應用程式所參考的秘密。
name	string	秘密名稱。
value	string	秘密值。

SecretVolumeItem

要新增至磁碟區的秘密。

名稱	類型	Description
path	string	專案秘密的路徑。 如果未提供路徑，path 預設為 secretRef 中列出的秘密名稱。
secretRef	string	要從中提取秘密值的容器應用程式秘密名稱。

Service

容器應用程式成為開發人員服務

名稱	類型	Description
type	string	Dev ContainerApp 服務類型

ServiceBind

將 ContainerApp 系結至 dev ContainerApp Service 的組態

名稱	類型	Description
name	string	服務系結的名稱
serviceId	string	目標服務的資源標識碼

StickySessions

單一修訂模式的黏性會話

名稱	類型	Description
affinity	affinity	黏性會話親和性

StorageType

磁碟區的儲存類型。 如果未提供，請使用 EmptyDir。

名稱	類型	Description
AzureFile	string
EmptyDir	string
Secret	string

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳 (UTC)
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

TcpScaleRule

容器應用程式容器 Tcp 調整規則。

名稱	類型	Description
auth	ScaleRuleAuth[]	Tcp 調整規則的驗證秘密。
metadata	object	描述 tcp 縮放規則的元數據屬性。

TcpSocket

TCPSocket 會指定涉及 TCP 連接埠的動作。 尚不支援 TCP 勾點。

名稱	類型	Description
host	string	選擇性：要連線的主機名，預設為 Pod IP。
port	integer	要存取容器之埠的數目或名稱。 數位的範圍必須介於 1 到 65535 之間。 名稱必須是IANA_SVC_NAME。

Template

容器應用程式已建立版本的應用程式定義。 定義不可變修訂的預期狀態。 本節的任何變更將會導致建立新的修訂

名稱	類型	Description
containers	Container[]	容器應用程式的容器定義清單。
initContainers	InitContainer[]	在應用程式容器之前執行的特製化容器清單。
revisionSuffix	string	附加至修訂名稱的使用者易記後綴
scale	Scale	調整容器應用程式的屬性。
serviceBinds	ServiceBind[]	系結至應用程式的容器應用程式服務清單
terminationGracePeriodSeconds	integer	容器應用程式實例需要正常終止的秒數選擇性持續時間。 值必須是非負整數。 零值表示透過終止訊號立即停止， (沒有機會關閉) 。 如果此值為 nil，則會改用預設寬限期。 將此值設為超過程序的預期清除時間。 預設為 30 秒。
volumes	Volume[]	容器應用程式的磁碟區定義清單。

TrafficWeight

指派給修訂的流量權數

名稱	類型	預設值	Description
label	string		將流量標籤與修訂產生關聯
latestRevision	boolean	False	指出流量權數屬於最新的穩定修訂
revisionName	string		修訂的名稱
weight	integer		指派給修訂的流量權數

Type

探查的類型。

名稱	類型	Description
Liveness	string
Readiness	string
Startup	string

UserAssignedIdentity

使用者指派的身分識別屬性

名稱	類型	Description
clientId	string	指派之身分識別的用戶端標識碼。
principalId	string	指派之身分識別的主體標識碼。

Volume

容器應用程式的磁碟區定義。

名稱	類型	Description
mountOptions	string	掛接 AzureFile 時所使用的掛接選項。 必須是逗號分隔字串。
name	string	磁碟區名稱。
secrets	SecretVolumeItem[]	要加入磁碟區中的秘密清單。 如果未提供任何秘密，集合中的所有秘密都會新增至磁碟區。
storageName	string	記憶體資源的名稱。 不需要提供 EmptyDir 和 Secret。
storageType	StorageType	磁碟區的儲存類型。 如果未提供，請使用 EmptyDir。

VolumeMount

容器應用程式的磁碟區掛接。

名稱	類型	Description
mountPath	string	容器內應該掛接磁碟區的路徑。不得包含 『：』。
subPath	string	應該從中掛接容器磁碟區之磁碟區內的路徑。 預設為 “” (磁碟區的根) 。
volumeName	string	這必須符合磁碟區的名稱。