Container Apps - Start

Dienst:

Azure Container Apps

API-Version:

2023-08-01-preview

Starten einer Container-App

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}/start?api-version=2023-08-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
containerAppName	path	True	string	Name der Container-App. RegEx-Muster: ^[-\w\._\(\)]+$
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	ContainerApp	Container-App wurde erfolgreich gestartet.
202 Accepted		Der Startvorgang wird ausgeführt. Header Location: string
Other Status Codes	DefaultErrorResponse	Häufige Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Start Container App

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testworkerapp0/start?api-version=2023-08-01-preview

Beispiel für eine Antwort

Statuscode:

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"
  }
}

Statuscode:

202

location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.App/containerApps/testworkerapp0/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2023-08-01-preview

Definitionen

Name	Beschreibung
action	Regeln zulassen oder verweigern, um für eingehende IP-Adressen zu bestimmen. Hinweis: Regeln können nur aus ALL Allow oder ALL Deny bestehen.
ActiveRevisionsMode	ActiveRevisionsMode steuert, wie aktive Revisionen für die Container-App behandelt werden: Mehrere: Mehrere Revisionen können aktiv sein.Single: Es kann jeweils nur eine Revision aktiv sein. Revisionsgewichtungen können in diesem Modus nicht verwendet werden. Wenn kein Wert angegeben wird, ist dies der Standardwert.
affinity	Affinität zu klebrigen Sitzungen
appProtocol	Teilt Dapr mit, welches Protokoll Ihre Anwendung verwendet. Gültige Optionen sind http und grpc. Der Standardwert ist http.
bindingType	Custom Domain Bindungstyp.
Configuration	Konfigurationseigenschaften von Container-Apps ohne Versionsangabe, die die veränderlichen Einstellungen einer Container-App definieren
Container	Container-App-Containerdefinition
ContainerApp	Container-App.
ContainerAppProbe	Der Test beschreibt eine Integritätsprüfung, die für einen Container ausgeführt werden soll, um zu bestimmen, ob er aktiv ist oder bereit ist, Datenverkehr zu empfangen.
ContainerAppProvisioningState	Bereitstellungsstatus der Container-App.
ContainerResources	Container-App-Containerressourcenanforderungen.
CorsPolicy	Richtlinie für die übergreifende Ressourcenfreigabe
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CustomDomain	Custom Domain einer Container-App
CustomScaleRule	Container-App-Container Benutzerdefinierte Skalierungsregel.
Dapr	Container-App-Dapr-Konfiguration.
DefaultErrorResponse	App Service Fehlerantwort.
Details	Details oder fehler
EnvironmentVar	Container-App-Umgebungsvariable.
Error	Fehlermodell.
ExtendedLocation	Der komplexe Typ des erweiterten Standorts.
ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.
HttpGet	HTTPGet gibt die auszuführende HTTP-Anforderung an.
HttpHeaders	Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP lässt wiederholte Header zu.
HttpScaleRule	Http-Skalierungsregel für Container-App-Container.
Ingress	Konfiguration der Eingehenden Container-App.
IngressClientCertificateMode	Clientzertifikatmodus für die mTLS-Authentifizierung. Ignore gibt an, dass der Server das Clientzertifikat bei der Weiterleitung löscht. Accept gibt an, dass der Server das Clientzertifikat weiterleitet, aber kein Clientzertifikat erfordert. Erforderlich gibt an, dass der Server ein Clientzertifikat erfordert.
IngressPortMapping	Portzuordnungen des Eingangs von Container-Apps
IngressTransportMethod	Protokoll für eingehenden Transport
InitContainer	Container-App-Initialisierungscontainerdefinition
IpSecurityRestrictionRule	Regel zum Einschränken eingehender IP-Adressen.
logLevel	Legt die Protokollebene für das Dapr-Seitenwagen fest. Zulässige Werte sind Debug, Info, Warnung, Fehler. Der Standardwert ist Info.
ManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).
QueueScaleRule	Container-App-Container: Azure Queue-basierte Skalierungsregel.
RegistryCredentials	Private Registrierung von Container-Apps
Scale	Konfigurationen für die Container-App-Skalierung.
ScaleRule	Container-App-Containerskalierungsregel.
ScaleRuleAuth	Authentifizierungsgeheimnisse für Skalierungsregel
Scheme	Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Der Standardwert ist HTTP.
Secret	Geheimnisdefinition.
SecretVolumeItem	Geheimnis, das dem Volume hinzugefügt werden soll.
Service	Container-App als Entwicklungsdienst
ServiceBind	Konfiguration zum Binden einer ContainerApp an einen dev ContainerApp Service
StickySessions	Haftsitzungen für den einzelnen Revisionsmodus
StorageType	Speichertyp für das Volume. Wenn nicht angegeben, verwenden Sie EmptyDir.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
TcpScaleRule	Tcp-Skalierungsregel für Container-App-Container.
TcpSocket	TCPSocket gibt eine Aktion an, die einen TCP-Port umfasst. TCP-Hooks werden noch nicht unterstützt.
Template	Anwendungsdefinition der Container-App mit Versionsangabe. Definiert den gewünschten Zustand einer unveränderlichen Revision. Alle Änderungen an diesem Abschnitt führen dazu, dass eine neue Revision erstellt wird.
TrafficWeight	Einer Revision zugewiesene Datenverkehrsgewichtung
Type	Der Typ des Tests.
UserAssignedIdentity	Benutzerseitig zugewiesene Identitätseigenschaften
Volume	Volumedefinitionen für die Container-App.
VolumeMount	Volumebereitstellung für die Container-App.

