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-cloudtrail:amazon-cloudtrail-import-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: AWS CloudTrail Import API
  version: '2013-11-01'
  description: Generated from AWS's published Smithy model for AWS CloudTrail. 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://cloudtrail.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Import
paths:
  /#GetImport:
    post:
      operationId: GetImport
      summary: Get Import
      description: CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change. Returns information about a specific import.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/GetImportResponse'
        '404':
          description: ImportNotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ImportNotFoundException'
        '400':
          description: InvalidParameterException; OperationNotPermittedException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.GetImport
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/GetImportRequest'
      tags:
      - Import
  /#ListImports:
    post:
      operationId: ListImports
      summary: List Imports
      description: CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change. Returns information on all imports, or a select set of imports by ImportStatus or Destination.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ListImportsResponse'
        '400':
          description: EventDataStoreARNInvalidException; InvalidNextTokenException; InvalidParameterException; OperationNotPermittedException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/EventDataStoreARNInvalidException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.ListImports
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/ListImportsRequest'
      tags:
      - Import
  /#StartImport:
    post:
      operationId: StartImport
      summary: Start Import
      description: CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change. Starts an import of logged trail events from a source S3 bucket to a destination event data store. By default, CloudTrail only imports events contained in the S3 bucket's CloudTrail prefix and the prefixes inside the CloudTrail prefix, and does not check prefixes for other Amazon Web Services services. If you want to import CloudTrail events contained in another prefix, you must include the prefix in the S3LocationUri. For more considerations about importing trail events, see Considerations for copying trail events in the CloudTrail User Guide. When you start a new import, the Destinations and ImportSource parameters are required. Before starting a new import, disable any access control lists (ACLs) attached to the source S3 bucket. For more information about disabling ACLs, see Controlling ownership of objects and disabling ACLs for your bucket. When you retry an import, the ImportID parameter is required. If th
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/StartImportResponse'
        '400':
          description: AccountHasOngoingImportException; EventDataStoreARNInvalidException; InactiveEventDataStoreException; InsufficientEncryptionPolicyException; InvalidEventDataStoreCategoryException; InvalidEventDataStoreStatusException; InvalidImportSourceException; InvalidParameterException; OperationNotPermittedException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccountHasOngoingImportException'
        '404':
          description: EventDataStoreNotFoundException; ImportNotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/EventDataStoreNotFoundException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.StartImport
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/StartImportRequest'
      tags:
      - Import
  /#StopImport:
    post:
      operationId: StopImport
      summary: Stop Import
      description: CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change. Stops a specified import.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/StopImportResponse'
        '404':
          description: ImportNotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ImportNotFoundException'
        '400':
          description: InvalidParameterException; OperationNotPermittedException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.StopImport
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/StopImportRequest'
      tags:
      - Import
