Ingestion Jobs - Get
Gets the status of an ingestion job by its id.
GET {endpoint}/openai/extensions/on-your-data/ingestion-jobs/{jobId}?api-version=2023-10-01-preview
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
endpoint
|
path | True |
string url |
Supported Cognitive Services endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI account name). |
job
|
path | True |
string |
The id of the ingestion job. |
api-version
|
query | True |
string |
The requested API version. |
Request Header
Name | Required | Type | Description |
---|---|---|---|
api-key | True |
string |
Provide your Cognitive Services Azure OpenAI account key here. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Success Headers Retry-After: integer |
|
Other Status Codes |
An error occurred. |
Security
api-key
Provide your Cognitive Services Azure OpenAI account key here.
Type:
apiKey
In:
header
Examples
Getting status of an ingestion job.
Sample Request
GET https://aoairesource.openai.azure.com/openai/extensions/on-your-data/ingestion-jobs/test-index?api-version=2023-10-01-preview
Sample Response
{
"id": "test-index",
"dataRefreshIntervalInMinutes": 60,
"completionAction": "cleanUpAssets",
"status": "running",
"warnings": [],
"progress": {
"stageProgress": [
{
"name": "Preprocessing",
"totalItems": 100,
"processedItems": 100
},
{
"name": "Indexing",
"totalItems": 200,
"processedItems": 50
}
]
}
}
Definitions
Name | Description |
---|---|
Error |
Error |
Error |
ErrorCode |
Error |
ErrorResponse |
Ingestion |
IngestionJob |
Ingestion |
IngestionJobCompletionAction |
Ingestion |
IngestionJobProgress |
Inner |
InnerError |
Inner |
InnerErrorCode |
Operation |
OperationState |
Stage |
Error
Error
Name | Type | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
The error details if available. |
innererror |
InnerError |
|
message |
string |
The message of this error. |
target |
string |
The location where the error happened if available. |
ErrorCode
ErrorCode
Name | Type | Description |
---|---|---|
conflict |
string |
The requested operation conflicts with the current resource state. |
contentFilter |
string |
Image generation failed as a result of our safety system. |
fileImportFailed |
string |
Import of file failed. |
forbidden |
string |
The operation is forbidden for the current user/api key. |
internalFailure |
string |
Internal error. Please retry. |
invalidPayload |
string |
The request data is invalid for this operation. |
itemDoesAlreadyExist |
string |
The item does already exist. |
jsonlValidationFailed |
string |
Validation of jsonl data failed. |
notFound |
string |
The resource is not found. |
quotaExceeded |
string |
Quota exceeded. |
serviceUnavailable |
string |
The service is currently not available. |
tooManyRequests |
string |
Too many requests. Please retry later. |
unauthorized |
string |
The current user/api key is not authorized for the operation. |
unexpectedEntityState |
string |
The operation cannot be executed in the current resource's state. |
ErrorResponse
ErrorResponse
Name | Type | Description |
---|---|---|
error |
Error |
IngestionJob
IngestionJob
Name | Type | Default Value | Description |
---|---|---|---|
chunkSize |
integer |
1024 |
This number defines the maximum number of tokens in each chunk produced by the ingestion flow. |
completionAction |
IngestionJobCompletionAction |
||
dataRefreshIntervalInMinutes |
integer |
||
error |
Error |
||
id |
string |
||
progress |
IngestionJobProgress |
||
status |
OperationState |
||
warnings |
string[] |
IngestionJobCompletionAction
IngestionJobCompletionAction
Name | Type | Description |
---|---|---|
cleanUpAssets |
string |
Will clean up intermediate assets created during the ingestion process. |
keepAllAssets |
string |
Will not clean up any of the intermediate assets created during the ingestion process. |
IngestionJobProgress
IngestionJobProgress
Name | Type | Description |
---|---|---|
stageProgress |
InnerError
InnerError
Name | Type | Description |
---|---|---|
code |
InnerErrorCode |
|
innererror |
InnerError |
InnerErrorCode
InnerErrorCode
Name | Type | Description |
---|---|---|
invalidPayload |
string |
The request data is invalid for this operation. |
OperationState
OperationState
Name | Type | Description |
---|---|---|
failed |
string |
The operation has completed processing with a failure and cannot be further consumed. |
notRunning |
string |
The operation is not yet queued to be processed in the future. |
running |
string |
The operation has started to be processed. |
succeeded |
string |
The operation has successfully be processed and is ready for consumption. |
StageProgress
Name | Type | Description |
---|---|---|
name |
string |
|
processedItems |
integer |
|
totalItems |
integer |