Batch Endpoints - Create Or Update

Hizmet:: Machine Learning

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

Bir toplu çıkarım noktası oluşturun (asenkron).
Toplu çıkarım uç noktası (zaman uyumsuz) oluşturur.

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

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ü.

İstek Gövdesi

Name	Gerekli	Tür	Description
location	True	string	Kaynağın bulunduğu coğrafi konum
properties	True	BatchEndpointProperties	[Gerekli] Varlığın ek öznitelikleri.
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.
sku		Sku	Otomatik Ölçeklendirme için ARM sözleşmesi için gereken SKU ayrıntıları.
tags		object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	BatchEndpoint	Resource 'BatchEndpoint' güncelleme işlemi başarılı oldu
201 Created	BatchEndpoint	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu. Üst Bilgiler Azure-AsyncOperation: string Retry-After: integer x-ms-async-operation-timeout: string
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

BatchEndpoint

Resource 'BatchEndpoint' güncelleme işlemi başarılı oldu

201 Created

BatchEndpoint

İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.

Üst Bilgiler

Azure-AsyncOperation: string
Retry-After: integer
x-ms-async-operation-timeout: string

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

CreateOrUpdate Workspace Batch Endpoint.

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName?api-version=2025-12-01

{
  "identity": {
    "type": "SystemAssigned",
    "userAssignedIdentities": {
      "string": {}
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "description": "string",
    "authMode": "AMLToken",
    "defaults": {
      "deploymentName": "string"
    },
    "properties": {
      "string": "string"
    }
  },
  "sku": {
    "name": "string",
    "capacity": 1,
    "family": "string",
    "size": "string",
    "tier": "Free"
  },
  "tags": {}
}

Örnek yanıt

Durum kodu:: 200

{
  "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",
    "authMode": "AMLToken",
    "defaults": {
      "deploymentName": "string"
    },
    "properties": {
      "string": "string"
    },
    "provisioningState": "Succeeded",
    "scoringUri": "https://www.contoso.com/example",
    "swaggerUri": "https://www.contoso.com/example"
  },
  "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": {}
}

Durum kodu:: 201

{
  "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",
    "authMode": "AMLToken",
    "defaults": {
      "deploymentName": "string"
    },
    "properties": {
      "string": "string"
    },
    "provisioningState": "Updating",
    "scoringUri": "https://www.contoso.com/example",
    "swaggerUri": "https://www.contoso.com/example"
  },
  "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
BatchEndpoint	Belirli bir özellik türü kullanılarak bu tür diğer ad kullanılarak somut izlenen kaynak türleri oluşturulabilir.
BatchEndpointDefaults	Batch uç noktası varsayılan değerleri
BatchEndpointProperties	Batch uç nokta yapılandırması.
createdByType	Kaynağı oluşturan kimliğin türü.
EndpointAuthKeys	Uç nokta kimlik doğrulaması için anahtarlar.
EndpointAuthMode	Uç nokta kimlik doğrulama modunu belirlemek için sabit listesi.
EndpointProvisioningState	Uç nokta sağlama durumu.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata detayı.
ErrorResponse	Hata yanıtı
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).
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

BatchEndpoint

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	BatchEndpointProperties	[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"

BatchEndpointDefaults

Nesne

Batch uç noktası varsayılan değerleri

Name	Tür	Description
deploymentName	string	Uç nokta için varsayılan olacak dağıtımın adı. Uç nokta puanlama URL'si çağrıldığında bu dağıtım 100% trafik alır.

BatchEndpointProperties

Nesne

Batch uç nokta yapılandırması.

Name	Tür	Description
authMode	EndpointAuthMode	[Gerekli] Uç noktayı çağırmak için kimlik doğrulama yöntemi (veri düzlemi işlemi). Anahtar tabanlı kimlik doğrulaması için 'Anahtar' kullanın. Azure Machine Learning belirteç tabanlı kimlik doğrulaması için 'AMLToken' kullanın. Microsoft Entra belirteç tabanlı kimlik doğrulaması için 'AADToken' kullanın.
defaults	BatchEndpointDefaults	Batch Uç Noktası için varsayılan değerler
description	string	Çıkarım uç noktasının açıklaması.
keys	EndpointAuthKeys (password)	EndpointAuthKeys, başlangıçta bir Uç Noktada ayarlanır. Bu özellik her zaman null olarak döndürülür. AuthKey değerleri ListKeys API'sini kullanarak alınmalıdır.
properties	object	Özellik sözlüğü. Özellikler eklenebilir, ancak kaldırılamaz veya değiştirilemez.
provisioningState	EndpointProvisioningState	Uç nokta için sağlama durumu.
scoringUri	string (uri)	Uç nokta URI'si.
swaggerUri	string (uri)	Uç Nokta Swagger URI'si.

createdByType

Numaralandırma

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

Değer	Description
User
Application
ManagedIdentity
Key

EndpointAuthKeys

Nesne

Uç nokta kimlik doğrulaması için anahtarlar.

Name	Tür	Description
primaryKey	string (password)	Birincil anahtar.
secondaryKey	string (password)	İkincil anahtar.

EndpointAuthMode

Numaralandırma

Uç nokta kimlik doğrulama modunu belirlemek için sabit listesi.

Değer	Description
AMLToken
Key
AADToken

EndpointProvisioningState

Numaralandırma

Uç nokta sağlama durumu.

Değer	Description
Creating
Deleting
Succeeded
Failed
Updating
Canceled

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.

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

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 Endpoints - Create Or Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

CreateOrUpdate Workspace Batch Endpoint.

Örnek isteği

Örnek yanıt

Tanımlar

BatchEndpoint

BatchEndpointDefaults

BatchEndpointProperties

createdByType

EndpointAuthKeys

EndpointAuthMode

EndpointProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

Sku

SkuTier

systemData

UserAssignedIdentity