Container Apps - Create Or Update
Beschreibung zum Erstellen oder Aktualisieren einer Container-App.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/containerApps/{name}?api-version=2023-12-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
name
|
path | True |
string |
Name der Container-App. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+[^\.]$ |
Name der Ressourcengruppe, zu der die Ressource gehört. |
subscription
|
path | True |
string |
Ihre Azure-Abonnement-ID. Dies ist eine GUID-formatierte Zeichenfolge (z. B. 0000000-0000-0000-0000-000000000000). |
api-version
|
query | True |
string |
API-Version |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
location | True |
string |
Ressourcenspeicherort. |
kind |
string |
Art der Ressource. |
|
properties.configuration |
Nicht versionsierte Container-App-Konfigurationseigenschaften. |
||
properties.kubeEnvironmentId |
string |
Ressourcen-ID des KubeEnvironment der Container-App. |
|
properties.template |
Anwendungsdefinition der Container-App mit Versionsverwaltung. |
||
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Für die Container-App wurde keine Änderung ausgeführt. |
|
201 Created |
Die Container-App wurde erstellt oder aktualisiert. |
|
Other Status Codes |
Fehlerantwort des App-Diensts. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
Create or Update Container App
Beispielanforderung
PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/containerApps/testcontainerApp0?api-version=2023-12-01
{
"kind": "containerApp",
"location": "East US",
"properties": {
"kubeEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/kubeEnvironments/demokube",
"configuration": {
"ingress": {
"external": true,
"targetPort": 3000
}
},
"template": {
"containers": [
{
"image": "repo/testcontainerApp0:v1",
"name": "testcontainerApp0"
}
],
"scale": {
"minReplicas": 1,
"maxReplicas": 5,
"rules": [
{
"name": "httpscalingrule",
"custom": {
"type": "http",
"metadata": {
"concurrentRequests": "50"
}
}
}
]
},
"dapr": {
"enabled": true,
"appPort": 3000
}
}
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/containerApps/testcontainerApp0",
"name": "testcontainerApp0",
"type": "Microsoft.Web/containerApps",
"kind": "containerApp",
"location": "East US",
"properties": {
"provisioningState": "Succeeded",
"kubeEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/kubeEnvironments/demokube",
"latestRevisionFqdn": "testcontainerApp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
"configuration": {
"ingress": {
"fqdn": "testcontainerApp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
"external": true,
"targetPort": 3000,
"transport": "auto"
}
},
"template": {
"containers": [
{
"image": "repo/testcontainerApp0:v4",
"name": "testcontainerApp0",
"resources": {
"cpu": 0.2,
"memory": "100Mi"
}
}
],
"scale": {
"minReplicas": 1,
"maxReplicas": 5,
"rules": [
{
"name": "httpscalingrule",
"http": {
"metadata": {
"concurrentRequests": "50"
}
}
}
]
},
"dapr": {
"enabled": true,
"appPort": 3000
}
}
}
}
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/containerApps/testcontainerApp0",
"name": "testcontainerApp0",
"type": "Microsoft.Web/containerApps",
"kind": "containerApp",
"location": "East US",
"properties": {
"provisioningState": "InProgress",
"kubeEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/kubeEnvironments/demokube",
"latestRevisionFqdn": "testcontainerApp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
"configuration": {
"ingress": {
"fqdn": "testcontainerApp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
"external": true,
"targetPort": 3000,
"transport": "auto"
}
},
"template": {
"containers": [
{
"image": "repo/testcontainerApp0:v4",
"name": "testcontainerApp0",
"resources": {
"cpu": 0.2,
"memory": "100Mi"
}
}
],
"scale": {
"minReplicas": 1,
"maxReplicas": 5,
"rules": [
{
"name": "httpscalingrule",
"http": {
"metadata": {
"concurrentRequests": "50"
}
}
}
]
},
"dapr": {
"enabled": true,
"appPort": 3000
}
}
}
}
Definitionen
Name | Beschreibung |
---|---|
Active |
ActiveRevisionsMode steuert, wie aktive Überarbeitungen für die Container-App behandelt werden: Mehrere Überarbeitungen können aktiv sein. Wenn kein Wert angegeben wird, ist dies die StandardeinstellungSingle: Es kann jeweils nur eine Überarbeitung aktiv sein. Überarbeitungsgewichte können in diesem Modus nicht verwendet werden |
Configuration |
Konfigurationseigenschaften der nicht versionsfreien Container-App, die die veränderbaren Einstellungen einer Container-App definieren |
Container |
Containerdefinition der Container-App. |
Container |
Container-App. |
Container |
Bereitstellungsstatus der Container-App. |
Container |
Container-App-Containerressourcenanforderungen. |
Custom |
Benutzerdefinierte Skalierungsregel für Container-App-Container. |
Dapr |
Container-App-Dapr-Konfiguration. |
Dapr |
Dapr-Komponentenkonfiguration |
Dapr |
Container-App-Dapr-Komponentenmetadaten. |
Default |
Fehlerantwort des App-Diensts. |
Details | |
Environment |
Container-App-Umgebungsvariable. |
Error |
Fehlermodell. |
Http |
Benutzerdefinierte Skalierungsregel für Container-App-Container. |
Ingress |
Container-App-Eingangskonfiguration. |
Ingress |
Ingress-Transportprotokoll |
Queue |
Container-App-Container Azure Queue-basierte Skalierungsregel. |
Registry |
Private Registrierung der Container-App |
Scale |
Konfigurationen für die Skalierung von Container-Apps. |
Scale |
Container-App-Skalierungsregel. |
Scale |
Authentifizierungsgeheimnisse für Die Skalierungsregel für Container-Apps |
Secret |
Geheimer Container-App-Schlüssel. |
Template |
Anwendungsdefinition der Container-App mit Versionsverwaltung. Definiert den gewünschten Zustand einer unveränderlichen Überarbeitung. Alle Änderungen an diesem Abschnitt führen dazu, dass eine neue Überarbeitung erstellt wird. |
Traffic |
Der Einer Überarbeitung zugewiesene Datenverkehrsgewicht |
ActiveRevisionsMode
ActiveRevisionsMode steuert, wie aktive Überarbeitungen für die Container-App behandelt werden: Mehrere Überarbeitungen können aktiv sein. Wenn kein Wert angegeben wird, ist dies die StandardeinstellungSingle: Es kann jeweils nur eine Überarbeitung aktiv sein. Überarbeitungsgewichte können in diesem Modus nicht verwendet werden
Wert | Beschreibung |
---|---|
multiple | |
single |
Configuration
Konfigurationseigenschaften der nicht versionsfreien Container-App, die die veränderbaren Einstellungen einer Container-App definieren
Name | Typ | Beschreibung |
---|---|---|
activeRevisionsMode |
ActiveRevisionsMode steuert, wie aktive Überarbeitungen für die Container-App behandelt werden: Mehrere Überarbeitungen können aktiv sein. Wenn kein Wert angegeben wird, ist dies die StandardeinstellungSingle: Es kann jeweils nur eine Überarbeitung aktiv sein. Überarbeitungsgewichte können in diesem Modus nicht verwendet werden |
|
ingress |
Eingangskonfigurationen. |
|
registries |
Sammlung privater Containerregistrierungsanmeldeinformationen für Container, die von der Container-App verwendet werden |
|
secrets |
Secret[] |
Sammlung von geheimen Schlüsseln, die von einer Container-App verwendet werden |
Container
Containerdefinition der Container-App.
Name | Typ | Beschreibung |
---|---|---|
args |
string[] |
Argumente für containerstartbefehle. |
command |
string[] |
Containerstartbefehl. |
env |
Containerumgebungsvariablen. |
|
image |
string |
Containerimage-Tag. |
name |
string |
Benutzerdefinierter Containername. |
resources |
Containerressourcenanforderungen. |
ContainerApp
Container-App.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
kind |
string |
Art der Ressource. |
location |
string |
Ressourcenspeicherort. |
name |
string |
Ressourcenname. |
properties.configuration |
Nicht versionsierte Container-App-Konfigurationseigenschaften. |
|
properties.kubeEnvironmentId |
string |
Ressourcen-ID des KubeEnvironment der Container-App. |
properties.latestRevisionFqdn |
string |
Vollqualifizierter Domänenname der neuesten Revision der Container-App. |
properties.latestRevisionName |
string |
Name der neuesten Überarbeitung der Container-App. |
properties.provisioningState |
Bereitstellungsstatus der Container-App. |
|
properties.template |
Anwendungsdefinition der Container-App mit Versionsverwaltung. |
|
tags |
object |
Ressourcentags. |
type |
string |
Ressourcentyp. |
ContainerAppProvisioningState
Bereitstellungsstatus der Container-App.
Wert | Beschreibung |
---|---|
Canceled | |
Failed | |
InProgress | |
Succeeded |
ContainerResources
Container-App-Containerressourcenanforderungen.
Name | Typ | Beschreibung |
---|---|---|
cpu |
number (double) |
Erforderliche CPU in Kernen, z. B. 0,5 |
memory |
string |
Erforderlicher Arbeitsspeicher, z. B. "250Mb" |
CustomScaleRule
Benutzerdefinierte Skalierungsregel für Container-App-Container.
Name | Typ | Beschreibung |
---|---|---|
auth |
Authentifizierungsschlüssel für die benutzerdefinierte Skalierungsregel. |
|
metadata |
object |
Metadateneigenschaften zur Beschreibung einer benutzerdefinierten Skalierungsregel. |
type |
string |
Typ der benutzerdefinierten Skalierungsregel z. B.: azure-servicebus, redis usw. |
Dapr
Container-App-Dapr-Konfiguration.
Name | Typ | Beschreibung |
---|---|---|
appId |
string |
Dapr-Anwendungsbezeichner |
appPort |
integer (int32) |
Hafen, an dem der Dapr-Seitenwagen |
components |
Sammlung von Dapr-Komponenten |
|
enabled |
boolean |
Boolescher Wert, der angibt, ob das Dapr Side Car aktiviert ist |
DaprComponent
Dapr-Komponentenkonfiguration
Name | Typ | Beschreibung |
---|---|---|
metadata |
Komponentenmetadaten |
|
name |
string |
Komponentenname |
type |
string |
Komponententyp |
version |
string |
Komponentenversion |
DaprMetadata
Container-App-Dapr-Komponentenmetadaten.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Name der Metadateneigenschaft. |
secretRef |
string |
Der Name des geheimen Container-App-Schlüssels, aus dem der Metadateneigenschaftswert abgerufen werden soll. |
value |
string |
Metadateneigenschaftswert. |
DefaultErrorResponse
Fehlerantwort des App-Diensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehlermodell. |
Details
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Standardisierte Zeichenfolge, um den Fehler programmgesteuert zu identifizieren. |
message |
string |
Detaillierte Fehlerbeschreibung und Debuginformationen. |
target |
string |
Detaillierte Fehlerbeschreibung und Debuginformationen. |
EnvironmentVar
Container-App-Umgebungsvariable.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Name der Umgebungsvariable. |
secretRef |
string |
Name des geheimen Container-App-Schlüssels, aus dem der Umgebungsvariablenwert abgerufen werden soll. |
value |
string |
Nicht geheimer Umgebungsvariablenwert. |
Error
Fehlermodell.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Standardisierte Zeichenfolge, um den Fehler programmgesteuert zu identifizieren. |
details |
Details[] |
Detaillierte Fehler. |
innererror |
string |
Weitere Informationen zum Debuggen von Fehlern. |
message |
string |
Detaillierte Fehlerbeschreibung und Debuginformationen. |
target |
string |
Detaillierte Fehlerbeschreibung und Debuginformationen. |
HttpScaleRule
Benutzerdefinierte Skalierungsregel für Container-App-Container.
Name | Typ | Beschreibung |
---|---|---|
auth |
Authentifizierungsschlüssel für die benutzerdefinierte Skalierungsregel. |
|
metadata |
object |
Metadateneigenschaften zur Beschreibung der HTTP-Skalierungsregel. |
Ingress
Container-App-Eingangskonfiguration.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
allowInsecure |
boolean |
Bool, der angibt, ob HTTP-Verbindungen zulässig sind. Bei Festlegung auf falsche HTTP-Verbindungen werden automatisch zu HTTPS-Verbindungen umgeleitet. |
|
external |
boolean |
False |
Bool, der angibt, ob die App einen externen HTTP-Endpunkt verfügbar macht |
fqdn |
string |
Hostname. |
|
targetPort |
integer (int32) |
Zielport in Containern für Datenverkehr vom Ingress |
|
traffic |
Der Einer Überarbeitung zugewiesene Datenverkehrsgewicht |
||
transport |
Ingress-Transportprotokoll |
IngressTransportMethod
Ingress-Transportprotokoll
Wert | Beschreibung |
---|---|
auto | |
http | |
http2 |
QueueScaleRule
Container-App-Container Azure Queue-basierte Skalierungsregel.
Name | Typ | Beschreibung |
---|---|---|
auth |
Authentifizierungsschlüssel für die Skalierungsregel der Warteschlange. |
|
queueLength |
integer (int32) |
Warteschlangenlänge. |
queueName |
string |
Warteschlangenname. |
RegistryCredentials
Private Registrierung der Container-App
Name | Typ | Beschreibung |
---|---|---|
passwordSecretRef |
string |
Der Name des Geheimen Schlüssels, der das Registrierungsanmeldungskennwort enthält |
server |
string |
Containerregistrierungsserver |
username |
string |
Benutzername der Containerregistrierung |
Scale
Konfigurationen für die Skalierung von Container-Apps.
Name | Typ | Beschreibung |
---|---|---|
maxReplicas |
integer (int32) |
Wahlfrei. Maximale Anzahl von Containerreplikaten. Wenn nicht festgelegt, wird standardmäßig 10 festgelegt. |
minReplicas |
integer (int32) |
Wahlfrei. Mindestanzahl der Containerreplikate. |
rules |
Skalierungsregeln. |
ScaleRule
Container-App-Skalierungsregel.
Name | Typ | Beschreibung |
---|---|---|
azureQueue |
Azure Queue-basierte Skalierung. |
|
custom |
Benutzerdefinierte Skalierungsregel. |
|
http |
HTTP-Anforderungen basierende Skalierung. |
|
name |
string |
Name der Skalierungsregel |
ScaleRuleAuth
Authentifizierungsgeheimnisse für Die Skalierungsregel für Container-Apps
Name | Typ | Beschreibung |
---|---|---|
secretRef |
string |
Name des geheimen Container-App-Schlüssels, aus dem die Authentifizierungsparameter abgerufen werden sollen. |
triggerParameter |
string |
Triggerparameter, der den geheimen Schlüssel verwendet |
Secret
Geheimer Container-App-Schlüssel.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Geheimer Name. |
value |
string |
Geheimer Wert. |
Template
Anwendungsdefinition der Container-App mit Versionsverwaltung. Definiert den gewünschten Zustand einer unveränderlichen Überarbeitung. Alle Änderungen an diesem Abschnitt führen dazu, dass eine neue Überarbeitung erstellt wird.
Name | Typ | Beschreibung |
---|---|---|
containers |
Liste der Containerdefinitionen für die Container-App. |
|
dapr |
Dapr-Konfiguration für die Container-App. |
|
revisionSuffix |
string |
Benutzerfreundliches Suffix, das an den Überarbeitungsnamen angefügt wird |
scale |
Skalierungseigenschaften für die Container-App. |
TrafficWeight
Der Einer Überarbeitung zugewiesene Datenverkehrsgewicht
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
latestRevision |
boolean |
False |
Gibt an, dass die Datenverkehrsgewichtung zu einer neuesten stabilen Revision gehört. |
revisionName |
string |
Name einer Überarbeitung |
|
weight |
integer (int32) |
Der Einer Überarbeitung zugewiesene Datenverkehrsgewicht |