Delen via

az containerapp sessionpool

Note

This reference is part of the containerapp extension for the Azure CLI (version 2.62.0 or higher). De extensie installeert automatisch de eerste keer dat u een az containerapp sessionpool-opdracht uitvoert. Learn more about extensions.

Opdrachten voor het beheren van sessiegroepen.

Opdracht

Name Description Type Status
az containerapp sessionpool create

Een sessiegroep maken of bijwerken.

 Extension GA
az containerapp sessionpool delete

Een sessiegroep verwijderen.

 Extension GA
az containerapp sessionpool list

Lijst met sessiegroepen per abonnement of resourcegroep.

 Extension GA
az containerapp sessionpool show

Details van een sessiegroep weergeven.

 Extension GA
az containerapp sessionpool update

Een sessiegroep bijwerken.

 Extension GA

az containerapp sessionpool create

Een sessiegroep maken of bijwerken.

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]

Voorbeelden

Een sessiegroep maken of bijwerken met standaardinstellingen voor PythonLTS van het containertype.

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

Maak of werk een sessiegroep bij met het containertype PythonLTS, waarbij maximaal 30 gelijktijdige sessies gereed zijn voor sessie-exemplaren 20.

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

Maak of werk een sessiegroep bij met het containertype CustomContainer met standaard quickstart-installatiekopie.

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

Maak of werk een sessiegroep bij met het containertype CustomContainer met geheimen en omgevingsvariabelen.

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

Een sessiegroep maken of bijwerken met het containertype CustomContainer die afkomstig is van een privéregister

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

Een sessiegroep maken of bijwerken met het containertype CustomContainer en Managed Identity om Azure Container Registry te verifiëren

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

Maak of werk een sessiegroep bij met het containertype CustomContainer met door het systeem toegewezen en door de gebruiker toegewezen identiteit.

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

Een sessiegroep maken of bijwerken met het containertype CustomContainer met cooldownperiode 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

Vereiste parameters

--name -n

De naam van de sessiegroep.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--args

Een lijst met opstartopdrachtargumenten voor containers. Door spaties gescheiden waarden, bijvoorbeeld '-c' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

Eigenschap Waarde
Parameter group: Container Arguments
--command

Een lijst met ondersteunde opdrachten in de container die wordt uitgevoerd tijdens het opstarten. Door spaties gescheiden waarden, bijvoorbeeld '/bin/queue' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

Eigenschap Waarde
Parameter group: Container Arguments
--container-name

Naam van de container. Bij het maken als er geen containernaam is opgegeven, wordt de containernaam standaard ingesteld op de naam van de sessiegroep die wordt bedekt met kleine letters.

Eigenschap Waarde
Parameter group: Container Arguments
--container-type

Het groepstype van de sessiegroep, default='PythonLTS'.

Eigenschap Waarde
Parameter group: Configuration Arguments
Geaccepteerde waarden: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Periode (in seconden), waarna de sessie wordt verwijderd, standaard=300.

Eigenschap Waarde
Parameter group: Configuration Arguments
--cpu

Vereiste CPU in kernen van 0,25 - 2.0, bijvoorbeeld 0,5.

Eigenschap Waarde
Parameter group: Container Arguments
--env-vars

Een lijst met omgevingsvariabelen voor de container. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen. Voorvoegselwaarde met 'secretref:' om te verwijzen naar een geheim.

Eigenschap Waarde
Parameter group: Container Arguments
--environment

Naam of resource-id van de omgeving van de container-app.

Eigenschap Waarde
Parameter group: Container Arguments
--image -i

Containerinstallatiekopieën, bijvoorbeeld publisher/image-name:tag.

Eigenschap Waarde
Parameter group: Container Arguments
--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--max-sessions

Het maximum aantal sessies kan tegelijkertijd worden uitgevoerd.

Eigenschap Waarde
Parameter group: Scale Arguments
--memory

Vereist geheugen van 0,5 - 4,0 eindigend op "Gi", bijvoorbeeld 1.0Gi.

Eigenschap Waarde
Parameter group: Container Arguments
--mi-system-assigned

Booleaanse waarde die aangeeft of een door het systeem toegewezen identiteit moet worden toegewezen.

Eigenschap Waarde
Default value: False
--mi-user-assigned

Door ruimte gescheiden gebruikersidentiteiten die moeten worden toegewezen.

--network-status

Uitgaand verkeer is ingeschakeld voor de sessies of niet.

Eigenschap Waarde
Parameter group: Configuration Arguments
Geaccepteerde waarden: EgressDisabled, EgressEnabled
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap Waarde
Default value: False
--ready-sessions

Het aantal sessies dat altijd gereed is in de sessiegroep.

Eigenschap Waarde
Parameter group: Scale Arguments
--registry-identity

De beheerde identiteit waarmee moet worden geverifieerd bij Azure Container Registry (in plaats van gebruikersnaam/wachtwoord). Gebruik 'systeem' voor een door het systeem toegewezen identiteit, gebruik een resource-id voor een door de gebruiker toegewezen identiteit. De beheerde identiteit moet zijn toegewezen aan acrpull-machtigingen voor de ACR vóór de implementatie (gebruik 'az role assignment create --role acrpull ...').

Eigenschap Waarde
Parameter group: Registry Arguments
--registry-password

Het wachtwoord om u aan te melden bij het containerregister. Als deze is opgeslagen als geheim, moet de waarde beginnen met 'secretref:', gevolgd door de geheime naam.

Eigenschap Waarde
Parameter group: Registry Arguments
--registry-server

De hostnaam van de containerregisterserver, bijvoorbeeld myregistry.azurecr.io.