action

Regeln zulassen oder verweigern, um für eingehende IP-Adressen zu bestimmen. Hinweis: Regeln können nur aus ALL Allow oder ALL Deny bestehen.

Name	Typ	Beschreibung
Allow	string
Deny	string

ActiveRevisionsMode

ActiveRevisionsMode steuert, wie aktive Revisionen für die Container-App behandelt werden: Mehrere: Mehrere Revisionen können aktiv sein.Single: Es kann jeweils nur eine Revision aktiv sein. Revisionsgewichtungen können in diesem Modus nicht verwendet werden. Wenn kein Wert angegeben wird, ist dies der Standardwert.

Name	Typ	Beschreibung
Multiple	string
Single	string

affinity

Affinität zu klebrigen Sitzungen

Name	Typ	Beschreibung
none	string
sticky	string

appProtocol

Teilt Dapr mit, welches Protokoll Ihre Anwendung verwendet. Gültige Optionen sind http und grpc. Der Standardwert ist http.

Name	Typ	Beschreibung
grpc	string
http	string

bindingType

Custom Domain Bindungstyp.

Name	Typ	Beschreibung
Disabled	string
SniEnabled	string

Configuration

Konfigurationseigenschaften von Container-Apps ohne Versionsangabe, die die veränderlichen Einstellungen einer Container-App definieren

Name	Typ	Standardwert	Beschreibung
activeRevisionsMode	ActiveRevisionsMode	Single	ActiveRevisionsMode steuert, wie aktive Revisionen für die Container-App behandelt werden: Mehrere: Mehrere Revisionen können aktiv sein.Single: Es kann jeweils nur eine Revision aktiv sein. Revisionsgewichtungen können in diesem Modus nicht verwendet werden. Wenn kein Wert angegeben wird, ist dies der Standardwert.
dapr	Dapr		Dapr-Konfiguration für die Container-App.
ingress	Ingress		Eingangskonfigurationen.
maxInactiveRevisions	integer		Optional. Max. inaktive Revisionen, die eine Container-App haben kann.
registries	RegistryCredentials[]		Sammlung von Anmeldeinformationen für die private Containerregistrierung für Container, die von der Container-App verwendet werden
secrets	Secret[]		Sammlung von Geheimnissen, die von einer Container-App verwendet werden
service	Service		Container-App als Entwicklungscontainer-App Service

Container

Container-App-Containerdefinition

