Projects - Train

Servicio:: Azure AI Services

Versión de la API:: 3.3

Pone en cola el proyecto para entrenamiento.

POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/train

Con parámetros opcionales:

POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/train?trainingType={trainingType}&reservedBudgetInHours={reservedBudgetInHours}&forceTrain={forceTrain}&notificationEmailAddress={notificationEmailAddress}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos.
projectId	path	True	string (uuid)	Identificador del proyecto.
forceTrain	query		boolean	Si se va a forzar el entrenamiento aunque el conjunto de datos y la configuración no cambien (valor predeterminado: false).
notificationEmailAddress	query		string	Dirección de correo electrónico a la que se va a enviar una notificación cuando finaliza el entrenamiento (valor predeterminado: null).
reservedBudgetInHours	query		integer (int32)	Número de horas reservadas como presupuesto para el entrenamiento (si procede).
trainingType	query		string	Tipo de entrenamiento que se va a usar para entrenar el proyecto (valor predeterminado: Normal).

Encabezado de la solicitud

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Nombre	Requerido	Tipo	Description
Training-Key	True	string

Cuerpo de la solicitud

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Nombre	Tipo	Description
selectedTags	string[] (uuid)	Lista de etiquetas seleccionadas para esta sesión de entrenamiento, se omitirán otras etiquetas del proyecto.

Respuestas

Nombre	Tipo	Description
200 OK	Iteration	De acuerdo Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	CustomVisionError	Respuesta de error Media Types: "application/json", "application/xml", "text/xml"

Nombre

Tipo

Description

200 OK

Iteration

De acuerdo

Media Types: "application/json", "application/xml", "text/xml"

Other Status Codes

CustomVisionError

Respuesta de error

Media Types: "application/json", "application/xml", "text/xml"

Seguridad

Training-Key

Tipo: apiKey
En: header

Ejemplos

Successful TrainProject request

Solicitud de ejemplo

HTTP

POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/train


{}

Respuesta de muestra

status code:: 200

{
  "id": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
  "name": "Iteration 2",
  "status": "Training",
  "created": "2017-12-18T22:40:36Z",
  "lastModified": "2017-12-19T15:46:58Z",
  "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
  "exportable": false,
  "domainId": null,
  "exportableTo": [
    "ONNX",
    "DockerFile",
    "TensorFlow",
    "CoreML"
  ],
  "trainingType": "Regular",
  "reservedBudgetInHours": 0,
  "publishName": ""
}

Definiciones

Nombre	Description
Classifier	Obtiene el tipo de clasificación del proyecto.
CustomVisionError
CustomVisionErrorCodes	Código de error.
ExportableTo	Un conjunto de plataformas a las que se puede exportar esta iteración.
Iteration	Modelo de iteración que se va a enviar a través de JSON.
TrainingParameters	Parámetros usados para el entrenamiento.
TrainingType	Obtiene el tipo de entrenamiento de la iteración.

Classifier

Enumeración

Obtiene el tipo de clasificación del proyecto.

Valor	Description
Multiclass
Multilabel

CustomVisionError

Object

Nombre	Tipo	Description
code	CustomVisionErrorCodes	Código de error.
message	string	Mensaje que explica el error notificado por el servicio.

CustomVisionErrorCodes

Enumeración

Código de error.

