Text Analysis Authoring - List Training Jobs

서비스:

Azure AI Services

API 버전:

2022-05-01

프로젝트에 대해 생성된 만료되지 않은 학습 작업을 나열합니다.

GET {Endpoint}/language/authoring/analyze-text/projects/{projectName}/train/jobs?api-version=2022-05-01

선택적 매개 변수:

GET {Endpoint}/language/authoring/analyze-text/projects/{projectName}/train/jobs?top={top}&skip={skip}&maxpagesize={maxpagesize}&api-version=2022-05-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(예: https://< resource-name.api.cognitiveservices.azure.com>).
projectName	path	True	string maxLength: 100	사용할 프로젝트의 이름입니다.
api-version	query	True	string	클라이언트 API 버전.
maxpagesize	query		integer (int32)	단일 응답에 포함할 최대 리소스 수입니다.
skip	query		integer (int32)	반환할 첫 번째 리소스의 컬렉션에 대한 오프셋입니다.
top	query		integer (int32)	컬렉션에서 반환할 최대 리소스 수입니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string	언어 서비스 리소스에 대한 구독 키입니다.

응답

Name	형식	Description
200 OK	TextAnalysisAuthoringTrainingJobs	학습 작업 목록입니다.
Other Status Codes	ErrorResponse	오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

언어 서비스 리소스에 대한 구독 키입니다.

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

예제

Successful List Training Jobs

샘플 요청

HTTP

GET {Endpoint}/language/authoring/analyze-text/projects/LoanAgreements/train/jobs?api-version=2022-05-01

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "result": {
        "modelLabel": "model1",
        "trainingConfigVersion": "2022-05-01",
        "trainingStatus": {
          "percentComplete": 100,
          "startDateTime": "2022-04-18T15:45:06.8190649Z",
          "endDateTime": "2022-04-18T15:47:19.2639682Z",
          "status": "succeeded"
        },
        "evaluationStatus": {
          "percentComplete": 100,
          "startDateTime": "2022-04-18T15:47:19.2734976Z",
          "endDateTime": "2022-04-18T15:47:23.8378892Z",
          "status": "succeeded"
        }
      },
      "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000",
      "createdDateTime": "2022-04-18T15:44:44Z",
      "lastUpdatedDateTime": "2022-04-18T15:47:50Z",
      "expirationDateTime": "2022-04-25T15:44:44Z",
      "status": "succeeded"
    },
    {
      "result": {
        "modelLabel": "model2",
        "trainingConfigVersion": "2022-05-01",
        "trainingStatus": {
          "percentComplete": 100,
          "startDateTime": "2022-04-18T17:22:39.3663023Z",
          "endDateTime": "2022-04-18T17:24:51.9440947Z",
          "status": "succeeded"
        },
        "evaluationStatus": {
          "percentComplete": 100,
          "startDateTime": "2022-04-18T17:24:51.9571747Z",
          "endDateTime": "2022-04-18T17:24:58.1427823Z",
          "status": "succeeded"
        }
      },
      "jobId": "9145f93f-6f37-418c-8527-d2ded84cece0_637858368000000000",
      "createdDateTime": "2022-04-18T17:22:11Z",
      "lastUpdatedDateTime": "2022-04-18T17:25:23Z",
      "expirationDateTime": "2022-04-25T17:22:11Z",
      "status": "succeeded"
    },
    {
      "result": {
        "modelLabel": "model2",
        "trainingConfigVersion": "2022-05-01",
        "trainingStatus": {
          "percentComplete": 100,
          "startDateTime": "2022-04-18T17:44:41.388358Z",
          "endDateTime": "2022-04-18T17:50:29.5675101Z",
          "status": "succeeded"
        },
        "evaluationStatus": {
          "percentComplete": 100,
          "startDateTime": "2022-04-18T17:50:29.5808461Z",
          "endDateTime": "2022-04-18T17:50:35.3482185Z",
          "status": "succeeded"
        }
      },
      "jobId": "ee23c900-354d-4b6d-96e1-8197db2bd5f7_637858368000000000",
      "createdDateTime": "2022-04-18T17:44:04Z",
      "lastUpdatedDateTime": "2022-04-18T17:51:11Z",
      "expirationDateTime": "2022-04-25T17:44:04Z",
      "status": "succeeded"
    }
  ],
  "nextLink": null
}

정의

