Batch Deployments - List

Hizmet:: Machine Learning

API Sürümü:: 2025-12-01

Çalışma alanındaki Batch çıkarım dağıtımlarını listeler.

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

İsteğe bağlı parametrelerle:

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpointName	path	True	string	Batch Uç Noktasının adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Azure Machine Learning Çalışma Alanı Adı
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
$orderBy	query		string	Liste sırası.
$skip	query		string	Sayfalandırma için devamlılık belirteci.
$top	query		integer (int32)	Listenin başı.

Yanıtlar

Name	Tür	Description
200 OK	BatchDeploymentTrackedResourceArmPaginatedResult	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

List Workspace Batch Deployment.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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": {}
    }
  ]
}

Tanımlar

Name	Description
BatchDeployment	Belirli bir özellik türü kullanılarak bu tür diğer ad kullanılarak somut izlenen kaynak türleri oluşturulabilir.
BatchDeploymentConfigurationType	Toplu dağıtımlar için numaralandırılmış özellik türleri.
BatchDeploymentProperties	Dağıtım başına toplu çıkarım ayarları.
BatchDeploymentTrackedResourceArmPaginatedResult	Varlıkların sayfalandırılmış listesi BatchDeployment .
BatchLoggingLevel	Toplu çıkarım için günlük ayrıntı düzeyi. Günlüğe kaydetme için artan ayrıntı sırası şöyledir: Uyarı, Bilgi ve Hata Ayıklama. Varsayılan değer Bilgi'dir.
BatchOutputAction	Toplu çıkarımın çıkışı nasıl işleyeceğini belirlemek için sabit listesi
BatchPipelineComponentDeploymentConfiguration	Batch işlem hattı bileşen dağıtımının özellikleri.
BatchRetrySettings	Toplu çıkarım işlemi için ayarları yeniden deneyin.
CodeConfiguration	Puanlama kodu varlığına ilişkin yapılandırma.
createdByType	Kaynağı oluşturan kimliğin türü.
DataPathAssetReference	Veri deposundaki yolu aracılığıyla bir varlığa başvuru.
DeploymentProvisioningState	DeploymentProvisioningState için olası değerler.
DeploymentResourceConfiguration
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata detayı.
ErrorResponse	Hata yanıtı
IdAssetReference	ARM kaynak kimliği aracılığıyla bir varlığa başvuru.
ManagedServiceIdentity	Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)
ManagedServiceIdentityType	Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).
OutputPathAssetReference	Bir iş çıkışındaki yolu aracılığıyla bir varlığa başvuru.
ReferenceType	Bir varlık için hangi başvuru yönteminin kullanılacağını belirlemek için sabit listesi.
Sku	SKU'yu temsil eden kaynak modeli tanımı
SkuTier	Hizmetin birden fazla katmanı varsa, ancak PUT üzerinde gerekli değilse, bu alanın Kaynak Sağlayıcısı tarafından uygulanması gerekir.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UserAssignedIdentity	Kullanıcı tarafından atanan kimlik özellikleri

BatchDeployment

Nesne

Belirli bir özellik türü kullanılarak bu tür diğer ad kullanılarak somut izlenen kaynak türleri oluşturulabilir.

Name	Tür	Description
id	string	Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)
kind	string	Portal/araçlar/vb. tarafından aynı türdeki kaynaklar için farklı UX deneyimlerini işlemek için kullanılan meta veriler.
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties	BatchDeploymentProperties	[Gerekli] Varlığın ek öznitelikleri.
sku	Sku	Otomatik Ölçeklendirme için ARM sözleşmesi için gereken SKU ayrıntıları.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

BatchDeploymentConfigurationType

Numaralandırma

Toplu dağıtımlar için numaralandırılmış özellik türleri.

Değer	Description
Model
PipelineComponent

BatchDeploymentProperties

Nesne

Dağıtım başına toplu çıkarım ayarları.

