Batch Deployments - Update
Kötegelt következtetés üzembe helyezésének frissítése (aszinkron).
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments/{deploymentName}?api-version=2024-04-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
deployment
|
path | True |
string |
A Batch-következtetés üzembe helyezésének azonosítója. Reguláris kifejezési minta: |
endpoint
|
path | True |
string |
Következtetésvégpont neve Reguláris kifejezési minta: |
resource
|
path | True |
string |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
workspace
|
path | True |
string |
Az Azure Machine Learning-munkaterület neve. Reguláris kifejezési minta: |
api-version
|
query | True |
string |
A művelethez használni kívánt API-verzió. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
properties |
Az entitás további attribútumai. |
|
tags |
object |
Erőforráscímkék. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Siker |
|
202 Accepted |
Elfogadott Fejlécek
|
|
Other Status Codes |
Hiba |
Példák
Update Workspace Batch Deployment.
Mintakérelem
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments/testDeploymentName?api-version=2024-04-01
{
"properties": {
"description": "string"
},
"tags": {}
}
Mintaválasz
Location: example_location
{
"id": "string",
"name": "string",
"type": "string",
"properties": {
"description": "string",
"properties": {
"string": "string"
},
"codeConfiguration": {
"codeId": "string",
"scoringScript": "string"
},
"environmentId": "string",
"environmentVariables": {
"string": "string"
},
"compute": "string",
"errorThreshold": 1,
"retrySettings": {
"maxRetries": 1,
"timeout": "PT5M"
},
"miniBatchSize": 1,
"loggingLevel": "Info",
"model": {
"referenceType": "Id",
"assetId": "string"
},
"maxConcurrencyPerInstance": 1,
"outputAction": "SummaryOnly",
"outputFileName": "string",
"resources": {
"instanceCount": 1,
"instanceType": "string",
"properties": {
"string": {
"1e5e1cf9-b0ea-4cf6-9764-e750bf85c10a": null
}
}
},
"provisioningState": "Creating"
},
"systemData": {
"createdAt": "2020-01-01T12:34:56.999Z",
"createdBy": "string",
"createdByType": "User",
"lastModifiedAt": "2020-01-01T12:34:56.999Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User"
},
"tags": {},
"location": "string",
"kind": "string",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-1111-2222-3333-444444444444",
"tenantId": "00000000-1111-2222-3333-444444444444",
"userAssignedIdentities": {
"string": {
"principalId": "00000000-1111-2222-3333-444444444444",
"clientId": "00000000-1111-2222-3333-444444444444"
}
}
},
"sku": {
"name": "string",
"tier": "Free",
"size": "string",
"family": "string",
"capacity": 1
}
}
Location: example_location
Definíciók
Name | Description |
---|---|
Batch |
Batch-következtetési beállítások üzemelő példányonként. |
Batch |
A kötegelt telepítések enumerált tulajdonságtípusai. |
Batch |
|
Batch |
Napló részletessége a kötegelt következtetéshez. A naplózás részletességi sorrendjének növelése: Figyelmeztetés, Információ és Hibakeresés. Az alapértelmezett érték az Információ. |
Batch |
Enum annak meghatározásához, hogy a kötegelt következtetés hogyan fogja kezelni a kimenetet |
Batch |
Batch Pipeline-összetevő üzembe helyezésének tulajdonságai. |
Batch |
Kötegelt következtetési művelet beállításainak újrapróbálkozása. |
Code |
Pontozókód-objektum konfigurációja. |
created |
Az erőforrást létrehozó identitás típusa. |
Data |
Hivatkozás egy adategységre az adattárban lévő elérési útján keresztül. |
Deployment |
A DeploymentProvisioningState lehetséges értékei. |
Deployment |
|
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Id |
Hivatkozás egy objektumra az ARM-erőforrásazonosítóján keresztül. |
Managed |
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások) |
Managed |
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). |
Output |
Hivatkozás egy objektumra a feladat kimenetében lévő elérési útján keresztül. |
Partial |
A kötegek lekérdezési beállításai üzembe helyezésenként. |
Partial |
Szigorúan a frissítési kérelmekben használják. |
Reference |
Szám az eszközhöz használandó referenciametódus meghatározásához. |
Sku |
A termékváltozatot képviselő erőforrásmodell-definíció |
Sku |
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. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
User |
Felhasználó által hozzárendelt identitástulajdonságok |
BatchDeployment
Batch-következtetési beállítások üzemelő példányonként.
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
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: |
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 |
-1 |
Hibaküszöb, ha a teljes bemenet hibaszáma meghaladja ezt az értéket, a köteg-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 | Info |
Naplózási szint a kötegelt következtetési művelethez. |
|
maxConcurrencyPerInstance |
integer |
1 |
A példányonkénti párhuzamosság maximális számát jelzi. |
miniBatchSize |
integer |
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: |
Hivatkozás a végpont üzembe helyezéséhez használt modelleszközre. |
|
outputAction | AppendRow |
A kimenet rendszerezését jelzi. |
|
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 |
A végpont üzembe helyezésének kiépítési állapota. |
||
resources |
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 |
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. |
BatchDeploymentConfigurationType
A kötegelt telepítések enumerált tulajdonságtípusai.
Name | Típus | Description |
---|---|---|
Model |
string |
|
PipelineComponent |
string |
BatchDeploymentTrackedResource
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
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 |
[Kötelező] Az entitás további attribútumai. |
|
sku |
Az automatikus skálázáshoz szükséges ARM-szerződéshez szükséges termékváltozat részletei. |
|
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" |
BatchLoggingLevel
Napló részletessége a kötegelt következtetéshez. A naplózás részletességi sorrendjének növelése: Figyelmeztetés, Információ és Hibakeresés. Az alapértelmezett érték az Információ.
Name | Típus | Description |
---|---|---|
Debug |
string |
|
Info |
string |
|
Warning |
string |
BatchOutputAction
Enum annak meghatározásához, hogy a kötegelt következtetés hogyan fogja kezelni a kimenetet
Name | Típus | Description |
---|---|---|
AppendRow |
string |
|
SummaryOnly |
string |
BatchPipelineComponentDeploymentConfiguration
Batch Pipeline-összetevő üzembe helyezésének tulajdonságai.
Name | Típus | Description |
---|---|---|
componentId |
A futtatni kívánt összetevő ARM-azonosítója. |
|
deploymentConfigurationType |
string:
Pipeline |
[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
Kötegelt következtetési művelet beállításainak újrapróbálkozása.
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
maxRetries |
integer |
3 |
Mini köteg újrapróbálkozásainak maximális száma |
timeout |
string |
PT30S |
Egy mini köteg meghívási időtúllépése ISO 8601 formátumban. |
CodeConfiguration
Pontozókód-objektum konfigurációja.
Name | Típus | Description |
---|---|---|
codeId |
string |
A kódobjektum ARM-erőforrás-azonosítója. |
scoringScript |
string |
[Kötelező] Az indításkor végrehajtandó szkript. Pl.. "score.py" |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataPathAssetReference
Hivatkozás egy adategységre az adattárban lévő elérési útján keresztül.
Name | Típus | Description |
---|---|---|
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:
Data |
[Kötelező] Az eszközhivatkozás típusát adja meg. |
DeploymentProvisioningState
A DeploymentProvisioningState lehetséges értékei.
Name | Típus | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Scaling |
string |
|
Succeeded |
string |
|
Updating |
string |
DeploymentResourceConfiguration
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
instanceCount |
integer |
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 |
object |
További tulajdonságok táska. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
IdAssetReference
Hivatkozás egy objektumra az ARM-erőforrásazonosítóján keresztül.
Name | Típus | Description |
---|---|---|
assetId |
string |
[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
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
Name | Típus | Description |
---|---|---|
principalId |
string |
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 |
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 |
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). |
|
userAssignedIdentities |
<string,
User |
User-Assigned 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).
Name | Típus | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
OutputPathAssetReference
Hivatkozás egy objektumra a feladat kimenetében lévő elérési útján keresztül.
Name | Típus | Description |
---|---|---|
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:
Output |
[Kötelező] Az eszközhivatkozás típusát adja meg. |
PartialBatchDeployment
A kötegek lekérdezési beállításai üzembe helyezésenként.
Name | Típus | Description |
---|---|---|
description |
string |
A végpont üzembe helyezésének leírása. |
PartialBatchDeploymentPartialMinimalTrackedResourceWithProperties
Szigorúan a frissítési kérelmekben használják.
Name | Típus | Description |
---|---|---|
properties |
Az entitás további attribútumai. |
|
tags |
object |
Erőforráscímkék. |
ReferenceType
Szám az eszközhöz használandó referenciametódus meghatározásához.
Name | Típus | Description |
---|---|---|
DataPath |
string |
|
Id |
string |
|
OutputPath |
string |
Sku
A termékváltozatot képviselő erőforrásmodell-definíció
Name | Típus | Description |
---|---|---|
capacity |
integer |
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 |
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
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.
Name | Típus | Description |
---|---|---|
Basic |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
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 |
Az erőforrást legutóbb módosító identitás típusa. |
UserAssignedIdentity
Felhasználó által hozzárendelt identitástulajdonságok
Name | Típus | Description |
---|---|---|
clientId |
string |
A hozzárendelt identitás ügyfélazonosítója. |
principalId |
string |
A hozzárendelt identitás egyszerű azonosítója. |