Train Project - Train Project

참조

서비스:: Azure AI Services

API 버전:: 3.4-preview

학습을 위해 프로젝트를 큐에 추가합니다.

POST {Endpoint}/customvision/v3.4-preview/training/projects/{projectId}/train

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트.
projectId	path	True	string (uuid)	프로젝트 ID입니다.
forceTrain	query		boolean	데이터 세트 및 구성이 변경되지 않더라도 학습을 강제 적용할지 여부(기본값: false).
notificationEmailAddress	query		string	학습이 완료되면 알림을 보낼 전자 메일 주소입니다(기본값: null).
reservedBudgetInHours	query		integer (int32)	교육 예산으로 예약된 시간(해당하는 경우)입니다.
trainingType	query		string	프로젝트를 학습하는 데 사용할 학습 유형입니다(기본값: 일반).

요청 헤더

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

Name	필수	형식	Description
Training-Key	True	string

요청 본문

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

Name	형식	Description
customBaseModelInfo	CustomBaseModelInfo	현재 반복의 학습에 대한 기본 모델을 제공하는 이전에 학습된 반복의 정보입니다.
selectedTags	string[] (uuid)	이 학습 세션에 대해 선택한 태그 목록입니다. 프로젝트의 다른 태그는 무시됩니다.

응답

Name	형식	Description
200 OK	Iteration	그래 Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	CustomVisionError	오류 응답 Media Types: "application/json", "application/xml", "text/xml"

Name

형식

Description

200 OK

Iteration

그래

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

Other Status Codes

CustomVisionError

오류 응답

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

보안

Training-Key

형식: apiKey
In(다음 안에): header

예제

Successful TrainProject request

샘플 요청

HTTP

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


{}

샘플 응답

상태 코드:: 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": ""
}

정의

Name	Description
Classifier	프로젝트의 분류 유형을 가져옵니다.
CustomBaseModelInfo
CustomVisionError
CustomVisionErrorCodes	오류 코드입니다.
ExportableTo	이 반복을 내보낼 수 있는 플랫폼 집합입니다.
Iteration	JSON을 통해 보낼 반복 모델입니다.
TrainingParameters	학습에 사용되는 매개 변수입니다.
TrainingType	반복의 학습 유형을 가져옵니다.

Classifier

열거형

프로젝트의 분류 유형을 가져옵니다.

값	Description
Multiclass
Multilabel

CustomBaseModelInfo

Object

Name	형식	Description
iterationId	string (uuid)	현재 반복 학습에 사용할 이전에 학습된 프로젝트의 반복 ID입니다.
projectId	string (uuid)	현재 반복 학습에 사용할 이전에 학습된 프로젝트의 프로젝트 ID입니다.

CustomVisionError

Object

Name	형식	Description
code	CustomVisionErrorCodes	오류 코드입니다.
message	string	서비스에서 보고한 오류를 설명하는 메시지입니다.

CustomVisionErrorCodes

열거형

오류 코드입니다.

값	Description
BadRequest
BadRequestCannotMigrateProjectWithName
BadRequestClassificationTrainingValidationFailed
BadRequestCustomBaseModelArchitectureRetired
BadRequestCustomBaseModelDomainNotCompatible
BadRequestCustomBaseModelIterationStatusNotCompleted
BadRequestCustomerManagedKeyRevoked
BadRequestDetectionTrainingNotAllowNegativeTag
BadRequestDetectionTrainingValidationFailed
BadRequestDomainNotSupportedForAdvancedTraining
BadRequestExceedIterationPerProjectLimit
BadRequestExceedProjectLimit
BadRequestExceedTagPerImageLimit
BadRequestExceedTagPerProjectLimit
BadRequestExceededBatchSize
BadRequestExceededQuota
BadRequestExportAlreadyInProgress
BadRequestExportPlatformNotSupportedForAdvancedTraining
BadRequestExportValidationFailed
BadRequestExportWhileTraining
BadRequestImageAspectRatio
BadRequestImageBatch
BadRequestImageDimensions
BadRequestImageExceededCount
BadRequestImageFormat
BadRequestImageMetadataKey
BadRequestImageMetadataValue
BadRequestImageRegions
BadRequestImageSizeBytes
BadRequestImageStream
BadRequestImageTags
BadRequestImageUrl
BadRequestInvalid
BadRequestInvalidArtifactUri
BadRequestInvalidEmailAddress
BadRequestInvalidIds
BadRequestInvalidImportToken
BadRequestInvalidPublishName
BadRequestInvalidPublishTarget
BadRequestInvalidUri
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
BadRequestRetiredDomainNotSupportedForTraining
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
ErrorServerTimeOut
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

열거형

이 반복을 내보낼 수 있는 플랫폼 집합입니다.

값	Description
CoreML
DockerFile
ONNX
OpenVino
TensorFlow
VAIDK

Iteration

Object

JSON을 통해 보낼 반복 모델입니다.

Name	형식	Description
classificationType	Classifier	프로젝트의 분류 유형을 가져옵니다.
created	string (date-time)	이 반복이 완료된 시간을 가져옵니다.
customBaseModelInfo	CustomBaseModelInfo	현재 반복의 학습에 대한 기본 모델을 제공하는 이전에 학습된 반복의 정보입니다. null의 기본값은 이전에 학습된 반복이 증분 학습에 사용되지 않음을 지정합니다.
domainId	string (uuid)	반복이 학습된 도메인의 GUID를 얻거나 설정합니다.
exportable	boolean	반복을 다운로드할 다른 형식으로 내보낼 수 있는지 여부입니다.
exportableTo	ExportableTo[]	이 반복을 내보낼 수 있는 플랫폼 집합입니다.
id	string (uuid)	반복의 ID를 가져옵니다.
lastModified	string (date-time)	이 반복이 마지막으로 수정된 시간을 가져옵니다.
name	string	반복의 이름을 가져오거나 설정합니다.
originalPublishResourceId	string	이 반복은 원래 게시된 리소스 공급자 ID입니다.
projectId	string (uuid)	반복의 프로젝트 ID를 가져옵니다.
publishName	string	게시된 모델의 이름입니다.
reservedBudgetInHours	integer (int32)	반복에 대한 예약된 고급 학습 예산을 가져옵니다.
status	string	현재 반복 상태를 가져옵니다.
trainedAt	string (date-time)	이 반복이 마지막으로 수정된 시간을 가져옵니다.
trainingErrorDetails	string	학습이 실패할 때 학습 오류 세부 정보입니다. 학습에 성공하면 값이 null입니다.
trainingTimeInMinutes	integer (int32)	반복에 대한 학습 시간을 가져옵니다.
trainingType	TrainingType	반복의 학습 유형을 가져옵니다.

TrainingParameters

Object

학습에 사용되는 매개 변수입니다.

Name	형식	Description
customBaseModelInfo	CustomBaseModelInfo	현재 반복의 학습에 대한 기본 모델을 제공하는 이전에 학습된 반복의 정보입니다.
selectedTags	string[] (uuid)	이 학습 세션에 대해 선택한 태그 목록입니다. 프로젝트의 다른 태그는 무시됩니다.

TrainingType

열거형

반복의 학습 유형을 가져옵니다.

값	Description
Advanced
Regular

다음을 통해 공유

Train Project - Train Project

URI 매개 변수

요청 헤더

요청 본문

응답

보안

Training-Key

예제

Successful TrainProject request

샘플 요청

샘플 응답

정의

Classifier

CustomBaseModelInfo

CustomVisionError

CustomVisionErrorCodes

ExportableTo

Iteration

TrainingParameters

TrainingType