Freigeben über


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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+[^\.]$

Name der Ressourcengruppe, zu der die Ressource gehört.

subscriptionId
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

Configuration

Nicht versionsierte Container-App-Konfigurationseigenschaften.

properties.kubeEnvironmentId

string

Ressourcen-ID des KubeEnvironment der Container-App.

properties.template

Template

Anwendungsdefinition der Container-App mit Versionsverwaltung.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

ContainerApp

Für die Container-App wurde keine Änderung ausgeführt.

201 Created

ContainerApp

Die Container-App wurde erstellt oder aktualisiert.

Other Status Codes

DefaultErrorResponse

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

Configuration

Konfigurationseigenschaften der nicht versionsfreien Container-App, die die veränderbaren Einstellungen einer Container-App definieren

Container

Containerdefinition der Container-App.

ContainerApp

Container-App.

ContainerAppProvisioningState

Bereitstellungsstatus der Container-App.

ContainerResources

Container-App-Containerressourcenanforderungen.

CustomScaleRule

Benutzerdefinierte Skalierungsregel für Container-App-Container.

Dapr

Container-App-Dapr-Konfiguration.

DaprComponent

Dapr-Komponentenkonfiguration

DaprMetadata

Container-App-Dapr-Komponentenmetadaten.

DefaultErrorResponse

Fehlerantwort des App-Diensts.

Details
EnvironmentVar

Container-App-Umgebungsvariable.

Error

Fehlermodell.

HttpScaleRule

Benutzerdefinierte Skalierungsregel für Container-App-Container.

Ingress

Container-App-Eingangskonfiguration.

IngressTransportMethod

Ingress-Transportprotokoll

QueueScaleRule

Container-App-Container Azure Queue-basierte Skalierungsregel.

RegistryCredentials

Private Registrierung der Container-App

Scale

Konfigurationen für die Skalierung von Container-Apps.

ScaleRule

Container-App-Skalierungsregel.

ScaleRuleAuth

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.

TrafficWeight

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

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

Ingress

Eingangskonfigurationen.

registries

RegistryCredentials[]

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

EnvironmentVar[]

Containerumgebungsvariablen.

image

string

Containerimage-Tag.

name

string

Benutzerdefinierter Containername.

resources

ContainerResources

Containerressourcenanforderungen.

ContainerApp

Container-App.

Name Typ Beschreibung
id

string

Ressourcen-ID.

kind

string

Art der Ressource.

location

string

Ressourcenspeicherort.

name

string

Ressourcenname.

properties.configuration

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

ContainerAppProvisioningState

Bereitstellungsstatus der Container-App.

properties.template

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

ScaleRuleAuth[]

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

DaprComponent[]

Sammlung von Dapr-Komponenten

enabled

boolean

Boolescher Wert, der angibt, ob das Dapr Side Car aktiviert ist

DaprComponent

Dapr-Komponentenkonfiguration

Name Typ Beschreibung
metadata

DaprMetadata[]

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

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

ScaleRuleAuth[]

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

TrafficWeight[]

Der Einer Überarbeitung zugewiesene Datenverkehrsgewicht

transport

IngressTransportMethod

Ingress-Transportprotokoll

IngressTransportMethod

Ingress-Transportprotokoll

Wert Beschreibung
auto
http
http2

QueueScaleRule

Container-App-Container Azure Queue-basierte Skalierungsregel.

Name Typ Beschreibung
auth

ScaleRuleAuth[]

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

ScaleRule[]

Skalierungsregeln.

ScaleRule

Container-App-Skalierungsregel.

Name Typ Beschreibung
azureQueue

QueueScaleRule

Azure Queue-basierte Skalierung.

custom

CustomScaleRule

Benutzerdefinierte Skalierungsregel.

http

HttpScaleRule

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

Container[]

Liste der Containerdefinitionen für die Container-App.

dapr

Dapr

Dapr-Konfiguration für die Container-App.

revisionSuffix

string

Benutzerfreundliches Suffix, das an den Überarbeitungsnamen angefügt wird

scale

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