Amazon DMS Dms Metadata Model Conversion API

openapi: 3.2.0
info:
  title: AWS Database Migration Service Metadata Model Conversion API
  version: '2016-01-01'
  description: Generated from AWS's published Smithy model for AWS Database Migration Service. 3 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://dms.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Metadata Model Conversion
paths:
  /#CancelMetadataModelConversion:
    post:
      operationId: CancelMetadataModelConversion
      summary: Cancel Metadata Model Conversion
      description: 'Cancels a single metadata model conversion operation that was started with StartMetadataModelConversion. Required permissions: dms:CancelMetadataModelConversion. For more information, see Actions, resources, and condition keys for Database Migration Service.'
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/CancelMetadataModelConversionResponse'
              example:
                Request:
                  Status: CANCELING
                  RequestIdentifier: a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
                  MigrationProjectArn: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
        '400':
          description: AccessDeniedFault; InvalidResourceStateFault; ResourceNotFoundFault
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedFault'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AmazonDMSv20160101.CancelMetadataModelConversion
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/CancelMetadataModelConversionMessage'
            example:
              MigrationProjectIdentifier: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
              RequestIdentifier: a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
      tags:
      - Metadata Model Conversion
  /#DescribeMetadataModelConversions:
    post:
      operationId: DescribeMetadataModelConversions
      summary: Describe Metadata Model Conversions
      description: 'Returns a paginated list of metadata model conversion requests for a migration project, initiated by StartMetadataModelConversion. To cancel a queued or in-progress request, call CancelMetadataModelConversion. Required permissions: dms:ListMetadataModelConversions. For more information, see Actions, resources, and condition keys for Database Migration Service.'
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/DescribeMetadataModelConversionsResponse'
              example:
                Requests:
                - Status: SUCCESS
                  RequestIdentifier: a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
                  MigrationProjectArn: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
                - Status: IN_PROGRESS
                  RequestIdentifier: a1b2c3d4-5678-90ab-cdef-EXAMPLE22222
                  MigrationProjectArn: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
                  Progress:
                    ProgressPercent: 50.0
                    TotalObjects: 100
                    ProgressStep: CONVERTING
                    ProcessedObject:
                      Name: ExampleTable
                      Type: table
                      EndpointType: SOURCE
                - Status: FAILED
                  RequestIdentifier: a1b2c3d4-5678-90ab-cdef-EXAMPLE33333
                  MigrationProjectArn: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
                  Error:
                    defaultErrorDetails:
                      Message: No objects were found according to the specified selection rules. Please review your selection rules and try again.
        '400':
          description: ResourceNotFoundFault
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundFault'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AmazonDMSv20160101.DescribeMetadataModelConversions
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/DescribeMetadataModelConversionsMessage'
            example:
              MigrationProjectIdentifier: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
              Filters:
              - Name: request-id
                Values:
                - a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
                - a1b2c3d4-5678-90ab-cdef-EXAMPLE22222
                - a1b2c3d4-5678-90ab-cdef-EXAMPLE33333
      tags:
      - Metadata Model Conversion
  /#StartMetadataModelConversion:
    post:
      operationId: StartMetadataModelConversion
      summary: Start Metadata Model Conversion
      description: 'Queues a conversion of the selected source metadata models (database objects such as tables, views, and procedures) to the target database format. If other requests created by Start* operations are already in the migration project''s queue, the conversion begins after they complete. The conversion request loads metadata models that are not yet in the metadata tree, but does not reload metadata models that are already present. If your source database has changed since the metadata was loaded, refresh the affected metadata models with StartMetadataModelImport before calling this operation. If converted objects already exist in the target metadata tree, the conversion overwrites them, including any manual edits. To check the status of the conversion request, call DescribeMetadataModelConversions using the returned RequestIdentifier as a filter. To cancel a queued or in-progress request, call CancelMetadataModelConversion with the returned RequestIdentifier. After the conversion completes successfully: To export a post-conversion assessment report, call ExportMetadataModelAssessment. To retrieve converted code, use any of the following options: DescribeMetadataModel and DescribeMetadata'
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/StartMetadataModelConversionResponse'
              example:
                RequestIdentifier: a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
        '400':
          description: AccessDeniedFault; InvalidResourceStateFault; KMSKeyNotAccessibleFault; ResourceAlreadyExistsFault; ResourceNotFoundFault; ResourceQuotaExceededFault; S3AccessDeniedFault; S3ResourceNotFoundFault
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedFault'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AmazonDMSv20160101.StartMetadataModelConversion
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/StartMetadataModelConversionMessage'
            example:
              MigrationProjectIdentifier: arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS
              SelectionRules: '{"rules": [{"rule-type": "selection","rule-id": "1","rule-name": "1","object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"},"rule-action": "explicit"}]}'
      tags:
      - Metadata Model Conversion