Valor	Description
NoError
BadRequest
BadRequestExceededBatchSize
BadRequestNotSupported
BadRequestInvalidIds
BadRequestProjectName
BadRequestProjectNameNotUnique
BadRequestProjectDescription
BadRequestProjectUnknownDomain
BadRequestProjectUnknownClassification
BadRequestProjectUnsupportedDomainTypeChange
BadRequestProjectUnsupportedExportPlatform
BadRequestProjectImagePreprocessingSettings
BadRequestProjectDuplicated
BadRequestIterationName
BadRequestIterationNameNotUnique
BadRequestIterationDescription
BadRequestIterationIsNotTrained
BadRequestIterationValidationFailed
BadRequestWorkspaceCannotBeModified
BadRequestWorkspaceNotDeletable
BadRequestTagName
BadRequestTagNameNotUnique
BadRequestTagDescription
BadRequestTagType
BadRequestMultipleNegativeTag
BadRequestMultipleGeneralProductTag
BadRequestImageTags
BadRequestImageRegions
BadRequestNegativeAndRegularTagOnSameImage
BadRequestUnsupportedDomain
BadRequestRequiredParamIsNull
BadRequestIterationIsPublished
BadRequestInvalidPublishName
BadRequestInvalidPublishTarget
BadRequestUnpublishFailed
BadRequestIterationNotPublished
BadRequestSubscriptionApi
BadRequestExceedProjectLimit
BadRequestExceedIterationPerProjectLimit
BadRequestExceedTagPerProjectLimit
BadRequestExceedTagPerImageLimit
BadRequestExceededQuota
BadRequestCannotMigrateProjectWithName
BadRequestNotLimitedTrial
BadRequestImageBatch
BadRequestImageStream
BadRequestImageUrl
BadRequestImageFormat
BadRequestImageSizeBytes
BadRequestImageDimensions
BadRequestImageExceededCount
BadRequestTrainingNotNeeded
BadRequestTrainingNotNeededButTrainingPipelineUpdated
BadRequestTrainingValidationFailed
BadRequestClassificationTrainingValidationFailed
BadRequestMultiClassClassificationTrainingValidationFailed
BadRequestMultiLabelClassificationTrainingValidationFailed
BadRequestDetectionTrainingValidationFailed
BadRequestTrainingAlreadyInProgress
BadRequestDetectionTrainingNotAllowNegativeTag
BadRequestInvalidEmailAddress
BadRequestDomainNotSupportedForAdvancedTraining
BadRequestExportPlatformNotSupportedForAdvancedTraining
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining
BadRequestExportValidationFailed
BadRequestExportAlreadyInProgress
BadRequestPredictionIdsMissing
BadRequestPredictionIdsExceededCount
BadRequestPredictionTagsExceededCount
BadRequestPredictionResultsExceededCount
BadRequestPredictionInvalidApplicationName
BadRequestPredictionInvalidQueryParameters
BadRequestInvalidImportToken
BadRequestExportWhileTraining
BadRequestImageMetadataKey
BadRequestImageMetadataValue
BadRequestOperationNotSupported
BadRequestInvalidArtifactUri
BadRequestCustomerManagedKeyRevoked
BadRequestInvalid
UnsupportedMediaType
Forbidden
ForbiddenUser
ForbiddenUserResource
ForbiddenUserSignupDisabled
ForbiddenUserSignupAllowanceExceeded
ForbiddenUserDoesNotExist
ForbiddenUserDisabled
ForbiddenUserInsufficientCapability
ForbiddenDRModeEnabled
ForbiddenInvalid
NotFound
NotFoundProject
NotFoundProjectDefaultIteration
NotFoundIteration
NotFoundIterationPerformance
NotFoundTag
NotFoundImage
NotFoundDomain
NotFoundApimSubscription
NotFoundInvalid
Conflict
ConflictInvalid
ErrorUnknown
ErrorIterationCopyFailed
ErrorPreparePerformanceMigrationFailed
ErrorProjectInvalidWorkspace
ErrorProjectInvalidPipelineConfiguration
ErrorProjectInvalidDomain
ErrorProjectTrainingRequestFailed
ErrorProjectImportRequestFailed
ErrorProjectExportRequestFailed
ErrorFeaturizationServiceUnavailable
ErrorFeaturizationQueueTimeout
ErrorFeaturizationInvalidFeaturizer
ErrorFeaturizationAugmentationUnavailable
ErrorFeaturizationUnrecognizedJob
ErrorFeaturizationAugmentationError
ErrorExporterInvalidPlatform
ErrorExporterInvalidFeaturizer
ErrorExporterInvalidClassifier
ErrorPredictionServiceUnavailable
ErrorPredictionModelNotFound
ErrorPredictionModelNotCached
ErrorPrediction
ErrorPredictionStorage
ErrorRegionProposal
ErrorUnknownBaseModel
ErrorInvalid

ExportableTo

Enumeración

Un conjunto de plataformas a las que se puede exportar esta iteración.

Valor	Description
CoreML
TensorFlow
DockerFile
ONNX
VAIDK

Iteration

Object

Modelo de iteración que se va a enviar a través de JSON.

Nombre	Tipo	Description
classificationType	Classifier	Obtiene el tipo de clasificación del proyecto.
created	string (date-time)	Obtiene la hora en que se completó esta iteración.
domainId	string (uuid)	Obtiene o establece un guid del dominio en el que se ha entrenado la iteración.
exportable	boolean	Si la iteración se puede exportar a otro formato para su descarga.
exportableTo	ExportableTo[]	Un conjunto de plataformas a las que se puede exportar esta iteración.
id	string (uuid)	Obtiene el identificador de la iteración.
lastModified	string (date-time)	Obtiene la hora en que se modificó por última vez esta iteración.
name	string	Obtiene o establece el nombre de la iteración.
originalPublishResourceId	string	Identificador del proveedor de recursos en el que se publicó originalmente esta iteración.
projectId	string (uuid)	Obtiene el identificador del proyecto de la iteración.
publishName	string	Nombre del modelo publicado.
reservedBudgetInHours	integer (int32)	Obtiene el presupuesto de entrenamiento avanzado reservado para la iteración.
status	string	Obtiene el estado de iteración actual.
trainedAt	string (date-time)	Obtiene la hora en que se modificó por última vez esta iteración.
trainingTimeInMinutes	integer (int32)	Obtiene el tiempo de entrenamiento de la iteración.
trainingType	TrainingType	Obtiene el tipo de entrenamiento de la iteración.

TrainingParameters

Object

Parámetros usados para el entrenamiento.

Nombre	Tipo	Description
selectedTags	string[] (uuid)	Lista de etiquetas seleccionadas para esta sesión de entrenamiento, se omitirán otras etiquetas del proyecto.

TrainingType

Enumeración

Obtiene el tipo de entrenamiento de la iteración.

Valor	Description
Regular
Advanced

Compartir a través de

Projects - Train

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

Training-Key

Ejemplos

Successful TrainProject request

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Classifier

CustomVisionError

CustomVisionErrorCodes

ExportableTo

Iteration

TrainingParameters

TrainingType