Question Answering Projects - Export

Служба:: Azure AI Services

Версия API:: 2021-10-01

Экспорт метаданных и ресурсов проекта.

POST {Endpoint}/language/query-knowledgebases/projects/{projectName}/:export?api-version=2021-10-01

С использованием необязательных параметров:

POST {Endpoint}/language/query-knowledgebases/projects/{projectName}/:export?api-version=2021-10-01&format={format}&assetKind={assetKind}

Параметры URI

Имя	В	Обязательно	Тип	Описание
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.
assetKind	query		string	Тип ресурса проекта.
format	query		format	Формат импорта или экспорта базы знаний.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string

Ответы

Имя	Тип	Описание
200 OK	ExportJobState	Экспорт состояния задания, метаданных проекта и ресурсов.
202 Accepted		Результаты успешного вызова с заголовком Operation-Location, используемым для проверки состояния задания. Заголовки Operation-Location: string
Other Status Codes	ErrorResponse	Ответ на ошибку.

Имя

Тип

Описание

200 OK

ExportJobState

Экспорт состояния задания, метаданных проекта и ресурсов.

202 Accepted

Результаты успешного вызова с заголовком Operation-Location, используемым для проверки состояния задания.

Заголовки

Operation-Location: string

Other Status Codes

ErrorResponse

Ответ на ошибку.

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Примеры

Successful query

Образец запроса

HTTP

POST {Endpoint}/language/query-knowledgebases/projects/proj1/:export?api-version=2021-10-01

Пример ответа

Код состояния:: 200

{
  "errors": [],
  "createdDateTime": "2021-05-01T17:21:14Z",
  "expirationDateTime": "2021-05-01T17:21:14Z",
  "jobId": "635c2741-15c4-4c2c-9f78-bfd30b6b2a4a",
  "lastUpdatedDateTime": "2021-05-01T17:21:14Z",
  "status": "succeeded",
  "resultUrl": "https://<resource-endpoint>/language/authoring/query-knowledgebases/projects/proj1/export/jobs/job1/result?api-version=2021-10-01"
}

Код состояния:: 202

Operation-Location: https:///language/authoring/query-knowledgebases/projects/proj1/export/jobs/job1?api-version=2021-10-01

Определения

Имя	Описание
Error	Объект ошибки.
ErrorCode	Код ошибки, доступный для чтения человеком.
ErrorResponse	Ответ на ошибку.
ExportJobState	Экспорт состояния задания, метаданных проекта и ресурсов.
format	Формат импорта или экспорта базы знаний.
InnerErrorCode	Код ошибки, доступный для чтения человеком.
InnerErrorModel	Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
jobStatus	Состояние задания.

Error

Object

Объект ошибки.

Имя	Тип	Описание
code	ErrorCode	Один из определяемых сервером кодов ошибок.
details	Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	InnerErrorModel	Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.
message	string	Читаемое пользователем представление ошибки.
target	string	Целевой объект ошибки.

ErrorCode

Перечисление

Код ошибки, доступный для чтения человеком.

Значение	Описание
InvalidRequest
InvalidArgument
Unauthorized
Forbidden
NotFound
ProjectNotFound
OperationNotFound
AzureCognitiveSearchNotFound
AzureCognitiveSearchIndexNotFound
TooManyRequests
AzureCognitiveSearchThrottling
AzureCognitiveSearchIndexLimitReached
InternalServerError
ServiceUnavailable

ErrorResponse

Object

Ответ на ошибку.

Имя	Тип	Описание
error	Error	Объект ошибки.

ExportJobState

Object

Экспорт состояния задания, метаданных проекта и ресурсов.

Имя	Тип	Описание
createdDateTime	string (date-time)
errors	Error[]	Объект ошибки.
expirationDateTime	string (date-time)
jobId	string
lastUpdatedDateTime	string (date-time)
resultUrl	string	URL-адрес для скачивания результата задания экспорта.
status	jobStatus	Состояние задания.

format

Перечисление

Формат импорта или экспорта базы знаний.

Значение	Описание
json	Экспорт или импорт ресурсов QnA в формате JSON.
tsv	Экспорт или импорт реплики базы знаний, включая все ресурсы и метаданные в формате Excel.
excel	Экспорт или импорт реплики базы знаний, включая все ресурсы и метаданные в формате Tsv.

InnerErrorCode

Перечисление

Код ошибки, доступный для чтения человеком.

Значение	Описание
InvalidRequest
InvalidParameterValue
KnowledgeBaseNotFound
AzureCognitiveSearchNotFound
AzureCognitiveSearchThrottling
ExtractionFailure

InnerErrorModel

Object

Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Имя	Тип	Описание
code	InnerErrorCode	Один из определяемых сервером кодов ошибок.
details	object	Сведения об ошибке.
innererror	InnerErrorModel	Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

jobStatus

Перечисление

Состояние задания.

Значение	Описание
notStarted
running
succeeded
failed
cancelled
cancelling
partiallyCompleted