Batch Deployments - Create Or Update

Crée/met à jour un déploiement d’inférence de lot.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments/{deploymentName}?api-version=2021-03-01-preview

Paramètres URI

Name In Required Type Description
deploymentName
path True
  • string

Identificateur du déploiement de l’inférence de lot.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

endpointName
path True
  • string

Nom du point de terminaison d’inférence

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

resourceGroupName
path True
  • string

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True
  • string

ID de l’abonnement cible.

workspaceName
path True
  • string

Nom de Azure Machine Learning espace de travail.

api-version
query True
  • string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Name Required Type Description
location True
  • string

Emplacement géographique dans lequel la ressource réside

properties True

Attributs supplémentaires de l’entité.

identity

Identité de service associée à une ressource.

kind
  • string
tags
  • object

Balises de ressource.

Réponses

Name Type Description
200 OK

Succès

201 Created

Date de création

Other Status Codes

Error

Exemples

CreateOrUpdate Batch Deployment.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/batchEndpoints/testBatchEndpoint/deployments/testBatchDeployment?api-version=2021-03-01-preview
{
  "tags": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuseridentity": {
        "principalId": "string",
        "clientId": "string"
      }
    }
  },
  "properties": {
    "compute": {
      "target": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/computes/testcompute",
      "instanceCount": 0,
      "isLocal": false,
      "location": "string",
      "instanceType": "string",
      "properties": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    },
    "errorThreshold": 0,
    "retrySettings": {
      "maxRetries": 0,
      "timeout": "string"
    },
    "partitionKeys": [
      "string"
    ],
    "miniBatchSize": 0,
    "loggingLevel": "Info",
    "outputConfiguration": {
      "outputAction": "SummaryOnly",
      "appendRowFileName": "string"
    },
    "description": "string",
    "properties": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "model": {
      "referenceType": "Id",
      "assetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/models/testmodel/versions/1"
    },
    "codeConfiguration": {
      "codeId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/codes/testcode/versions/1",
      "scoringScript": "score.py"
    },
    "environmentId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/environments/myenv",
    "environmentVariables": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/batchEndpoints/testBatchEndpoint/deployments/testBatchDeployment",
  "name": "testBatchDeployment",
  "type": "Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments",
  "tags": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuseridentity": {
        "clientId": "string"
      }
    }
  },
  "properties": {
    "compute": {
      "target": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/computes/testcompute",
      "instanceCount": 0,
      "isLocal": false,
      "location": "string",
      "instanceType": "string",
      "properties": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    },
    "errorThreshold": 0,
    "retrySettings": {
      "maxRetries": 0,
      "timeout": "string"
    },
    "partitionKeys": [
      "string"
    ],
    "miniBatchSize": 0,
    "loggingLevel": "Info",
    "outputConfiguration": {
      "outputAction": "SummaryOnly",
      "appendRowFileName": "string"
    },
    "description": "string",
    "properties": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "model": {
      "referenceType": "Id",
      "assetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/models/testmodel/versions/1"
    },
    "codeConfiguration": {
      "codeId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/codes/testcode/versions/1",
      "scoringScript": "score.py"
    },
    "environmentId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/environments/myenv",
    "environmentVariables": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  },
  "systemData": {
    "createdAt": "2021-03-25T20:46:47.062Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2021-03-25T20:46:47.062Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/batchEndpoints/testBatchEndpoint/deployments/testBatchDeployment",
  "name": "testBatchDeployment",
  "type": "Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments",
  "tags": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuseridentity": {
        "clientId": "string"
      }
    }
  },
  "properties": {
    "compute": {
      "target": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/computes/testcompute",
      "instanceCount": 0,
      "isLocal": false,
      "location": "string",
      "instanceType": "string",
      "properties": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    },
    "errorThreshold": 0,
    "retrySettings": {
      "maxRetries": 0,
      "timeout": "string"
    },
    "partitionKeys": [
      "string"
    ],
    "miniBatchSize": 0,
    "loggingLevel": "Info",
    "outputConfiguration": {
      "outputAction": "SummaryOnly",
      "appendRowFileName": "string"
    },
    "description": "string",
    "properties": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "model": {
      "referenceType": "Id",
      "assetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/models/testmodel/versions/1"
    },
    "codeConfiguration": {
      "codeId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/codes/testcode/versions/1",
      "scoringScript": "score.py"
    },
    "environmentId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/environments/myenv",
    "environmentVariables": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  },
  "systemData": {
    "createdAt": "2021-03-25T20:46:47.062Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2021-03-25T20:46:47.062Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Définitions

BatchDeployment

Paramètres d’inférence de lot par déploiement.

BatchDeploymentTrackedResource
BatchLoggingLevel

Commentaires du journal pour l’inférence par lot. L’ordre de commentaires accru pour la journalisation est : Warning, info et Debug. La valeur par défaut est info.

BatchOutputAction

Enum pour déterminer comment l’inférence par lot gèrera la sortie

BatchOutputConfiguration

Configuration de la sortie de l’inférence de traitement.

BatchRetrySettings

Paramètres de nouvelle tentative pour une opération d’inférence de lot.

CodeConfiguration

Configuration pour une ressource de code d’évaluation.

ComputeConfiguration

Configuration de la liaison de calcul.

createdByType

Type d’identité qui a créé la ressource.

DataPathAssetReference

Référence à une ressource via son chemin d’accès dans un magasin de banques.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

IdAssetReference

Référence à un élément multimédia via son ID de ressource ARM.

OutputPathAssetReference

Référence à une ressource via son chemin d’accès dans une sortie de travail.

ReferenceType

Enum pour déterminer la méthode de référence à utiliser pour un élément multimédia.

ResourceIdentity

Identité de service associée à une ressource.

ResourceIdentityAssignment

Définit des valeurs pour le type d’un ResourceIdentity.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

UserAssignedIdentityMeta

Identités affectées par l’utilisateur associées à une ressource.

BatchDeployment

Paramètres d’inférence de lot par déploiement.

Name Type Description
codeConfiguration

Configuration du code pour le déploiement du point de terminaison.

compute

Configuration de la liaison de calcul.

description
  • string

Description du déploiement du point de terminaison.

environmentId
  • string

ID de ressource ARM de la spécification de l’environnement pour le déploiement du point de terminaison.

environmentVariables
  • object

Configuration des variables d’environnement pour le déploiement.

errorThreshold
  • integer

Seuil d’erreur, si le nombre d’erreurs pour la totalité de l’entrée est supérieur à cette valeur, l’inférence du lot sera abandonnée. La plage est [-1, entier. MaxValue]. Pour FileDataset, cette valeur est le nombre d’échecs de fichier. Pour TabularDataset, cette valeur est le nombre d’échecs d’enregistrement. Si la valeur est égale à-1 (limite inférieure), tous les échecs pendant l’inférence de traitement seront ignorés.

loggingLevel

Niveau de journalisation pour l’opération d’inférence de lot.

miniBatchSize
  • integer

Taille du mini-lot passé à chaque appel de lot. Pour FileDataset, il s’agit du nombre de fichiers par mini-lot. Pour TabularDataset, il s’agit de la taille des enregistrements en octets, par mini-lot.

model AssetReferenceBase:

Référence à l’élément multimédia du modèle pour le déploiement du point de terminaison.

outputConfiguration

Configuration de sortie pour l’opération d’inférence de lot.

partitionKeys
  • string[]

Liste de clés de partition utilisée pour le partitionnement nommé.

properties
  • object

Dictionnaire de propriétés. Les propriétés peuvent être ajoutées, mais pas supprimées ou modifiées.

retrySettings

Paramètres de nouvelle tentative pour l’opération d’inférence de lot.

BatchDeploymentTrackedResource

Name Type Description
id
  • string

ID de ressource complet pour la ressource. Ex-/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identité de service associée à une ressource.

kind
  • string
location
  • string

Emplacement géographique dans lequel la ressource réside

name
  • string

nom de la ressource.

properties

Attributs supplémentaires de l’entité.

systemData

Données système associées au fournisseur de ressources

tags
  • object

Balises de ressource.

type
  • string

Type de la ressource. Par exemple, « Microsoft. Compute/virtualMachines » ou « Microsoft. Storage/storageAccounts »

BatchLoggingLevel

Commentaires du journal pour l’inférence par lot. L’ordre de commentaires accru pour la journalisation est : Warning, info et Debug. La valeur par défaut est info.

Name Type Description
Debug
  • string
Info
  • string
Warning
  • string

BatchOutputAction

Enum pour déterminer comment l’inférence par lot gèrera la sortie

Name Type Description
AppendRow
  • string
SummaryOnly
  • string

BatchOutputConfiguration

Configuration de la sortie de l’inférence de traitement.

Name Type Description
appendRowFileName
  • string

Nom du fichier de sortie personnalisé pour append_row action de sortie.

outputAction

Indique comment la sortie sera organisée.

BatchRetrySettings

Paramètres de nouvelle tentative pour une opération d’inférence de lot.

Name Type Description
maxRetries
  • integer

Nombre maximal de nouvelles tentatives pour un mini-lot

timeout
  • string

Délai d’attente d’invocation pour un mini-lot, au format ISO 8601.

CodeConfiguration

Configuration pour une ressource de code d’évaluation.

Name Type Description
codeId
  • string

ID de ressource ARM de la ressource de code.

scoringScript
  • string

Script à exécuter au démarrage. par exemple « score.py »

ComputeConfiguration

Configuration de la liaison de calcul.

Name Type Description
instanceCount
  • integer

Nombre d’instances ou de nœuds.

instanceType
  • string

Type de référence (SKU) à exécuter sur.

isLocal
  • boolean

Affectez la valeur true pour les travaux en cours d’exécution sur le calcul local.

location
  • string

Emplacement de l’exécution du cluster virtuel.

properties
  • object

Propriétés supplémentaires.

target
  • string

ID de ressource ARM de la ressource de calcul.

createdByType

Type d’identité qui a créé la ressource.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DataPathAssetReference

Référence à une ressource via son chemin d’accès dans un magasin de banques.

Name Type Description
datastoreId
  • string

ID de ressource ARM du magasin de stockage où se trouve la ressource.

path
  • string

Chemin d’accès du fichier/répertoire dans le magasin de banques.

referenceType string:
  • DataPath

Spécifie le type de référence de ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Name Type Description
info
  • object

Informations supplémentaires.

type
  • string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Name Type Description
additionalInfo

Informations supplémentaires sur l’erreur.

code
  • string

Code d'erreur.

details

Détails de l’erreur.

message
  • string

Message d’erreur.

target
  • string

Cible de l’erreur.

ErrorResponse

Réponse d’erreur

Name Type Description
error

Objet d’erreur.

IdAssetReference

Référence à un élément multimédia via son ID de ressource ARM.

Name Type Description
assetId
  • string

ID de ressource ARM de la ressource.

referenceType string:
  • Id

Spécifie le type de référence de ressource.

OutputPathAssetReference

Référence à une ressource via son chemin d’accès dans une sortie de travail.

Name Type Description
jobId
  • string

ID de ressource ARM du travail.

path
  • string

Chemin d’accès du fichier/répertoire dans la sortie du travail.

referenceType string:
  • OutputPath

Spécifie le type de référence de ressource.

ReferenceType

Enum pour déterminer la méthode de référence à utiliser pour un élément multimédia.

Name Type Description
DataPath
  • string
Id
  • string
OutputPath
  • string

ResourceIdentity

Identité de service associée à une ressource.

Name Type Description
principalId
  • string

ID client utilisé lors de l’authentification.

tenantId
  • string

Locataire AAD dans lequel cette identité réside.

type

Définit des valeurs pour le type d’un ResourceIdentity.

userAssignedIdentities

Dictionnaire des identités affectées par l’utilisateur, la clé est l’ID de ressource ARM du UAI.

ResourceIdentityAssignment

Définit des valeurs pour le type d’un ResourceIdentity.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Name Type Description
createdAt
  • string

Horodatage de la création de ressources (UTC).

createdBy
  • string

Identité qui a créé la ressource.

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt
  • string

Horodateur de la dernière modification de la ressource (UTC)

lastModifiedBy
  • string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

Type d’identité qui a modifié la ressource pour la dernière fois.

UserAssignedIdentityMeta

Identités affectées par l’utilisateur associées à une ressource.

Name Type Description
clientId
  • string

Alias de l’application, identificateur unique généré par Azure AD qui est lié à une application et un principal du service lors de son approvisionnement initial.

principalId
  • string

ID d’objet de l’objet principal de service pour votre identité managée qui est utilisé pour accorder l’accès en fonction du rôle à une ressource Azure.