Freigeben über

az containerapp sessionpool

  • Vorschau
  • Referenz

Hinweis

Diese Referenz ist Teil der Containerapp-Erweiterung für die Azure CLI (Version 2.62.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az containerapp sessionpool-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Befehle zum Verwalten von Sitzungspools.

Befehle

Name Beschreibung Typ Status
az containerapp sessionpool create

Erstellen oder Aktualisieren eines Sitzungspools.

 Erweiterung Vorschau
az containerapp sessionpool delete

Löschen eines Sitzungspools.

 Erweiterung Vorschau
az containerapp sessionpool list

Sitzungspools nach Abonnement oder Ressourcengruppe auflisten.

 Erweiterung Vorschau
az containerapp sessionpool show

Details eines Sitzungspools anzeigen.

 Erweiterung Vorschau
az containerapp sessionpool update

Aktualisieren eines Sitzungspools.

 Erweiterung Vorschau

az containerapp sessionpool create

Vorschau

Die Befehlsgruppe "containerapp sessionpool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen oder Aktualisieren eines Sitzungspools.

az containerapp sessionpool create --name
                                   --resource-group
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--container-type {CustomContainer, NodeLTS, PythonLTS}]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--environment]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-identity]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--target-port]

Beispiele

Erstellen oder Aktualisieren eines Sitzungspools mit den Standardeinstellungen des Containertyps PythonLTS.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --location eastasia

Erstellen oder Aktualisieren eines Sitzungspools mit Containertyp PythonLTS, wobei max. gleichzeitige Sitzungen 30, bereite Sitzungsinstanzen 20 sind.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type PythonLTS --max-sessions 30 --ready-sessions 20 \
    --location eastasia

Erstellen oder Aktualisieren eines Sitzungspools mit containertyp CustomContainer mit Standardschnellstartimage.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --location eastasia --image mcr.microsoft.com/k8se/quickstart:latest

Erstellen oder Aktualisieren eines Sitzungspools mit containertyp CustomContainer mit geheimen Schlüsseln und Umgebungsvariablen.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --image MyImage \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" --location eastasia

Erstellen oder Aktualisieren eines Sitzungspools mit containertyp CustomContainer, der aus der privaten Registrierung stammt

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --location eastasia

Erstellen oder Aktualisieren eines Sitzungspools mit Containertyp CustomContainer und managed Identity zum Authentifizieren der Azure-Containerregistrierung

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-identity  MyUserIdentityResourceId \
    --location eastasia

Erstellen oder Aktualisieren eines Sitzungspools mit containertyp CustomContainer mit system zugewiesener und benutzer zugewiesener Identität.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 \
    --mi-system-assigned --mi-user-assigned MyUserIdentityResourceId \
    --location eastasia

Erstellen oder Aktualisieren eines Sitzungspools mit Containertyp CustomContainer mit Cooldownzeitraum 360s

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --environment MyEnvironment --cpu 0.5 --memory 1Gi --target-port 80 --container-type CustomContainer \
    --cooldown-period 360 --location eastasia

Erforderliche Parameter

--name -n

Der Name des Sitzungspools.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--args

Eine Liste der Argumente des Containerstartbefehls. Durch Leerzeichen getrennte Werte, z. B. "-c" "mycommand". Leere Zeichenfolge zum Löschen vorhandener Werte.

--command

Eine Liste der unterstützten Befehle für den Container, der während des Starts ausgeführt wird. Durch Leerzeichen getrennte Werte, z. B. "/bin/queue" "mycommand". Leere Zeichenfolge zum Löschen vorhandener Werte.

--container-name

Der Name des Containers Beim Erstellen, wenn kein Containername angegeben wird, wird der Containername standardmäßig auf den Namen des Sitzungspools festgelegt, der in Kleinbuchstaben abgedeckt ist.

--container-type

Der Pooltyp des Sitzungspools, default='PythonLTS'.

Zulässige Werte: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Zeitraum (in Sekunden), nach dem die Sitzung gelöscht wird, default=300.

--cpu

Erforderliche CPU in Kernen von 0,25 - 2,0, z. B. 0,5.

--env-vars

Eine Liste der Umgebungsvariablen für den Container. Leerzeichentrennte Werte im Format "key=value". Leere Zeichenfolge zum Löschen vorhandener Werte. Präfixwert mit "secretref:", um auf einen geheimen Schlüssel zu verweisen.

--environment

Name oder Ressourcen-ID der Umgebung der Container-App.

--image -i

Containerimage, z. B. Publisher/image-name:tag.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--max-sessions

Die maximale Anzahl von Sitzungen kann gleichzeitig ausgeführt werden.

--memory

Erforderlicher Speicher von 0,5 - 4.0 endet mit "Gi", z. B. 1.0Gi.

--mi-system-assigned

Boolescher Wert, der angibt, ob die vom System zugewiesene Identität zugewiesen werden soll.

Standardwert: False
--mi-user-assigned

Zugewiesene, durch Leerzeichen getrennte Benutzeridentitäten.

--network-status

Der Ausgang ist für die Sitzungen aktiviert oder nicht.

Zulässige Werte: EgressDisabled, EgressEnabled
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--ready-sessions

Die Anzahl der Sitzungen, die immer im Sitzungspool bereit sind.

--registry-identity

