Share via

az devcenter dev environment

  • Reference

Note

This reference is part of the devcenter extension for the Azure CLI (version 2.51.0 or higher). The extension will automatically install the first time you run an az devcenter dev environment command. Learn more about extensions.

Manage environments.

Commands

Name Description Type Status
az devcenter dev environment create

Create an environment.

 Extension GA
az devcenter dev environment delay-action

Delay an environment action.

 Extension GA
az devcenter dev environment delete

Delete an environment and all its associated resources.

 Extension GA
az devcenter dev environment deploy

Update an environment.

 Extension GA
az devcenter dev environment list

List the environments for a project or list the environments for a user within a project.

 Extension GA
az devcenter dev environment list-action

List specific environment actions.

 Extension GA
az devcenter dev environment list-operation

Lists operations on the environment which have occurred within the past 90 days.

 Extension GA
az devcenter dev environment show

Get an environment.

 Extension GA
az devcenter dev environment show-action

Retrieve a specific environment action.

 Extension GA
az devcenter dev environment show-logs-by-operation

Gets the logs for an operation on an environment.

 Extension GA
az devcenter dev environment show-operation

Gets an environment action result.

 Extension GA
az devcenter dev environment show-outputs

Gets outputs from the environment.

 Extension GA
az devcenter dev environment skip-action

Skip a specific environment action.

 Extension GA
az devcenter dev environment update

Update an environment.

 Extension GA
az devcenter dev environment update-expiration-date

Update the environment expiration.

 Extension GA

az devcenter dev environment create

Create an environment.

az devcenter dev environment create --catalog-name
                                    --environment-definition-name
                                    --environment-name
                                    --environment-type
                                    --project
                                    [--dev-center]
                                    [--endpoint]
                                    [--expiration]
                                    [--no-wait]
                                    [--parameters]
                                    [--user-id]

Examples

Create using dev center

az devcenter dev environment create --dev-center-name "ContosoDevCenter" --project-name "DevProject" --catalog-name "main" --environment-definition-name "helloworld" --environment-type "DevTest" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000"

Create using endpoint

az devcenter dev environment create --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --catalog-name "main" --environment-definition-name "helloworld" --environment-type "DevTest" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--catalog-name

Name of the catalog.

--environment-definition-name -e

Name of the environment definition.

--environment-name --name -n

The name of the environment.

--environment-type

Environment type.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--expiration --expiration-date

The time the expiration date will be triggered (UTC), after which the environment and associated resources will be deleted. The string format is ISO format.

--no-wait

Do not wait for the long-running operation to finish.

Default value: False
--parameters

Parameters object for the environment. Expected value: json-string/json-file/@json-file.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment delay-action

Delay an environment action.

az devcenter dev environment delay-action --action-name
                                          --delay-time
                                          --environment-name
                                          --project
                                          [--dev-center]
                                          [--endpoint]
                                          [--user-id]

Examples

Delay using endpoint

az devcenter dev environment delay-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete" --delay-time "04:30"

Required Parameters

--action-name

The name of an action that will take place on an environment.

--delay-time

The delayed timespan from the scheduled action time. Format HH:MM.

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment delete

Delete an environment and all its associated resources.

az devcenter dev environment delete --environment-name
                                    --project
                                    [--dev-center]
                                    [--endpoint]
                                    [--force {false, true}]
                                    [--no-wait]
                                    [--user-id]
                                    [--yes]

Examples

Delete using dev center

az devcenter dev environment delete --dev-center-name "ContosoDevCenter"  --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Delete using endpoint

az devcenter dev environment delete --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--force

Optional to force environment deletion even if the environment definition does not exist. This is a best-effort delete, and anything custom that forces resource creation beyond the associated resource group may not be deleted.

Accepted values: false, true
--no-wait

Do not wait for the long-running operation to finish.

Default value: False
--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
--yes -y

Do not prompt for confirmation.

Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment deploy

Update an environment.

az devcenter dev environment deploy --environment-name
                                    --project
                                    [--dev-center]
                                    [--endpoint]
                                    [--expiration]
                                    [--no-wait]
                                    [--parameters]
                                    [--user-id]

Examples

Update using dev center

az devcenter dev environment deploy --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Update using endpoint

az devcenter dev environment deploy --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--expiration --expiration-date

The date of environment expiration. Must be an ISO string.

--no-wait

Do not wait for the long-running operation to finish.

Default value: False
--parameters

Parameters object for the environment. Expected value: json-string/json-file/@json-file.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment list

List the environments for a project or list the environments for a user within a project.