components:
  schemas:
    ListImportsRequest:
      type: object
      properties:
        MaxResults:
          type: integer
          description: The maximum number of imports to display on a single page.
        Destination:
          type: string
          description: The ARN of the destination event data store.
        ImportStatus:
          type: string
          enum:
          - INITIALIZING
          - IN_PROGRESS
          - FAILED
          - STOPPED
          - COMPLETED
          description: The status of the import.
        NextToken:
          type: string
          description: A token you can use to get the next page of import results.
    EventDataStoreNotFoundException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    S3ImportSource:
      type: object
      properties:
        S3LocationUri:
          type: string
          description: The URI for the source S3 bucket.
        S3BucketRegion:
          type: string
          description: The Region associated with the source S3 bucket.
        S3BucketAccessRoleArn:
          type: string
          description: The IAM ARN role used to access the source S3 bucket.
      required:
      - S3LocationUri
      - S3BucketRegion
      - S3BucketAccessRoleArn
    GetImportRequest:
      type: object
      properties:
        ImportId:
          type: string
          description: The ID for the import.
      required:
      - ImportId
    ImportNotFoundException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    ImportStatistics:
      type: object
      properties:
        PrefixesFound:
          type: integer
          description: The number of S3 prefixes found for the import.
        PrefixesCompleted:
          type: integer
          description: The number of S3 prefixes that completed import.
        FilesCompleted:
          type: integer
          description: The number of log files that completed import.
        EventsCompleted:
          type: integer
          description: The number of trail events imported into the event data store.
        FailedEntries:
          type: integer
          description: The number of failed entries.
    InvalidParameterException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    StopImportResponse:
      type: object
      properties:
        ImportId:
          type: string
          description: The ID for the import.
        ImportSource:
          $ref: '#/components/schemas/ImportSource'
        Destinations:
          type: array
          items:
            type: string
          description: The ARN of the destination event data store.
        ImportStatus:
          type: string
          enum:
          - INITIALIZING
          - IN_PROGRESS
          - FAILED
          - STOPPED
          - COMPLETED
          description: The status of the import.
        CreatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of the import's creation.
        UpdatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of the import's last update.
        StartEventTime:
          type: string
          format: date-time
          description: Used with EndEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
        EndEventTime:
          type: string
          format: date-time
          description: Used with StartEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
        ImportStatistics:
          $ref: '#/components/schemas/ImportStatistics'
    ListImportsResponse:
      type: object
      properties:
        Imports:
          type: array
          items:
            $ref: '#/components/schemas/ImportsListItem'
          description: The list of returned imports.
        NextToken:
          type: string
          description: A token you can use to get the next page of import results.
    ImportSource:
      type: object
      properties:
        S3:
          $ref: '#/components/schemas/S3ImportSource'
      required:
      - S3
    AccountHasOngoingImportException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    StopImportRequest:
      type: object
      properties:
        ImportId:
          type: string
          description: The ID of the import.
      required:
      - ImportId
    GetImportResponse:
      type: object
      properties:
        ImportId:
          type: string
          description: The ID of the import.
        Destinations:
          type: array
          items:
            type: string
          description: The ARN of the destination event data store.
        ImportSource:
          $ref: '#/components/schemas/ImportSource'
        StartEventTime:
          type: string
          format: date-time
          description: Used with EndEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
        EndEventTime:
          type: string
          format: date-time
          description: Used with StartEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
        ImportStatus:
          type: string
          enum:
          - INITIALIZING
          - IN_PROGRESS
          - FAILED
          - STOPPED
          - COMPLETED
          description: The status of the import.
        CreatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of the import's creation.
        UpdatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of when the import was updated.
        ImportStatistics:
          $ref: '#/components/schemas/ImportStatistics'
    EventDataStoreARNInvalidException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    StartImportRequest:
      type: object
      properties:
        Destinations:
          type: array
          items:
            type: string
          description: The ARN of the destination event data store. Use this parameter for a new import.
        ImportSource:
          $ref: '#/components/schemas/ImportSource'
        StartEventTime:
          type: string
          format: date-time
          description: Use with EndEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period. When you specify a time range, CloudTrail checks the prefix and log file names to verify the names contain a date between the specified StartEventTime and EndEventTime before attempting to import events.
        EndEventTime:
          type: string
          format: date-time
          description: Use with StartEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period. When you specify a time range, CloudTrail checks the prefix and log file names to verify the names contain a date between the specified StartEventTime and EndEventTime before attempting to import events.
        ImportId:
          type: string
          description: The ID of the import. Use this parameter when you are retrying an import.
    ImportsListItem:
      type: object
      properties:
        ImportId:
          type: string
          description: The ID of the import.
        ImportStatus:
          type: string
          enum:
          - INITIALIZING
          - IN_PROGRESS
          - FAILED
          - STOPPED
          - COMPLETED
          description: The status of the import.
        Destinations:
          type: array
          items:
            type: string
          description: The ARN of the destination event data store.
        CreatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of the import's creation.
        UpdatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of the import's last update.
    StartImportResponse:
      type: object
      properties:
        ImportId:
          type: string
          description: The ID of the import.
        Destinations:
          type: array
          items:
            type: string
          description: The ARN of the destination event data store.
        ImportSource:
          $ref: '#/components/schemas/ImportSource'
        StartEventTime:
          type: string
          format: date-time
          description: Used with EndEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
        EndEventTime:
          type: string
          format: date-time
          description: Used with StartEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
        ImportStatus:
          type: string
          enum:
          - INITIALIZING
          - IN_PROGRESS
          - FAILED
          - STOPPED
          - COMPLETED
          description: Shows the status of the import after a StartImport request. An import finishes with a status of COMPLETED if there were no failures, or FAILED if there were failures.
        CreatedTimestamp:
          type: string
          format: date-time
          description: The timestamp for the import's creation.
        UpdatedTimestamp:
          type: string
          format: date-time
          description: The timestamp of the import's last update, if applicable.
  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: cloudtrail
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloudtrail/service/2013-11-01/cloudtrail-2013-11-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)