Batch Deployments - List

Servicio:: Machine Learning

Versión de la API:: 2025-12-01

Enumera las implementaciones de inferencia por lotes en el área de trabajo.

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

Con parámetros opcionales:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments?api-version=2025-12-01&$orderBy={$orderBy}&$top={$top}&$skip={$skip}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpointName	path	True	string	Nombre del punto de conexión de Batch.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nombre del área de trabajo de Azure Machine Learning
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.
$orderBy	query		string	Ordenación de la lista.
$skip	query		string	Token de continuación para la paginación.
$top	query		integer (int32)	Parte superior de la lista.

Respuestas

Nombre	Tipo	Description
200 OK	BatchDeploymentTrackedResourceArmPaginatedResult	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

List Workspace Batch Deployment.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments?api-version=2025-12-01&$orderBy=string&$top=1

Respuesta de muestra

status code:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments?api-version=2025-07-01-preview&$skip=2",
  "value": [
    {
      "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",
        "codeConfiguration": {
          "codeId": "string",
          "scoringScript": "string"
        },
        "compute": "string",
        "environmentId": "string",
        "environmentVariables": {
          "string": "string"
        },
        "errorThreshold": 1,
        "loggingLevel": "Info",
        "maxConcurrencyPerInstance": 1,
        "miniBatchSize": 1,
        "model": {
          "assetId": "string",
          "referenceType": "Id"
        },
        "outputAction": "SummaryOnly",
        "outputFileName": "string",
        "properties": {
          "string": "string"
        },
        "provisioningState": "Creating",
        "resources": {
          "instanceCount": 1,
          "instanceType": "string",
          "properties": {
            "string": {
              "a3c13e2e-a213-4cac-9f5a-b49966906ad6": null
            }
          }
        },
        "retrySettings": {
          "maxRetries": 1,
          "timeout": "PT5M"
        }
      },
      "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": {}
    }
  ]
}

Definiciones

Nombre	Description
BatchDeployment	Los tipos de recursos de seguimiento concreto se pueden crear mediante el alias de este tipo mediante un tipo de propiedad específico.
BatchDeploymentConfigurationType	Los tipos de propiedad enumerados para implementaciones por lotes.
BatchDeploymentProperties	Configuración de inferencia por lotes por implementación.
BatchDeploymentTrackedResourceArmPaginatedResult	Una lista paginada de entidades BatchDeployment.
BatchLoggingLevel	Detalle del registro para la inferencia por lotes. El orden de detalle creciente para el registro es: Advertencia, Información y Depuración. El valor predeterminado es Info.
BatchOutputAction	Enumeración para determinar cómo la inferencia por lotes controlará la salida
BatchPipelineComponentDeploymentConfiguration	Propiedades de una implementación de componentes de canalización por lotes.
BatchRetrySettings	Reintentar la configuración de una operación de inferencia por lotes.
CodeConfiguration	Configuración de un recurso de código de puntuación.
createdByType	Tipo de identidad que creó el recurso.
DataPathAssetReference	Referencia a un activo a través de su ruta en un almacén de datos.
DeploymentProvisioningState	Valores posibles para DeploymentProvisioningState.
DeploymentResourceConfiguration
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
IdAssetReference	Referencia a un activo a través de su identificador de recurso de ARM.
ManagedServiceIdentity	Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
OutputPathAssetReference	Referencia a un recurso a través de su ruta en la salida de un trabajo.
ReferenceType	Enumeración para determinar qué método de referencia usar para un activo.
Sku	Definición del modelo de recursos que representa la SKU
SkuTier	El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.
systemData	Metadatos relativos a la creación y última modificación del recurso.
UserAssignedIdentity	Propiedades de identidad asignadas por el usuario

BatchDeployment

Objeto

Los tipos de recursos de seguimiento concreto se pueden crear mediante el alias de este tipo mediante un tipo de propiedad específico.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Ej: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
kind	string	Metadatos usados por el portal, las herramientas, etc. para representar diferentes experiencias de experiencia de usuario para los recursos del mismo tipo.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties	BatchDeploymentProperties	[Obligatorio] Atributos adicionales de la entidad.
sku	Sku	Detalles de SKU necesarios para el contrato arm para el escalado automático.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