az devcenter dev environment list --project
                                  [--dev-center]
                                  [--endpoint]
                                  [--user-id]

Examples

List by project using dev center

az devcenter dev environment list --dev-center-name "ContosoDevCenter" --project-name "DevProject"

List by project using endpoint

az devcenter dev environment list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject"

List by user and project using dev center

az devcenter dev environment list --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

List by user and project using endpoint

az devcenter dev environment list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment list-action

List specific environment actions.

az devcenter dev environment list-action --environment-name
                                         --project
                                         [--dev-center]
                                         [--endpoint]
                                         [--user-id]

Examples

List using endpoint

az devcenter dev environment list-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment list-operation

Lists operations on the environment which have occurred within the past 90 days.

az devcenter dev environment list-operation --environment-name
                                            --project
                                            [--dev-center]
                                            [--endpoint]
                                            [--user-id]

Examples

List using endpoint

az devcenter dev environment list-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment show

Get an environment.

az devcenter dev environment show --environment-name
                                  --project
                                  [--dev-center]
                                  [--endpoint]
                                  [--user-id]

Examples

Get using endpoint

az devcenter dev environment show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment show-action

Retrieve a specific environment action.

az devcenter dev environment show-action --action-name
                                         --environment-name
                                         --project
                                         [--dev-center]
                                         [--endpoint]
                                         [--user-id]

Examples

Get using endpoint

az devcenter dev environment show-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete"

Required Parameters

--action-name

The name of an action that will take place on an environment.

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment show-logs-by-operation

Gets the logs for an operation on an environment.

az devcenter dev environment show-logs-by-operation --environment-name
                                                    --operation-id
                                                    --project
                                                    [--dev-center]
                                                    [--endpoint]
                                                    [--user-id]

Examples

Get using endpoint

az devcenter dev environment show-logs-by-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Required Parameters

--environment-name --name -n

The name of the environment.

--operation-id

The ID of the operation.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment show-operation

Gets an environment action result.

az devcenter dev environment show-operation --environment-name
                                            --operation-id
                                            --project
                                            [--dev-center]
                                            [--endpoint]
                                            [--user-id]

Examples

Get using endpoint

az devcenter dev environment show-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Required Parameters

--environment-name --name -n

The name of the environment.

--operation-id

The ID of the operation.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment show-outputs

Gets outputs from the environment.

az devcenter dev environment show-outputs --environment-name
                                          --project
                                          [--dev-center]
                                          [--endpoint]
                                          [--user-id]

Examples

Get using endpoint

az devcenter dev environment show-outputs --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment skip-action

Skip a specific environment action.

az devcenter dev environment skip-action --action-name
                                         --environment-name
                                         --project
                                         [--dev-center]
                                         [--endpoint]
                                         [--user-id]

Examples

Skip using endpoint

az devcenter dev environment skip-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete"

Required Parameters

--action-name

The name of an action that will take place on an environment.

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment update

Update an environment.

az devcenter dev environment update --environment-name
                                    --project
                                    [--dev-center]
                                    [--endpoint]
                                    [--expiration]
                                    [--no-wait]
                                    [--parameters]
                                    [--user-id]

Examples

Update using dev center

az devcenter dev environment update --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Update using endpoint

az devcenter dev environment update --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--expiration --expiration-date

The date of environment expiration. Must be an ISO string.

--no-wait

Do not wait for the long-running operation to finish.

Default value: False
--parameters

Parameters object for the environment. Expected value: json-string/json-file/@json-file.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devcenter dev environment update-expiration-date

Update the environment expiration.

az devcenter dev environment update-expiration-date --environment-name
                                                    --project
                                                    [--dev-center]
                                                    [--endpoint]
                                                    [--expiration]
                                                    [--user-id]

Examples

Get using endpoint

az devcenter dev environment update-expiration-date --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2025-11-30T22:35:00+00:00"

Required Parameters

--environment-name --name -n

The name of the environment.

--project --project-name

The name of the project. Use az configure -d project=<project_name> to configure a default.

Optional Parameters

--dev-center --dev-center-name -d

The name of the dev center. Use az configure -d dev-center=<dev_center_name> to configure a default.

--endpoint

The API endpoint for the developer resources. Use az configure -d endpoint=<endpoint_uri> to configure a default.

--expiration --expiration-date

The time the expiration date will be triggered (UTC), after which the environment and associated resources will be deleted. The string format is ISO format.

--user-id

The AAD object id of the user. If value is 'me', the identity is taken from the authentication context.

Default value: me
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.