CLI (v2) Git connection YAML schema

APPLIES TO: Azure CLI ml extension v2 (current)

Note

The YAML syntax detailed in this document is based on the JSON schema for the latest version of the ML CLI v2 extension. This syntax is guaranteed only to work with the latest version of the ML CLI v2 extension. You can find the schemas for older extension versions at https://azuremlschemasprod.azureedge.net/.

YAML syntax

Key Type Description Allowed values Default value
$schema string The YAML schema. If you use the Azure Machine Learning Visual Studio Code extension to author the YAML file, include $schema at the top of your file to invoke schema and resource completions.
name string Required. The connection name.
description string The connection description.
tags object The connection tag dictionary.
type string Required. The connection type. git git
is_shared boolean true if the connection is shared across other projects in the hub; otherwise, false. true
target string The URL of the GitHub repo.
credentials object Credential-based authentication to access the storage account. A personal access token. Do not specify credentials when using a public repo.
credentials.type string The type of authentication to use. pat
credentials.pat string The personal access token to authenticate with.

Remarks

The az ml connection commands can be used to manage both Azure Machine Learning and Azure AI Studio connections.

Examples

These examples would be in the form of YAML files and used from the CLI. For example, az ml connection create -f <file-name>.yaml.

YAML: Personal access token

#Connection.yml
name: test_ws_conn_git_pat
type: git
target: https://github.com/contoso/contosorepo
credentials:
  type: pat
  pat: dummy_pat

YAML: No credentials

#Connection.yml

name: git_no_cred_conn
type: git
target: https://https://github.com/contoso/contosorepo

Next steps