Die verwaltete Identität, mit der die Authentifizierung bei der Azure-Containerregistrierung erfolgen soll (anstelle von Benutzername/Kennwort). Verwenden Sie "System" für eine vom System zugewiesene Identität, und verwenden Sie eine Ressourcen-ID für eine vom Benutzer zugewiesene Identität. Die verwaltete Identität sollte vor der Bereitstellung acrpull-Berechtigungen für die ACR zugewiesen worden sein (verwenden Sie "az role assignment create --role acrpull ...").

--registry-password

Das Kennwort zum Anmelden bei der Containerregistrierung. Wenn er als geheimer Schlüssel gespeichert ist, muss der Wert mit "secretref:" beginnen, gefolgt vom geheimen Namen.

--registry-server

Der Hostname des Containerregistrierungsservers, z. B. myregistry.azurecr.io.

--registry-username

Der Benutzername, der sich bei der Containerregistrierung anmeldet.

--secrets -s

Eine Liste der geheimen Schlüssel für den Sitzungspool. Leerzeichentrennte Werte im Format "key=value". Leere Zeichenfolge zum Löschen vorhandener Werte.

--target-port

Der Sitzungsport, der für eingehenden Datenverkehr verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az containerapp sessionpool delete

Vorschau

Die Befehlsgruppe "containerapp sessionpool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen eines Sitzungspools.

az containerapp sessionpool delete --resource-group
                                   [--ids]
                                   [--name]
                                   [--no-wait]
                                   [--subscription]
                                   [--yes]

Beispiele

Löschen eines Sitzungspools.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name -n

Der Name des Sitzungspools.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az containerapp sessionpool list

Vorschau

Die Befehlsgruppe "containerapp sessionpool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Sitzungspools nach Abonnement oder Ressourcengruppe auflisten.

az containerapp sessionpool list [--resource-group]

Beispiele

Sitzungspools im aktuellen Abonnement auflisten.

az containerapp sessionpool list

Sitzungspools nach Ressourcengruppe auflisten.

az containerapp sessionpool list -g MyResourceGroup

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az containerapp sessionpool show

Vorschau

Die Befehlsgruppe "containerapp sessionpool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Details eines Sitzungspools anzeigen.

az containerapp sessionpool show --resource-group
                                 [--ids]
                                 [--name]
                                 [--subscription]

Beispiele

Zeigen Sie die Details eines Sitzungspools an.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name -n

Der Name des Sitzungspools.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az containerapp sessionpool update

Vorschau

Die Befehlsgruppe "containerapp sessionpool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren eines Sitzungspools.

az containerapp sessionpool update --resource-group
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--ids]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--name]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--subscription]
                                   [--target-port]

Beispiele

Aktualisieren der maximalen Konfiguration und des Images für gleichzeitige Sitzungen eines Sitzungspools.

az containerapp sessionpool update -n mysessionpool -g MyResourceGroup --max-sessions 20 --image MyNewImage

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--args

Eine Liste der Argumente des Containerstartbefehls. Durch Leerzeichen getrennte Werte, z. B. "-c" "mycommand". Leere Zeichenfolge zum Löschen vorhandener Werte.

--command

Eine Liste der unterstützten Befehle für den Container, der während des Starts ausgeführt wird. Durch Leerzeichen getrennte Werte, z. B. "/bin/queue" "mycommand". Leere Zeichenfolge zum Löschen vorhandener Werte.

--container-name

Der Name des Containers Beim Erstellen, wenn kein Containername angegeben wird, wird der Containername standardmäßig auf den Namen des Sitzungspools festgelegt, der in Kleinbuchstaben abgedeckt ist.

--cooldown-period

Zeitraum (in Sekunden), nach dem die Sitzung gelöscht wird, default=300.

--cpu

Erforderliche CPU in Kernen von 0,25 - 2,0, z. B. 0,5.

--env-vars

Eine Liste der Umgebungsvariablen für den Container. Leerzeichentrennte Werte im Format "key=value". Leere Zeichenfolge zum Löschen vorhandener Werte. Präfixwert mit "secretref:", um auf einen geheimen Schlüssel zu verweisen.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--image -i

Containerimage, z. B. Publisher/image-name:tag.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--max-sessions

Die maximale Anzahl von Sitzungen kann gleichzeitig ausgeführt werden.

--memory

Erforderlicher Speicher von 0,5 - 4.0 endet mit "Gi", z. B. 1.0Gi.

--name -n

Der Name des Sitzungspools.

--network-status

Der Ausgang ist für die Sitzungen aktiviert oder nicht.

Zulässige Werte: EgressDisabled, EgressEnabled
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--ready-sessions

Die Anzahl der Sitzungen, die immer im Sitzungspool bereit sind.

--registry-password

Das Kennwort zum Anmelden bei der Containerregistrierung. Wenn er als geheimer Schlüssel gespeichert ist, muss der Wert mit "secretref:" beginnen, gefolgt vom geheimen Namen.

--registry-server

Der Hostname des Containerregistrierungsservers, z. B. myregistry.azurecr.io.

--registry-username

Der Benutzername, der sich bei der Containerregistrierung anmeldet.

--secrets -s

Eine Liste der geheimen Schlüssel für den Sitzungspool. Leerzeichentrennte Werte im Format "key=value". Leere Zeichenfolge zum Löschen vorhandener Werte.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--target-port

Der Sitzungsport, der für eingehenden Datenverkehr verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.