Name	Typ	Beschreibung
args	string[]	Containerstartbefehlsargumente.
command	string[]	Containerstartbefehl.
env	EnvironmentVar[]	Containerumgebungsvariablen.
image	string	Containerimagetag.
name	string	Benutzerdefinierter Containername.
probes	ContainerAppProbe[]	Liste der Tests für den Container.
resources	ContainerResources	Anforderungen an Containerressourcen.
volumeMounts	VolumeMount[]	Bereitstellungen von Containervolumes.

ContainerApp

Container-App.

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Der komplexe Typ des erweiterten Standorts.
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Verwaltete Identitäten für die Container-App, um mit anderen Azure-Diensten zu interagieren, ohne Geheimnisse oder Anmeldeinformationen im Code beizubehalten.
location	string	Der geografische Standort, an dem sich die Ressource befindet
managedBy	string	Die vollqualifizierte Ressourcen-ID der Ressource, die diese Ressource verwaltet. Gibt an, ob diese Ressource von einer anderen Azure-Ressource verwaltet wird. Wenn dies vorhanden ist, löscht die Bereitstellung im vollständigen Modus die Ressource nicht, wenn sie aus der Vorlage entfernt wird, da sie von einer anderen Ressource verwaltet wird.
name	string	Der Name der Ressource
properties.configuration	Configuration	Konfigurationseigenschaften für Container-Apps ohne Versionsangabe.
properties.customDomainVerificationId	string	Id, die zum Überprüfen des Domänennamenbesitzes verwendet wird
properties.environmentId	string	Ressourcen-ID der Umgebung.
properties.eventStreamEndpoint	string	Der Endpunkt des Eventstreams der Container-App.
properties.latestReadyRevisionName	string	Name der letzten bereite Revision der Container-App.
properties.latestRevisionFqdn	string	Vollqualifizierter Domänenname der neuesten Revision der Container-App.
properties.latestRevisionName	string	Name der neuesten Revision der Container-App.
properties.managedEnvironmentId	string	Veraltet. Ressourcen-ID der Umgebung der Container-App.
properties.outboundIpAddresses	string[]	Ausgehende IP-Adressen für Container-App.
properties.provisioningState	ContainerAppProvisioningState	Bereitstellungsstatus der Container-App.
properties.template	Template	Anwendungsdefinition der Container-App mit Versionsangabe.
properties.workloadProfileName	string	Workloadprofilname, der für die Ausführung der Container-App angeheften werden soll.
systemData	systemData	Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ContainerAppProbe

Der Test beschreibt eine Integritätsprüfung, die für einen Container ausgeführt werden soll, um zu bestimmen, ob er aktiv ist oder bereit ist, Datenverkehr zu empfangen.

Name	Typ	Beschreibung
failureThreshold	integer	Minimale aufeinanderfolgende Fehler für den Test, der nach dem Erfolgreichen als fehlgeschlagen gilt. Der Standardwert ist 3. Der Mindestwert ist 1. Der maximale Wert ist 10.
httpGet	HttpGet	HTTPGet gibt die auszuführende HTTP-Anforderung an.
initialDelaySeconds	integer	Die Anzahl der Sekunden, die nach dem Start des Containers vergehen, bevor Livetests initiiert werden. Der Mindestwert ist 1. Der Maximalwert ist 60.
periodSeconds	integer	Gibt an, wie häufig (in Sekunden) ein Test durchgeführt werden soll. Der Standardwert ist 10 Sekunden. Der Mindestwert ist 1. Der Maximalwert ist 240.
successThreshold	integer	Minimale aufeinanderfolgende Erfolge, damit der Test nach einem Fehler als erfolgreich betrachtet wird. Der Standardwert lautet 1. Muss 1 für Liveness und Start sein. Der Mindestwert ist 1. Der maximale Wert ist 10.
tcpSocket	TcpSocket	TCPSocket gibt eine Aktion an, die einen TCP-Port umfasst. TCP-Hooks werden noch nicht unterstützt.
terminationGracePeriodSeconds	integer	Optionale Dauer in Sekunden, die der Pod bei einem Testfehler ordnungsgemäß beenden muss. Die Nachfrist ist die Dauer in Sekunden, nachdem die im Pod ausgeführten Prozesse ein Beendigungssignal gesendet haben, und der Zeitpunkt, zu dem die Prozesse mit einem Kill-Signal gewaltsam angehalten werden. Legen Sie für diesen Wert eine längere Zeit als die erwartete Bereinigungszeit für Ihren Prozess fest. Wenn dieser Wert null ist, wird die terminGracePeriodSeconds des Pods verwendet. Andernfalls überschreibt dieser Wert den von der Podspezifikation bereitgestellten Wert. Der Wert muss eine nicht negative ganze Zahl sein. Der Wert 0 gibt an, dass sofort über das Kill-Signal angehalten wird (keine Möglichkeit zum Herunterfahren). Dies ist ein Alphafeld und erfordert die Aktivierung des Featuregates "ProbeTerminationGracePeriod". Maximaler Wert ist 3600 Sekunden (1 Stunde)
timeoutSeconds	integer	Anzahl der Sekunden, nach denen der Test ein Zeitüberschreitungsintervall aufweist. Der Standardwert ist 1 Sekunde. Der Mindestwert ist 1. Der Maximalwert ist 240.
type	Type	Der Typ des Tests.

