Registry Model Versions - List

Servizio:: Machine Learning

Versione API:: 2025-09-01

Elenca le versioni.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}/models/{modelName}/versions?api-version=2025-09-01

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}/models/{modelName}/versions?api-version=2025-09-01&$skip={$skip}&$orderBy={$orderBy}&$top={$top}&version={version}&description={description}&tags={tags}&properties={properties}&listViewType={listViewType}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
modelName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$	Nome del contenitore. Distinzione tra maiuscole e minuscole.
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Nome del registro di Azure Machine Learning. Questo non fa distinzione tra maiuscole e minuscole
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$orderBy	query		string	Ordinamento dell'elenco.
$skip	query		string	Token di continuazione per la paginazione.
$top	query		integer (int32)	Numero massimo di record da restituire.
description	query		string	Descrizione del modello.
listViewType	query		ListViewType	Tipo di visualizzazione per le entità archiviate incluse/escluse (ad esempio).
properties	query		string	Elenco delimitato da virgole di nomi di proprietà (e facoltativamente valori). Esempio: prop1,prop2=value2
tags	query		string	Elenco delimitato da virgole di nomi di tag (e facoltativamente valori). Esempio: tag1,tag2=value2
version	query		string	Identificatore della versione.

Risposte

Nome	Tipo	Descrizione
200 OK	ModelVersionResourceArmPaginatedResult	Success
Other Status Codes	ErrorResponse	Errore

Esempio

List Registry Model Version.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/my-aml-registry/models/string/versions?api-version=2025-09-01&$orderBy=string&$top=1&version=string&description=string&tags=string&properties=string

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "properties": {
        "description": "string",
        "tags": {
          "string": "string"
        },
        "properties": {
          "string": "string"
        },
        "isAnonymous": false,
        "flavors": {
          "string": {
            "data": {
              "string": "string"
            }
          }
        },
        "modelType": "CustomModel",
        "modelUri": "string"
      },
      "systemData": {
        "createdAt": "2020-01-01T12:34:56.999Z",
        "createdBy": "string",
        "createdByType": "User",
        "lastModifiedAt": "2020-01-01T12:34:56.999Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User"
      }
    }
  ],
  "nextLink": "string"
}

Definizioni

Nome	Descrizione
AssetProvisioningState	Stato di provisioning dell'asset del Registro di sistema.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FlavorData
ListViewType
ModelVersion	Dettagli della versione dell'asset del modello.
ModelVersionResource	Busta delle risorse di Azure Resource Manager.
ModelVersionResourceArmPaginatedResult	Elenco impaginato di entità ModelVersion.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AssetProvisioningState

Enumerazione

Stato di provisioning dell'asset del Registro di sistema.

Valore	Descrizione
Succeeded
Failed
Canceled
Creating
Updating
Deleting

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

FlavorData

Oggetto

Nome	Tipo	Descrizione
data	object	Dati specifici del modello.

ListViewType

Enumerazione

Valore	Descrizione
ActiveOnly
ArchivedOnly
All

ModelVersion

Oggetto

Dettagli della versione dell'asset del modello.

Nome	Tipo	Valore predefinito	Descrizione
description	string		Testo della descrizione dell'asset.
flavors	<string, FlavorData>		Mapping delle versioni del modello alle relative proprietà.
isAnonymous	boolean	False	Se la versione del nome viene generata dal sistema (registrazione anonima).
isArchived	boolean	False	L'asset è archiviato?
jobName	string		Nome del processo di training che ha prodotto questo modello
modelType	string		Formato di archiviazione per questa entità. Utilizzato per NCD.
modelUri	string		Percorso URI del contenuto del modello.
properties	object		Dizionario delle proprietà dell'asset.
provisioningState	AssetProvisioningState		Stato di provisioning per la versione del modello.
stage	string		Fase del ciclo di vita del modello assegnato a questo modello
tags	object		Dizionario tag. I tag possono essere aggiunti, rimossi e aggiornati.

ModelVersionResource

Oggetto

Busta delle risorse di Azure Resource Manager.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	ModelVersion	[Obbligatorio] Attributi aggiuntivi dell'entità.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ModelVersionResourceArmPaginatedResult

Oggetto

Elenco impaginato di entità ModelVersion.

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva degli oggetti ModelVersion. Se null, non sono presenti pagine aggiuntive.
value	ModelVersionResource[]	Matrice di oggetti di tipo ModelVersion.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.