Eigenschap Waarde
Parameter group: Registry Arguments
--registry-username

De gebruikersnaam om u aan te melden bij het containerregister.

Eigenschap Waarde
Parameter group: Registry Arguments
--secrets -s

Een lijst met geheimen voor de sessiegroep. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen.

Eigenschap Waarde
Parameter group: Configuration Arguments
--target-port

De sessiepoort die wordt gebruikt voor inkomend verkeer.

Eigenschap Waarde
Parameter group: Container Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az containerapp sessionpool delete

Een sessiegroep verwijderen.

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

Voorbeelden

Een sessiegroep verwijderen.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Vereiste parameters

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--name -n

De naam van de sessiegroep.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap Waarde
Default value: False
--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--yes -y

Niet vragen om bevestiging.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az containerapp sessionpool list

Lijst met sessiegroepen per abonnement of resourcegroep.

az containerapp sessionpool list [--resource-group]

Voorbeelden

Lijst met sessiegroepen in het huidige abonnement.

az containerapp sessionpool list

Lijst met sessiegroepen per resourcegroep.

az containerapp sessionpool list -g MyResourceGroup

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az containerapp sessionpool show

Details van een sessiegroep weergeven.

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

Voorbeelden

De details van een sessiegroep weergeven.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Vereiste parameters

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--name -n

De naam van de sessiegroep.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap Waarde
Parameter group: Resource Id Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az containerapp sessionpool update

Een sessiegroep bijwerken.

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

Voorbeelden

Werk de maximale configuratie en installatiekopieën van een sessiegroep bij.

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

Vereiste parameters

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--args

Een lijst met opstartopdrachtargumenten voor containers. Door spaties gescheiden waarden, bijvoorbeeld '-c' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

Eigenschap Waarde
Parameter group: Container Arguments
--command

Een lijst met ondersteunde opdrachten in de container die wordt uitgevoerd tijdens het opstarten. Door spaties gescheiden waarden, bijvoorbeeld '/bin/queue' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

Eigenschap Waarde
Parameter group: Container Arguments
--container-name

Naam van de container. Bij het maken als er geen containernaam is opgegeven, wordt de containernaam standaard ingesteld op de naam van de sessiegroep die wordt bedekt met kleine letters.

Eigenschap Waarde
Parameter group: Container Arguments
--cooldown-period

Periode (in seconden), waarna de sessie wordt verwijderd, standaard=300.

Eigenschap Waarde
Parameter group: Configuration Arguments
--cpu

Vereiste CPU in kernen van 0,25 - 2.0, bijvoorbeeld 0,5.

Eigenschap Waarde
Parameter group: Container Arguments
--env-vars

Een lijst met omgevingsvariabelen voor de container. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen. Voorvoegselwaarde met 'secretref:' om te verwijzen naar een geheim.

Eigenschap Waarde
Parameter group: Container Arguments
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--image -i

Containerinstallatiekopieën, bijvoorbeeld publisher/image-name:tag.

Eigenschap Waarde
Parameter group: Container Arguments
--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--max-sessions

Het maximum aantal sessies kan tegelijkertijd worden uitgevoerd.

Eigenschap Waarde
Parameter group: Scale Arguments
--memory

Vereist geheugen van 0,5 - 4,0 eindigend op "Gi", bijvoorbeeld 1.0Gi.

Eigenschap Waarde
Parameter group: Container Arguments
--mi-system-assigned

Booleaanse waarde die aangeeft of een door het systeem toegewezen identiteit moet worden toegewezen.

Eigenschap Waarde
Default value: False
--mi-user-assigned

Door ruimte gescheiden gebruikersidentiteiten die moeten worden toegewezen.

--name -n

De naam van de sessiegroep.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--network-status

Uitgaand verkeer is ingeschakeld voor de sessies of niet.

Eigenschap Waarde
Parameter group: Configuration Arguments
Geaccepteerde waarden: EgressDisabled, EgressEnabled
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap Waarde
Default value: False
--ready-sessions

Het aantal sessies dat altijd gereed is in de sessiegroep.

Eigenschap Waarde
Parameter group: Scale Arguments
--registry-identity

De beheerde identiteit waarmee moet worden geverifieerd bij Azure Container Registry (in plaats van gebruikersnaam/wachtwoord). Gebruik 'systeem' voor een door het systeem toegewezen identiteit, gebruik een resource-id voor een door de gebruiker toegewezen identiteit. De beheerde identiteit moet zijn toegewezen aan acrpull-machtigingen voor de ACR vóór de implementatie (gebruik 'az role assignment create --role acrpull ...').

Eigenschap Waarde
Parameter group: Registry Arguments
--registry-password

Het wachtwoord om u aan te melden bij het containerregister. Als deze is opgeslagen als geheim, moet de waarde beginnen met 'secretref:', gevolgd door de geheime naam.

Eigenschap Waarde
Parameter group: Registry Arguments
--registry-server

De hostnaam van de containerregisterserver, bijvoorbeeld myregistry.azurecr.io.

Eigenschap Waarde
Parameter group: Registry Arguments
--registry-username

De gebruikersnaam om u aan te melden bij het containerregister.

Eigenschap Waarde
Parameter group: Registry Arguments
--secrets -s

Een lijst met geheimen voor de sessiegroep. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen.

Eigenschap Waarde
Parameter group: Configuration Arguments
--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap Waarde
Parameter group: Resource Id Arguments
--target-port

De sessiepoort die wordt gebruikt voor inkomend verkeer.

Eigenschap Waarde
Parameter group: Container Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False