ContainerAppProvisioningState

Bereitstellungsstatus der Container-App.

Name	Typ	Beschreibung
Canceled	string
Deleting	string
Failed	string
InProgress	string
Succeeded	string

ContainerResources

Container-App-Containerressourcenanforderungen.

Name	Typ	Beschreibung
cpu	number	Erforderliche CPU in Kernen, z. B. 0,5
ephemeralStorage	string	Ephemeral Storage, z.B. "1Gi"
memory	string	Erforderlicher Arbeitsspeicher, z. B. "250MB"

CorsPolicy

Richtlinie für die übergreifende Ressourcenfreigabe

Name	Typ	Beschreibung
allowCredentials	boolean	Gibt an, ob die Ressource Anmeldeinformationen zulässt.
allowedHeaders	string[]	Gibt den Inhalt für den Header access-control-allow-headers an.
allowedMethods	string[]	Gibt den Inhalt für den Header access-control-allow-methods an.
allowedOrigins	string[]	Gibt den Inhalt für den Header access-control-allow-origins an.
exposeHeaders	string[]	Gibt den Inhalt für den Header access-control-expose-headers an.
maxAge	integer	Gibt den Inhalt für den Access-Control-max-age-Header an.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

CustomDomain

Custom Domain einer Container-App

Name	Typ	Beschreibung
bindingType	bindingType	Custom Domain Bindungstyp.
certificateId	string	Ressourcen-ID des Zertifikats, das an diesen Hostnamen gebunden werden soll. Muss in der verwalteten Umgebung vorhanden sein.
name	string	Hostname.

CustomScaleRule

Container-App-Container Benutzerdefinierte Skalierungsregel.

Name	Typ	Beschreibung
auth	ScaleRuleAuth[]	Authentifizierungsgeheimnisse für die benutzerdefinierte Skalierungsregel.
metadata	object	Metadateneigenschaften zum Beschreiben einer benutzerdefinierten Skalierungsregel.
type	string	Typ der benutzerdefinierten Skalierungsregel, z. B. azure-servicebus, redis usw.

Dapr

Container-App-Dapr-Konfiguration.

Name	Typ	Standardwert	Beschreibung
appId	string		Dapr-Anwendungsbezeichner
appPort	integer		Teilt Dapr mit, an welchem Port Ihre Anwendung lauscht.
appProtocol	appProtocol	http	Teilt Dapr mit, welches Protokoll Ihre Anwendung verwendet. Gültige Optionen sind http und grpc. Der Standardwert ist http.
enableApiLogging	boolean		Aktiviert die API-Protokollierung für das Dapr-Sidecar
enabled	boolean	False	Boolescher Wert, der angibt, ob das Dapr-Seitenfahrzeug aktiviert ist
httpMaxRequestSize	integer		Erhöhen der maximalen Größe des Http- und grpc-Serverparameters für den Anforderungstext in MB, um das Hochladen großer Dateien zu verarbeiten. Der Standardwert ist 4 MB.
httpReadBufferSize	integer		Dapr maximale Größe des HTTP-Headerlesepuffers in KB, der beim Senden von Multi-KB-Headern behandelt werden soll. Der Standardwert ist 65 KB.
logLevel	logLevel		Legt die Protokollebene für das Dapr-Sidecar fest. Zulässige Werte sind debug, info, warn, error. Der Standardwert ist info.

