Projects - Create
Erstellt ein Projekt.
POST {Endpoint}/customvision/v3.3/training/projects?name={name}
POST {Endpoint}/customvision/v3.3/training/projects?name={name}&description={description}&domainId={domainId}&classificationType={classificationType}&targetExportPlatforms={targetExportPlatforms}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Unterstützte Cognitive Services-Endpunkte. |
name
|
query | True |
string |
Der Name des Projekts. |
classification
|
query |
string |
Der Typ des Klassifizierers, der für dieses Projekt erstellt werden soll. |
|
description
|
query |
string |
Die Beschreibung des Projekts. |
|
domain
|
query |
string uuid |
Die ID der Domäne, die für dieses Projekt verwendet werden soll. Der Standardwert ist "Allgemein". |
|
target
|
query |
string[] |
Liste der Plattformen, auf die das trainierte Modell exportiert werden soll. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Training-Key | True |
string |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK Media Types: "application/json", "application/xml", "text/xml" |
|
Other Status Codes |
Fehlerantwort Media Types: "application/json", "application/xml", "text/xml" |
Sicherheit
Training-Key
Type:
apiKey
In:
header
Beispiele
Successful CreateProject request
Sample Request
POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects?name=My New Project&description=A test project&domainId=ee85a74c-405e-4adc-bb47-ffa8ca0c9f31
Sample Response
{
"id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
"name": "My New Project",
"description": "A test project",
"settings": {
"domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
},
"created": "2017-12-18T05:43:18Z",
"lastModified": "2017-12-18T05:43:18Z",
"thumbnailUri": ""
}
Definitionen
Name | Beschreibung |
---|---|
Classifier |
Ruft den Klassifizierungstyp des Projekts ab. |
Custom |
|
Custom |
Der Fehlercode. |
Image |
Stellt bildvorverarbeitete Einstellungen dar, die von der Bilderweiterung verwendet werden. |
Project |
Stellt ein Projekt dar. |
Project |
Stellt einstellungen dar, die einem Projekt zugeordnet sind. |
Project |
Ruft die status des Projekts ab. |
Target |
Eine Liste von ExportPlatform, die vom trainierten Modell unterstützt werden soll. |
Classifier
Ruft den Klassifizierungstyp des Projekts ab.
Name | Typ | Beschreibung |
---|---|---|
Multiclass |
string |
|
Multilabel |
string |
CustomVisionError
Name | Typ | Beschreibung |
---|---|---|
code |
Der Fehlercode. |
|
message |
string |
Eine Meldung, die den vom Dienst gemeldeten Fehler erläutert. |
CustomVisionErrorCodes
Der Fehlercode.
Name | Typ | Beschreibung |
---|---|---|
BadRequest |
string |
|
BadRequestCannotMigrateProjectWithName |
string |
|
BadRequestClassificationTrainingValidationFailed |
string |
|
BadRequestCustomerManagedKeyRevoked |
string |
|
BadRequestDetectionTrainingNotAllowNegativeTag |
string |
|
BadRequestDetectionTrainingValidationFailed |
string |
|
BadRequestDomainNotSupportedForAdvancedTraining |
string |
|
BadRequestExceedIterationPerProjectLimit |
string |
|
BadRequestExceedProjectLimit |
string |
|
BadRequestExceedTagPerImageLimit |
string |
|
BadRequestExceedTagPerProjectLimit |
string |
|
BadRequestExceededBatchSize |
string |
|
BadRequestExceededQuota |
string |
|
BadRequestExportAlreadyInProgress |
string |
|
BadRequestExportPlatformNotSupportedForAdvancedTraining |
string |
|
BadRequestExportValidationFailed |
string |
|
BadRequestExportWhileTraining |
string |
|
BadRequestImageBatch |
string |
|
BadRequestImageDimensions |
string |
|
BadRequestImageExceededCount |
string |
|
BadRequestImageFormat |
string |
|
BadRequestImageMetadataKey |
string |
|
BadRequestImageMetadataValue |
string |
|
BadRequestImageRegions |
string |
|
BadRequestImageSizeBytes |
string |
|
BadRequestImageStream |
string |
|
BadRequestImageTags |
string |
|
BadRequestImageUrl |
string |
|
BadRequestInvalid |
string |
|
BadRequestInvalidArtifactUri |
string |
|
BadRequestInvalidEmailAddress |
string |
|
BadRequestInvalidIds |
string |
|
BadRequestInvalidImportToken |
string |
|
BadRequestInvalidPublishName |
string |
|
BadRequestInvalidPublishTarget |
string |
|
BadRequestIterationDescription |
string |
|
BadRequestIterationIsNotTrained |
string |
|
BadRequestIterationIsPublished |
string |
|
BadRequestIterationName |
string |
|
BadRequestIterationNameNotUnique |
string |
|
BadRequestIterationNotPublished |
string |
|
BadRequestIterationValidationFailed |
string |
|
BadRequestMultiClassClassificationTrainingValidationFailed |
string |
|
BadRequestMultiLabelClassificationTrainingValidationFailed |
string |
|
BadRequestMultipleGeneralProductTag |
string |
|
BadRequestMultipleNegativeTag |
string |
|
BadRequestNegativeAndRegularTagOnSameImage |
string |
|
BadRequestNotLimitedTrial |
string |
|
BadRequestNotSupported |
string |
|
BadRequestOperationNotSupported |
string |
|
BadRequestPredictionIdsExceededCount |
string |
|
BadRequestPredictionIdsMissing |
string |
|
BadRequestPredictionInvalidApplicationName |
string |
|
BadRequestPredictionInvalidQueryParameters |
string |
|
BadRequestPredictionResultsExceededCount |
string |
|
BadRequestPredictionTagsExceededCount |
string |
|
BadRequestProjectDescription |
string |
|
BadRequestProjectDuplicated |
string |
|
BadRequestProjectImagePreprocessingSettings |
string |
|
BadRequestProjectName |
string |
|
BadRequestProjectNameNotUnique |
string |
|
BadRequestProjectUnknownClassification |
string |
|
BadRequestProjectUnknownDomain |
string |
|
BadRequestProjectUnsupportedDomainTypeChange |
string |
|
BadRequestProjectUnsupportedExportPlatform |
string |
|
BadRequestRequiredParamIsNull |
string |
|
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining |
string |
|
BadRequestSubscriptionApi |
string |
|
BadRequestTagDescription |
string |
|
BadRequestTagName |
string |
|
BadRequestTagNameNotUnique |
string |
|
BadRequestTagType |
string |
|
BadRequestTrainingAlreadyInProgress |
string |
|
BadRequestTrainingNotNeeded |
string |
|
BadRequestTrainingNotNeededButTrainingPipelineUpdated |
string |
|
BadRequestTrainingValidationFailed |
string |
|
BadRequestUnpublishFailed |
string |
|
BadRequestUnsupportedDomain |
string |
|
BadRequestWorkspaceCannotBeModified |
string |
|
BadRequestWorkspaceNotDeletable |
string |
|
Conflict |
string |
|
ConflictInvalid |
string |
|
ErrorExporterInvalidClassifier |
string |
|
ErrorExporterInvalidFeaturizer |
string |
|
ErrorExporterInvalidPlatform |
string |
|
ErrorFeaturizationAugmentationError |
string |
|
ErrorFeaturizationAugmentationUnavailable |
string |
|
ErrorFeaturizationInvalidFeaturizer |
string |
|
ErrorFeaturizationQueueTimeout |
string |
|
ErrorFeaturizationServiceUnavailable |
string |
|
ErrorFeaturizationUnrecognizedJob |
string |
|
ErrorInvalid |
string |
|
ErrorIterationCopyFailed |
string |
|
ErrorPrediction |
string |
|
ErrorPredictionModelNotCached |
string |
|
ErrorPredictionModelNotFound |
string |
|
ErrorPredictionServiceUnavailable |
string |
|
ErrorPredictionStorage |
string |
|
ErrorPreparePerformanceMigrationFailed |
string |
|
ErrorProjectExportRequestFailed |
string |
|
ErrorProjectImportRequestFailed |
string |
|
ErrorProjectInvalidDomain |
string |
|
ErrorProjectInvalidPipelineConfiguration |
string |
|
ErrorProjectInvalidWorkspace |
string |
|
ErrorProjectTrainingRequestFailed |
string |
|
ErrorRegionProposal |
string |
|
ErrorUnknown |
string |
|
ErrorUnknownBaseModel |
string |
|
Forbidden |
string |
|
ForbiddenDRModeEnabled |
string |
|
ForbiddenInvalid |
string |
|
ForbiddenUser |
string |
|
ForbiddenUserDisabled |
string |
|
ForbiddenUserDoesNotExist |
string |
|
ForbiddenUserInsufficientCapability |
string |
|
ForbiddenUserResource |
string |
|
ForbiddenUserSignupAllowanceExceeded |
string |
|
ForbiddenUserSignupDisabled |
string |
|
NoError |
string |
|
NotFound |
string |
|
NotFoundApimSubscription |
string |
|
NotFoundDomain |
string |
|
NotFoundImage |
string |
|
NotFoundInvalid |
string |
|
NotFoundIteration |
string |
|
NotFoundIterationPerformance |
string |
|
NotFoundProject |
string |
|
NotFoundProjectDefaultIteration |
string |
|
NotFoundTag |
string |
|
UnsupportedMediaType |
string |
ImageProcessingSettings
Stellt bildvorverarbeitete Einstellungen dar, die von der Bilderweiterung verwendet werden.
Name | Typ | Beschreibung |
---|---|---|
augmentationMethods |
object |
Ruft aktivierte Bildtransformationen ab oder legt diese fest. Der Schlüssel entspricht dem Transformationsnamen. Wenn der Wert auf true festgelegt ist, ist die korrespondierende Transformation aktiviert. Andernfalls wird diese Transformation nicht verwendet. Die Augmentation wird auf aktivierte Transformationen gleichmäßig verteilt. |
Project
Stellt ein Projekt dar.
Name | Typ | Beschreibung |
---|---|---|
created |
string |
Ruft das Datum ab, an dem dieses Projekt erstellt wurde. |
description |
string |
Ruft die Beschreibung des Projekts ab oder legt sie fest. |
drModeEnabled |
boolean |
Ruft ab, wenn der Notfallwiederherstellungsmodus (DR) aktiviert ist, was angibt, dass das Projekt vorübergehend schreibgeschützt ist. |
id |
string |
Ruft die Projekt-ID ab. |
lastModified |
string |
Ruft das Datum ab, an dem dieses Projekt zuletzt geändert wurde. |
name |
string |
Ruft den Namen des Projekts ab oder legt ihn fest. |
settings |
Ruft die Projekteinstellungen ab oder legt sie fest. |
|
status |
Ruft die status des Projekts ab. |
|
thumbnailUri |
string |
Ruft die Miniaturansichts-URL ab, die das Bild darstellt. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll. Andernfalls handelt es sich um einen absoluten URI für die Ressource. |
ProjectSettings
Stellt einstellungen dar, die einem Projekt zugeordnet sind.
Name | Typ | Beschreibung |
---|---|---|
classificationType |
Ruft den Klassifizierungstyp des Projekts ab oder legt diese fest. |
|
detectionParameters |
string |
Erkennungsparameter werden verwendet, falls vorhanden. |
domainId |
string |
Ruft die ID der Domäne ab, die mit diesem Projekt verwendet werden soll, oder legt diese fest. |
imageProcessingSettings |
Ruft Einstellungen für die Bildvorverarbeitung ab oder legt diese fest. |
|
targetExportPlatforms |
Eine Liste von ExportPlatform, die vom trainierten Modell unterstützt werden soll. |
|
useNegativeSet |
boolean |
Gibt an, ob ein negativer Satz verwendet wird. |
ProjectStatus
Ruft die status des Projekts ab.
Name | Typ | Beschreibung |
---|---|---|
Failed |
string |
|
Importing |
string |
|
Succeeded |
string |
TargetExportPlatforms
Eine Liste von ExportPlatform, die vom trainierten Modell unterstützt werden soll.
Name | Typ | Beschreibung |
---|---|---|
CoreML |
string |
|
DockerFile |
string |
|
ONNX |
string |
|
TensorFlow |
string |
|
VAIDK |
string |