Batch Deployments - List

Szolgáltatás:: Machine Learning

API verzió:: 2025-12-01

Felsorolja a Batch-következtetési üzemelő példányokat a munkaterületen.

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

Opcionális paraméterekkel:

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
endpointName	path	True	string	A Batch-végpont neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Azure Machine Learning munkaterület neve
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
$orderBy	query		string	A lista sorrendje.
$skip	query		string	Folytatási jogkivonat lapozáshoz.
$top	query		integer (int32)	A lista tetején.

Válaszok

Név	Típus	Leírás
200 OK	BatchDeploymentTrackedResourceArmPaginatedResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Flow: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Leírás
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

List Workspace Batch Deployment.

Mintakérés

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=2025-12-01&$orderBy=string&$top=1

Mintaválasz

Állapotkód:: 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": {}
    }
  ]
}

Meghatározások

Név	Leírás
BatchDeployment	A konkrét nyomon követett erőforrástípusok úgy hozhatók létre, hogy ezt a típust egy adott tulajdonságtípus használatával aliasként használják.
BatchDeploymentConfigurationType	A kötegelt telepítések felsorolt tulajdonságtípusai.
BatchDeploymentProperties	Kötegelt következtetési beállítások üzemelő példányonként.
BatchDeploymentTrackedResourceArmPaginatedResult	A BatchDeployment entitások lapszámozott listája.
BatchLoggingLevel	Naplózza a részletességet kötegelt következtetéshez. A naplózás részletességének növelése a következő: Figyelmeztetés, Információ és Hibakeresés. Az alapértelmezett érték: „Információ”.
BatchOutputAction	Felsorolás annak meghatározásához, hogy a kötegelt következtetés hogyan kezeli a kimenetet
BatchPipelineComponentDeploymentConfiguration	A Batch-folyamatösszetevő üzembe helyezésének tulajdonságai.
BatchRetrySettings	Próbálja meg újra a kötegelt következtetési művelet beállításait.
CodeConfiguration	Pontozási kódeszköz konfigurálása.
createdByType	Az erőforrást létrehozó identitás típusa.
DataPathAssetReference	Hivatkozás egy eszközre az adattárban lévő elérési úton keresztül.
DeploymentProvisioningState	A DeploymentProvisioningState lehetséges értékei.
DeploymentResourceConfiguration
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
IdAssetReference	Hivatkozás egy eszközre az ARM-erőforrás-azonosítón keresztül.
ManagedServiceIdentity	Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).
OutputPathAssetReference	Hivatkozás egy eszközre a feladat kimenetében lévő elérési úton keresztül.
ReferenceType	Felsorolás annak meghatározására, hogy melyik referenciamódszert kell használni egy eszközhöz.
Sku	A termékváltozatot képviselő erőforrásmodell-definíció
SkuTier	Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UserAssignedIdentity	Felhasználó által hozzárendelt identitástulajdonságok

BatchDeployment

Tárgy

A konkrét nyomon követett erőforrástípusok úgy hozhatók létre, hogy ezt a típust egy adott tulajdonságtípus használatával aliasként használják.

Név	Típus	Leírás
id	string	Az erőforrás teljes erőforrás-azonosítója. Example - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
kind	string	A portál/eszközhasználat/stb. által használt metaadatok különböző UX-élményeket jelenítenek meg az azonos típusú erőforrásokhoz.
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties	BatchDeploymentProperties	[Kötelező] Az entitás további attribútumai.
sku	Sku	Az automatikus skálázáshoz szükséges ARM-szerződéshez szükséges termékváltozat részletei.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

BatchDeploymentConfigurationType

Felsorolás

A kötegelt telepítések felsorolt tulajdonságtípusai.

Érték	Leírás
Model
PipelineComponent

BatchDeploymentProperties

Tárgy

Kötegelt következtetési beállítások üzemelő példányonként.