DefaultErrorResponse

App Service Fehlerantwort.

Name	Typ	Beschreibung
error	Error	Fehlermodell.

Details

Details oder fehler

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zum programmgesteuerten Identifizieren des Fehlers.
message	string	Ausführliche Fehlerbeschreibung und Debuginformationen.
target	string	Ausführliche Fehlerbeschreibung und Debuginformationen.

EnvironmentVar

Container-App-Umgebungsvariable.

Name	Typ	Beschreibung
name	string	Umgebungsvariablenname.
secretRef	string	Name des Geheimen Container-App-Geheimnisses, aus dem der Wert der Umgebungsvariablen abgerufen werden soll.
value	string	Nicht geheimer Umgebungsvariablenwert.

Error

Fehlermodell.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zum programmgesteuerten Identifizieren des Fehlers.
details	Details[]	Details oder fehler
innererror	string	Weitere Informationen zum Debuggen des Fehlers.
message	string	Ausführliche Fehlerbeschreibung und Debuginformationen.
target	string	Ausführliche Fehlerbeschreibung und Debuginformationen.

ExtendedLocation

Der komplexe Typ des erweiterten Standorts.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.

ExtendedLocationTypes

Der Typ des erweiterten Speicherorts.

Name	Typ	Beschreibung
CustomLocation	string

HttpGet

HTTPGet gibt die auszuführende HTTP-Anforderung an.

Name	Typ	Beschreibung
host	string	Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP-Adresse. Sie möchten wahrscheinlich stattdessen "Host" in httpHeaders festlegen.
httpHeaders	HttpHeaders[]	Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP lässt wiederholte Header zu.
path	string	Pfad zum Zugriff auf den HTTP-Server.
port	integer	Name oder Nummer des Ports, auf den für den Container zugegriffen werden soll. Die Zahl muss im Bereich 1 bis 65535 liegen. Name muss ein IANA_SVC_NAME sein.
scheme	Scheme	Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Der Standardwert ist HTTP.

HttpHeaders

Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP lässt wiederholte Header zu.

Name	Typ	Beschreibung
name	string	Der Name des Kopfzeilenfelds
value	string	Der Wert des Headerfelds

HttpScaleRule

Http-Skalierungsregel für Container-App-Container.

Name	Typ	Beschreibung
auth	ScaleRuleAuth[]	Authentifizierungsgeheimnisse für die benutzerdefinierte Skalierungsregel.
metadata	object	Metadateneigenschaften zur Beschreibung der HTTP-Skalierungsregel.

Ingress

Konfiguration der Eingehenden Container-App.

Name	Typ	Standardwert	Beschreibung
additionalPortMappings	IngressPortMapping[]		Einstellungen zum Verfügbarmachen zusätzlicher Ports in der Container-App
allowInsecure	boolean	False	Bool, der angibt, ob HTTP-Verbindungen mit zulässig sind. Wenn auf "False" festgelegt ist, werden HTTP-Verbindungen automatisch an HTTPS-Verbindungen umgeleitet.
clientCertificateMode	IngressClientCertificateMode		Clientzertifikatmodus für die mTLS-Authentifizierung. Ignore gibt an, dass der Server das Clientzertifikat bei der Weiterleitung löscht. Accept gibt an, dass der Server das Clientzertifikat weiterleitet, aber kein Clientzertifikat erfordert. Erforderlich gibt an, dass der Server ein Clientzertifikat erfordert.
corsPolicy	CorsPolicy		CORS-Richtlinie für Container-App
customDomains	CustomDomain[]		benutzerdefinierte Domänenbindungen für Container Apps-Hostnamen.
exposedPort	integer		Verfügbar gemachter Port in Containern für TCP-Datenverkehr aus eingehendem Datenverkehr
external	boolean	False	Bool, der angibt, ob die App einen externen HTTP-Endpunkt verfügbar macht
fqdn	string		Hostname.
ipSecurityRestrictions	IpSecurityRestrictionRule[]		Regeln zum Einschränken eingehender IP-Adressen.
stickySessions	StickySessions		Kurzsitzungen für den einzelnen Revisionsmodus
targetPort	integer		Zielport in Containern für Eingehenden Datenverkehr
traffic	TrafficWeight[]		Datenverkehrsgewichtung für App-Revisionen
transport	IngressTransportMethod	auto	Protokoll für eingehenden Transport

