Schéma YAML du modèle CLI (v2)

APPLIES TO :Azure CLI ml extension v2 (actuel)

Le schéma JSON source se trouve à l’adresse https://azuremlschemas.azureedge.net/latest/model.schema.json.

Note

La syntaxe YAML détaillée dans ce document est basée sur le schéma JSON pour la dernière version de l’extension ML CLI v2. Le fonctionnement de cette syntaxe est garanti uniquement avec la dernière version de l’extension ML CLI v2. Vous trouverez les schémas des versions d’extension plus anciennes sur https://azuremlschemasprod.azureedge.net/.

Syntaxe YAML

Clé Catégorie Description Valeurs autorisées
$schema string Schéma YAML.
name string Required. Nom du modèle.
version int Version du modèle. En cas d’omission, Azure Machine Learning génère automatiquement une version.
description string Description du modèle.
tags Objet Dictionnaire d’étiquettes pour le modèle.
path string Un chemin d’accès local aux fichiers de modèle ou l’URI d’un chemin d’accès cloud aux fichiers de modèle. Peut pointer vers un fichier ou un répertoire.
type string Type de format de stockage du modèle. Applicable aux scénarios de déploiement sans code. custom_model, , mlflow_modeltriton_model
flavors Objet Saveurs du modèle. Chaque type de format de stockage de modèle peut avoir une ou plusieurs saveurs prises en charge. Applicable aux scénarios de déploiement sans code.
default_deployment_template Objet Modèle de déploiement par défaut pour le modèle. S’applique uniquement aux modèles délimités au Registre. Quand il est défini, les déploiements qui référencent ce modèle utilisent les paramètres du modèle de déploiement (tels que environment, instance_typeet sondes) par défaut.
default_deployment_template.asset_id string ID de ressource du modèle de déploiement. Format : azureml://registries/<registry-name>/deploymenttemplates/<template-name>/versions/<version>.
allowed_deployment_templates liste d’objets Les conseils d’auteur répertoriant les modèles de déploiement qu’un consommateur est recommandé d’utiliser comme remplacements lorsqu’ils déploient ce modèle , un ensemble organisé de modèles validés. Il n’est pas appliqué : une substitution spécifiée au moment du déploiement n’est pas nécessaire pour figurer dans cette liste.
allowed_deployment_templates[].asset_id string ID de ressource d’un modèle de déploiement autorisé. Format : azureml://registries/<registry-name>/deploymenttemplates/<template-name>/labels/latest.

Remarks

La commande az ml model peut être utilisée pour gérer les modèles Azure Machine Learning.

Exemples

Des exemples sont disponibles dans le référentiel examples GitHub. Vous en trouverez plusieurs ci-dessous.

YAML : fichier local

$schema: https://azuremlschemas.azureedge.net/latest/model.schema.json
name: local-file-example
path: mlflow-model/model.pkl
description: Model created from local file.

YAML : dossier local au format MLflow

$schema: https://azuremlschemas.azureedge.net/latest/model.schema.json
name: local-mlflow-example
path: mlflow-model
type: mlflow_model
description: Model created from local MLflow model directory.

YAML : modèle de déploiement par défaut

$schema: https://azuremlschemas.azureedge.net/latest/model.schema.json
name: my-model
version: 1
path: ./model
default_deployment_template:
  asset_id: azureml://registries/my-registry/deploymenttemplates/my-template/versions/1

YAML : modèles de déploiement par défaut et autorisés

$schema: https://azuremlschemas.azureedge.net/latest/model.schema.json
name: my-model
version: 1
type: custom_model
path: ./model
default_deployment_template:
  asset_id: azureml://registries/my-registry/deploymenttemplates/my-template/versions/1
allowed_deployment_templates:
  - asset_id: azureml://registries/my-registry/deploymenttemplates/my-template/labels/latest
  - asset_id: azureml://registries/my-registry/deploymenttemplates/my-template2/labels/latest

Étapes suivantes