Name	Description
Error	오류 개체입니다.
ErrorCode	사람이 읽을 수 있는 오류 코드입니다.
ErrorResponse	오류 응답입니다.
InnerErrorCode	사람이 읽을 수 있는 오류 코드입니다.
InnerErrorModel	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
JobStatus	작업 상태입니다.
TextAnalysisAuthoringSubTrainingJobState	학습 하위 작업의 세부 상태를 나타냅니다.
TextAnalysisAuthoringTrainingJobResult	학습 작업의 출력을 나타냅니다.
TextAnalysisAuthoringTrainingJobs	검색된 학습 작업 목록을 나타냅니다.
TextAnalysisAuthoringTrainingJobState	학습 작업의 상태를 나타냅니다.
TextAnalysisAuthoringWarning	요청을 실행하는 동안 발생한 경고를 나타냅니다.

Error

Object

오류 개체입니다.

Name	형식	Description
code	ErrorCode	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	InnerErrorModel	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

ErrorCode

열거형

사람이 읽을 수 있는 오류 코드입니다.

값	Description
InvalidRequest
InvalidArgument
Unauthorized
Forbidden
NotFound
ProjectNotFound
OperationNotFound
AzureCognitiveSearchNotFound
AzureCognitiveSearchIndexNotFound
TooManyRequests
AzureCognitiveSearchThrottling
AzureCognitiveSearchIndexLimitReached
InternalServerError
ServiceUnavailable
Timeout
QuotaExceeded
Conflict
Warning

ErrorResponse

Object

오류 응답입니다.

Name	형식	Description
error	Error	오류 개체입니다.

InnerErrorCode

열거형

사람이 읽을 수 있는 오류 코드입니다.

값	Description
InvalidRequest
InvalidParameterValue
KnowledgeBaseNotFound
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
ExtractionFailure
InvalidRequestBodyFormat
EmptyRequest
MissingInputDocuments
InvalidDocument
ModelVersionIncorrect
InvalidDocumentBatch
UnsupportedLanguageCode
InvalidCountryHint

InnerErrorModel

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	형식	Description
code	InnerErrorCode	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	object	오류 세부 정보입니다.
innererror	InnerErrorModel	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

JobStatus

열거형

작업 상태입니다.

값	Description
notStarted
running
succeeded
failed
cancelled
cancelling
partiallyCompleted

TextAnalysisAuthoringSubTrainingJobState

Object

학습 하위 작업의 세부 상태를 나타냅니다.

Name	형식	Description
endDateTime	string (date-time)	종료 날짜 시간을 나타냅니다.
percentComplete	integer (int32)	진행률을 나타냅니다.
startDateTime	string (date-time)	시작 날짜/시간을 나타냅니다.
status	JobStatus	하위 작업의 상태를 나타냅니다.

TextAnalysisAuthoringTrainingJobResult

Object

학습 작업의 출력을 나타냅니다.

Name	형식	Description
estimatedEndDateTime	string (date-time)	학습 및 평가를 위한 예상 종료 날짜 시간을 나타냅니다.
evaluationStatus	TextAnalysisAuthoringSubTrainingJobState	모델 평가 상태를 나타냅니다.
modelLabel	string	학습된 모델 레이블을 나타냅니다.
trainingConfigVersion	string	학습 구성 버전을 나타냅니다.
trainingStatus	TextAnalysisAuthoringSubTrainingJobState	모형 열차 상태를 나타냅니다.

TextAnalysisAuthoringTrainingJobs

Object

검색된 학습 작업 목록을 나타냅니다.

Name	형식	Description
nextLink	string	다음 페이지 링크입니다.
value	TextAnalysisAuthoringTrainingJobState[]	작업 목록입니다.

TextAnalysisAuthoringTrainingJobState

Object

학습 작업의 상태를 나타냅니다.

Name	형식	Description
createdDateTime	string (date-time)	작업의 생성 날짜 시간입니다.
errors	Error[]	작업을 실행하는 동안 발생한 오류입니다.
expirationDateTime	string (date-time)	작업의 만료 날짜 시간입니다.
jobId	string	작업 ID입니다.
lastUpdatedDateTime	string (date-time)	작업이 업데이트된 마지막 날짜입니다.
result	TextAnalysisAuthoringTrainingJobResult	학습 작업 세부 결과를 나타냅니다.
status	JobStatus	작업 상태입니다.
warnings	TextAnalysisAuthoringWarning[]	작업을 실행하는 동안 발생한 경고입니다.

TextAnalysisAuthoringWarning

Object

요청을 실행하는 동안 발생한 경고를 나타냅니다.

Name	형식	Description
code	string	경고 코드입니다.
message	string	경고 메시지입니다.