Udostępnij przez

Projects - Train

Usługa:
Azure AI Services
Wersja interfejsu API:
3.3

Projekt kolejki na potrzeby trenowania.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
Endpoint
 path True

string

Obsługiwane punkty końcowe usług Cognitive Services.
projectId
 path True

string (uuid)

Identyfikator projektu.
forceTrain
 query

boolean

Czy wymusić trenowanie, nawet jeśli zestaw danych i konfiguracja nie zmieni się (wartość domyślna: false).
notificationEmailAddress
 query

string

Adres e-mail, do który ma być wysyłane powiadomienie po zakończeniu trenowania (wartość domyślna: null).
reservedBudgetInHours
 query

integer (int32)

Liczba godzin zarezerwowanych jako budżet na szkolenie (jeśli dotyczy).
trainingType
 query

string

Typ trenowania używanego do trenowania projektu (ustawienie domyślne: Regular).

Nagłówek żądania

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

Nazwa Wymagane Typ Opis
Training-Key True

string

Treść żądania

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

Nazwa Typ Opis
selectedTags

string[] (uuid)

Lista tagów wybranych dla tej sesji szkoleniowej, inne tagi w projekcie zostaną zignorowane.

Odpowiedzi

Nazwa Typ Opis
200 OK

Iteration

OK

Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes

CustomVisionError

Odpowiedź na błąd

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

Zabezpieczenia

Training-Key

Typ: apiKey
W: header

Przykłady

Successful TrainProject request

Przykładowe żądanie

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


{}

Przykładowa odpowiedź

Kod stanu:
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": ""
}

Definicje

Nazwa Opis
Classifier

Pobiera typ klasyfikacji projektu.
CustomVisionError
CustomVisionErrorCodes

Kod błędu.
ExportableTo

Zestaw platform, do których ta iteracja może być eksportowana.
Iteration

Model iteracji do wysłania za pośrednictwem formatu JSON.
TrainingParameters

Parametry używane do trenowania.
TrainingType

Pobiera typ trenowania iteracji.

Classifier

Wyliczanie

Pobiera typ klasyfikacji projektu.

Wartość Opis
Multiclass
Multilabel

CustomVisionError

Objekt
Nazwa Typ Opis
code

CustomVisionErrorCodes

Kod błędu.
message

string

Komunikat wyjaśniający błąd zgłoszony przez usługę.

CustomVisionErrorCodes

Wyliczanie

Kod błędu.

Wartość Opis
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

Wyliczanie

Zestaw platform, do których ta iteracja może być eksportowana.

Wartość Opis
CoreML
TensorFlow
DockerFile
ONNX
VAIDK

Iteration

Objekt

Model iteracji do wysłania za pośrednictwem formatu JSON.

Nazwa Typ Opis
classificationType

Classifier

Pobiera typ klasyfikacji projektu.
created

string (date-time)

Pobiera czas ukończenia tej iteracji.
domainId

string (uuid)

Pobierz lub ustawia identyfikator GUID domeny, w ramach których iteracja została wytrenowana.
exportable

boolean

Czy iteracji można wyeksportować do innego formatu do pobrania.
exportableTo

ExportableTo[]

Zestaw platform, do których ta iteracja może być eksportowana.
id

string (uuid)

Pobiera identyfikator iteracji.
lastModified

string (date-time)

Pobiera czas ostatniej modyfikacji tej iteracji.
name

string

Pobiera lub ustawia nazwę iteracji.
originalPublishResourceId

string

Identyfikator dostawcy zasobów, do którego pierwotnie opublikowano tę iterację.
projectId

string (uuid)

Pobiera identyfikator projektu iteracji.
publishName

string

Nazwa opublikowanego modelu.
reservedBudgetInHours

integer (int32)

Pobiera zarezerwowany zaawansowany budżet szkoleniowy dla iteracji.
status

string

Pobiera bieżący stan iteracji.
trainedAt

string (date-time)

Pobiera czas ostatniej modyfikacji tej iteracji.
trainingTimeInMinutes

integer (int32)

Pobiera czas trenowania iteracji.
trainingType

TrainingType

Pobiera typ trenowania iteracji.

TrainingParameters

Objekt

Parametry używane do trenowania.

Nazwa Typ Opis
selectedTags

string[] (uuid)

Lista tagów wybranych dla tej sesji szkoleniowej, inne tagi w projekcie zostaną zignorowane.

TrainingType

Wyliczanie

Pobiera typ trenowania iteracji.

Wartość Opis
Regular
Advanced