Container Apps - Start
Starten einer Container-App
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}/start?api-version=2024-03-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
container
|
path | True |
string |
Name der Container-App. RegEx-Muster: |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
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 |
Container-App wurde erfolgreich gestartet. |
|
202 Accepted |
Der Startvorgang wird ausgeführt. Header Location: string |
|
Other Status Codes |
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
Beispiel für eine Antwort
{
"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"
}
}
location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.App/containerApps/testworkerapp0/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-03-01
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. |
Active |
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 zwischen Sticky-Sitzungen |
app |
Teilt Dapr mit, welches Protokoll Ihre Anwendung verwendet. Gültige Optionen sind http und grpc. Der Standardwert ist http. |
binding |
Custom Domain Bindungstyp. |
Configuration |
Konfigurationseigenschaften von Container-Apps ohne Versionsangabe, die die veränderlichen Einstellungen einer Container-App definieren |
Container |
Container-App-Containerdefinition |
Container |
Container-App. |
Container |
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 für den Empfang von Datenverkehr ist. |
Container |
Bereitstellungsstatus der Container-App. |
Container |
Container-App-Containerressourcenanforderungen. |
Cors |
Richtlinie "Cross-Origin-Resource-Sharing" |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Custom |
Custom Domain einer Container-App |
Custom |
Benutzerdefinierte Skalierungsregel für Container-App-Container. |
Dapr |
Container-App-Dapr-Konfiguration. |
Default |
App Service Fehlerantwort. |
Details |
Details oder fehler |
Environment |
Container-App-Umgebungsvariable. |
Error |
Fehlermodell. |
Extended |
Der komplexe Typ des erweiterten Standorts. |
Extended |
Der Typ des erweiterten Speicherorts. |
Http |
HTTPGet gibt die auszuführende HTTP-Anforderung an. |
Http |
Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP lässt wiederholte Header zu. |
Http |
Http-Skalierungsregel für Container-App-Container. |
Ingress |
Konfiguration der Eingehenden Container-App. |
Ingress |
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. |
Ingress |
Portzuordnungen von eingehenden Container-Apps |
Ingress |
Protokoll für eingehenden Transport |
Init |
Container-App-Initialisierungscontainerdefinition |
Ip |
Regel zum Einschränken eingehender IP-Adressen. |
log |
Legt die Protokollebene für das Dapr-Sidecar fest. Zulässige Werte sind debug, info, warn, error. Der Standardwert ist info. |
Managed |
Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten) |
Managed |
Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind). |
Queue |
Azure Queue-basierte Skalierungsregel für Container-App-Container. |
Registry |
Private Registrierung von Container-Apps |
Scale |
Konfigurationen für die Container-App-Skalierung. |
Scale |
Container-App-Containerskalierungsregel. |
Scale |
Authentifizierungsgeheimnisse für Skalierungsregel |
Scheme |
Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Der Standardwert ist HTTP. |
Secret |
Geheimnisdefinition. |
Secret |
Geheimnis, das dem Volume hinzugefügt werden soll. |
Service |
Container-App als Entwicklungsdienst |
Service |
Konfiguration zum Binden einer ContainerApp an einen dev ContainerApp Service |
Sticky |
Kurzsitzungen für den einzelnen Revisionsmodus |
Storage |
Speichertyp für das Volume. Wenn nicht angegeben, verwenden Sie EmptyDir. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
Tcp |
Tcp-Skalierungsregel für Container-App-Container. |
Tcp |
TCPSocket gibt eine Aktion mit einem TCP-Port an. 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. |
Traffic |
Einer Revision zugewiesene Datenverkehrsgewichtung |
Type |
Der Typ des Tests. |
User |
Benutzerseitig zugewiesene Identitätseigenschaften |
Volume |
Volumedefinitionen für die Container-App. |
Volume |
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 zwischen Sticky-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 | 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-Konfiguration für die Container-App. |
||
ingress |
Eingangskonfigurationen. |
||
maxInactiveRevisions |
integer |
Optional. Max. inaktive Revisionen, die eine Container-App haben kann. |
|
registries |
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 |
Container-App als Entwicklungscontainer-App Service |
Container
Container-App-Containerdefinition
Name | Typ | Beschreibung |
---|---|---|
args |
string[] |
Containerstartbefehlsargumente. |
command |
string[] |
Containerstartbefehl. |
env |
Containerumgebungsvariablen. |
|
image |
string |
Containerimagetag. |
name |
string |
Benutzerdefinierter Containername. |
probes |
Liste der Tests für den Container. |
|
resources |
Anforderungen an Containerressourcen. |
|
volumeMounts |
Bereitstellungen von Containervolumes. |
ContainerApp
Container-App.
Name | Typ | Beschreibung |
---|---|---|
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 |
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 |
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 |
Bereitstellungsstatus der Container-App. |
|
properties.template |
Anwendungsdefinition der Container-App mit Versionsangabe. |
|
properties.workloadProfileName |
string |
Workloadprofilname, der für die Ausführung der Container-App angeheften werden soll. |
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 für den Empfang von Datenverkehr ist.
Name | Typ | Beschreibung |
---|---|---|
failureThreshold |
integer |
Minimale aufeinanderfolgende Fehler, damit der Test nach dem Erfolgreichen als fehlgeschlagen gilt. Der Standardwert ist 3. Der Mindestwert ist 1. Der maximale Wert ist 10. |
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 Höchstwert ist 240. |
successThreshold |
integer |
Minimale aufeinanderfolgende Erfolge, damit der Test nach einem Fehler als erfolgreich angesehen wird. Der Standardwert lautet 1. Muss 1 sein, um live zu sein und zu starten. Der Mindestwert ist 1. Der maximale Wert ist 10. |
tcpSocket |
TCPSocket gibt eine Aktion mit einem TCP-Port an. TCP-Hooks werden noch nicht unterstützt. |
|
terminationGracePeriodSeconds |
integer |
Optionale Dauer in Sekunden, die der Pod bei einem Testfehler ordnungsgemäß beenden muss. Die Toleranzperiode 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 erzwungen 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 der 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 Gelegenheit 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 das Zeitüberschreitungsintervall für den Test aufgetreten ist. Der Standardwert ist 1 Sekunde. Der Mindestwert ist 1. Der Höchstwert ist 240. |
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 |
Kurzlebige Speicherung, z.B. "1Gi" |
memory |
string |
Erforderlicher Arbeitsspeicher, z. B. "250Mb" |
CorsPolicy
Richtlinie "Cross-Origin-Resource-Sharing"
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 Access-Control-allow-methods-Header an. |
allowedOrigins |
string[] |
Gibt den Inhalt für den Header access-control-allow-origins an. |
exposeHeaders |
string[] |
Gibt den Inhalt für den access-control-expose-headers-Header 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 |
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
Benutzerdefinierte Skalierungsregel für Container-App-Container.
Name | Typ | Beschreibung |
---|---|---|
auth |
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 | 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 |
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 |
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 |
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 |
Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP lässt wiederholte Header zu. |
|
path |
string |
Pfad zum Zugriff auf dem HTTP-Server. |
port |
integer |
Name oder Nummer des Ports, auf den auf den Container zugegriffen werden soll. Die Zahl muss im Bereich von 1 bis 65535 liegen. Name muss ein IANA_SVC_NAME sein. |
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 |
Name des Kopfzeilenfelds |
value |
string |
Der Wert des Kopfzeilenfelds |
HttpScaleRule
Http-Skalierungsregel für Container-App-Container.
Name | Typ | Beschreibung |
---|---|---|
auth |
Authentifizierungsgeheimnisse für die benutzerdefinierte Skalierungsregel. |
|
metadata |
object |
Metadateneigenschaften zum Beschreiben der HTTP-Skalierungsregel. |
Ingress
Konfiguration der Eingehenden Container-App.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
additionalPortMappings |
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 |
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 |
CORS-Richtlinie für Container-App |
||
customDomains |
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 |
Regeln zum Einschränken eingehender IP-Adressen. |
||
stickySessions |
Kurzsitzungen für den einzelnen Revisionsmodus |
||
targetPort |
integer |
Zielport in Containern für Eingehenden Datenverkehr |
|
traffic |
Datenverkehrsgewichtung für App-Revisionen |
||
transport | 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 von eingehenden 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, an ob 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 |
Containerumgebungsvariablen. |
|
image |
string |
Containerimagetag. |
name |
string |
Benutzerdefinierter Containername. |
resources |
Anforderungen an Containerressourcen. |
|
volumeMounts |
Bereitstellungen von Containervolumes. |
IpSecurityRestrictionRule
Regel zum Einschränken eingehender IP-Adressen.
Name | Typ | 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. |
|
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-Sidecar fest. Zulässige Werte sind debug, info, warn, error. 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 |
Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind). |
|
userAssignedIdentities |
<string,
User |
User-Assigned Identitäten |
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
Azure Queue-basierte Skalierungsregel für Container-App-Container.
Name | Typ | Beschreibung |
---|---|---|
auth |
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 |
Skalierungsregeln. |
ScaleRule
Container-App-Containerskalierungsregel.
Name | Typ | Beschreibung |
---|---|---|
azureQueue |
Azure Queue-basierte Skalierung. |
|
custom |
Benutzerdefinierte Skalierungsregel. |
|
http |
AUF HTTP-Anforderungen basierende Skalierung. |
|
name |
string |
Name der Skalierungsregel |
tcp |
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 |
---|---|---|
name |
string |
Name der Dienstbindung |
serviceId |
string |
Ressourcen-ID des Zieldiensts |
StickySessions
Kurzsitzungen für den einzelnen Revisionsmodus
Name | Typ | Beschreibung |
---|---|---|
affinity |
Affinität zwischen Sticky-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 |
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 |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
TcpScaleRule
Tcp-Skalierungsregel für Container-App-Container.
Name | Typ | Beschreibung |
---|---|---|
auth |
Authentifizierungsgeheimnisse für die TCP-Skalierungsregel. |
|
metadata |
object |
Metadateneigenschaften zum Beschreiben der TCP-Skalierungsregel. |
TcpSocket
TCPSocket gibt eine Aktion mit einem TCP-Port an. 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 von 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 |
Liste der Containerdefinitionen für die Container-App. |
|
initContainers |
Liste der spezialisierten Container, die vor App-Containern ausgeführt werden. |
|
revisionSuffix |
string |
Benutzerfreundliches Suffix, das an den Revisionsnamen angefügt wird |
scale |
Skalierungseigenschaften für die Container-App. |
|
serviceBinds |
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 |
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 |
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 bereitgestellt werden soll. Darf ":" nicht enthalten. |
subPath |
string |
Pfad innerhalb des Volumes, von dem das Volume des Containers bereitgestellt werden soll. Der Standardwert ist "" (Stammverzeichnis des Volumes). |
volumeName |
string |
Dies muss mit dem Namen eines Volumes übereinstimmen. |