Question Answering Projects - List Projects

서비스:: Azure AI Services

API 버전:: 2023-04-01

사용자에 대한 모든 프로젝트를 가져옵니다.

GET {Endpoint}/language/authoring/query-knowledgebases/projects?api-version=2023-04-01

선택적 매개 변수:

GET {Endpoint}/language/authoring/query-knowledgebases/projects?api-version=2023-04-01&top={top}&skip={skip}&maxpagesize={maxpagesize}

URI 매개 변수

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

응답

Name	형식	Description
200 OK	PagedQuestionAnsweringProjectMetadata	요청이 성공했습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

PagedQuestionAnsweringProjectMetadata

요청이 성공했습니다.

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

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

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
https://cognitiveservices.azure.com/.default

예제

Successful query

샘플 요청

HTTP

GET {Endpoint}/language/authoring/query-knowledgebases/projects?api-version=2023-04-01

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "description": "proj1 is a test project.",
      "createdDateTime": "2021-05-01T15:13:22Z",
      "lastDeployedDateTime": "2021-05-01T15:13:22Z",
      "lastModifiedDateTime": "2021-05-01T15:13:22Z",
      "multilingualResource": true,
      "projectName": "proj1",
      "language": "en"
    },
    {
      "description": "proj2 is a test project.",
      "createdDateTime": "2021-05-01T15:13:22Z",
      "lastDeployedDateTime": "2021-05-01T15:13:22Z",
      "lastModifiedDateTime": "2021-05-01T15:13:22Z",
      "multilingualResource": true,
      "projectName": "proj2",
      "language": "fr"
    }
  ]
}

정의

Name	Description
Error	오류 개체입니다.
ErrorCode	사람이 읽을 수 있는 오류 코드입니다.
ErrorResponse	오류 응답입니다.
InnerErrorCode	사람이 읽을 수 있는 오류 코드입니다.
InnerErrorModel	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
PagedQuestionAnsweringProjectMetadata	QuestionAnsweringProjectMetadata 항목의 페이징된 컬렉션
ProjectSettings	Project의 구성 가능한 설정입니다.
QuestionAnsweringProjectMetadata	프로젝트를 나타냅니다.

Error

Object

오류 개체입니다.

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

ErrorCode

열거형

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

값	Description
InvalidRequest	잘못된 요청 오류
InvalidArgument	잘못된 인수 오류
Unauthorized	권한 없는 액세스 오류
Forbidden	사용할 수 없는 액세스 오류
NotFound	찾을 수 없음 오류
ProjectNotFound	프로젝트를 찾을 수 없음 오류
OperationNotFound	작업을 찾을 수 없음 오류
AzureCognitiveSearchNotFound	Azure Cognitive Search를 찾을 수 없음 오류
AzureCognitiveSearchIndexNotFound	Azure Cognitive Search 인덱스 찾을 수 없음 오류
TooManyRequests	요청이 너무 많음 오류
AzureCognitiveSearchThrottling	Azure Cognitive Search 제한 오류
AzureCognitiveSearchIndexLimitReached	Azure Cognitive Search 인덱스 제한에 도달한 오류
InternalServerError	내부 서버 오류
ServiceUnavailable	서비스를 사용할 수 없음 오류
Timeout	시간 제한 오류
QuotaExceeded	할당량 초과 오류
Conflict	충돌 오류
Warning	경고 오류

ErrorResponse

Object

오류 응답입니다.

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

InnerErrorCode

열거형

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

값	Description
InvalidRequest	잘못된 요청 오류
InvalidParameterValue	잘못된 매개 변수 값 오류
KnowledgeBaseNotFound	기술 자료를 찾을 수 없음 오류
AzureCognitiveSearchNotFound	Azure Cognitive Search를 찾을 수 없음 오류
AzureCognitiveSearchThrottling	Azure Cognitive Search 제한 오류
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	오류 대상입니다.

PagedQuestionAnsweringProjectMetadata

Object

QuestionAnsweringProjectMetadata 항목의 페이징된 컬렉션

Name	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	QuestionAnsweringProjectMetadata[]	이 페이지의 QuestionAnsweringProjectMetadata 항목

ProjectSettings

Object

Project의 구성 가능한 설정입니다.

Name	형식	Description
defaultAnswer	string	기술 자료에서 일치하는 항목이 없으면 기본 응답 응답입니다.

QuestionAnsweringProjectMetadata

Object

프로젝트를 나타냅니다.

Name	형식	Description
createdDateTime	string (date-time)	프로젝트 생성 날짜-시간.
description	string	프로젝트에 대한 설명입니다.
language	string	텍스트 레코드의 언어입니다. 이는 언어의 BCP-47 표현입니다. 예를 들어 영어에는 "en"을 사용합니다. 스페인어 등에 대한 "es". 설정하지 않으면 영어에 "en"을 기본값으로 사용합니다.
lastDeployedDateTime	string (date-time)	프로젝트의 마지막 배포 날짜-시간을 나타냅니다.
lastModifiedDateTime	string (date-time)	마지막으로 수정한 날짜-시간을 프로젝트를 나타냅니다.
multilingualResource	boolean	프로젝트 전체에서 여러 언어에 사용할 수 있는 리소스입니다.
projectName	string maxLength: 100 pattern: ^(?=[a-zA-Z0-9])[a-zA-Z0-9-]{0,98}[a-zA-Z0-9]$	프로젝트의 이름입니다.
settings	ProjectSettings	Project의 구성 가능한 설정입니다.

다음을 통해 공유

Question Answering Projects - List Projects

URI 매개 변수

응답

보안

Ocp-Apim-Subscription-Key

OAuth2Auth

범위

예제

Successful query

샘플 요청

샘플 응답

정의

Error

ErrorCode

ErrorResponse

InnerErrorCode

InnerErrorModel

PagedQuestionAnsweringProjectMetadata

ProjectSettings

QuestionAnsweringProjectMetadata