BatchDeploymentConfigurationType

Enumeración

Los tipos de propiedad enumerados para implementaciones por lotes.

Valor	Description
Model
PipelineComponent

BatchDeploymentProperties

Objeto

Configuración de inferencia por lotes por implementación.

Nombre	Tipo	Valor predeterminado	Description
codeConfiguration	CodeConfiguration		Configuración de código para la implementación del punto de conexión.
compute	string		Destino de proceso para la operación de inferencia por lotes.
deploymentConfiguration	BatchDeploymentConfiguration: BatchPipelineComponentDeploymentConfiguration		Propiedades relevantes para diferentes tipos de implementación.
description	string		Descripción de la implementación del punto de conexión.
environmentId	string		Identificador de recurso de ARM o AssetId de la especificación del entorno para la implementación del punto de conexión.
environmentVariables	object		Configuración de variables de entorno para la implementación.
errorThreshold	integer (int32)	-1	Umbral de error, si el recuento de errores de toda la entrada supera este valor, se anulará la inferencia por lotes. El intervalo es [-1, int. MaxValue]. Para FileDataset, este valor es el recuento de errores de archivo. Para TabularDataset, este valor es el recuento de errores de registro. Si se establece en -1 (límite inferior), se omitirán todos los errores durante la inferencia por lotes.
loggingLevel	BatchLoggingLevel	Info	Detalle del registro para la inferencia por lotes. El orden de detalle creciente para el registro es: Advertencia, Información y Depuración. El valor predeterminado es Info.
maxConcurrencyPerInstance	integer (int32)	1	Indica el número máximo de paralelismo por instancia.
miniBatchSize	integer (int64)	10	Tamaño del minilote pasado a cada invocación de lote. Para FileDataset, este es el número de archivos por minilote. Para TabularDataset, este es el tamaño de los registros en bytes, por minilote.
model	AssetReferenceBase: DataPathAssetReference IdAssetReference OutputPathAssetReference		Referencia al recurso de modelo para la implementación del punto de conexión.
outputAction	BatchOutputAction	AppendRow	Enumeración para determinar cómo la inferencia por lotes controlará la salida
outputFileName	string	predictions.csv	Nombre de archivo de salida personalizado para append_row acción de salida.
properties	object		Diccionario de propiedades. Se pueden agregar propiedades, pero no se pueden quitar ni modificar.
provisioningState	DeploymentProvisioningState		Estado de aprovisionamiento para la implementación del punto de conexión.
resources	DeploymentResourceConfiguration		Indica la configuración de proceso para el trabajo. Si no se proporciona, el valor predeterminado será el predeterminado definido en ResourceConfiguration.
retrySettings	BatchRetrySettings		Vuelva a intentar la configuración de la operación de inferencia por lotes. Si no se proporciona, el valor predeterminado será el predeterminado definido en BatchRetrySettings.

BatchDeploymentTrackedResourceArmPaginatedResult

Objeto

Una lista paginada de entidades BatchDeployment.

Nombre	Tipo	Description
nextLink	string (uri)	El enlace a la siguiente página de artículos
value	BatchDeployment[]	Los elementos de BatchDeployment en esta página

BatchLoggingLevel

Enumeración

Detalle del registro para la inferencia por lotes. El orden de detalle creciente para el registro es: Advertencia, Información y Depuración. El valor predeterminado es Info.

Valor	Description
Info
Warning
Debug

BatchOutputAction

Enumeración

Enumeración para determinar cómo la inferencia por lotes controlará la salida

Valor	Description
SummaryOnly
AppendRow

BatchPipelineComponentDeploymentConfiguration

Objeto

Propiedades de una implementación de componentes de canalización por lotes.

Nombre	Tipo	Description
componentId	IdAssetReference	Identificador arm del componente que se va a ejecutar.
deploymentConfigurationType	string: PipelineComponent	[Obligatorio] Tipo de la implementación
description	string	Descripción que se aplicará al trabajo.
settings	object	Configuración en tiempo de ejecución para el trabajo de canalización.
tags	object	Etiquetas que se aplicarán al trabajo.

