Azure Machine Learning CLI (v2) release notes
APPLIES TO: Azure CLI ml extension v2 (current)
In this article, learn about Azure Machine Learning CLI (v2) releases.
RSS feed: Get notified when this page is updated by copying and pasting the following URL into your feed reader:
https://learn.microsoft.com/api/search/rss?search=%22Azure+machine+learning+release+notes-v2%22&locale=en-us
2024-09-18
Azure Machine Learning CLI (v2) v2.30.0
az ml workspace outbound-rule set
- Added support of Optional
--fqdns
property for private_endpoint outbound rule creation in a workspace managed network. Related to support of Application Gateway PE target. - Added support of Optional
--address-prefixes
property for service_tag outbound rule creation in workspace managed network.
- Added support of Optional
2024-08-14
Azure Machine Learning CLI (v2) v2.29.0
az ml compute enable-sso
- Added enable-sso to allow user to enable sso setting of a compute instance without any write permission set on compute.
2024-06-21
Azure Machine Learning CLI (v2) v2.27.0
az ml workspace create --system-datastores-auth-mode
- Added
--system-datastores-auth-mode
to create for AzureML workspace.
- Added
az ml workspace update --system-datastores-auth-mode
- Added
--system-datastores-auth-mode
to update for AzureML workspace.
- Added
az ml workspace create --allow-roleassignment-on-rg
- Added
--allow-roleassignment-on-rg
to create for AzureML workspace with allow/disallow role assignment on RG level.
- Added
az ml workspace update --allow-roleassignment-on-rg
- Added
--allow-roleassignment-on-rg
to update for AzureML workspace with allow/disallow role assignment on RG level.
- Added
2023-10-18
Azure Machine Learning CLI (v2) v2.21.1
- pydash dependency version was upgraded to >=6.0.0 to patch security vulnerability in versions below 6.0.0
2023-09-11
Azure Machine Learning CLI (v2) v2.20.0
az ml feature-store provision-network
- [Public review] Added this command to allow user to provision managed network for feature store
az ml feature-store create
- Added
--not-grant-permissions
to allow user to not grant materialization identity access to feature store
- Added
az ml feature-store update
- Added
--not-grant-permissions
to allow user to not grant materialization identity access to feature store
- Added
az ml feature-set
- Added
--feature-store-name
and deprecated--workspace-name
, backward compatiblity will be removed in 6 month
- Added
az ml feature-store-entity
- Added
--feature-store-name
and deprecated--workspace-name
, backward compatiblity will be removed in 6 months
- Added
az configure
- Added
--defaults feature-store=<name>
to allow user to configure default feature store
- Added
az ml job connect-ssh
- Added
--ssh-args/-c
to allow specifying additional ssh options + commands, eg to send signals to running processes or to attach to an interactive terminal
- Added
2023-05-09
Azure Machine Learning CLI (v2) v2.17.0
az ml online-deployment create
- Added
--local-enable-gpu
to allow gpu access to local deployment.
- Added
az ml online-deployment update
- Added
--local-enable-gpu
to allow gpu access to local deployment.
- Added
2023-05-01
Azure Machine Learning CLI (v2) v2.16.0
az ml job connect-ssh
- This command is marked as GA.
az ml job show-services
- This command is marked as GA.
az ml model download
- Fixed issue where, when downloading a model from a registry via the
--registry-name
argument,workspace_name
was mandatory.
- Fixed issue where, when downloading a model from a registry via the
az ml model create
- Add
--stage(-s)
flag to add the stage of the model.
- Add
az ml model update
- Add
--stage(-s)
flag to update the stage of the model.
- Add
az ml model list
- Add
--stage(-s)
flag to list by the stage of the model.
- Add
az ml workspace delete
- Add
--purge(-p)
flag to force to purge instead of soft delete.
- Add
az ml workspace create
- Add
--enable-data-isolation(-e)
flag to determine if a workspace has data isolation enabled.
- Add
2023-03-21
Azure Machine Learning CLI (v2) v2.15.0
az ml compute
- Added
--tags
to create and update for Azure Machine Learning compute.
- Added
az ml data import
- Support create a data asset version by first importing data from database and file_system to Azure cloud storage.
az ml data list-materialization-status
- Support list status of data import materialization jobs that create data asset versions of <asset_name> via
--name
argument.
- Support list status of data import materialization jobs that create data asset versions of <asset_name> via
az ml online-deployment update
- Added
--skip-script-validation
to create for Azure Machine Learning online deployment.
- Added
az ml workspace provision-network
- Support to provision managed network for workspace
2023-02-03
Azure Machine Learning CLI (v2) v2.14.0
az ml compute
- Added
--location
to create for Azure Machine Learning compute. - Added
--enable-node-public-ip
to create for Compute.
- Added
az ml data
- Minor edits to help text
az ml data list
- Added support for listing data assets in a registry via the
--registry-name
argument
- Added support for listing data assets in a registry via the
az ml data show
- Added support for showing a data asset in a registry via the
--registry-name
argument
- Added support for showing a data asset in a registry via the
az ml data create
- Added support for creating a data asset in a registry via the
--registry-name
argument - Added support for promoting a data asset from a workspace to a registry
- Added support for creating a data asset in a registry via the
az ml workspace create
- Added support for creating a workspace with a managed network with
--managed-network
argument
- Added support for creating a workspace with a managed network with
az ml workspace update
- Added support for updating a workspace with a managed network with
--managed-network
argument
- Added support for updating a workspace with a managed network with
az ml compute connect-ssh
- Added support for connecting to a compute instance via SSH
az ml workspace outbound-rule
- Added support for listing a managed network's outbound rules for a workspace
az ml workspace outbound-rule list
- Added support for showing a managed network's outbound rules for a workspace
az ml workspace outbound-rule show
- Added support for removing a managed network's outbound rules for a workspace
az ml workspace outbound-rule remove
- Added support for creating or updating a managed network's outbound rules for a workspace
az ml workspace outbound-rule set
- Added support for listing a managed network's outbound rules for a workspace
2022-12-06
Azure Machine Learning CLI (v2) v2.12.0
- Improved error message for
az ml
commands that are registry enabled, when neither workspace nor registry name is passed. az ml compute
- Fixed issue caused by no-wait parameter.
2022-11-08
Azure Machine Learning CLI (v2) v2.11.0
- The CLI is depending on azure-ai-ml 1.1.0.
az ml registry
- Added
ml registry delete
command. - Adjusted registry experimental tags and imports to avoid warning printouts for unrelated operations.
- Added
az ml environment
- Prevented registering an already existing environment that references conda file.
2022-10-10
Azure Machine Learning CLI (v2) v2.10.0
- The CLI is depending on GA version of azure-ai-ml.
- Dropped support for Python 3.6.
az ml registry
- New command group added to manage ML asset registries.
az ml job
- Added
az ml job show-services
command. - Added model sweeping and hyperparameter tuning to AutoML NLP jobs.
- Added
az ml schedule
- Added
month_days
property in recurrence schedule.
- Added
az ml compute
- Added custom setup scripts support for compute instances.
2022-09-22
Azure Machine Learning CLI (v2) v2.8.0
az ml job
- Added spark job support.
- Added shm_size and docker_args to job.
az ml compute
- Compute instance supports managed identity.
- Added idle shutdown time support for compute instance.
az ml online-deployment
- Added support for data collection for eventhub and data storage.
- Added syntax validation for scoring script.
az ml batch-deployment
- Added syntax validation for scoring script.
2022-08-10
Azure Machine Learning CLI (v2) v2.7.0
az ml component
- Added AutoML component.
az ml dataset
- Deprecated command group (Use
az ml data
instead).
- Deprecated command group (Use
2022-07-16
Azure Machine Learning CLI (v2) v2.6.0
- Added MoonCake cloud support.
az ml job
- Allow Git repo URLs to be used as code.
- AutoML jobs use the same input schema as other job types.
- Pipeline jobs now support registry assets.
az ml component
- Allow Git repo URLs to be used as code.
az ml online-endpoint
- MIR now supports registry assets.
2022-05-24
Azure Machine Learning CLI (v2) v2.4.0
- The Azure Machine Learning CLI (v2) is now GA.
az ml job
- The command group is marked as GA.
- Added AutoML job type in public preview.
- Added
schedules
property to pipeline job in public preview. - Added an option to list only archived jobs.
- Improved reliability of
az ml job download
command.
az ml data
- The command group is marked as GA.
- Added MLTable data type in public preview.
- Added an option to list only archived data assets.
az ml environment
- Added an option to list only archived environments.
az ml model
- The command group is marked as GA.
- Allow models to be created from job outputs.
- Added an option to list only archived models.
az ml online-deployment
- The command group is marked as GA.
- Removed timeout waiting for deployment creation.
- Improved online deployment list view.
az ml online-endpoint
- The command group is marked as GA.
- Added
mirror_traffic
property to online endpoints in public preview. - Improved online endpoint list view.
az ml batch-deployment
- The command group is marked as GA.
- Added support for
uri_file
anduri_folder
as invocation input. - Fixed a bug in batch deployment update.
- Fixed a bug in batch deployment list-jobs output.
az ml batch-endpoint
- The command group is marked as GA.
- Added support for
uri_file
anduri_folder
as invocation input. - Fixed a bug in batch endpoint update.
- Fixed a bug in batch endpoint list-jobs output.
az ml component
- The command group is marked as GA.
- Added an option to list only archived components.
az ml code
- This command group is removed.
2022-03-14
Azure Machine Learning CLI (v2) v2.2.1
az ml job
- For all job types, flattened the
code
section of the YAML schema. Instead ofcode.local_path
to specify the path to the source code directory, it's now justcode
- For all job types, changed the schema for defining data inputs to the job in the job YAML. Instead of specifying the data path using either the
file
orfolder
fields, use thepath
field to specify either a local path, a URI to a cloud path containing the data, or a reference to an existing registered Azure Machine Learning data asset viapath: azureml:<data_name>:<data_version>
. Also specify thetype
field to clarify whether the data source is a single file (uri_file
) or a folder (uri_folder
). Iftype
field is omitted, it defaults totype: uri_folder
. For more information, see the section of any of the job YAML references that discuss the schema for specifying input data. - In the sweep job YAML schema, changed the
sampling_algorithm
field from a string to an object in order to support more configurations for the random sampling algorithm type - Removed the component job YAML schema. With this release, if you want to run a command job inside a pipeline that uses a component, just specify the component to the
component
field of the command job YAML definition. - For all job types, added support for referencing the latest version of a nested asset in the job YAML configuration. When referencing a registered environment or data asset to use as input in a job, you can alias by latest version rather than having to explicitly specify the version. For example:
environment: azureml:AzureML-Minimal@latest
- For pipeline jobs, introduced the
${{ parent }}
context for binding inputs and outputs between steps in a pipeline. For more information, see Expression syntax for binding inputs and outputs between steps in a pipeline job. - Added support for downloading named outputs of job via the
--output-name
argument for theaz ml job download
command
- For all job types, flattened the
az ml data
- Deprecated the
az ml dataset
subgroup, now usingaz ml data
instead - There are two types of data that can now be created, either from a single file source (
type: uri_file
) or a folder (type: uri_folder
). When creating the data asset, you can either specify the data source from a local file / folder or from a URI to a cloud path location. See the data YAML schema for the full schema
- Deprecated the
az ml environment
- In the environment YAML schema, renamed the
build.local_path
field tobuild.path
- Removed the
build.context_uri
field, the URI of the uploaded build context location will be accessible viabuild.path
when the environment is returned
- In the environment YAML schema, renamed the
az ml model
- In the model YAML schema,
model_uri
andlocal_path
fields removed and consolidated to onepath
field that can take either a local path or a cloud path URI.model_format
field renamed totype
; the default type iscustom_model
, but you can specify one of the other types (mlflow_model
,triton_model
) to use the model in no-code deployment scenarios - For
az ml model create
,--model-uri
and--local-path
arguments removed and consolidated to one--path
argument that can take either a local path or a cloud path URI - Added the
az ml model download
command to download a model's artifact files
- In the model YAML schema,
az ml online-deployment
- In the online deployment YAML schema, flattened the
code
section of thecode_configuration
field. Instead ofcode_configuration.code.local_path
to specify the path to the source code directory containing the scoring files, it's now justcode_configuration.code
- Added an
environment_variables
field to the online deployment YAML schema to support configuring environment variables for an online deployment
- In the online deployment YAML schema, flattened the
az ml batch-deployment
- In the batch deployment YAML schema, flattened the
code
section of thecode_configuration
field. Instead ofcode_configuration.code.local_path
to specify the path to the source code directory containing the scoring files, it's now justcode_configuration.code
- In the batch deployment YAML schema, flattened the
az ml component
- Flattened the
code
section of the command component YAML schema. Instead ofcode.local_path
to specify the path to the source code directory, it's now justcode
- Added support for referencing the latest version of a registered environment to use in the component YAML configuration. When referencing a registered environment, you can alias by latest version rather than having to explicitly specify the version. For example:
environment: azureml:AzureML-Minimal@latest
- Renamed the component input and output type value from
path
touri_folder
for thetype
field when defining a component input or output
- Flattened the
- Removed the
delete
commands for assets (model, component, data, environment). The existing delete functionality is only a soft delete, so thedelete
commands will be reintroduced in a later release once hard delete is supported - Added support for archiving and restoring assets (model, component, data, environment) and jobs, for example,
az ml model archive
andaz ml model restore
. You can now archive assets and jobs, which will hide the archived entity from list queries (for example,az ml model list
).
2021-10-04
Azure Machine Learning CLI (v2) v2.0.2
az ml workspace
- Updated workspace YAML schema
az ml compute
- Updated YAML schemas for AmlCompute and Compute Instance
- Removed support for legacy AKS attach via
az ml compute attach
. Azure Arc-enabled Kubernetes attach will be supported in the next release
az ml datastore
- Updated YAML schemas for Azure blob, Azure file, Azure Data Lake Gen1, and Azure Data Lake Gen2 datastores
- Added support for creating Azure Data Lake Storage Gen1 and Gen2 datastores
az ml job
- Updated YAML schemas for command job and sweep job
- Added support for running pipeline jobs (pipeline job YAML schema)
- Added support for job input literals and input data URIs for all job types
- Added support for job outputs for all job types
- Changed the expression syntax from
{ <expression> }
to${{ <expression> }}
. For more information, see Expression syntax for configuring Azure Machine Learning jobs
az ml environment
- Updated environment YAML schema
- Added support for creating environments from Docker build context
az ml model
- Updated model YAML schema
- Added new
model_format
property to Model for no-code deployment scenarios
az ml dataset
- Renamed
az ml data
subgroup toaz ml dataset
- Updated dataset YAML schema
- Renamed
az ml component
- Added the
az ml component
commands for managing Azure Machine Learning components - Added support for command components (command component YAML schema)
- Added the
az ml online-endpoint
az ml endpoint
subgroup split into two separate groups:az ml online-endpoint
andaz ml batch-endpoint
- Updated online endpoint YAML schema
- Added support for local endpoints for dev/test scenarios
- Added interactive VS Code debugging support for local endpoints (added the
--vscode-debug
flag toaz ml batch-endpoint create/update
)
az ml online-deployment
az ml deployment
subgroup split into two separate groups:az ml online-deployment
andaz ml batch-deployment
- Updated managed online deployment YAML schema
- Added autoscaling support via integration with Azure Monitor Autoscale
- Added support for updating multiple online deployment properties in the same update operation
- Added support for performing concurrent operations on deployments under the same endpoint
az ml batch-endpoint
az ml endpoint
subgroup split into two separate groups:az ml online-endpoint
andaz ml batch-endpoint
- Updated batch endpoint YAML schema
- Removed
traffic
property; replaced with a configurable default deployment property - Added support for input data URIs for
az ml batch-endpoint invoke
- Added support for VNet ingress (private link)
az ml batch-deployment
az ml deployment
subgroup split into two separate groups:az ml online-deployment
andaz ml batch-deployment
- Updated batch deployment YAML schema
2021-05-25
Announcing the CLI (v2) for Azure Machine Learning
The ml
extension to the Azure CLI is the next-generation interface for Azure Machine Learning. It enables you to train and deploy models from the command line, with features that accelerate scaling data science up and out while tracking the model lifecycle. Install and get started.