IngressClientCertificateMode

Clientzertifikatmodus für die mTLS-Authentifizierung. Ignore gibt an, dass der Server das Clientzertifikat bei der Weiterleitung löscht. Accept gibt an, dass der Server das Clientzertifikat weiterleitet, aber kein Clientzertifikat erfordert. Erforderlich gibt an, dass der Server ein Clientzertifikat erfordert.

Name	Typ	Beschreibung
accept	string
ignore	string
require	string

IngressPortMapping

Portzuordnungen des Eingangs von Container-Apps

Name	Typ	Beschreibung
exposedPort	integer	Gibt den verfügbar gemachten Port für den Zielport an. Wenn nicht angegeben, wird standardmäßig der Zielport verwendet.
external	boolean	Gibt an, ob auf den App-Port außerhalb der Umgebung zugegriffen werden kann.
targetPort	integer	Gibt an, dass der Container des Portbenutzers lauscht.

IngressTransportMethod

Protokoll für eingehenden Transport

Name	Typ	Beschreibung
auto	string
http	string
http2	string
tcp	string

InitContainer

Container-App-Initialisierungscontainerdefinition

Name	Typ	Beschreibung
args	string[]	Containerstartbefehlsargumente.
command	string[]	Containerstartbefehl.
env	EnvironmentVar[]	Containerumgebungsvariablen.
image	string	Containerimagetag.
name	string	Benutzerdefinierter Containername.
resources	ContainerResources	Anforderungen an Containerressourcen.
volumeMounts	VolumeMount[]	Bereitstellungen von Containervolumes.

IpSecurityRestrictionRule

Regel zum Einschränken eingehender IP-Adressen.

Name	Typ	Beschreibung
action	action	Regeln zulassen oder verweigern, um für eingehende IP-Adressen zu bestimmen. Hinweis: Regeln können nur aus ALL Allow oder ALL Deny bestehen.
description	string	Beschreiben sie die IP-Einschränkungsregel, die an die container-app gesendet wird. Dies ist ein optionales Feld.
ipAddressRange	string	CIDR-Notation zur Übereinstimmung mit eingehender IP-Adresse
name	string	Name für die IP-Einschränkungsregel.

logLevel

Legt die Protokollebene für das Dapr-Seitenwagen fest. Zulässige Werte sind Debug, Info, Warnung, Fehler. Der Standardwert ist Info.

Name	Typ	Beschreibung
debug	string
error	string
info	string
warn	string

ManagedServiceIdentity

Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)

Name	Typ	Beschreibung
principalId	string	Die Dienstprinzipal-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
tenantId	string	Die Mandanten-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
type	ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).
userAssignedIdentities	<string,  UserAssignedIdentity>	User-Assigned Identitäten Der Satz von benutzerseitig zugewiesenen Identitäten, die der Ressource zugeordnet sind. Bei den userAssignedIdentities-Wörterbuchschlüsseln handelt es sich um ARM-Ressourcen-IDs im Format :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).

Name	Typ	Beschreibung
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

QueueScaleRule

Container-App-Container: Azure Queue-basierte Skalierungsregel.

Name	Typ	Beschreibung
auth	ScaleRuleAuth[]	Authentifizierungsgeheimnisse für die Warteschlangenskalierungsregel.
queueLength	integer	Warteschlangenlänge.
queueName	string	Warteschlangenname.

RegistryCredentials