Név	Típus	Alapértelmezett érték	Leírás
codeConfiguration	CodeConfiguration		A végpont üzembe helyezésének kódkonfigurációja.
compute	string		Számítási cél kötegelt következtetési művelethez.
deploymentConfiguration	BatchDeploymentConfiguration: BatchPipelineComponentDeploymentConfiguration		A különböző üzemelő példánytípusokhoz kapcsolódó tulajdonságok.
description	string		A végpont üzembe helyezésének leírása.
environmentId	string		A végponttelepítés környezeti specifikációjának ARM-erőforrás-azonosítója vagy AssetId-azonosítója.
environmentVariables	object		Környezeti változók konfigurálása az üzembe helyezéshez.
errorThreshold	integer (int32)	-1	Hibaküszöbérték, ha a teljes bemenet hibaszáma meghaladja ezt az értéket, a kötegelt következtetés megszakad. A tartomány [-1, int. MaxValue]. A FileDataset esetében ez az érték a fájlhibák száma. A TabularDataset esetében ez az érték a rekordhibák száma. Ha -1 (alsó határ) értékre van állítva, a kötegkövetkezési hibák figyelmen kívül lesznek hagyva.
loggingLevel	BatchLoggingLevel	Info	Naplózza a részletességet kötegelt következtetéshez. A naplózás részletességének növelése a következő: Figyelmeztetés, Információ és Hibakeresés. Az alapértelmezett érték: „Információ”.
maxConcurrencyPerInstance	integer (int32)	1	A példányonkénti párhuzamosság maximális számát jelzi.
miniBatchSize	integer (int64)	10	Az egyes köteghívások számára átadott mini köteg mérete. A FileDataset esetében ez a minimális kötegenkénti fájlok száma. A TabularDataset esetében ez a rekordok mérete bájtban, mini-kötegenként.
model	AssetReferenceBase: DataPathAssetReference IdAssetReference OutputPathAssetReference		Hivatkozás a végpont üzembe helyezéséhez használt modelleszközre.
outputAction	BatchOutputAction	AppendRow	Felsorolás annak meghatározásához, hogy a kötegelt következtetés hogyan kezeli a kimenetet
outputFileName	string	predictions.csv	Testreszabott kimeneti fájlnév append_row kimeneti művelethez.
properties	object		Tulajdonságszótár. A tulajdonságok hozzáadhatók, de nem távolíthatók el és nem módosíthatók.
provisioningState	DeploymentProvisioningState		A végpont üzembe helyezésének kiépítési állapota.
resources	DeploymentResourceConfiguration		A feladat számítási konfigurációját jelzi. Ha nincs megadva, a ResourceConfigurationban definiált alapértelmezett értékek lesznek alapértelmezettek.
retrySettings	BatchRetrySettings		Próbálkozzon újra a kötegelt következtetési művelet beállításaival. Ha nincs megadva, alapértelmezés szerint a BatchRetrySettingsben definiált alapértelmezett értékek lesznek.

BatchDeploymentTrackedResourceArmPaginatedResult

Tárgy

A BatchDeployment entitások lapszámozott listája.

Név	Típus	Leírás
nextLink	string (uri)	A következő oldalra mutató link
value	BatchDeployment[]	A BatchDeployment elemek ezen az oldalon

BatchLoggingLevel

Felsorolás

Naplózza a részletességet kötegelt következtetéshez. A naplózás részletességének növelése a következő: Figyelmeztetés, Információ és Hibakeresés. Az alapértelmezett érték: „Információ”.

Érték	Leírás
Info
Warning
Debug

BatchOutputAction

Felsorolás

Felsorolás annak meghatározásához, hogy a kötegelt következtetés hogyan kezeli a kimenetet

Érték	Leírás
SummaryOnly
AppendRow

BatchPipelineComponentDeploymentConfiguration

Tárgy

A Batch-folyamatösszetevő üzembe helyezésének tulajdonságai.

Név	Típus	Leírás
componentId	IdAssetReference	A futtatni kívánt összetevő ARM-azonosítója.
deploymentConfigurationType	string: PipelineComponent	[Kötelező] Az üzembe helyezés típusa
description	string	A feladatra alkalmazott leírás.
settings	object	A folyamatfeladat futásidejű beállításai.
tags	object	A feladatra alkalmazott címkék.

BatchRetrySettings

Tárgy

Próbálja meg újra a kötegelt következtetési művelet beállításait.

Név	Típus	Alapértelmezett érték	Leírás
maxRetries	integer (int32)	3	Mini köteg újrapróbálkozásainak maximális száma
timeout	string (duration)	PT30S	Egy mini köteg meghívási időtúllépése ISO 8601 formátumban.

CodeConfiguration

Tárgy

Pontozási kódeszköz konfigurálása.