BatchRetrySettings

Objeto

Reintentar la configuración de una operación de inferencia por lotes.

Nombre	Tipo	Valor predeterminado	Description
maxRetries	integer (int32)	3	Número máximo de reintentos para un miniproceso
timeout	string (duration)	PT30S	Tiempo de espera de invocación para un miniproceso, en formato ISO 8601.

CodeConfiguration

Objeto

Configuración de un recurso de código de puntuación.

Nombre	Tipo	Description
codeId	string	Identificador de recurso de ARM del recurso de código.
scoringScript	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obligatorio] Script que se va a ejecutar al iniciarse. eg. "score.py"

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DataPathAssetReference

Objeto

Referencia a un activo a través de su ruta en un almacén de datos.

Nombre	Tipo	Description
datastoreId	string	Identificador de recurso de ARM del almacén de datos donde se encuentra el recurso.
path	string	Ruta de acceso del archivo o directorio en el almacén de datos.
referenceType	string: DataPath	[Obligatorio] Especifica el tipo de referencia de recurso.

DeploymentProvisioningState

Enumeración

Valores posibles para DeploymentProvisioningState.

Valor	Description
Creating
Deleting
Scaling
Updating
Succeeded
Failed
Canceled

DeploymentResourceConfiguration

Objeto

Nombre	Tipo	Valor predeterminado	Description
instanceCount	integer (int32)	1	Número opcional de instancias o nodos usados por el destino de proceso.
instanceType	string		Tipo opcional de máquina virtual que se usa como compatible con el destino de proceso.
properties			Bolsa de propiedades adicionales.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IdAssetReference

Objeto

Referencia a un activo a través de su identificador de recurso de ARM.

Nombre	Tipo	Description
assetId	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obligatorio] Identificador de recurso de ARM del recurso.
referenceType	string: Id	[Obligatorio] Especifica el tipo de referencia de recurso.

ManagedServiceIdentity

Objeto

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre	Tipo	Description
principalId	string (uuid)	Identificador de entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId	string (uuid)	Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identidades de User-Assigned Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

ManagedServiceIdentityType

Enumeración

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Valor	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OutputPathAssetReference

Objeto

Referencia a un recurso a través de su ruta en la salida de un trabajo.

Nombre	Tipo	Description
jobId	string	Identificador de recurso de ARM del trabajo.
path	string	Ruta de acceso del archivo o directorio en la salida del trabajo.
referenceType	string: OutputPath	[Obligatorio] Especifica el tipo de referencia de recurso.

ReferenceType

Enumeración

Enumeración para determinar qué método de referencia usar para un activo.

Valor	Description
Id
DataPath
OutputPath

Sku

Objeto

Definición del modelo de recursos que representa la SKU

Nombre	Tipo	Description
capacity	integer (int32)	Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir.
family	string	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.
name	string	Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número
size	string	Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente.
tier	SkuTier	El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.

SkuTier

Enumeración

El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.

Valor	Description
Free
Basic
Standard
Premium

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UserAssignedIdentity

Objeto

Propiedades de identidad asignadas por el usuario

Nombre	Tipo	Description
clientId	string (uuid)	Identificador de cliente de la identidad asignada.
principalId	string (uuid)	Identificador de entidad de seguridad de la identidad asignada.

Compartir a través de

Batch Deployments - List

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

List Workspace Batch Deployment.

Solicitud de ejemplo

Respuesta de muestra

Definiciones

BatchDeployment

BatchDeploymentConfigurationType

BatchDeploymentProperties

BatchDeploymentTrackedResourceArmPaginatedResult

BatchLoggingLevel

BatchOutputAction

BatchPipelineComponentDeploymentConfiguration

BatchRetrySettings

CodeConfiguration

createdByType

DataPathAssetReference

DeploymentProvisioningState

DeploymentResourceConfiguration

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdAssetReference

ManagedServiceIdentity

ManagedServiceIdentityType

OutputPathAssetReference

ReferenceType

Sku

SkuTier

systemData

UserAssignedIdentity