Batch Endpoints - Create Or Update

Szolgáltatás:: Machine Learning

API verzió:: 2025-12-01

Hozz létre egy batch inference endpointet (aszinkron).
Létrehoz egy kötegelt következtetési végpontot (aszinkron).

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

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

Kérő Testület

Név	Szükséges	Típus	Leírás
location	True	string	Az a földrajzi hely, ahol az erőforrás él
properties	True	BatchEndpointProperties	[Kötelező] Az entitás további attribútumai.
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.
sku		Sku	Az automatikus skálázáshoz szükséges ARM-szerződéshez szükséges termékváltozat részletei.
tags		object	Erőforráscímkék.

Válaszok

Név	Típus	Leírás
200 OK	BatchEndpoint	A 'BatchEndpoint' erőforrás frissítési művelete sikeres
201 Created	BatchEndpoint	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre. Fejlécek Azure-AsyncOperation: string Retry-After: integer x-ms-async-operation-timeout: string
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Név

Típus

Leírás

200 OK

BatchEndpoint

A 'BatchEndpoint' erőforrás frissítési művelete sikeres

201 Created

BatchEndpoint

A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.

Fejlécek

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

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

CreateOrUpdate Workspace Batch Endpoint.

Mintakérés

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

Mintaválasz

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

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

Meghatározások

Név	Leírás
BatchEndpoint	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.
BatchEndpointDefaults	Batch-végpont alapértelmezett értékei
BatchEndpointProperties	Batch-végpont konfigurálása.
createdByType	Az erőforrást létrehozó identitás típusa.
EndpointAuthKeys	Kulcsok a végponthitelesítéshez.
EndpointAuthMode	Enum a végpont-hitelesítési mód meghatározásához.
EndpointProvisioningState	A végpont kiépítésének állapota.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
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).
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

BatchEndpoint

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

BatchEndpointDefaults

Tárgy

Batch-végpont alapértelmezett értékei

Név	Típus	Leírás
deploymentName	string	Annak az üzembe helyezésnek a neve, amely alapértelmezés szerint a végponthoz lesz bekapcsolva. Ez az üzembe helyezés végül 100% forgalmat kap a végpont pontozási URL-címének meghívásakor.

BatchEndpointProperties

Tárgy

Batch-végpont konfigurálása.

Név	Típus	Leírás
authMode	EndpointAuthMode	[Kötelező] A végpont meghívásának hitelesítési módszere (adatsík-művelet). Kulcsalapú hitelesítéshez használja a "Key" (Kulcs) parancsot. Használja az "AMLToken" parancsot az Azure Machine Learning tokenalapú hitelesítéséhez. Használja az "AADToken" parancsot a Microsoft Entra tokenalapú hitelesítéshez.
defaults	BatchEndpointDefaults	A Batch-végpont alapértelmezett értékei
description	string	A következtetési végpont leírása.
keys	EndpointAuthKeys (password)	EndpointAuthKeys, amely először egy végponton van beállítva. Ezt a tulajdonságot a rendszer mindig null értékként adja vissza. Az AuthKey-értékeket a ListKeys API használatával kell lekérni.
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	EndpointProvisioningState	A végpont kiépítési állapota.
scoringUri	string (uri)	Végpont URI-ja.
swaggerUri	string (uri)	Végpont hencegő URI-ja.

createdByType

Felsorolás

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

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

EndpointAuthKeys

Tárgy

Kulcsok a végponthitelesítéshez.

Név	Típus	Leírás
primaryKey	string (password)	Az elsődleges kulcs.
secondaryKey	string (password)	A másodlagos kulcs.

EndpointAuthMode

Felsorolás

Enum a végpont-hitelesítési mód meghatározásához.

Érték	Leírás
AMLToken
Key
AADToken

EndpointProvisioningState

Felsorolás

A végpont kiépítésének állapota.

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

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.

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

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

URI paraméterek

Kérő Testület

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

CreateOrUpdate Workspace Batch Endpoint.

Mintakérés

Mintaválasz

Meghatározások

BatchEndpoint

BatchEndpointDefaults

BatchEndpointProperties

createdByType

EndpointAuthKeys

EndpointAuthMode

EndpointProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

Sku

SkuTier

systemData

UserAssignedIdentity