azureopenai.json

{
  "swagger": "2.0",
  "info": {
    "title": "Azure OpenAI API version 2024-05-01-preview",
    "description": "APIs for fine-tuning and managing deployments of OpenAI models.",
    "version": "2024-05-01-preview"
  },
  "paths": {
    "/files": {
      "get": {
        "tags": [
          "Files:"
        ],
        "summary": "Gets a list of all files owned by the Azure OpenAI resource.\r\nThese include user uploaded content like files with purpose \"fine-tune\" for training or validation of fine-tunes models\r\nas well as files that are generated by the service such as \"fine-tune-results\" which contains various metrics for the corresponding fine-tune job.",
        "operationId": "Files_List",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "purpose",
            "description": "Only return files with the given purpose.",
            "type": "string",
            "enum": [
              "fine-tune",
              "fine-tune-results",
              "assistants",
              "assistants_output"
            ],
            "x-ms-enum": {
              "name": "Purpose",
              "modelAsString": true,
              "values": [
                {
                  "value": "fine-tune",
                  "description": "This file contains training data for a fine tune job."
                },
                {
                  "value": "fine-tune-results",
                  "description": "This file contains the results of a fine tune job."
                },
                {
                  "value": "assistants",
                  "description": "This file contains data to be used in assistants."
                },
                {
                  "value": "assistants_output",
                  "description": "This file contains the results of an assistant."
                }
              ]
            }
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/FileList"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting all files owned by this account.": {
            "$ref": "./examples/get_files.json"
          }
        }
      },
      "post": {
        "tags": [
          "Files:"
        ],
        "summary": "Creates a new file entity by uploading data from a local machine. Uploaded files can, for example, be used for training or evaluating fine-tuned models.",
        "operationId": "Files_Upload",
        "consumes": [
          "multipart/form-data"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          },
          {
            "in": "formData",
            "name": "purpose",
            "description": "The intended purpose of the uploaded documents. Use \"fine-tune\" for fine-tuning. This allows us to validate the format of the uploaded file.",
            "required": true,
            "type": "string",
            "enum": [
              "fine-tune",
              "fine-tune-results",
              "assistants",
              "assistants_output"
            ],
            "x-ms-enum": {
              "name": "Purpose",
              "modelAsString": true,
              "values": [
                {
                  "value": "fine-tune",
                  "description": "This file contains training data for a fine tune job."
                },
                {
                  "value": "fine-tune-results",
                  "description": "This file contains the results of a fine tune job."
                },
                {
                  "value": "assistants",
                  "description": "This file contains data to be used in assistants."
                },
                {
                  "value": "assistants_output",
                  "description": "This file contains the results of an assistant."
                }
              ]
            }
          },
          {
            "in": "formData",
            "name": "file",
            "description": "Gets or sets the file to upload into Azure OpenAI.",
            "required": true,
            "type": "file"
          }
        ],
        "responses": {
          "201": {
            "description": "The file has been successfully created.",
            "schema": {
              "$ref": "#/definitions/File"
            },
            "headers": {
              "Location": {
                "description": "The location of the newly created item.",
                "type": "string",
                "format": "url"
              }
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Upload a file.": {
            "$ref": "./examples/upload_file.json"
          }
        }
      }
    },
    "/files/{file-id}": {
      "get": {
        "tags": [
          "Files:"
        ],
        "summary": "Gets details for a single file specified by the given file-id including status, size, purpose, etc.",
        "operationId": "Files_Get",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "file-id",
            "description": "The identifier of the file.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/File"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting a file.": {
            "$ref": "./examples/get_file.json"
          }
        }
      },
      "delete": {
        "tags": [
          "Files:"
        ],
        "summary": "Deletes the file with the given file-id.\r\nDeletion is also allowed if a file was used, e.g., as training file in a fine-tune job.",
        "operationId": "Files_Delete",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "file-id",
            "description": "The identifier of the file.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "204": {
            "description": "The file was successfully deleted."
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Deleting a file.": {
            "$ref": "./examples/delete_file.json"
          }
        }
      }
    },
    "/files/{file-id}/content": {
      "get": {
        "tags": [
          "Files:"
        ],
        "summary": "Gets the content of the file specified by the given file-id.\r\nFiles can be user uploaded content or generated by the service like result metrics of a fine-tune job.",
        "operationId": "Files_GetContent",
        "produces": [
          "application/octet-stream",
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "file-id",
            "description": "The identifier of the file.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "type": "file"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting the file content.": {
            "$ref": "./examples/get_file_content.json"
          }
        }
      }
    },
    "/files/import": {
      "post": {
        "tags": [
          "Files:"
        ],
        "summary": "Creates a new file entity by importing data from a provided url. Uploaded files can, for example, be used for training or evaluating fine-tuned models.",
        "operationId": "Files_Import",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          },
          {
            "in": "body",
            "name": "fileImport",
            "description": "The definition of the file to create including its purpose, the file name and the url of the file location.",
            "required": true,
            "schema": {
              "$ref": "#/definitions/FileImport"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "The file has been successfully created.",
            "schema": {
              "$ref": "#/definitions/File"
            },
            "headers": {
              "Location": {
                "description": "The location of the newly created item.",
                "type": "string",
                "format": "url"
              }
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Importing a file with a blob url as source.": {
            "$ref": "./examples/import_file.json"
          }
        }
      }
    },
    "/fine_tuning/jobs": {
      "get": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Gets a list of all fine-tune jobs owned by the Azure OpenAI resource.\r\nThe details that are returned for each fine-tune job contain besides its identifier\r\nthe base model, training and validation files, hyper parameters, time stamps, status and events.\r\nEvents are created when the job status changes, e.g. running or complete, and when results are uploaded.",
        "operationId": "FineTuning_List",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "after",
            "description": "Identifier for the last event from the previous pagination request.",
            "type": "string"
          },
          {
            "in": "query",
            "name": "limit",
            "description": "Number of events to retrieve. Defaults to 20.",
            "type": "integer",
            "format": "int32",
            "default": 20
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/FineTuningJobList"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting all fine tuning jobs owned by this account.": {
            "$ref": "./examples/get_finetuning_jobs.json"
          }
        }
      },
      "post": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Creates a job that fine-tunes a specified model from a given training file.\r\nResponse includes details of the enqueued job including job status and hyper parameters.\r\nThe name of the fine-tuned model is added to the response once complete.",
        "operationId": "FineTuning_Create",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          },
          {
            "in": "body",
            "name": "fineTuningJob",
            "description": "The specification of the fine-tuned model to create.\r\nRequired parameters are the base model and the training file to use.\r\nOptionally a validation file can be specified to compute validation metrics during training.\r\nHyper parameters will be set to default values or can be optionally specified.\r\nThese include batch size, learning rate multiplier, number of epochs and others.",
            "required": true,
            "schema": {
              "$ref": "#/definitions/FineTuningJobCreation"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "The fine tune has been successfully created.",
            "schema": {
              "$ref": "#/definitions/FineTuningJob"
            },
            "headers": {
              "Location": {
                "description": "The location of the newly created item.",
                "type": "string",
                "format": "url"
              }
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Creating a fine tuning job.": {
            "$ref": "./examples/post_finetuning_job.json"
          }
        }
      }
    },
    "/fine_tuning/jobs/{fine-tuning-job-id}": {
      "get": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Gets details for a single fine-tune job specified by the given fine-tune-id.\r\nThe details contain the base model, training and validation files, hyper parameters, time stamps, status and events.\r\nEvents are created when the job status changes, e.g. running or complete, and when results are uploaded.",
        "operationId": "FineTuning_Get",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "fine-tuning-job-id",
            "description": "The identifier of the fine-tune job.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/FineTuningJob"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting a fine tuning job.": {
            "$ref": "./examples/get_finetuning_job.json"
          }
        }
      },
      "delete": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Deletes the fine-tune job specified by the given fine-tune-id.",
        "operationId": "FineTuning_Delete",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "fine-tuning-job-id",
            "description": "The identifier of the fine-tune job.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "204": {
            "description": "The fine tune was successfully deleted."
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Deleting a fine tuning job.": {
            "$ref": "./examples/delete_finetuning_job.json"
          }
        }
      }
    },
    "/fine_tuning/jobs/{fine-tuning-job-id}/events": {
      "get": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Gets the events for the fine-tune job specified by the given fine-tune-id.\r\nEvents are created when the job status changes, e.g. running or complete, and when results are uploaded.",
        "operationId": "FineTuning_GetEvents",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "fine-tuning-job-id",
            "description": "The identifier of the fine-tune job.",
            "required": true,
            "type": "string"
          },
          {
            "in": "query",
            "name": "after",
            "description": "Identifier for the last event from the previous pagination request.",
            "type": "string"
          },
          {
            "in": "query",
            "name": "limit",
            "description": "Number of events to retrieve. Defaults to 20.",
            "type": "integer",
            "format": "int32",
            "default": 20
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/FineTuningJobEventList"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting events of a fine tuning job.": {
            "$ref": "./examples/get_finetuning_job_events.json"
          }
        }
      }
    },
    "/fine_tuning/jobs/{fine-tuning-job-id}/checkpoints": {
      "get": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Gets the checkpoints for the fine-tune job specified by the given fine-tune-id.\r\nCheckpoints are created at the end of successful epochs during training.",
        "operationId": "FineTuning_GetCheckpoints",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "fine-tuning-job-id",
            "description": "The identifier of the fine-tune job.",
            "required": true,
            "type": "string"
          },
          {
            "in": "query",
            "name": "after",
            "description": "Identifier for the last checkpoint ID from the previous pagination request.",
            "type": "string"
          },
          {
            "in": "query",
            "name": "limit",
            "description": "Number of checkpoints to retrieve. Defaults to 10.",
            "type": "integer",
            "format": "int32",
            "default": 10
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/FineTuningJobCheckpointList"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting checkpoints of a fine tuning job.": {
            "$ref": "./examples/get_finetuning_job_checkpoints.json"
          }
        }
      }
    },
    "/fine_tuning/jobs/{fine-tuning-job-id}/cancel": {
      "post": {
        "tags": [
          "Fine-tuning:"
        ],
        "summary": "Cancels the processing of the fine-tune job specified by the given fine-tune-id.",
        "operationId": "FineTuning_Cancel",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "fine-tuning-job-id",
            "description": "The identifier of the fine-tune job.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "The fine tune has been successfully canceled",
            "schema": {
              "$ref": "#/definitions/FineTuningJob"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Canceling a fine tuning job.": {
            "$ref": "./examples/cancel_finetuning_job.json"
          }
        }
      }
    },
    "/models": {
      "get": {
        "tags": [
          "Models:"
        ],
        "summary": "Gets a list of all models that are accessible by the Azure OpenAI resource.\r\nThese include base models as well as all successfully completed fine-tuned models owned by the Azure OpenAI resource.",
        "operationId": "Models_List",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/ModelList"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting all models owned by account.": {
            "$ref": "./examples/get_models.json"
          }
        }
      }
    },
    "/models/{model-id}": {
      "get": {
        "tags": [
          "Models:"
        ],
        "summary": "Gets details for the model specified by the given modelId.",
        "operationId": "Models_Get",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "model-id",
            "description": "The identifier of the model.",
            "required": true,
            "type": "string"
          },
          {
            "$ref": "#/parameters/apiVersionQueryParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/Model"
            }
          },
          "default": {
            "description": "An error occurred.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Getting a base model.": {
            "$ref": "./examples/get_model_base.json"
          },
          "Getting a fine-tuned model.": {
            "$ref": "./examples/get_model_finetune.json"
          }
        }
      }
    },
    "/ingestion/jobs": {
        "get": {
            "tags": [
                "Ingestion:"
            ],
            "summary": "Lists the ingestion jobs.",
            "operationId": "IngestionJobs_List",
            "produces": [
                "application/json"
            ],
            "parameters": [
                {
                    "$ref": "#/parameters/apiVersionQueryParameter"
                },
                {
                    "in": "header",
                    "name": "mgmt-user-token",
                    "type": "string",
                    "description": "The token used to access the workspace (needed only for user compute jobs)."
                }
            ],
            "responses": {
                "200": {
                    "description": "Success",
                    "schema": {
                        "$ref": "#/definitions/IngestionJobList"
                    }
                },
                "default": {
                    "description": "An error occurred.",
                    "schema": {
                        "$ref": "#/definitions/ErrorResponse"
                    }
                }
            },
            "x-ms-examples": {
                "List all ingestion jobs": {
                    "$ref": "./examples/list_ingestion_jobs.json"
                }
            }
        }
    },
    "/ingestion/jobs/{job-id}": {
        "put": {
            "tags": [
                "Ingestion:"
            ],
            "summary": "Creates an ingestion job with the specified job id.",
            "operationId": "IngestionJobs_Create",
            "consumes": [
                "application/json"
            ],
            "produces": [
                "application/json"
            ],
            "parameters": [
                {
                    "$ref": "#/parameters/apiVersionQueryParameter"
                },
                {
                    "in": "path",
                    "name": "job-id",
                    "required": true,
                    "type": "string",
                    "description": "The id of the job that will be created."
                },
                {
                    "in": "header",
                    "name": "mgmt-user-token",
                    "type": "string",
                    "description": "The token used to access the workspace (needed only for user compute jobs)."
                },
                {
                    "in": "header",
                    "name": "aml-user-token",
                    "type": "string",
                    "description": "The token used to access the resources within the job in the workspace (needed only for user compute jobs)."
                },
                {
                    "in": "body",
                    "name": "ingestionJob",
                    "schema": {
                        "$ref": "#/definitions/IngestionJob"
                    }
                }
            ],
            "responses": {
                "200": {
                    "description": "Success",
                    "schema": {
                        "$ref": "#/definitions/IngestionJob"
                    }
                },
                "default": {
                    "description": "An error occurred.",
                    "schema": {
                        "$ref": "#/definitions/ErrorResponse"
                    }
                }
            },
            "x-ms-examples": {
                "Create a system-compute ingestion job": {
                    "$ref": "./examples/put_ingestion_job_sc.json"
                },
                "Create a user-compute ingestion job": {
                    "$ref": "./examples/put_ingestion_job_uc.json"
                }
            }
        },
        "get": {
            "tags": [
                "Ingestion:"
            ],
            "summary": "Gets the details of the specified job id.",
            "operationId": "IngestionJobs_Get",
            "produces": [
                "application/json"
            ],
            "parameters": [
                {
                    "$ref": "#/parameters/apiVersionQueryParameter"
                },
                {
                    "in": "path",
                    "name": "job-id",
                    "required": true,
                    "description": "The id of the job.",
                    "type": "string"
                }
            ],
            "responses": {
                "200": {
                    "description": "Success",
                    "schema": {
                        "$ref": "#/definitions/IngestionJob"
                    }
                },
                "default": {
                    "description": "An error occurred.",
                    "schema": {
                        "$ref": "#/definitions/ErrorResponse"
                    }
                }
            },
            "x-ms-examples": {
                "Get ingestion job": {
                    "$ref": "./examples/get_ingestion_job.json"
                }
            }
        }
    },
    "/ingestion/jobs/{job-id}/runs": {
        "get": {
            "tags": [
                "Ingestion:"
            ],
            "summary": "Lists the runs of the specified job id.",
            "operationId": "IngestionJobRuns_List",
            "produces": [
                "application/json"
            ],
            "parameters": [
                {
                    "$ref": "#/parameters/apiVersionQueryParameter"
                },
                {
                    "in": "path",
                    "name": "job-id",
                    "required": true,
                    "description": "The id of the job.",
                    "type": "string"
                },
                {
                    "in": "header",
                    "name": "mgmt-user-token",
                    "type": "string",
                    "description": "The token used to access the workspace (needed only for user compute jobs)."
                }
            ],
            "responses": {
                "200": {
                    "description": "Success",
                    "schema": {
                        "$ref": "#/definitions/IngestionJobRunList"
                    }
                },
                "default": {
                    "description": "An error occurred.",
                    "schema": {
                        "$ref": "#/definitions/ErrorResponse"
                    }
                }
            },
            "x-ms-examples": {
                "List ingestion job runs": {
                    "$ref": "./examples/list_ingestion_job_runs.json"
                }
            }
        }
    },
    "/ingestion/jobs/{job-id}/runs/{run-id}": {
        "get": {
            "tags": [
                "Ingestion:"
            ],
            "summary": "Gets the details of the specified run id as part of the specified job id.",
            "operationId": "IngestionJobRuns_Get",
            "produces": [
                "application/json"
            ],
            "parameters": [
                {
                    "$ref": "#/parameters/apiVersionQueryParameter"
                },
                {
                    "in": "path",
                    "name": "job-id",
                    "required": true,
                    "description": "The id of the job.",
                    "type": "string"
                },
                {
                    "in": "path",
                    "name": "run-id",
                    "required": true,
                    "description": "The id of the run.",
                    "type": "string"
                },
                {
                    "in": "header",
                    "name": "mgmt-user-token",
                    "type": "string",
                    "description": "The token used to access the workspace (needed only for user compute jobs)."
                }
            ],
            "responses": {
                "200": {
                    "description": "Success",
                    "schema": {
                        "$ref": "#/definitions/IngestionJobRun"
                    }
                },
                "default": {
                    "description": "An error occurred.",
                    "schema": {
                        "$ref": "#/definitions/ErrorResponse"
                    }
                }
            },
            "x-ms-examples": {
                "Get ingestion job runs": {
                    "$ref": "./examples/get_ingestion_job_run.json"
                }
            }
        }
    }
  },
  "definitions": {
    "Capabilities": {
      "title": "Capabilities",
      "description": "The capabilities of a base or fine tune model.",
      "required": [
        "chat_completion",
        "completion",
        "embeddings",
        "fine_tune",
        "inference"
      ],
      "type": "object",
      "properties": {
        "fine_tune": {
          "description": "A value indicating whether a model can be used for fine tuning.",
          "type": "boolean"
        },
        "inference": {
          "description": "A value indicating whether a model can be deployed.",
          "type": "boolean"
        },
        "completion": {
          "description": "A value indicating whether a model supports completion.",
          "type": "boolean"
        },
        "chat_completion": {
          "description": "A value indicating whether a model supports chat completion.",
          "type": "boolean"
        },
        "embeddings": {
          "description": "A value indicating whether a model supports embeddings.",
          "type": "boolean"
        }
      }
    },
    "Deprecation": {
      "title": "Deprecation",
      "description": "Defines the dates of deprecation for the different use cases of a model.\r\nUsually base models support 1 year of fine tuning after creation. Inference is typically supported 2 years after creation of base or\r\nfine tuned models. The exact dates are specified in the properties.",
      "required": [
        "inference"
      ],
      "type": "object",
      "properties": {
        "fine_tune": {
          "format": "unixtime",
          "description": "The end date of fine tune support of this model. Will be `null` for fine tune models.",
          "type": "integer"
        },
        "inference": {
          "format": "unixtime",
          "description": "The end date of inference support of this model.",
          "type": "integer"
        }
      }
    },
    "Error": {
      "title": "Error",
      "description": "Error content as defined in the Microsoft REST guidelines\r\n(https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).",
      "required": [
        "code",
        "message"
      ],
      "type": "object",
      "properties": {
        "code": {
          "$ref": "#/definitions/ErrorCode"
        },
        "message": {
          "description": "The message of this error.",
          "minLength": 1,
          "type": "string"
        },
        "target": {
          "description": "The location where the error happened if available.",
          "type": "string"
        },
        "details": {
          "description": "The error details if available.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Error"
          }
        },
        "innererror": {
          "$ref": "#/definitions/InnerError"
        }
      }
    },
    "ErrorCode": {
      "title": "ErrorCode",
      "description": "Error codes as defined in the Microsoft REST guidelines\r\n(https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).",
      "enum": [
        "conflict",
        "invalidPayload",
        "forbidden",
        "notFound",
        "unexpectedEntityState",
        "itemDoesAlreadyExist",
        "serviceUnavailable",
        "internalFailure",
        "quotaExceeded",
        "jsonlValidationFailed",
        "fileImportFailed",
        "tooManyRequests",
        "unauthorized",
        "contentFilter"
      ],
      "type": "string",
      "x-ms-enum": {
        "name": "ErrorCode",
        "modelAsString": true,
        "values": [
          {
            "value": "conflict",
            "description": "The requested operation conflicts with the current resource state."
          },
          {
            "value": "invalidPayload",
            "description": "The request data is invalid for this operation."
          },
          {
            "value": "forbidden",
            "description": "The operation is forbidden for the current user/api key."
          },
          {
            "value": "notFound",
            "description": "The resource is not found."
          },
          {
            "value": "unexpectedEntityState",
            "description": "The operation cannot be executed in the current resource's state."
          },
          {
            "value": "itemDoesAlreadyExist",
            "description": "The item does already exist."
          },
          {
            "value": "serviceUnavailable",
            "description": "The service is currently not available."
          },
          {
            "value": "internalFailure",
            "description": "Internal error. Please retry."
          },
          {
            "value": "quotaExceeded",
            "description": "Quota exceeded."
          },
          {
            "value": "jsonlValidationFailed",
            "description": "Validation of jsonl data failed."
          },
          {
            "value": "fileImportFailed",
            "description": "Import of file failed."
          },
          {
            "value": "tooManyRequests",
            "description": "Too many requests. Please retry later."
          },
          {
            "value": "unauthorized",
            "description": "The current user/api key is not authorized for the operation."
          },
          {
            "value": "contentFilter",
            "description": "Image generation failed as a result of our safety system."
          }
        ]
      }
    },
    "ErrorResponse": {
      "title": "ErrorResponse",
      "description": "Error response as defined in the Microsoft REST guidelines\r\n(https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).",
      "required": [
        "error"
      ],
      "type": "object",
      "properties": {
        "error": {
          "$ref": "#/definitions/Error"
        }
      }
    },
    "EventType": {
      "title": "EventType",
      "description": "Defines the severity of a content filter result.",
      "enum": [
        "message",
        "metrics"
      ],
      "type": "string",
      "x-ms-enum": {
        "name": "EventType",
        "modelAsString": true,
        "values": [
          {
            "value": "message",
            "description": "Event only contains human readable messages."
          },
          {
            "value": "metrics",
            "description": "Event contains metrics."
          }
        ]
      }
    },
    "File": {
      "title": "File",
      "description": "A file is a document usable for training and validation. It can also be a service generated document with result details.",
      "required": [
        "filename",
        "purpose"
      ],
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "created_at": {
          "format": "unixtime",
          "description": "A timestamp when this job or item was created (in unix epochs).",
          "type": "integer",
          "readOnly": true
        },
        "id": {
          "description": "The identity of this item.",
          "type": "string",
          "readOnly": true
        },
        "status": {
          "$ref": "#/definitions/FileState"
        },
        "bytes": {
          "format": "int64",
          "description": "The size of this file when available (can be null). File sizes larger than 2^53-1 are not supported to ensure compatibility\r\nwith JavaScript integers.",
          "type": "integer",
          "readOnly": true
        },
        "purpose": {
          "$ref": "#/definitions/Purpose"
        },
        "filename": {
          "description": "The name of the file.",
          "minLength": 1,
          "type": "string"
        },
        "status_details": {
          "description": "The error message with details in case processing of this file failed.",
          "type": "string",
          "readOnly": true
        }
      }
    },
    "FileImport": {
      "title": "FileImport",
      "description": "Defines a document to import from an external content url to be usable with Azure OpenAI.",
      "required": [
        "content_url",
        "filename",
        "purpose"
      ],
      "type": "object",
      "properties": {
        "purpose": {
          "$ref": "#/definitions/Purpose"
        },
        "filename": {
          "description": "The name of the [JSON Lines](https://jsonlines.readthedocs.io/en/latest/) file to be uploaded.\r\nIf the `purpose` is set to \"fine-tune\", each line is a JSON record with \"prompt\" and \"completion\" fields representing your training examples.",
          "minLength": 1,
          "type": "string"
        },
        "content_url": {
          "format": "url",
          "description": "The url to download the document from (can be SAS url of a blob or any other external url accessible with a GET request).",
          "type": "string"
        }
      }
    },
    "FileList": {
      "title": "FileList",
      "description": "Represents a list of files.",
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "data": {
          "description": "The list of items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/File"
          }
        }
      }
    },
    "FileState": {
      "title": "FileState",
      "description": "The state of a file.",
      "enum": [
        "uploaded",
        "pending",
        "running",
        "processed",
        "error",
        "deleting",
        "deleted"
      ],
      "type": "string",
      "readOnly": true,
      "x-ms-enum": {
        "name": "FileState",
        "modelAsString": true,
        "values": [
          {
            "value": "uploaded",
            "description": "The file has been uploaded but it's not yet processed. This state is not returned by Azure OpenAI and exposed only for compatibility. It can be categorized as an inactive state."
          },
          {
            "value": "pending",
            "description": "The operation was created and is not queued to be processed in the future. It can be categorized as an inactive state."
          },
          {
            "value": "running",
            "description": "The operation has started to be processed. It can be categorized as an active state."
          },
          {
            "value": "processed",
            "description": "The operation has successfully be processed and is ready for consumption. It can be categorized as a terminal state."
          },
          {
            "value": "error",
            "description": "The operation has completed processing with a failure and cannot be further consumed. It can be categorized as a terminal state."
          },
          {
            "value": "deleting",
            "description": "The entity is ni the process to be deleted. This state is not returned by Azure OpenAI and exposed only for compatibility. It can be categorized as an active state."
          },
          {
            "value": "deleted",
            "description": "The entity has been deleted but may still be referenced by other entities predating the deletion. It can be categorized as a terminal state."
          }
        ]
      }
    },
    "FineTuningHyperParameters": {
      "title": "FineTuningHyperParameters",
      "description": "The hyper parameter settings used in a fine tune job.",
      "type": "object",
      "properties": {
        "n_epochs": {
          "format": "int32",
          "description": "The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset.",
          "type": "integer"
        },
        "batch_size": {
          "format": "int32",
          "description": "The batch size to use for training. The batch size is the number of training examples used to train a single forward and backward pass.\r\nIn general, we've found that larger batch sizes tend to work better for larger datasets.\r\nThe default value as well as the maximum value for this property are specific to a base model.",
          "type": "integer"
        },
        "learning_rate_multiplier": {
          "format": "double",
          "description": "The learning rate multiplier to use for training. The fine-tuning learning rate is the original learning rate used for pre-training multiplied by this value.\r\nLarger learning rates tend to perform better with larger batch sizes.\r\nWe recommend experimenting with values in the range 0.02 to 0.2 to see what produces the best results.",
          "type": "number"
        }
      }
    },
    "FineTuningJob": {
      "title": "FineTuningJob",
      "description": "Defines the values of a fine tune job.",
      "required": [
        "model",
        "training_file"
      ],
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "created_at": {
          "format": "unixtime",
          "description": "A timestamp when this job or item was created (in unix epochs).",
          "type": "integer",
          "readOnly": true
        },
        "id": {
          "description": "The identity of this item.",
          "type": "string",
          "readOnly": true
        },
        "status": {
          "$ref": "#/definitions/FineTuningState"
        },
        "model": {
          "description": "The identifier (model-id) of the base model used for the fine-tune.",
          "minLength": 1,
          "type": "string"
        },
        "fine_tuned_model": {
          "description": "The identifier (model-id) of the resulting fine tuned model. This property is only populated for successfully completed fine-tune runs.\r\nUse this identifier to create a deployment for inferencing.",
          "type": "string"
        },
        "training_file": {
          "description": "The file which is used for training.",
          "minLength": 1,
          "type": "string"
        },
        "validation_file": {
          "description": "The file which is used to evaluate the fine tuned model during training.",
          "type": "string"
        },
        "result_files": {
          "description": "The result file identities (file-id) containing training and evaluation metrics in csv format.\r\nThe file is only available for successfully completed fine-tune runs.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "finished_at": {
          "format": "int32",
          "description": "A timestamp when this job or item has finished successfully (in unix epochs).",
          "type": "integer",
          "readOnly": true
        },
        "organisation_id": {
          "description": "The organisation id of this fine tune job. Unused on Azure OpenAI; compatibility for OpenAI only.",
          "type": "string"
        },
        "trained_tokens": {
          "format": "int32",
          "description": "The total number of billable tokens processed by this fine tuning job.",
          "type": "integer",
          "readOnly": true
        },
        "hyperparameters": {
          "$ref": "#/definitions/FineTuningHyperParameters"
        },
        "suffix": {
          "description": "The suffix used to identify the fine-tuned model. The suffix can contain up to 40 characters (a-z, A-Z, 0-9,- and _) that will be added to your fine-tuned model name.",
          "type": "string"
        },
        "seed": {
          "format": "int32",
          "description": "The seed used for the finetuning job.",
          "type": "integer"
        }
      }
    },
    "FineTuningJobCheckpoint": {
      "title": "FineTuningJobCheckpoint",
      "required": [
        "created_at",
        "fine_tuned_model_checkpoint",
        "fine_tuning_job_id",
        "metrics",
        "step_number"
      ],
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "id": {
          "description": "The identity of this checkpoint.",
          "type": "string",
          "readOnly": true
        },
        "created_at": {
          "format": "unixtime",
          "description": "The Unix timestamp (in seconds) for when the checkpoint was created.",
          "type": "integer"
        },
        "fine_tuned_model_checkpoint": {
          "description": "The name of the fine-tuned checkpoint model that is created.",
          "minLength": 1,
          "type": "string"
        },
        "step_number": {
          "format": "int32",
          "description": "The step number that the checkpoint was created at.",
          "type": "integer"
        },
        "metrics": {
          "title": "Dictionary`2",
          "description": "The metrics at the step number during the fine-tuning job.",
          "type": "object",
          "additionalProperties": {
            "format": "double",
            "type": "number"
          }
        },
        "fine_tuning_job_id": {
          "description": "The name of the fine-tuning job that this checkpoint was created from..",
          "minLength": 1,
          "type": "string"
        }
      }
    },
    "FineTuningJobCheckpointList": {
      "title": "FineTuningJobCheckpointList",
      "description": "Represents a list of checkpoints.",
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "data": {
          "description": "The list of items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/FineTuningJobCheckpoint"
          }
        },
        "has_more": {
          "description": "A value indicating whether the list contains more elements than returned.",
          "type": "boolean"
        }
      }
    },
    "FineTuningJobCreation": {
      "title": "FineTuningJobCreation",
      "description": "Defines the values of a fine tune job.",
      "required": [
        "model",
        "training_file"
      ],
      "type": "object",
      "properties": {
        "model": {
          "description": "The identifier (model-id) of the base model used for this fine-tune.",
          "minLength": 1,
          "type": "string"
        },
        "training_file": {
          "description": "The file identity (file-id) that is used for training this fine tuned model.",
          "minLength": 1,
          "type": "string"
        },
        "validation_file": {
          "description": "The file identity (file-id) that is used to evaluate the fine tuned model during training.",
          "type": "string"
        },
        "hyperparameters": {
          "$ref": "#/definitions/FineTuningHyperParameters"
        },
        "suffix": {
          "description": "The suffix used to identify the fine-tuned model. The suffix can contain up to 40 characters (a-z, A-Z, 0-9,- and _) that will be added to your fine-tuned model name.",
          "type": "string"
        },
        "seed": {
          "format": "int32",
          "description": "The seed used for the finetuning job. Passing in the same seed and job parameters should produce the same results, but may differ in rare cases. If a seed is not specified, one will be generated for you.",
          "type": "integer"
        }
      }
    },
    "FineTuningJobEvent": {
      "title": "FineTuningJobEvent",
      "required": [
        "created_at",
        "level",
        "message",
        "type"
      ],
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "id": {
          "description": "The identity of this event.",
          "type": "string",
          "readOnly": true
        },
        "created_at": {
          "format": "unixtime",
          "description": "A timestamp when this event was created (in unix epochs).",
          "type": "integer"
        },
        "level": {
          "$ref": "#/definitions/LogLevel"
        },
        "message": {
          "description": "The message describing the event. This can be a change of state, e.g., enqueued, started, failed or completed, or other events like uploaded results.",
          "minLength": 1,
          "type": "string"
        },
        "type": {
          "$ref": "#/definitions/EventType"
        },
        "data": {
          "description": "Machine readable data of this event."
        }
      }
    },
    "FineTuningJobEventList": {
      "title": "FineTuningJobEventList",
      "description": "Represents a list of events.",
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "data": {
          "description": "The list of items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/FineTuningJobEvent"
          }
        },
        "has_more": {
          "description": "A value indicating whether the list contains more elements than returned.",
          "type": "boolean"
        }
      }
    },
    "FineTuningJobList": {
      "title": "FineTuningJobList",
      "description": "Represents a list of fine tunes.",
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "data": {
          "description": "The list of items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/FineTuningJob"
          }
        },
        "has_more": {
          "description": "A value indicating whether the list contains more elements than returned.",
          "type": "boolean"
        }
      }
    },
    "FineTuningState": {
      "title": "FineTuningState",
      "description": "The state of a finetunes object or fine tuning job.",
      "enum": [
        "created",
        "pending",
        "running",
        "succeeded",
        "cancelled",
        "failed"
      ],
      "type": "string",
      "readOnly": true,
      "x-ms-enum": {
        "name": "FineTuningState",
        "modelAsString": true,
        "values": [
          {
            "value": "created",
            "description": "The operation was created. This state is not returned by Azure OpenAI and exposed only for compatibility. It can be categorized as an inactive state."
          },
          {
            "value": "pending",
            "description": "The operation is not yet queued to be processed in the future. It can be categorized as an inactive state."
          },
          {
            "value": "running",
            "description": "The operation has started to be processed. It can be categorized as an active state."
          },
          {
            "value": "succeeded",
            "description": "The operation has successfully be processed and is ready for consumption. It can be categorized as a terminal state."
          },
          {
            "value": "cancelled",
            "description": "The operation has been cancelled and is incomplete. It can be categorized as a terminal state."
          },
          {
            "value": "failed",
            "description": "The operation has completed processing with a failure and cannot be further consumed. It can be categorized as a terminal state."
          }
        ]
      }
    },
    "InnerError": {
      "title": "InnerError",
      "description": "Inner error as defined in the Microsoft REST guidelines\r\n(https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).",
      "type": "object",
      "properties": {
        "code": {
          "$ref": "#/definitions/InnerErrorCode"
        },
        "innererror": {
          "$ref": "#/definitions/InnerError"
        }
      }
    },
    "InnerErrorCode": {
      "title": "InnerErrorCode",
      "description": "Inner error codes as defined in the Microsoft REST guidelines\r\n(https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).",
      "enum": [
        "invalidPayload"
      ],
      "type": "string",
      "x-ms-enum": {
        "name": "InnerErrorCode",
        "modelAsString": true,
        "values": [
          {
            "value": "invalidPayload",
            "description": "The request data is invalid for this operation."
          }
        ]
      }
    },
    "LifeCycleStatus": {
      "title": "LifeCycleStatus",
      "description": "The life cycle status of a model.\r\nNote: A model can be promoted from \"preview\" to \"generally-available\", but never from \"generally-available\" to \"preview\".",
      "enum": [
        "preview",
        "generally-available"
      ],
      "type": "string",
      "x-ms-enum": {
        "name": "LifeCycleStatus",
        "modelAsString": true,
        "values": [
          {
            "value": "preview",
            "description": "Model is in preview and covered by the service preview terms."
          },
          {
            "value": "generally-available",
            "description": "Model is generally available."
          }
        ]
      }
    },
    "LogLevel": {
      "title": "LogLevel",
      "description": "The verbosity level of an event.",
      "enum": [
        "info",
        "warning",
        "error"
      ],
      "type": "string",
      "x-ms-enum": {
        "name": "LogLevel",
        "modelAsString": true,
        "values": [
          {
            "value": "info",
            "description": "This event is for information only."
          },
          {
            "value": "warning",
            "description": "This event represents a mitigated issue."
          },
          {
            "value": "error",
            "description": "This message represents a non recoverable issue."
          }
        ]
      }
    },
    "Model": {
      "title": "Model",
      "description": "A model is either a base model or the result of a successful fine tune job.",
      "required": [
        "capabilities",
        "deprecation",
        "lifecycle_status"
      ],
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "created_at": {
          "format": "unixtime",
          "description": "A timestamp when this job or item was created (in unix epochs).",
          "type": "integer",
          "readOnly": true
        },
        "id": {
          "description": "The identity of this item.",
          "type": "string",
          "readOnly": true
        },
        "status": {
          "$ref": "#/definitions/FineTuningState"
        },
        "model": {
          "description": "The base model identity (model-id) if this is a fine tune model; otherwise `null`.",
          "type": "string"
        },
        "fine_tune": {
          "description": "The fine tune job identity (fine-tune-id) if this is a fine tune model; otherwise `null`.",
          "type": "string"
        },
        "capabilities": {
          "$ref": "#/definitions/Capabilities"
        },
        "lifecycle_status": {
          "$ref": "#/definitions/LifeCycleStatus"
        },
        "deprecation": {
          "$ref": "#/definitions/Deprecation"
        }
      }
    },
    "ModelList": {
      "title": "ModelList",
      "description": "Represents a list of models.",
      "type": "object",
      "properties": {
        "object": {
          "$ref": "#/definitions/TypeDiscriminator"
        },
        "data": {
          "description": "The list of items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Model"
          }
        }
      }
    },
    "Purpose": {
      "title": "Purpose",
      "description": "The intended purpose of the uploaded documents. Use \"fine-tune\" for fine-tuning. This allows us to validate the format of the uploaded file.",
      "enum": [
        "fine-tune",
        "fine-tune-results",
        "assistants",
        "assistants_output"
      ],
      "type": "string",
      "x-ms-enum": {
        "name": "Purpose",
        "modelAsString": true,
        "values": [
          {
            "value": "fine-tune",
            "description": "This file contains training data for a fine tune job."
          },
          {
            "value": "fine-tune-results",
            "description": "This file contains the results of a fine tune job."
          },
          {
            "value": "assistants",
            "description": "This file contains data to be used in assistants."
          },
          {
            "value": "assistants_output",
            "description": "This file contains the results of an assistant."
          }
        ]
      }
    },
    "TypeDiscriminator": {
      "title": "TypeDiscriminator",
      "description": "Defines the type of an object.",
      "enum": [
        "list",
        "fine_tuning.job",
        "file",
        "fine_tuning.job.event",
        "fine_tuning.job.checkpoint",
        "model"
      ],
      "type": "string",
      "readOnly": true,
      "x-ms-enum": {
        "name": "TypeDiscriminator",
        "modelAsString": true,
        "values": [
          {
            "value": "list",
            "description": "This object represents a list of other objects."
          },
          {
            "value": "fine_tuning.job",
            "description": "This object represents a fine tune job."
          },
          {
            "value": "file",
            "description": "This object represents a file."
          },
          {
            "value": "fine_tuning.job.event",
            "description": "This object represents an event of a fine tuning job."
          },
          {
            "value": "fine_tuning.job.checkpoint",
            "description": "This object represents a checkpoint of a fine tuning job."
          },
          {
            "value": "model",
            "description": "This object represents a model (can be a base model or fine tune job result)."
          }
        ]
      }
    },
    "IngestionJob": {
      "title": "IngestionJob",
      "description": "Represents the details of a job.",
      "type": "object",
      "required": [
        "kind"
      ],
      "discriminator": "kind",
      "properties": {
        "kind": {
          "$ref": "#/definitions/IngestionJobType"
        },
        "jobId": {
          "type": "string"
        }
      }
    },
    "IngestionJobType": {
      "title": "IngestionJobType",
      "type": "string",
      "description": "The job type.",
      "enum": [
        "system",
        "user"
      ],
      "x-ms-enum": {
        "name": "IngestionJobType",
        "modelAsString": true,
        "values": [
          {
            "name": "SystemCompute",
            "value": "system",
            "description": "Jobs that run on service owned resources."
          },
          {
            "name": "UserCompute",
            "value": "user",
            "description": "Jobs that run on user owned workspace."
          }
      ]
    }
  },
  "IngestionJobSystemCompute": {
    "type": "object",
    "allOf": [
      {
        "$ref": "#/definitions/IngestionJob"
      },
      {
        "properties": {
          "searchServiceConnection": {
            "$ref": "#/definitions/BaseConnection"
          },
          "datasource": {
            "$ref": "#/definitions/SystemComputeDatasource"
          },
          "completionAction": {
            "$ref": "#/definitions/CompletionAction"
          },
          "dataRefreshIntervalInHours": {
            "type": "integer"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "system"
  },
  "IngestionJobUserCompute": {
    "type": "object",
    "required": [
      "workspaceId"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/IngestionJob"
      },
      {
        "properties": {
          "workspaceId": {
            "type": "string"
          },
          "compute": {
            "$ref": "#/definitions/JobCompute"
          },
          "target": {
            "$ref": "#/definitions/TargetIndex"
          },
          "datasource": {
            "$ref": "#/definitions/UserComputeDatasource"
          },
          "dataRefreshIntervalInHours": {
            "type": "integer"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "user"
  },
  "JobCompute": {
    "title": "JobCompute",
    "description": "The compute settings of the job.",
    "type": "object",
    "discriminator": "kind",
    "required": [ "kind" ],
    "properties": {
      "kind": {
        "$ref": "#/definitions/ComputeType"
      }
    }
  },
  "ComputeType": {
    "type": "string",
    "description": "The compute type.",
    "enum": [
      "serverless",
      "custom"
    ],
    "x-ms-enum": {
      "name": "ComputeType",
      "modelAsString": true,
      "values": [
        {
          "name": "ServerlessCompute",
          "value": "serverless",
          "description": "Serverless user compute."
        },
        {
          "name": "CustomCompute",
          "value": "custom",
          "description": "Custom user compute."
        }
      ]
    }
  },
  "ServerlessCompute": {
    "description": "Serverless compute.",
    "allOf": [
      {
        "$ref": "#/definitions/JobCompute"
      },
      {
        "properties": {
          "sku": {
            "type": "string",
            "description": "SKU Level"
          },
          "instanceCount": {
            "type": "integer",
            "description": "The count of instances to run the job on."
          }
        }
      }
    ],
    "x-ms-discriminator-value": "serverless"
  },
  "CustomCompute": {
    "description": "Custom compute.",
    "required": [
      "computeId"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/JobCompute"
      },
      {
        "properties": {
          "computeId": {
            "type": "string",
            "description": "Id of the custom compute"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "custom"
  },
  "TargetIndex": {
    "title": "TargetIndex",
    "description": "Information about the index to be created.",
    "type": "object",
    "discriminator": "kind",
    "required": [
      "kind"
    ],
    "properties": {
      "kind": {
        "$ref": "#/definitions/TargetType"
      }
	  }
  },
  "TargetType": {
    "type": "string",
    "description": "The target type.",
    "enum": [
      "acs",
      "cosmosdb",
      "pinecone"
    ],
    "x-ms-enum": {
      "name": "TargetType",
      "modelAsString": "true",
      "values": [
        {
          "name": "AzureSearch",
          "value": "acs",
          "description": "Azure AI Search Index."
        },
        {
          "name": "CosmosDB",
          "value": "cosmosdb",
          "description": "CosmosDB Index."
        },
        {
          "name": "Pinecone",
          "value": "pinecone",
          "description": "Pinecone Index."
        }
      ]
    }
  },
  "ACSIndex": {
    "description": "ACS Index.",
    "required": [
      "connectionId"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/TargetIndex"
      },
      {
        "properties": {
          "connectionId": {
            "type": "string",
            "description": "The id of the connection pointing to the ACS Index."
          }
        }
      }
    ],
    "x-ms-discriminator-value": "acs"
  },
  "CosmosDBIndex": {
    "description": "CosmosDB Index.",
    "required": [
      "connectionId"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/TargetIndex"
      },
      {
        "properties": {
          "connectionId": {
            "type": "string",
            "description": "The id of the connection pointing to the cosmos DB."
          },
          "collectionName": {
            "type": "string",
            "description": "The name of the cosmos DB collection."
          },
          "databaseName": {
            "type": "string",
            "description": "The name of the cosmos DB database."
          }
        }
      }
    ],
    "x-ms-discriminator-value": "cosmosdb"
  },
  "PineconeIndex": {
    "description": "Pinecone Index.",
    "required": [
      "connectionId"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/TargetIndex"
      },
      {
        "properties": {
          "connectionId": {
            "type": "string",
            "description": "The id of the connection pointing to the pinecone."
          }
        }
      }
    ],
    "x-ms-discriminator-value": "pinecone"
  },
  "UserComputeDatasource": {
    "title": "UserComputeDatasource",
    "type": "object",
    "discriminator": "kind",
    "required": [
      "kind"
    ],
    "properties": {
      "kind": {
        "$ref": "#/definitions/UserComputeDatasourceType"
      }
    }
  },
  "UserComputeDatasourceType": {
    "type": "string",
    "description": "The datasource type.",
    "enum": [
      "dataset",
      "urls"
    ],
    "x-ms-enum": {
      "name": "DatasourceType",
      "modelAsString": true,
      "values": [
        {
          "name": "Dataset",
          "value": "dataset",
          "description": "Workspace Dataset."
        },
        {
          "name": "Urls",
          "value": "urls",
          "description": "URLs."
        }
      ]
    }
  },
  "UserComputeDataset": {
    "type": "object",
    "title": "UserComputeStorage",
    "description": "Storage account",
    "required": [
      "datasetId",
      "datasetType"
    ],
    "x-ms-discriminator-value": "dataset",
    "allOf": [
      {
        "$ref": "#/definitions/UserComputeDatasource"
      },
      {
        "properties": {
          "datasetId": {
            "type": "string"
          },
          "datasetType": {
            "type": "string"
          },
          "chunking": {
            "$ref": "#/definitions/ChunkingSettings"
          },
          "embeddings": {
            "type": "array",
            "items":
            {
              "$ref": "#/definitions/WorkspaceConnectionEmbeddingSettings"
            }
          }
        }
      }
    ]
  },
  "UserComputeUrl": {
    "type": "object",
    "title": "UserComputeUrl",
    "description": "Urls",
    "required": [
      "urls",
      "embeddings"
    ],
    "x-ms-discriminator-value": "urls",
    "allOf": [
      {
        "$ref": "#/definitions/UserComputeDatasource"
      },
      {
        "properties": {
          "urls": {
            "type": "array",
            "items":
              {
                "type": "string"
              }
          },
          "crawling": {
            "$ref": "#/definitions/CrawlingSettings"
          },
          "chunking": {
            "$ref": "#/definitions/ChunkingSettings"
          },
          "embeddings": {
            "type": "array",
            "items":
              {
                "$ref": "#/definitions/WorkspaceConnectionEmbeddingSettings"
              }
          }
        }
      }
    ]
  },
  "SystemComputeDatasource": {
    "title": "SystemComputeDatasource",
    "type": "object",
    "required": [
      "kind"
    ],
    "properties": {
      "kind": {
        "$ref": "#/definitions/SystemComputeDatasourceType"
      }
    }
  },
  "SystemComputeDatasourceType": {
    "type": "string",
    "description": "The datasource type.",
    "enum": [
      "storage",
      "urls"
    ],
    "x-ms-enum": {
      "name": "DatasourceType",
      "modelAsString": true,
      "values": [
        {
          "name": "Storage",
          "value": "storage",
          "description": "Azure Storage Account."
        },
        {
          "name": "Urls",
          "value": "urls",
          "description": "URLs."
        }
      ]
    }
  },
  "SystemComputeStorage": {
    "title": "SystemComputeStorage",
    "description": "Storage account",
    "required": [
      "connection",
      "containerName",
      "embeddings"
    ],
    "x-ms-discriminator-value": "storage",
    "allOf": [
      {
        "$ref": "#/definitions/SystemComputeDatasource"
      },
      {
        "properties": {
          "connection": {
            "$ref": "#/definitions/BaseConnection"
          },
          "containerName": {
            "type": "string",
            "description": "container name"
          },
          "chunking": {
            "$ref": "#/definitions/ChunkingSettings"
          },
          "embeddings": {
            "type": "array",
            "items": {
              "$ref": "#/definitions/GenericEmbeddingSettings"
            }
          }
        }
      }
    ]
  },
  "SystemComputeUrl": {
    "title": "SystemComputeUrl",
    "description": "Urls",
    "required": [
      "urls",
      "connection",
      "containerName",
      "embeddings"
    ],
    "x-ms-discriminator-value": "urls",
    "allOf": [
      {
        "$ref": "#/definitions/SystemComputeDatasource"
      },
      {
        "properties": {
          "urls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "connection": {
            "$ref": "#/definitions/BaseConnection"
          },
          "containerName": {
            "type": "string",
            "description": "container name"
          },
          "crawling": {
            "$ref": "#/definitions/CrawlingSettings"
          },
          "chunking": {
            "$ref": "#/definitions/ChunkingSettings"
          },
          "embeddings": {
            "type": "array",
            "items": {
              "$ref": "#/definitions/GenericEmbeddingSettings"
            }
          }
        }
      }
    ]
  },
  "ChunkingSettings": {
    "title": "ChunkingSettings",
    "description": "Chunking settings",
    "properties": {
      "maxChunkSizeInTokens": {
        "type": "integer"
      }
    }
  },
  "CrawlingSettings": {
    "title": "CrawlingSettings",
    "description": "Crawling settings",
    "properties": {
      "maxCrawlDepth": {
        "type": "integer"
      },
      "maxCrawlTimeInMins": {
        "type": "integer"
      },
      "maxDownloadTimeInMins": {
        "type": "integer"
      },
      "maxFileSize": {
        "type": "integer"
      },
      "maxRedirects": {
        "type": "integer"
      },
      "maxFiles": {
        "type": "integer"
      }
    }
  },
  "GenericEmbeddingSettings": {
    "title": "ConnectionEmbeddingSettings",
    "description": "Connection Embedding Settings",
    "type": "object",
    "x-ms-discriminator-value": "connection",
    "properties": {
      "connection": {
        "$ref": "#/definitions/BaseConnection"
      },
      "deploymentName": {
        "type": "string"
      },
      "modelName": {
        "type": "string"
      }
    }
  },
  "WorkspaceConnectionEmbeddingSettings": {
    "title": "WorkspaceConnectionEmbeddingSettings",
    "description": "Connection id to the embedding model",
    "type": "object",
    "properties": {
      "connectionId": {
        "type": "string"
      },
      "deploymentName": {
        "type": "string"
      },
      "modelName": {
        "type": "string"
      }
    }
  },
  "BaseConnection": {
    "title": "BaseConnection",
    "description": "A connection to a resource.",
    "type": "object",
    "required": [
      "kind"
    ],
    "properties": {
      "kind": {
        "$ref": "#/definitions/ConnectionType"
      }
    }
  },
  "ConnectionType": {
    "type": "string",
    "description": "The connection type.",
    "enum": [
      "endpointKey",
      "connectionString",
      "endpointMI",
      "workspace"
    ],
    "x-ms-enum": {
      "name": "ConnectionType",
      "modelAsString": true,
      "values": [
        {
          "name": "EndpointKey",
          "value": "endpointKey",
          "description": "Endpoint and key connection."
        },
        {
          "name": "ConnectionString",
          "value": "connectionString",
          "description": "Connection string."
        },
        {
          "name": "EndpointManagedIdentity",
          "value": "endpointMI",
          "description": "Endpoint and managed identity."
        },
        {
          "name": "AMLWorkspace",
          "value": "workspace",
          "description": "AML Workspace connection."
        },
        {
          "name": "RelativeDeployment",
          "value": "relativeDeployment",
          "description": "Relative deployment"
        }
      ]
    }
  },
  "EndpointKeyConnection": {
    "description": "Endpoint key connection.",
    "required": [
      "endpoint",
      "key"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/BaseConnection"
      },
      {
        "properties": {
          "endpoint": {
            "type": "string",
            "description": "Endpoint"
          },
          "key": {
            "type": "string",
            "description": "Key"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "endpointKey"
  },
  "ConnectionStringConnection": {
    "description": "Connection string connection.",
    "required": [
      "connectionString"
    ],
    "allOf": [
      {
        "$ref": "#/definitions/BaseConnection"
      },
      {
        "properties": {
          "connectionString": {
            "type": "string",
            "description": "Connection string"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "connectionString"
  },
  "EndpointMIConnection": {
    "description": "Endpoint Managed Identity connection.",
    "required": [
      "endpoint" ],
    "allOf": [
      {
        "$ref": "#/definitions/BaseConnection"
      },
      {
        "properties": {
          "endpoint": {
            "type": "string",
            "description": "Endpoint"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "endpointMI"
  },
  "WorkspaceConnection": {
    "description": "AML Workspace connection.",
    "required": [
      "connectionId" ],
    "allOf": [
      {
        "$ref": "#/definitions/BaseConnection"
      },
      {
        "properties": {
          "connectionId": {
            "type": "string",
            "description": "ConnectionId"
          }
        }
      }
    ],
    "x-ms-discriminator-value": "workspace"
  },
  "DeploymentConnection": {
    "description": "Relative deployment connection.",
    "allOf": [
      {
        "$ref": "#/definitions/BaseConnection"
      }
    ],
    "x-ms-discriminator-value": "relativeDeployment"
  },
  "CompletionAction": {
    "type": "string",
    "description": "The completion action.",
    "enum": [
      "cleanUpAssets",
      "keepAllAssets"
    ],
    "x-ms-enum": {
      "name": "IngestionJobCompletionAction",
      "modelAsString": true,
      "values": [
        {
          "name": "keepAllAssets",
          "value": "keepAllAssets",
          "description": "Will not clean up any of the intermediate assets created during the ingestion process."
        },
        {
          "name": "cleanUpAssets",
          "value": "cleanUpAssets",
          "description": "Will clean up intermediate assets created during the ingestion process."
        }
      ]
    }
  },
  "IngestionJobList": {
    "title": "IngestionJobList",
    "description": "Represents a list of ingestion jobs.",
    "type": "object",
    "properties": {
      "nextLink": {
        "description": "The link to the next page.",
        "type": "string"
      },
      "value": {
        "description": "The list of items.",
        "type": "array",
        "items": {
          "$ref": "#/definitions/IngestionJob"
        }
      }
    }
  },
  "IngestionJobRunList": {
    "title": "IngestionJobRunList",
    "description": "Represents a list of ingestion job runs.",
    "type": "object",
    "properties": {
      "nextLink": {
        "description": "The link to the next page.",
        "type": "string"
      },
      "value": {
        "description": "The list of items.",
        "type": "array",
        "items": {
          "$ref": "#/definitions/IngestionJobRun"
        }
      }
    }
  },
  "IngestionJobRun": {
    "title": "IngestionJobRun",
    "description": "The details of a job run",
    "type": "object",
    "properties": {
      "jobId": {
        "type": "string"
      },
      "runId": {
        "type": "string"
      },
      "status": {
        "$ref": "#/definitions/OperationState"
      },
      "error": {
        "$ref": "#/definitions/IngestionError"
      },
      "warnings": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "progress": {
        "$ref": "#/definitions/IngestionJobProgress"
      }
    }
  },
  "IngestionError": {
    "title": "IngestionError",
    "description": "The details of the ingestion error",
    "type": "object",
    "properties": {
      "message": {
        "type": "string"
      },
      "innerErrors": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  },
  "IngestionJobProgress": {
    "title": "IngestionJobProgress",
    "type": "object",
    "required": [
      "stageProgress" ],
    "properties": {
      "stageProgress": {
        "type": "array",
        "items": {
          "$ref": "#/definitions/IngestionJobStageProgress"
        }
      }
    }
  },
  "IngestionJobStageProgress": {
    "title": "IngestionJobStageProgress",
    "type": "object",
    "properties": {
      "name": {
        "type": "string"
      },
      "totalItems": {
        "type": "integer",
        "format": "int32"
      },
      "processedItems": {
        "type": "integer",
        "format": "int32"
      },
      "state": {
        "$ref": "#/definitions/OperationState"
      },
      "subStageProgress": {
        "type": "array",
        "items": {
          "$ref": "#/definitions/IngestionJobStageProgress"
        }
      }
    }
  }
  },
  "parameters": {
    "endpoint": {
      "in": "path",
      "name": "endpoint",
      "description": "Supported Cognitive Services endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace \"aoairesource\" with your Azure OpenAI account name).",
      "required": true,
      "type": "string",
      "format": "url",
      "x-ms-skip-url-encoding": true,
      "x-ms-parameter-location": "client"
    },
    "apiVersionQueryParameter": {
      "in": "query",
      "name": "api-version",
      "description": "The requested API version.",
      "required": true,
      "type": "string",
      "x-ms-client-default": "2024-05-01-preview",
      "x-ms-parameter-location": "client"
    }
  },
  "securityDefinitions": {
    "api-key": {
      "type": "apiKey",
      "name": "api-key",
      "in": "header",
      "description": "Provide your Cognitive Services Azure OpenAI account key here."
    }
  },
  "security": [
    {
      "api-key": [ ]
    }
  ],
  "schemes": [
    "https"
  ],
  "x-ms-parameterized-host": {
    "hostTemplate": "{endpoint}/openai",
    "useSchemePrefix": false,
    "parameters": [
      {
        "$ref": "#/parameters/endpoint"
      }
    ]
  }
}