Private Registrierung von Container-Apps

Name	Typ	Beschreibung
identity	string	Eine verwaltete Identität, die für die Authentifizierung bei Azure Container Registry verwendet werden soll. Verwenden Sie für benutzerseitig zugewiesene Identitäten die vollständige benutzerseitig zugewiesene Identitätsressourcen-ID. Verwenden Sie für systemseitig zugewiesene Identitäten "system".
passwordSecretRef	string	Der Name des Geheimnisses, das das Anmeldekennwort für die Registrierung enthält.
server	string	ContainerRegistrierungsserver
username	string	Benutzername der Containerregistrierung

Scale

Konfigurationen für die Container-App-Skalierung.

Name	Typ	Standardwert	Beschreibung
maxReplicas	integer	10	Optional. Maximale Anzahl von Containerreplikaten. Der Standardwert ist 10, wenn nicht festgelegt.
minReplicas	integer		Optional. Mindestanzahl von Containerreplikaten.
rules	ScaleRule[]		Skalierungsregeln.

ScaleRule

Container-App-Containerskalierungsregel.

Name	Typ	Beschreibung
azureQueue	QueueScaleRule	Azure Queue-basierte Skalierung.
custom	CustomScaleRule	Benutzerdefinierte Skalierungsregel.
http	HttpScaleRule	AUF HTTP-Anforderungen basierende Skalierung.
name	string	Name der Skalierungsregel
tcp	TcpScaleRule	Tcp-Anforderungen basierende Skalierung.

ScaleRuleAuth

Authentifizierungsgeheimnisse für Skalierungsregel

Name	Typ	Beschreibung
secretRef	string	Name des Geheimnisses, aus dem die Authentifizierungsparameter abgerufen werden sollen.
triggerParameter	string	Triggerparameter, der das Geheimnis verwendet

Scheme

Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Der Standardwert ist HTTP.

Name	Typ	Beschreibung
HTTP	string
HTTPS	string

Secret

Geheimnisdefinition.

Name	Typ	Beschreibung
identity	string	Ressourcen-ID einer verwalteten Identität zur Authentifizierung bei Azure Key Vault oder System zur Verwendung einer systemseitig zugewiesenen Identität.
keyVaultUrl	string	Azure Key Vault URL, die auf das Geheimnis verweist, auf das die Container-App verweist.
name	string	Name des Geheimnisses.
value	string	Geheimniswert.

SecretVolumeItem

Geheimnis, das dem Volume hinzugefügt werden soll.

Name	Typ	Beschreibung
path	string	Pfad zum Projektgeheimnis. Wenn kein Pfad angegeben wird, wird der Pfad standardmäßig auf den Namen des in secretRef aufgeführten Geheimnisses festgelegt.
secretRef	string	Name des Geheimen Container-App-Geheimnisses, aus dem der Geheimniswert abgerufen werden soll.

Service

Container-App als Entwicklungsdienst

Name	Typ	Beschreibung
type	string	Dev ContainerApp-Diensttyp

ServiceBind

Konfiguration zum Binden einer ContainerApp an einen dev ContainerApp Service

Name	Typ	Beschreibung
clientType	string	Typ des Clients, der zum Herstellen einer Verbindung mit dem Dienst verwendet werden soll
customizedKeys	object	Angepasste Schlüssel zum Anpassen eingefügter Werte an die App
name	string	Name der Dienstbindung
serviceId	string	Ressourcen-ID des Zieldiensts

StickySessions

Haftsitzungen für den einzelnen Revisionsmodus

Name	Typ	Beschreibung
affinity	affinity	Affinität zu klebrigen Sitzungen

StorageType

Speichertyp für das Volume. Wenn nicht angegeben, verwenden Sie EmptyDir.

Name	Typ	Beschreibung
AzureFile	string
EmptyDir	string
Secret	string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TcpScaleRule

Tcp-Skalierungsregel für Container-App-Container.

Name	Typ	Beschreibung
auth	ScaleRuleAuth[]	Authentifizierungsgeheimnisse für die TCP-Skalierungsregel.
metadata	object	Metadateneigenschaften zum Beschreiben der TCP-Skalierungsregel.

