Projects - Train
Reiht das Projekt für das Training in eine Warteschlange ein.
POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/trainPOST {Endpoint}/customvision/v3.3/training/projects/{projectId}/train?trainingType={trainingType}&reservedBudgetInHours={reservedBudgetInHours}&forceTrain={forceTrain}¬ificationEmailAddress={notificationEmailAddress}URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Endpoint
|
path | True |
string |
Unterstützte Cognitive Services-Endpunkte. |
|
project
|
path | True |
string (uuid) |
Die Projekt-ID. |
|
force
|
query |
boolean |
Gibt an, ob der Zug erzwungen werden soll, auch wenn sich Dataset und Konfiguration nicht ändern (Standard: false). |
|
|
notification
|
query |
string |
Die E-Mail-Adresse, an die eine Benachrichtigung gesendet werden soll, wenn die Schulung abgeschlossen ist (Standard: NULL). |
|
|
reserved
|
query |
integer (int32) |
Die Anzahl der Stunden, die als Budget für Schulungen reserviert sind (falls zutreffend). |
|
|
training
|
query |
string |
Die Art der Schulung, die zum Trainieren des Projekts verwendet werden soll (Standard: Normal). |
Anforderungsheader
Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| Training-Key | True |
string |
Anforderungstext
Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Name | Typ | Beschreibung |
|---|---|---|
| selectedTags |
string[] (uuid) |
Die Liste der tags, die für diese Schulungssitzung ausgewählt sind, werden andere Tags im Projekt ignoriert. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY Media Types: "application/json", "application/xml", "text/xml" |
|
| Other Status Codes |
Fehlerantwort Media Types: "application/json", "application/xml", "text/xml" |
Sicherheit
Training-Key
Typ:
apiKey
In:
header
Beispiele
Successful TrainProject request
Beispielanforderung
POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/train
{}
Beispiel für eine Antwort
{
"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": ""
}Definitionen
| Name | Beschreibung |
|---|---|
| Classifier |
Ruft den Klassifizierungstyp des Projekts ab. |
|
Custom |
|
|
Custom |
Der Fehlercode. |
|
Exportable |
Eine Reihe von Plattformen, in die diese Iteration exportiert werden kann. |
| Iteration |
Iterationsmodell, das über JSON gesendet werden soll. |
|
Training |
Parameter, die für die Schulung verwendet werden. |
|
Training |
Ruft den Schulungstyp der Iteration ab. |
Classifier
Ruft den Klassifizierungstyp des Projekts ab.
| Wert | Beschreibung |
|---|---|
| Multiclass | |
| Multilabel |
CustomVisionError
| Name | Typ | Beschreibung |
|---|---|---|
| code |
Der Fehlercode. |
|
| message |
string |
Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt. |
CustomVisionErrorCodes
Der Fehlercode.
| Wert | Beschreibung |
|---|---|
| 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
Eine Reihe von Plattformen, in die diese Iteration exportiert werden kann.
| Wert | Beschreibung |
|---|---|
| CoreML | |
| TensorFlow | |
| DockerFile | |
| ONNX | |
| VAIDK |
Iteration
Iterationsmodell, das über JSON gesendet werden soll.
| Name | Typ | Beschreibung |
|---|---|---|
| classificationType |
Ruft den Klassifizierungstyp des Projekts ab. |
|
| created |
string (date-time) |
Ruft die Zeit ab, zu der diese Iteration abgeschlossen wurde. |
| domainId |
string (uuid) |
Dient zum Abrufen oder Festlegen einer GUID der Domäne, auf der die Iteration trainiert wurde. |
| exportable |
boolean |
Gibt an, ob die Iteration zum Herunterladen in ein anderes Format exportiert werden kann. |
| exportableTo |
Eine Reihe von Plattformen, in die diese Iteration exportiert werden kann. |
|
| id |
string (uuid) |
Ruft die ID der Iteration ab. |
| lastModified |
string (date-time) |
Ruft die Zeit ab, zu der diese Iteration zuletzt geändert wurde. |
| name |
string |
Ruft den Namen der Iteration ab oder legt den Namen fest. |
| originalPublishResourceId |
string |
Die Ressourcenanbieter-ID dieser Iteration wurde ursprünglich veröffentlicht. |
| projectId |
string (uuid) |
Ruft die Projekt-ID der Iteration ab. |
| publishName |
string |
Name des veröffentlichten Modells. |
| reservedBudgetInHours |
integer (int32) |
Ruft das reservierte Budget für erweiterte Schulungen für die Iteration ab. |
| status |
string |
Ruft den aktuellen Iterationsstatus ab. |
| trainedAt |
string (date-time) |
Ruft die Zeit ab, zu der diese Iteration zuletzt geändert wurde. |
| trainingTimeInMinutes |
integer (int32) |
Ruft die Schulungszeit für die Iteration ab. |
| trainingType |
Ruft den Schulungstyp der Iteration ab. |
TrainingParameters
Parameter, die für die Schulung verwendet werden.
| Name | Typ | Beschreibung |
|---|---|---|
| selectedTags |
string[] (uuid) |
Die Liste der tags, die für diese Schulungssitzung ausgewählt sind, werden andere Tags im Projekt ignoriert. |
TrainingType
Ruft den Schulungstyp der Iteration ab.
| Wert | Beschreibung |
|---|---|
| Regular | |
| Advanced |