Batch Deployments - List

Servizio:

Machine Learning

Versione API:

2026-05-01

Elenca le distribuzioni di inferenza batch nell'area di lavoro.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments?api-version=2026-05-01

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments?api-version=2026-05-01&$orderBy={$orderBy}&$top={$top}&$skip={$skip}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpointName	path	True	string	Nome per l'endpoint batch.
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.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nome dell'area di lavoro di Azure Machine Learning
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)	Inizio dell'elenco.

Risposte

Nome	Tipo	Descrizione
200 OK	BatchDeploymentTrackedResourceArmPaginatedResult	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

List Workspace Batch Deployment.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments?api-version=2026-05-01&$orderBy=string&$top=1

Risposta di esempio

Codice di stato:

200

{
  "nextLink": "https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments?api-version=2025-07-01-preview&$skip=2",
  "value": [
    {
      "name": "string",
      "type": "string",
      "id": "string",
      "identity": {
        "type": "SystemAssigned",
        "principalId": "00000000-1111-2222-3333-444444444444",
        "tenantId": "00000000-1111-2222-3333-444444444444",
        "userAssignedIdentities": {
          "string": {
            "clientId": "00000000-1111-2222-3333-444444444444",
            "principalId": "00000000-1111-2222-3333-444444444444"
          }
        }
      },
      "kind": "string",
      "location": "string",
      "properties": {
        "description": "string",
        "codeConfiguration": {
          "codeId": "string",
          "scoringScript": "string"
        },
        "compute": "string",
        "environmentId": "string",
        "environmentVariables": {
          "string": "string"
        },
        "errorThreshold": 1,
        "loggingLevel": "Info",
        "maxConcurrencyPerInstance": 1,
        "miniBatchSize": 1,
        "model": {
          "assetId": "string",
          "referenceType": "Id"
        },
        "outputAction": "SummaryOnly",
        "outputFileName": "string",
        "properties": {
          "string": "string"
        },
        "provisioningState": "Creating",
        "resources": {
          "instanceCount": 1,
          "instanceType": "string",
          "properties": {
            "string": {
              "a3c13e2e-a213-4cac-9f5a-b49966906ad6": null
            }
          }
        },
        "retrySettings": {
          "maxRetries": 1,
          "timeout": "PT5M"
        }
      },
      "sku": {
        "name": "string",
        "capacity": 1,
        "family": "string",
        "size": "string",
        "tier": "Free"
      },
      "systemData": {
        "createdAt": "2020-01-01T12:34:56.999Z",
        "createdBy": "string",
        "createdByType": "User",
        "lastModifiedAt": "2020-01-01T12:34:56.999Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User"
      },
      "tags": {}
    }
  ]
}

Definizioni

Nome	Descrizione
BatchDeployment	I tipi di risorse rilevati concreti possono essere creati eseguendo l'aliasing di questo tipo usando un tipo di proprietà specifico.
BatchDeploymentConfigurationType	Tipi di proprietà enumerati per le distribuzioni batch.
BatchDeploymentProperties	Impostazioni di inferenza batch per distribuzione.
BatchDeploymentTrackedResourceArmPaginatedResult	Elenco impaginato di entità BatchDeployment.
BatchLoggingLevel	Livello di dettaglio del log per l'inferenza batch. L'ordine di dettaglio crescente per la registrazione è: Avviso, Informazioni e Debug. Il valore predefinito è Info.
BatchOutputAction	Enum per determinare il modo in cui l'inferenza batch gestirà l'output
BatchPipelineComponentDeploymentConfiguration	Proprietà per la distribuzione di un componente della pipeline batch.
BatchRetrySettings	Impostazioni di ripetizione dei tentativi per un'operazione di inferenza batch.
CodeConfiguration	Configurazione per un asset del codice di punteggio.
createdByType	Tipo di identità che ha creato la risorsa.
DataPathAssetReference	Riferimento a un asset tramite il relativo percorso in un datastore.
DeploymentProvisioningState	Valori possibili per DeploymentProvisioningState.
DeploymentResourceConfiguration
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
IdAssetReference	Riferimento a un asset tramite il relativo ID risorsa ARM.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
OutputPathAssetReference	Riferimento a un asset tramite il relativo percorso nell'output di un processo.
ReferenceType	Enum per determinare il metodo di riferimento da utilizzare per un asset.
Sku	Definizione del modello di risorse che rappresenta lo SKU
SkuTier	Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