TcpSocket

TCPSocket gibt eine Aktion an, die einen TCP-Port umfasst. TCP-Hooks werden noch nicht unterstützt.

Name	Typ	Beschreibung
host	string	Optional: Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP-Adresse.
port	integer	Nummer oder Name des Ports, auf den auf den Container zugegriffen werden soll. Die Zahl muss im Bereich 1 bis 65535 liegen. Name muss ein IANA_SVC_NAME sein.

Template

Anwendungsdefinition der Container-App mit Versionsangabe. Definiert den gewünschten Zustand einer unveränderlichen Revision. Alle Änderungen an diesem Abschnitt führen dazu, dass eine neue Revision erstellt wird.

Name	Typ	Beschreibung
containers	Container[]	Liste der Containerdefinitionen für die Container-App.
initContainers	InitContainer[]	Liste der spezialisierten Container, die vor App-Containern ausgeführt werden.
revisionSuffix	string	Benutzerfreundliches Suffix, das an den Revisionsnamen angefügt wird
scale	Scale	Skalierungseigenschaften für die Container-App.
serviceBinds	ServiceBind[]	Liste der an die App gebundenen Container-App-Dienste
terminationGracePeriodSeconds	integer	Optionale Dauer in Sekunden, die die Container-App-Instanz ordnungsgemäß beenden muss. Der Wert muss eine nicht negative ganze Zahl sein. Der Wert 0 gibt an, dass sofort über das Kill-Signal angehalten wird (keine Gelegenheit zum Herunterfahren). Wenn dieser Wert gleich null ist, wird stattdessen der standardmäßige Nachfristzeitraum verwendet. Legen Sie für diesen Wert eine längere Zeit als die erwartete Bereinigungszeit für Ihren Prozess fest. Der Standardwert beträgt 30 Sekunden.
volumes	Volume[]	Liste der Volumedefinitionen für die Container-App.

TrafficWeight

Einer Revision zugewiesene Datenverkehrsgewichtung

Name	Typ	Standardwert	Beschreibung
label	string		Ordnet eine Datenverkehrsbezeichnung einer Revision zu
latestRevision	boolean	False	Gibt an, dass die Datenverkehrsgewichtung zu einer aktuellen stabilen Revision gehört.
revisionName	string		Name einer Revision
weight	integer		Einer Revision zugewiesene Datenverkehrsgewichtung

Type

Der Typ des Tests.

Name	Typ	Beschreibung
Liveness	string
Readiness	string
Startup	string

UserAssignedIdentity

Benutzerseitig zugewiesene Identitätseigenschaften

Name	Typ	Beschreibung
clientId	string	Die Client-ID der zugewiesenen Identität.
principalId	string	Die Prinzipal-ID der zugewiesenen Identität.

Volume

Volumedefinitionen für die Container-App.

Name	Typ	Beschreibung
mountOptions	string	Einbindungsoptionen, die beim Einbinden der AzureFile verwendet werden. Muss eine durch Trennzeichen getrennte Zeichenfolge sein.
name	string	Volumename.
secrets	SecretVolumeItem[]	Liste der Geheimnisse, die dem Volume hinzugefügt werden sollen. Wenn keine Geheimnisse bereitgestellt werden, werden alle Geheimnisse in der Sammlung dem Volume hinzugefügt.
storageName	string	Name der Speicherressource. Es ist nicht erforderlich, emptyDir und Secret anzugeben.
storageType	StorageType	Speichertyp für das Volume. Wenn nicht angegeben, verwenden Sie EmptyDir.

VolumeMount

Volumebereitstellung für die Container-App.

Name	Typ	Beschreibung
mountPath	string	Pfad innerhalb des Containers, an dem das Volume eingebunden werden soll. Darf nicht ":" enthalten.
subPath	string	Pfad innerhalb des Volumes, von dem das Volume des Containers eingebunden werden soll. Standardmäßig ist "" (Stammverzeichnis des Volumes).
volumeName	string	Dies muss mit dem Namen eines Volumes übereinstimmen.