Név	Típus	Leírás
codeId	string	A kódobjektum ARM-erőforrás-azonosítója.
scoringScript	string minLength: 1 pattern: [a-zA-Z0-9_]	[Kötelező] Az indításkor végrehajtandó szkript. eg. "score.py"

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Leírás
User
Application
ManagedIdentity
Key

DataPathAssetReference

Tárgy

Hivatkozás egy eszközre az adattárban lévő elérési úton keresztül.

Név	Típus	Leírás
datastoreId	string	Annak az adattárnak az ARM-erőforrás-azonosítója, amelyben az objektum található.
path	string	A fájl/könyvtár elérési útja az adattárban.
referenceType	string: DataPath	[Kötelező] Az eszközhivatkozás típusát adja meg.

DeploymentProvisioningState

Felsorolás

A DeploymentProvisioningState lehetséges értékei.

Érték	Leírás
Creating
Deleting
Scaling
Updating
Succeeded
Failed
Canceled

DeploymentResourceConfiguration

Tárgy

Név	Típus	Alapértelmezett érték	Leírás
instanceCount	integer (int32)	1	A számítási cél által használt példányok vagy csomópontok opcionális száma.
instanceType	string		A számítási cél által támogatott virtuális gép választható típusa.
properties			További tulajdonságok táska.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Név	Típus	Leírás
error	ErrorDetail	A hibaobjektum.

IdAssetReference

Tárgy

Hivatkozás egy eszközre az ARM-erőforrás-azonosítón keresztül.

Név	Típus	Leírás
assetId	string minLength: 1 pattern: [a-zA-Z0-9_]	[Kötelező] Az eszköz ARM-erőforrás-azonosítója.
referenceType	string: Id	[Kötelező] Az eszközhivatkozás típusát adja meg.

ManagedServiceIdentity

Tárgy

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)

Név	Típus	Leírás
principalId	string (uuid)	A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.
tenantId	string (uuid)	A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.
type	ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identitások Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben.

ManagedServiceIdentityType

Felsorolás

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

Érték	Leírás
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OutputPathAssetReference

Tárgy

Hivatkozás egy eszközre a feladat kimenetében lévő elérési úton keresztül.

Név	Típus	Leírás
jobId	string	A feladat ARM-erőforrás-azonosítója.
path	string	A fájl/könyvtár elérési útja a feladat kimenetében.
referenceType	string: OutputPath	[Kötelező] Az eszközhivatkozás típusát adja meg.

ReferenceType

Felsorolás

Felsorolás annak meghatározására, hogy melyik referenciamódszert kell használni egy eszközhöz.

Érték	Leírás
Id
DataPath
OutputPath

Sku

Tárgy

A termékváltozatot képviselő erőforrásmodell-definíció

Név	Típus	Leírás
capacity	integer (int32)	Ha az SKU támogatja a vertikális felskálázást/azt, akkor a kapacitás egészét is tartalmaznia kell. Ha az erőforrás esetében nem lehetséges a vertikális felskálázás/beskálázás, akkor ez kihagyható.
family	string	Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti.
name	string	Az termékváltozat neve. Ex - P3. Ez általában egy betű+szám kód
size	string	A termékváltozat mérete. Ha a névmező a réteg és más értékek kombinációja, akkor ez a különálló kód.
tier	SkuTier	Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.

SkuTier

Felsorolás

Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.

Érték	Leírás
Free
Basic
Standard
Premium

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Név	Típus	Leírás
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UserAssignedIdentity

Tárgy

Felhasználó által hozzárendelt identitástulajdonságok

Név	Típus	Leírás
clientId	string (uuid)	A hozzárendelt identitás ügyfélazonosítója.
principalId	string (uuid)	A hozzárendelt identitás egyszerű azonosítója.

Megosztás a következőn keresztül:

Batch Deployments - List

URI paraméterek

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

List Workspace Batch Deployment.

Mintakérés

Mintaválasz

Meghatározások

BatchDeployment

BatchDeploymentConfigurationType

BatchDeploymentProperties

BatchDeploymentTrackedResourceArmPaginatedResult

BatchLoggingLevel

BatchOutputAction

BatchPipelineComponentDeploymentConfiguration

BatchRetrySettings

CodeConfiguration

createdByType

DataPathAssetReference

DeploymentProvisioningState

DeploymentResourceConfiguration

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdAssetReference

ManagedServiceIdentity

ManagedServiceIdentityType

OutputPathAssetReference

ReferenceType

Sku

SkuTier

systemData

UserAssignedIdentity