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


Batch Deployments - Create Or Update

Kötegkövető üzembe helyezést hoz létre/frissít (aszinkron).

PUT 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
deploymentName
path True

string

A Batch-következtetés üzembe helyezésének azonosítója.

Reguláris kifejezési minta: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

endpointName
path True

string

Következtetésvégpont neve

Reguláris kifejezési minta: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

resourceGroupName
path True

string

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
path True

string

A cél-előfizetés azonosítója.

workspaceName
path True

string

Az Azure Machine Learning-munkaterület neve.

Reguláris kifejezési minta: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$

api-version
query True

string

A művelethez használni kívánt API-verzió.

Kérelem törzse

Name Kötelező Típus Description
location True

string

Az a földrajzi hely, ahol az erőforrás él

properties True

BatchDeployment

[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

Name Típus Description
200 OK

BatchDeploymentTrackedResource

A létrehozási vagy frissítési kérés sikeres.

201 Created

BatchDeploymentTrackedResource

Létrehozott

Fejlécek

  • x-ms-async-operation-timeout: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Hiba

Példák

CreateOrUpdate Workspace Batch Deployment.

Mintakérelem

PUT 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",
    "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": {
          "cd3c37dc-2876-4ca4-8a54-21bd7619724a": null
        }
      }
    }
  },
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "SystemAssigned",
    "userAssignedIdentities": {
      "string": {}
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  }
}

Mintaválasz

{
  "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": {
          "4939850d-8eae-4343-8566-0826259a2ad1": 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
  }
}
{
  "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": {
          "b76755e4-16bf-45d4-b625-6634df7444cc": 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
  }
}

Definíciók

Name Description
BatchDeployment

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

BatchDeploymentConfigurationType

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

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

BatchOutputAction

Enum annak meghatározásához, hogy a kötegelt következtetés hogyan fogja kezelni a kimenetet

BatchPipelineComponentDeploymentConfiguration

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

BatchRetrySettings

Kötegelt következtetési művelet beállításainak újrapróbálkozása.

CodeConfiguration

Pontozókód-objektum konfigurációja.

createdByType

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

DataPathAssetReference

Hivatkozás egy adategységre az adattárban lévő elérési útján 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 objektumra az ARM-erőforrásazonosítójá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 objektumra a feladat kimenetében lévő elérési útján keresztül.

ReferenceType

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ó

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

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

Name Típus Alapértelmezett érték Description
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

-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

BatchLoggingLevel

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

BatchOutputAction

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

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.

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

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

BatchDeployment

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

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

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

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:

DataPath

[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

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

Hibaválasz

Name Típus Description
error

ErrorDetail

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

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

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:

OutputPath

[Kötelező] Az eszközhivatkozás típusát adja meg.

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

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

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

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

createdByType

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.