Name	Tür	Default value	Description
codeConfiguration	CodeConfiguration		Uç nokta dağıtımı için kod yapılandırması.
compute	string		Toplu çıkarım işlemi için işlem hedefi.
deploymentConfiguration	BatchDeploymentConfiguration: BatchPipelineComponentDeploymentConfiguration		Farklı dağıtım türleriyle ilgili özellikler.
description	string		Uç nokta dağıtımının açıklaması.
environmentId	string		Uç nokta dağıtımı için ortam belirtiminin ARM kaynak kimliği veya AssetId değeri.
environmentVariables	object		Dağıtım için ortam değişkenleri yapılandırması.
errorThreshold	integer (int32)	-1	Hata eşiği, tüm girişin hata sayısı bu değerin üzerine çıkarsa toplu çıkarım iptal edilir. Aralık :[-1, int. MaxValue]. FileDataset için bu değer, dosya hatalarının sayısıdır. TabularDataset için bu değer, kayıt hatalarının sayısıdır. -1 (alt sınır) olarak ayarlanırsa, toplu çıkarım sırasındaki tüm hatalar yoksayılır.
loggingLevel	BatchLoggingLevel	Info	Toplu çıkarım için günlük ayrıntı düzeyi. Günlüğe kaydetme için artan ayrıntı sırası şöyledir: Uyarı, Bilgi ve Hata Ayıklama. Varsayılan değer Bilgi'dir.
maxConcurrencyPerInstance	integer (int32)	1	Örnek başına en fazla paralellik sayısını gösterir.
miniBatchSize	integer (int64)	10	Her toplu çağrıya geçirilen mini toplu iş boyutu. FileDataset için bu, mini toplu iş başına dosya sayısıdır. TabularDataset için bu, mini toplu iş başına bayt cinsinden kayıtların boyutudur.
model	AssetReferenceBase: DataPathAssetReference IdAssetReference OutputPathAssetReference		Uç nokta dağıtımı için model varlığına başvuru.
outputAction	BatchOutputAction	AppendRow	Toplu çıkarımın çıkışı nasıl işleyeceğini belirlemek için sabit listesi
outputFileName	string	predictions.csv	append_row çıktı eylemi için özelleştirilmiş çıktı dosyası adı.
properties	object		Özellik sözlüğü. Özellikler eklenebilir, ancak kaldırılamaz veya değiştirilemez.
provisioningState	DeploymentProvisioningState		Uç nokta dağıtımı için sağlama durumu.
resources	DeploymentResourceConfiguration		İş için işlem yapılandırmasını gösterir. Sağlanmazsa, varsayılan olarak ResourceConfiguration'da tanımlanan varsayılan değerler kullanılır.
retrySettings	BatchRetrySettings		Toplu çıkarım işlemi için Ayarları yeniden deneyin. Sağlanmadıysa, BatchRetrySettings'te tanımlanan varsayılan değerler varsayılan değerdir.

BatchDeploymentTrackedResourceArmPaginatedResult

Nesne

Varlıkların sayfalandırılmış listesi BatchDeployment .

Name	Tür	Description
nextLink	string (uri)	Öğelerin bir sonraki sayfasına bağlantı
value	BatchDeployment[]	Bu sayfadaki BatchDeployment öğeleri

BatchLoggingLevel

Numaralandırma

Toplu çıkarım için günlük ayrıntı düzeyi. Günlüğe kaydetme için artan ayrıntı sırası şöyledir: Uyarı, Bilgi ve Hata Ayıklama. Varsayılan değer Bilgi'dir.

Değer	Description
Info
Warning
Debug

BatchOutputAction

Numaralandırma

Toplu çıkarımın çıkışı nasıl işleyeceğini belirlemek için sabit listesi

Değer	Description
SummaryOnly
AppendRow

BatchPipelineComponentDeploymentConfiguration

Nesne

Batch işlem hattı bileşen dağıtımının özellikleri.

Name	Tür	Description
componentId	IdAssetReference	Çalıştırılacak bileşenin ARM kimliği.
deploymentConfigurationType	string: PipelineComponent	[Gerekli] Dağıtımın türü
description	string	İşe uygulanacak açıklama.
settings	object	İşlem hattı işi için çalışma zamanı ayarları.
tags	object	İşe uygulanacak etiketler.

BatchRetrySettings

Nesne

Toplu çıkarım işlemi için ayarları yeniden deneyin.

Name	Tür	Default value	Description
maxRetries	integer (int32)	3	Mini toplu iş için en fazla yeniden deneme sayısı
timeout	string (duration)	PT30S	ISO 8601 biçiminde bir mini toplu iş için çağrı zaman aşımı.

CodeConfiguration

