Iterations - Update

Servicio:

Azure AI Services

Versión de la API:

3.3

Actualiza una iteración concreta.

PATCH {Endpoint}/customvision/v3.3/training/projects/{projectId}/iterations/{iterationId}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos.
iterationId	path	True	string (uuid)	Identificador de iteración.
projectId	path	True	string (uuid)	Identificador del proyecto.

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	Requerido	Tipo	Description
name	True	string	Obtiene o establece el nombre de la iteración.

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"

Seguridad

Training-Key

Tipo: apiKey
En: header

Ejemplos

Successful UpdateIteration request

Solicitud de ejemplo

HTTP

PATCH https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/iterations/e31a14ab-5d78-4f7b-a267-3a1e4fd8a758


{
  "name": "Best Iteration"
}

Respuesta de muestra

status code:

200

{
  "id": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
  "name": "Best Iteration",
  "status": "Completed",
  "created": "2017-12-18T22:40:36Z",
  "lastModified": "2017-12-19T15:53:07Z",
  "trainedAt": "2017-12-19T15:47:02Z",
  "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
  "exportable": false,
  "exportableTo": [
    "ONNX",
    "DockerFile",
    "TensorFlow",
    "CoreML"
  ],
  "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31",
  "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.
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
BadRequest
BadRequestCannotMigrateProjectWithName
BadRequestClassificationTrainingValidationFailed
BadRequestCustomerManagedKeyRevoked
BadRequestDetectionTrainingNotAllowNegativeTag
BadRequestDetectionTrainingValidationFailed
BadRequestDomainNotSupportedForAdvancedTraining
BadRequestExceedIterationPerProjectLimit
BadRequestExceedProjectLimit
BadRequestExceedTagPerImageLimit
BadRequestExceedTagPerProjectLimit
BadRequestExceededBatchSize
BadRequestExceededQuota
BadRequestExportAlreadyInProgress
BadRequestExportPlatformNotSupportedForAdvancedTraining
BadRequestExportValidationFailed
BadRequestExportWhileTraining
BadRequestImageBatch
BadRequestImageDimensions
BadRequestImageExceededCount
BadRequestImageFormat
BadRequestImageMetadataKey
BadRequestImageMetadataValue
BadRequestImageRegions
BadRequestImageSizeBytes
BadRequestImageStream
BadRequestImageTags
BadRequestImageUrl
BadRequestInvalid
BadRequestInvalidArtifactUri
BadRequestInvalidEmailAddress
BadRequestInvalidIds
BadRequestInvalidImportToken
BadRequestInvalidPublishName
BadRequestInvalidPublishTarget
BadRequestIterationDescription
BadRequestIterationIsNotTrained
BadRequestIterationIsPublished
BadRequestIterationName
BadRequestIterationNameNotUnique
BadRequestIterationNotPublished
BadRequestIterationValidationFailed
BadRequestMultiClassClassificationTrainingValidationFailed
BadRequestMultiLabelClassificationTrainingValidationFailed
BadRequestMultipleGeneralProductTag
BadRequestMultipleNegativeTag
BadRequestNegativeAndRegularTagOnSameImage
BadRequestNotLimitedTrial
BadRequestNotSupported
BadRequestOperationNotSupported
BadRequestPredictionIdsExceededCount
BadRequestPredictionIdsMissing
BadRequestPredictionInvalidApplicationName
BadRequestPredictionInvalidQueryParameters
BadRequestPredictionResultsExceededCount
BadRequestPredictionTagsExceededCount
BadRequestProjectDescription
BadRequestProjectDuplicated
BadRequestProjectImagePreprocessingSettings
BadRequestProjectName
BadRequestProjectNameNotUnique
BadRequestProjectUnknownClassification
BadRequestProjectUnknownDomain
BadRequestProjectUnsupportedDomainTypeChange
BadRequestProjectUnsupportedExportPlatform
BadRequestRequiredParamIsNull
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining
BadRequestSubscriptionApi
BadRequestTagDescription
BadRequestTagName
BadRequestTagNameNotUnique
BadRequestTagType
BadRequestTrainingAlreadyInProgress
BadRequestTrainingNotNeeded
BadRequestTrainingNotNeededButTrainingPipelineUpdated
BadRequestTrainingValidationFailed
BadRequestUnpublishFailed
BadRequestUnsupportedDomain
BadRequestWorkspaceCannotBeModified
BadRequestWorkspaceNotDeletable
Conflict
ConflictInvalid
ErrorExporterInvalidClassifier
ErrorExporterInvalidFeaturizer
ErrorExporterInvalidPlatform
ErrorFeaturizationAugmentationError
ErrorFeaturizationAugmentationUnavailable
ErrorFeaturizationInvalidFeaturizer
ErrorFeaturizationQueueTimeout
ErrorFeaturizationServiceUnavailable
ErrorFeaturizationUnrecognizedJob
ErrorInvalid
ErrorIterationCopyFailed
ErrorPrediction
ErrorPredictionModelNotCached
ErrorPredictionModelNotFound
ErrorPredictionServiceUnavailable
ErrorPredictionStorage
ErrorPreparePerformanceMigrationFailed
ErrorProjectExportRequestFailed
ErrorProjectImportRequestFailed
ErrorProjectInvalidDomain
ErrorProjectInvalidPipelineConfiguration
ErrorProjectInvalidWorkspace
ErrorProjectTrainingRequestFailed
ErrorRegionProposal
ErrorUnknown
ErrorUnknownBaseModel
Forbidden
ForbiddenDRModeEnabled
ForbiddenInvalid
ForbiddenUser
ForbiddenUserDisabled
ForbiddenUserDoesNotExist
ForbiddenUserInsufficientCapability
ForbiddenUserResource
ForbiddenUserSignupAllowanceExceeded
ForbiddenUserSignupDisabled
NoError
NotFound
NotFoundApimSubscription
NotFoundDomain
NotFoundImage
NotFoundInvalid
NotFoundIteration
NotFoundIterationPerformance
NotFoundProject
NotFoundProjectDefaultIteration
NotFoundTag
UnsupportedMediaType

ExportableTo

Enumeración

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

Valor	Description
CoreML
DockerFile
ONNX
TensorFlow
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.

TrainingType

Enumeración

Obtiene el tipo de entrenamiento de la iteración.

Valor	Description
Advanced
Regular