BatchDeployment

Oggetto

I tipi di risorse rilevati concreti possono essere creati eseguendo l'aliasing di questo tipo usando un tipo di proprietà specifico.

Nome	Tipo	Descrizione
id	string	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
kind	string	Metadati usati dal portale, dagli strumenti e così via per eseguire il rendering di esperienze utente diverse per le risorse dello stesso tipo.
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties	BatchDeploymentProperties	[Obbligatorio] Attributi aggiuntivi dell'entità.
sku	Sku	Dettagli sku necessari per il contratto ARM per la scalabilità automatica.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

BatchDeploymentConfigurationType

Enumerazione

Tipi di proprietà enumerati per le distribuzioni batch.

Valore	Descrizione
Model
PipelineComponent

BatchDeploymentProperties

Oggetto

Impostazioni di inferenza batch per distribuzione.

Nome	Tipo	Valore predefinito	Descrizione
codeConfiguration	CodeConfiguration		Configurazione del codice per la distribuzione dell'endpoint.
compute	string		Destinazione di calcolo per l'operazione di inferenza batch.
deploymentConfiguration	BatchDeploymentConfiguration: BatchPipelineComponentDeploymentConfiguration		Proprietà rilevanti per diversi tipi di distribuzione.
description	string		Descrizione della distribuzione dell'endpoint.
environmentId	string		ID risorsa ARM o AssetId della specifica dell'ambiente per la distribuzione dell'endpoint.
environmentVariables	object		Configurazione delle variabili di ambiente per la distribuzione.
errorThreshold	integer (int32)	-1	Soglia di errore, se il conteggio degli errori per l'intero input supera questo valore, l'inferenza batch verrà interrotta. L'intervallo è [-1, int. MaxValue]. Per FileDataset, questo valore è il numero di errori di file. Per TabularDataset, questo valore è il numero di errori di record. Se impostato su -1 (limite inferiore), tutti gli errori durante l'inferenza batch verranno ignorati.
loggingLevel	BatchLoggingLevel	Info	Livello di dettaglio del log per l'inferenza batch. L'ordine di dettaglio crescente per la registrazione è: Avviso, Informazioni e Debug. Il valore predefinito è Info.
maxConcurrencyPerInstance	integer (int32)	1	Indica il numero massimo di parallelismo per istanza.
miniBatchSize	integer (int64)	10	Dimensioni del mini batch passato a ogni chiamata batch. Per FileDataset, si tratta del numero di file per mini batch. Per TabularDataset, si tratta delle dimensioni dei record in byte, per mini batch.
model	AssetReferenceBase: DataPathAssetReference IdAssetReference OutputPathAssetReference		Riferimento all'asset del modello per la distribuzione dell'endpoint.
outputAction	BatchOutputAction	AppendRow	Enum per determinare il modo in cui l'inferenza batch gestirà l'output
outputFileName	string	predictions.csv	Nome file di output personalizzato per append_row'azione di output.
properties	object		Dizionario delle proprietà. Le proprietà possono essere aggiunte, ma non rimosse o modificate.
provisioningState	DeploymentProvisioningState		Stato di provisioning per la distribuzione dell'endpoint.
resources	DeploymentResourceConfiguration		Indica la configurazione di calcolo per il processo. Se non specificato, per impostazione predefinita verranno specificate le impostazioni predefinite definite in ResourceConfiguration.
retrySettings	BatchRetrySettings		Impostazioni di ripetizione dei tentativi per l'operazione di inferenza batch. Se non specificato, per impostazione predefinita verranno specificate le impostazioni predefinite definite in BatchRetrySettings.

BatchDeploymentTrackedResourceArmPaginatedResult

Oggetto