Nesne

Puanlama kodu varlığına ilişkin yapılandırma.

Name	Tür	Description
codeId	string	Kod varlığının ARM kaynak kimliği.
scoringScript	string minLength: 1 pattern: [a-zA-Z0-9_]	[Gerekli] Başlangıçta yürütülecek betik. eg. "score.py"

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DataPathAssetReference

Nesne

Veri deposundaki yolu aracılığıyla bir varlığa başvuru.

Name	Tür	Description
datastoreId	string	Varlığın bulunduğu veri deposunun ARM kaynak kimliği.
path	string	Veri deposundaki dosyanın/dizinin yolu.
referenceType	string: DataPath	[Gerekli] Varlık başvurusunun türünü belirtir.

DeploymentProvisioningState

Numaralandırma

DeploymentProvisioningState için olası değerler.

Değer	Description
Creating
Deleting
Scaling
Updating
Succeeded
Failed
Canceled

DeploymentResourceConfiguration

Nesne

Name	Tür	Default value	Description
instanceCount	integer (int32)	1	İşlem hedefi tarafından kullanılan isteğe bağlı örnek veya düğüm sayısı.
instanceType	string		İşlem hedefi tarafından desteklendiği şekilde kullanılan isteğe bağlı VM türü.
properties			Ek özellikler çantası.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgi.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata detayı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IdAssetReference

Nesne

ARM kaynak kimliği aracılığıyla bir varlığa başvuru.

Name	Tür	Description
assetId	string minLength: 1 pattern: [a-zA-Z0-9_]	[Gerekli] Varlığın ARM kaynak kimliği.
referenceType	string: Id	[Gerekli] Varlık başvurusunun türünü belirtir.

ManagedServiceIdentity

Nesne

Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)

Name	Tür	Description
principalId	string (uuid)	Sistem tarafından atanan kimliğin hizmet sorumlusu kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.
tenantId	string (uuid)	Sistem tarafından atanan kimliğin kiracı kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.
type	ManagedServiceIdentityType	Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).
userAssignedIdentities	<string, UserAssignedIdentity>	kimlikleri User-Assigned Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.

ManagedServiceIdentityType

Numaralandırma

Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).

Değer	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OutputPathAssetReference

Nesne

Bir iş çıkışındaki yolu aracılığıyla bir varlığa başvuru.

Name	Tür	Description
jobId	string	İşin ARM kaynak kimliği.
path	string	İş çıkışındaki dosyanın/dizinin yolu.
referenceType	string: OutputPath	[Gerekli] Varlık başvurusunun türünü belirtir.

ReferenceType

Numaralandırma

Bir varlık için hangi başvuru yönteminin kullanılacağını belirlemek için sabit listesi.

Değer	Description
Id
DataPath
OutputPath

Sku

Nesne

SKU'yu temsil eden kaynak modeli tanımı

Name	Tür	Description
capacity	integer (int32)	SKU ölçeği genişletmeyi/genişletmeyi destekliyorsa kapasite tamsayısı dahil edilmelidir. Kaynak için ölçeği genişletme/daraltma mümkün değilse bu atlanabilir.
family	string	Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir.
name	string	SKU'nun adı. Eski - P3. Bu genellikle bir harf+sayı kodudur
size	string	SKU boyutu. Ad alanı katman ile başka bir değerin birleşimi olduğunda, bu tek başına kod olacaktır.
tier	SkuTier	Hizmetin birden fazla katmanı varsa, ancak PUT üzerinde gerekli değilse, bu alanın Kaynak Sağlayıcısı tarafından uygulanması gerekir.

SkuTier

Numaralandırma

Hizmetin birden fazla katmanı varsa, ancak PUT üzerinde gerekli değilse, bu alanın Kaynak Sağlayıcısı tarafından uygulanması gerekir.

Değer	Description
Free
Basic
Standard
Premium

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

UserAssignedIdentity

Nesne

Kullanıcı tarafından atanan kimlik özellikleri

Name	Tür	Description
clientId	string (uuid)	Atanan kimliğin istemci kimliği.
principalId	string (uuid)	Atanan kimliğin asıl kimliği.

Aracılığıyla paylaş

Batch Deployments - List

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

List Workspace Batch Deployment.

Örnek isteği

Örnek yanıt

Tanımlar

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