Freigeben über


Container Apps - Stop

Beenden einer Container-App

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}/stop?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 beendet.

202 Accepted

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

Stop Container App

Beispielanforderung

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

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