Elenco impaginato di entità BatchDeployment.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	BatchDeployment[]	Gli elementi di BatchDeployment in questa pagina

BatchLoggingLevel

Enumerazione

Livello di dettaglio del log per l'inferenza batch. L'ordine di dettaglio crescente per la registrazione è: Avviso, Informazioni e Debug. Il valore predefinito è Info.

Valore	Descrizione
Info
Warning
Debug

BatchOutputAction

Enumerazione

Enum per determinare il modo in cui l'inferenza batch gestirà l'output

Valore	Descrizione
SummaryOnly
AppendRow

BatchPipelineComponentDeploymentConfiguration

Oggetto

Proprietà per la distribuzione di un componente della pipeline batch.

Nome	Tipo	Descrizione
componentId	IdAssetReference	ID ARM del componente da eseguire.
deploymentConfigurationType	string: PipelineComponent	[Obbligatorio] Tipo di distribuzione
description	string	Descrizione che verrà applicata al processo.
settings	object	Impostazioni di runtime per il processo della pipeline.
tags	object	Tag che verranno applicati al processo.

BatchRetrySettings

Oggetto

Impostazioni di ripetizione dei tentativi per un'operazione di inferenza batch.

Nome	Tipo	Valore predefinito	Descrizione
maxRetries	integer (int32)	3	Numero massimo di tentativi per un mini batch
timeout	string (duration)	PT30S	Timeout di chiamata per un mini batch, in formato ISO 8601.

CodeConfiguration

Oggetto

Configurazione per un asset del codice di punteggio.

Nome	Tipo	Descrizione
codeId	string	ID risorsa ARM dell'asset di codice.
scoringScript	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obbligatorio] Script da eseguire all'avvio. eg. "score.py"

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DataPathAssetReference

Oggetto

Riferimento a un asset tramite il relativo percorso in un datastore.

Nome	Tipo	Descrizione
datastoreId	string	ID risorsa ARM dell'archivio dati in cui si trova l'asset.
path	string	Percorso del file o della directory nell'archivio dati.
referenceType	string: DataPath	[Obbligatorio] Specifica il tipo di riferimento all'asset.

DeploymentProvisioningState

Enumerazione

Valori possibili per DeploymentProvisioningState.

Valore	Descrizione
Creating
Deleting
Scaling
Updating
Succeeded
Failed
Canceled

DeploymentResourceConfiguration

Oggetto

Nome	Tipo	Valore predefinito	Descrizione
instanceCount	integer (int32)	1	Numero facoltativo di istanze o nodi usati dalla destinazione di calcolo.
instanceType	string		Tipo facoltativo di macchina virtuale usato come supportato dalla destinazione di calcolo.
properties			Contenitore di proprietà aggiuntive.

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	La destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

IdAssetReference

Oggetto

Riferimento a un asset tramite il relativo ID risorsa ARM.

Nome	Tipo	Descrizione
assetId	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obbligatorio] ID risorsa ARM dell'asset.
referenceType	string: Id	[Obbligatorio] Specifica il tipo di riferimento all'asset.

ManagedServiceIdentity

Oggetto

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string,  UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OutputPathAssetReference

Oggetto

Riferimento a un asset tramite il relativo percorso nell'output di un processo.

Nome	Tipo	Descrizione
jobId	string	ID risorsa ARM del processo.
path	string	Percorso del file o della directory nell'output del processo.
referenceType	string: OutputPath	[Obbligatorio] Specifica il tipo di riferimento all'asset.

ReferenceType

Enumerazione

Enum per determinare il metodo di riferimento da utilizzare per un asset.

Valore	Descrizione
Id
DataPath
OutputPath

Sku

Oggetto

Definizione del modello di risorse che rappresenta lo SKU

Nome	Tipo	Descrizione
capacity	integer (int32)	Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.
name	string	Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero
size	string	Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo.
tier	SkuTier	Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT.

SkuTier

Enumerazione

Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT.

Valore	Descrizione
Free
Basic
Standard
Premium

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.

UserAssignedIdentity

Oggetto

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.