Amazon OpenSearch Service API Opensearch Ingestion Job API

The Opensearch Ingestion Job API from Amazon OpenSearch Service API — 4 operation(s) for opensearch ingestion job.

GitHub OpenAPI

Operations 4

POST /#CancelIngestionJob Cancel Ingestion Job #
POST /#CreateIngestionJob Create Ingestion Job #
POST /#GetIngestionJob Get Ingestion Job #
POST /#ListIngestionJobs List Ingestion Jobs #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-opensearch:amazon-opensearch-ingestion-job-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-opensearch-ingestion-job-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon OpenSearch Service Ingestion Job API
  version: '2021-01-01'
  description: Generated from AWS's published Smithy model for Amazon OpenSearch Service. 4 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://aoss.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /#CancelIngestionJob:
    post:
      operationId: CancelIngestionJob
      summary: Cancel Ingestion Job
      description: Cancels an in-progress ingestion job. Documents that were already indexed before the cancellation remain
        in the index.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/CancelIngestionJobResponse'
        '409':
          description: ConflictException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossConflictException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossResourceNotFoundException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - OpenSearchServerless.CancelIngestionJob
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/CancelIngestionJobRequest'
      tags:
      - Ingestion Job
  /#CreateIngestionJob:
    post:
      operationId: CreateIngestionJob
      summary: Create Ingestion Job
      description: Creates an ingestion job that performs a one-time bulk ingestion of data from an Amazon S3 bucket into
        an index in an OpenSearch Serverless collection. An ingestion job scans the source bucket, indexes the documents it
        finds, and then completes. To continuously ingest new data as it arrives, use CreateIngestionStream instead.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/CreateIngestionJobResponse'
        '409':
          description: ConflictException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossConflictException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossServiceQuotaExceededException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - OpenSearchServerless.CreateIngestionJob
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/CreateIngestionJobRequest'
      tags:
      - Ingestion Job
  /#GetIngestionJob:
    post:
      operationId: GetIngestionJob
      summary: Get Ingestion Job
      description: Returns information about an ingestion job, including its configuration, status, and processing state.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/GetIngestionJobResponse'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossResourceNotFoundException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - OpenSearchServerless.GetIngestionJob
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/GetIngestionJobRequest'
      tags:
      - Ingestion Job
  /#ListIngestionJobs:
    post:
      operationId: ListIngestionJobs
      summary: List Ingestion Jobs
      description: Returns a list of ingestion jobs in a collection.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ListIngestionJobsResponse'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossResourceNotFoundException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AossValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - OpenSearchServerless.ListIngestionJobs
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/ListIngestionJobsRequest'
      tags:
      - Ingestion Job
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: aoss
  schemas:
    AossConflictException:
      type: object
      properties:
        message:
          type: string
    AossResourceNotFoundException:
      type: object
      properties:
        message:
          type: string
    AossServiceQuotaExceededException:
      type: object
      properties:
        message:
          type: string
          description: Description of the error.
        resourceId:
          type: string
          description: Identifier of the resource affected.
        resourceType:
          type: string
          description: Type of the resource affected.
        serviceCode:
          type: string
          description: Service Quotas requirement to identify originating service.
        quotaCode:
          type: string
          description: Service Quotas requirement to identify originating quota.
      required:
      - message
      - serviceCode
    AossTag:
      type: object
      properties:
        key:
          type: string
          description: The key to use in the tag.
        value:
          type: string
          description: The value of the tag.
      required:
      - key
      - value
    AossValidationException:
      type: object
      properties:
        message:
          type: string
    CancelIngestionJobRequest:
      type: object
      properties:
        collectionId:
          type: string
          description: The unique identifier of the collection that the ingestion job belongs to.
        ingestionJobId:
          type: string
          description: The unique identifier of the ingestion job to cancel.
        clientToken:
          type: string
          description: Unique, case-sensitive identifier to ensure idempotency of the request.
      required:
      - collectionId
      - ingestionJobId
    CancelIngestionJobResponse:
      type: object
      properties:
        ingestionJobId:
          type: string
          description: The unique identifier of the cancelled ingestion job.
        collectionId:
          type: string
          description: The unique identifier of the collection that the ingestion job belongs to.
        ingestionJobName:
          type: string
          description: The name of the cancelled ingestion job.
        status:
          type: string
          description: The current status of the ingestion job.
    CreateIngestionJobRequest:
      type: object
      properties:
        collectionId:
          type: string
          description: The unique identifier of the collection to ingest data into.
        ingestionJobName:
          type: string
          description: The name of the ingestion job. The name must be unique within the collection.
        indexName:
          type: string
          description: The name of the index to ingest documents into.
        failureIndexName:
          type: string
          description: The name of the index where documents that fail to be ingested are recorded.
        source:
          $ref: '#/components/schemas/IngestionJobSource'
        tags:
          type: array
          items:
            $ref: '#/components/schemas/AossTag'
          description: An arbitrary set of tags (key–value pairs) to associate with the ingestion job.
        clientToken:
          type: string
          description: Unique, case-sensitive identifier to ensure idempotency of the request.
      required:
      - collectionId
      - ingestionJobName
      - indexName
      - source
    CreateIngestionJobResponse:
      type: object
      properties:
        ingestionJobDetail:
          $ref: '#/components/schemas/IngestionJobDetail'
    GetIngestionJobRequest:
      type: object
      properties:
        collectionId:
          type: string
          description: The unique identifier of the collection that the ingestion job belongs to.
        ingestionJobId:
          type: string
          description: The unique identifier of the ingestion job to retrieve.
      required:
      - collectionId
      - ingestionJobId
    GetIngestionJobResponse:
      type: object
      properties:
        ingestionJobDetail:
          $ref: '#/components/schemas/IngestionJobDetail'
    IngestionAlert:
      type: object
      properties:
        code:
          type: string
          description: The code that identifies the alert.
        message:
          type: string
          description: A description of the alert.
    IngestionFailureReason:
      type: object
      properties:
        code:
          type: string
          description: The code that identifies the reason for the failure.
        message:
          type: string
          description: A description of the reason for the failure.
    IngestionJobDetail:
      type: object
      properties:
        ingestionJobId:
          type: string
          description: The unique identifier of the ingestion job.
        arn:
          type: string
          description: The Amazon Resource Name (ARN) of the ingestion job.
        collectionId:
          type: string
          description: The unique identifier of the collection that the ingestion job belongs to.
        ingestionJobName:
          type: string
          description: The name of the ingestion job.
        indexName:
          type: string
          description: The name of the index that documents are ingested into.
        failureIndexName:
          type: string
          description: The name of the index where documents that fail to be ingested are recorded.
        source:
          $ref: '#/components/schemas/IngestionJobSource'
        status:
          type: string
          description: The current lifecycle status of the ingestion job. For example, CREATING, ACTIVE, COMPLETED, or CANCELLED.
        state:
          type: string
          description: The current processing state of the ingestion job. For example, SCANNING, INGESTION_IN_PROGRESS, or
            INGESTION_COMPLETE.
        statistics:
          $ref: '#/components/schemas/IngestionStatistics'
        revision:
          type: integer
          description: The revision number of the ingestion job.
        createdAt:
          type: string
          description: The date and time when the ingestion job was created.
        updatedAt:
          type: string
          description: The date and time when the ingestion job was last updated.
        failureReasons:
          type: array
          items:
            $ref: '#/components/schemas/IngestionFailureReason'
          description: The reasons that the ingestion job reached a terminal failure state, if applicable.
        activeAlerts:
          type: array
          items:
            $ref: '#/components/schemas/IngestionAlert'
          description: Active alerts about operational issues that currently affect the ingestion job. Alerts are cleared
            when the issue is resolved.
    IngestionJobS3Source:
      type: object
      properties:
        bucket:
          type: string
          description: The name or Amazon Resource Name (ARN) of the Amazon S3 bucket to ingest data from.
        bucketOwnerAccountId:
          type: string
          description: The Amazon Web Services account ID that owns the Amazon S3 bucket.
        keyPrefix:
          type: string
          description: A key prefix that limits ingestion to objects in the Amazon S3 bucket whose keys begin with the prefix.
    IngestionJobSource:
      type: object
      properties:
        s3:
          $ref: '#/components/schemas/IngestionJobS3Source'
      required:
      - s3
    IngestionJobSummary:
      type: object
      properties:
        ingestionJobId:
          type: string
          description: The unique identifier of the ingestion job.
        arn:
          type: string
          description: The Amazon Resource Name (ARN) of the ingestion job.
        ingestionJobName:
          type: string
          description: The name of the ingestion job.
        indexName:
          type: string
          description: The name of the index that documents are ingested into.
        status:
          type: string
          description: The current lifecycle status of the ingestion job.
        createdAt:
          type: string
          description: The date and time when the ingestion job was created.
        updatedAt:
          type: string
          description: The date and time when the ingestion job was last updated.
    IngestionStatistics:
      type: object
      properties:
        s3:
          $ref: '#/components/schemas/S3Statistics'
    InternalServerException:
      type: object
      properties:
        message:
          type: string
    ListIngestionJobsRequest:
      type: object
      properties:
        collectionId:
          type: string
          description: The unique identifier of the collection to list ingestion jobs for.
        nextToken:
          type: string
          description: If your initial ListIngestionJobs operation returns a nextToken, you can include the returned nextToken
            in subsequent ListIngestionJobs operations, which returns results in the next page.
        maxResults:
          type: integer
          description: The maximum number of results to return. Valid values are 1–100. If you don't specify a value, the
            default is 100. You can use nextToken to get the next page of results. A response can contain fewer results than
            maxResults, or no results, and still include a nextToken. To retrieve all results, continue to make the call with
            the returned nextToken until no nextToken is returned.
      required:
      - collectionId
    ListIngestionJobsResponse:
      type: object
      properties:
        ingestionJobSummaries:
          type: array
          items:
            $ref: '#/components/schemas/IngestionJobSummary'
          description: Summary information about each ingestion job.
        nextToken:
          type: string
          description: When nextToken is returned, there are more results available. The value of nextToken is a unique pagination
            token for each page. Make the call again using the returned token to retrieve the next page.
    S3Statistics:
      type: object
      properties:
        objectsDiscovered:
          type: integer
          description: The number of Amazon S3 objects discovered for ingestion.
        objectsIngested:
          type: integer
          description: The number of Amazon S3 objects successfully ingested.
        objectsFailed:
          type: integer
          description: The number of Amazon S3 objects that failed to be ingested.
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/opensearchserverless/service/2021-11-01/opensearchserverless-2021-11-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)