components:
  schemas:
    Progress:
      type: object
      properties:
        ProgressPercent:
          type: number
          description: The percent complete for the current step of the schema conversion operation.
        TotalObjects:
          type: integer
          description: The number of objects in this schema conversion operation.
        ProgressStep:
          type: string
          description: 'The step of the schema conversion operation. This parameter can store one of the following values: IN_PROGRESS – The operation is running. LOADING_METADATA – Loads metadata from the source database. COUNTING_OBJECTS – Determines the number of objects involved in the operation. ANALYZING – Analyzes the source database objects. CONVERTING – Converts the source database objects to a format compatible with the target database. APPLYING – Applies the converted code to the target database. FINISHED – The operation completed successfully.'
        ProcessedObject:
          $ref: '#/components/schemas/ProcessedObject'
    ProcessedObject:
      type: object
      properties:
        Name:
          type: string
          description: The name of the database object.
        Type:
          type: string
          description: The type of the database object. For example, a table, view, procedure, and so on.
        EndpointType:
          type: string
          description: 'The type of the data provider. This parameter can store one of the following values: "SOURCE" or "TARGET".'
    CancelMetadataModelConversionMessage:
      type: object
      properties:
        MigrationProjectIdentifier:
          type: string
          description: The migration project name or Amazon Resource Name (ARN).
        RequestIdentifier:
          type: string
          description: The identifier for the metadata model conversion operation to cancel. This operation was initiated by StartMetadataModelConversion.
      required:
      - MigrationProjectIdentifier
      - RequestIdentifier
    AccessDeniedFault:
      type: object
      properties:
        message:
          type: string
    Filter:
      type: object
      properties:
        Name:
          type: string
          description: The name of the filter as specified for a Describe* or similar operation.
        Values:
          type: array
          items:
            type: string
          description: The filter value, which can specify one or more values used to narrow the returned results.
      required:
      - Name
      - Values
    ResourceNotFoundFault:
      type: object
      properties:
        message:
          type: string
    ExportSqlDetails:
      type: object
      properties:
        S3ObjectKey:
          type: string
          description: The Amazon S3 URI of the object that contains the ZIP archive with exported DDL scripts.
        ObjectURL:
          type: string
          description: The URL of the Amazon S3 object that contains the ZIP archive with exported DDL scripts.
    SchemaConversionRequest:
      type: object
      properties:
        Status:
          type: string
          description: 'The schema conversion operation status. Possible values: RECEIVED – The operation is received but not yet queued for processing. IN_PROGRESS – The operation is queued or actively running. SUCCESS – The operation completed successfully. FAILED – The operation did not complete. CANCELING – The operation is being canceled. The operation might still succeed or fail before cancellation takes effect. CANCELED – The operation was canceled before completion.'
        RequestIdentifier:
          type: string
          description: The identifier for the schema conversion action.
        MigrationProjectArn:
          type: string
          description: The migration project ARN.
        Error:
          $ref: '#/components/schemas/ErrorDetails'
        ExportSqlDetails:
          $ref: '#/components/schemas/ExportSqlDetails'
        Progress:
          $ref: '#/components/schemas/Progress'
    StartMetadataModelConversionMessage:
      type: object
      properties:
        MigrationProjectIdentifier:
          type: string
          description: The migration project name or Amazon Resource Name (ARN).
        SelectionRules:
          type: string
          description: 'A JSON string that identifies the metadata models to convert. For the selection rule format and examples, see Selection rules in DMS Schema Conversion. Usage: Accepts only source selection rules, where server-name in the object locator matches the source data provider. Supports explicit, include, and exclude rule actions.'
      required:
      - MigrationProjectIdentifier
      - SelectionRules
    StartMetadataModelConversionResponse:
      type: object
      properties:
        RequestIdentifier:
          type: string
          description: The identifier for the conversion request.
    DescribeMetadataModelConversionsResponse:
      type: object
      properties:
        Marker:
          type: string
          description: Specifies the unique pagination token that makes it possible to display the next page of results. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords. If Marker is returned by a previous response, there are more results available. The value of Marker is a unique pagination token for each page. To retrieve the next page, make the call again using the returned token and keeping all other arguments unchanged.
        Requests:
          type: array
          items:
            $ref: '#/components/schemas/SchemaConversionRequest'
          description: A paginated list of metadata model conversion requests. DMS never populates the ExportSqlDetails field for this operation.
    ErrorDetails:
      type: object
      properties:
        defaultErrorDetails:
          $ref: '#/components/schemas/DefaultErrorDetails'
      description: Exactly one member is set.
    DefaultErrorDetails:
      type: object
      properties:
        Message:
          type: string
          description: The error message.
    DescribeMetadataModelConversionsMessage:
      type: object
      properties:
        MigrationProjectIdentifier:
          type: string
          description: The migration project name or Amazon Resource Name (ARN).
        Filters:
          type: array
          items:
            $ref: '#/components/schemas/Filter'
          description: 'The filters to apply to the metadata model conversion requests. The following filter names are supported: request-id – The request identifier. status – The request status. Valid values: RECEIVED, IN_PROGRESS, SUCCESS, FAILED, CANCELING, CANCELED.'
        Marker:
          type: string
          description: Specifies the unique pagination token that makes it possible to display the next page of results. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords. If Marker is returned by a previous response, there are more results available. The value of Marker is a unique pagination token for each page. To retrieve the next page, make the call again using the returned token and keeping all other arguments unchanged.
        MaxRecords:
          type: integer
          description: The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, DMS includes a pagination token in the response so that you can retrieve the remaining results.
      required:
      - MigrationProjectIdentifier
    CancelMetadataModelConversionResponse:
      type: object
      properties:
        Request:
          $ref: '#/components/schemas/SchemaConversionRequest'
  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: dms
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/database-migration-service/service/2016-01-01/database-migration-service-2016-01-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)