openapi: 3.0.0
info:
  version: '2021-06-17'
  x-release: v4
  title: 'AWS IoT FleetWise #X Amz Target=IoTAutobahnControlPlane.AssociateVehicleFleet #X Amz Target=IoTAutobahnControlPlane.AssociateVehicleFleet #X Amz Target=IoTAutobahnControlPlane.GetCampaign API'
  description: <p>Amazon Web Services IoT FleetWise is a fully managed service that you can use to collect, model, and transfer vehicle data to the Amazon Web Services cloud at scale. With Amazon Web Services IoT FleetWise, you can standardize all of your vehicle data models, independent of the in-vehicle communication architecture, and define data collection rules to transfer only high-value data to the cloud. </p> <p>For more information, see <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/">What is Amazon Web Services IoT FleetWise?</a> in the <i>Amazon Web Services IoT FleetWise Developer Guide</i>.</p>
  x-logo:
    url: https://twitter.com/awscloud/profile_image?size=original
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: iotfleetwise
  x-aws-signingName: iotfleetwise
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/iotfleetwise-2021-06-17.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
      version: 1.0.0
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://iotfleetwise.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The AWS IoT FleetWise multi-region endpoint
- url: https://iotfleetwise.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The AWS IoT FleetWise multi-region endpoint
- url: http://iotfleetwise.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The AWS IoT FleetWise endpoint for China (Beijing) and China (Ningxia)
- url: https://iotfleetwise.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The AWS IoT FleetWise endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: '#X Amz Target=IoTAutobahnControlPlane.GetCampaign'
paths:
  /#X-Amz-Target=IoTAutobahnControlPlane.GetCampaign:
    parameters:
    - $ref: '#/components/parameters/X-Amz-Content-Sha256'
    - $ref: '#/components/parameters/X-Amz-Date'
    - $ref: '#/components/parameters/X-Amz-Algorithm'
    - $ref: '#/components/parameters/X-Amz-Credential'
    - $ref: '#/components/parameters/X-Amz-Security-Token'
    - $ref: '#/components/parameters/X-Amz-Signature'
    - $ref: '#/components/parameters/X-Amz-SignedHeaders'
    post:
      operationId: GetCampaign
      description: ' Retrieves information about a campaign. '
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCampaignResponse'
        '480':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '481':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '482':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '483':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
        '484':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetCampaignRequest'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - IoTAutobahnControlPlane.GetCampaign
      summary: Amazon IoT FleetWise Get Campaign
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      tags:
      - '#X Amz Target=IoTAutobahnControlPlane.GetCampaign'
components:
  parameters:
    X-Amz-Credential:
      name: X-Amz-Credential
      in: header
      schema:
        type: string
      required: false
    X-Amz-Algorithm:
      name: X-Amz-Algorithm
      in: header
      schema:
        type: string
      required: false
    X-Amz-Content-Sha256:
      name: X-Amz-Content-Sha256
      in: header
      schema:
        type: string
      required: false
    X-Amz-Security-Token:
      name: X-Amz-Security-Token
      in: header
      schema:
        type: string
      required: false
    X-Amz-SignedHeaders:
      name: X-Amz-SignedHeaders
      in: header
      schema:
        type: string
      required: false
    X-Amz-Date:
      name: X-Amz-Date
      in: header
      schema:
        type: string
      required: false
    X-Amz-Signature:
      name: X-Amz-Signature
      in: header
      schema:
        type: string
      required: false
  schemas:
    DataDestinationConfigs:
      type: array
      items:
        $ref: '#/components/schemas/DataDestinationConfig'
      minItems: 1
      maxItems: 1
    InternalServerException: {}
    eventExpression:
      type: string
      minLength: 1
      maxLength: 2048
    ThrottlingException: {}
    GetCampaignRequest:
      type: object
      required:
      - name
      title: GetCampaignRequest
      properties:
        name:
          allOf:
          - $ref: '#/components/schemas/campaignName'
          - description: ' The name of the campaign to retrieve information about. '
    Compression:
      type: string
      enum:
      - 'OFF'
      - SNAPPY
    languageVersion:
      type: integer
      minimum: 1
    StorageCompressionFormat:
      type: string
      enum:
      - NONE
      - GZIP
    DataExtraDimensionNodePathList:
      type: array
      items:
        $ref: '#/components/schemas/NodePath'
      minItems: 0
      maxItems: 5
    timestamp:
      type: string
      format: date-time
    uint32:
      type: integer
      minimum: 0
      maximum: 4294967295
    arn:
      type: string
    collectionPeriodMs:
      type: integer
      minimum: 10000
      maximum: 60000
    priority:
      type: integer
      minimum: 0
    CollectionScheme:
      type: object
      properties:
        timeBasedCollectionScheme:
          allOf:
          - $ref: '#/components/schemas/TimeBasedCollectionScheme'
          - description: Information about a collection scheme that uses a time period to decide how often to collect data.
        conditionBasedCollectionScheme:
          allOf:
          - $ref: '#/components/schemas/ConditionBasedCollectionScheme'
          - description: Information about a collection scheme that uses a simple logical expression to recognize what data to collect.
      description: Specifies what data to collect and how often or when to collect it.
    TimestreamConfig:
      type: object
      required:
      - timestreamTableArn
      - executionRoleArn
      properties:
        timestreamTableArn:
          allOf:
          - $ref: '#/components/schemas/TimestreamTableArn'
          - description: The Amazon Resource Name (ARN) of the Amazon Timestream table.
        executionRoleArn:
          allOf:
          - $ref: '#/components/schemas/IAMRoleArn'
          - description: The Amazon Resource Name (ARN) of the task execution role that grants Amazon Web Services IoT FleetWise permission to deliver data to the Amazon Timestream table.
      description: The Amazon Timestream table where the Amazon Web Services IoT FleetWise campaign sends data. Timestream stores and organizes data to optimize query processing time and to reduce storage costs. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/data-modeling.html">Data modeling</a> in the <i>Amazon Timestream Developer Guide</i>.
    S3Config:
      type: object
      required:
      - bucketArn
      properties:
        bucketArn:
          allOf:
          - $ref: '#/components/schemas/S3BucketArn'
          - description: The Amazon Resource Name (ARN) of the Amazon S3 bucket.
        dataFormat:
          allOf:
          - $ref: '#/components/schemas/DataFormat'
          - description: <p>Specify the format that files are saved in the Amazon S3 bucket. You can save files in an Apache Parquet or JSON format.</p> <ul> <li> <p>Parquet - Store data in a columnar storage file format. Parquet is optimal for fast data retrieval and can reduce costs. This option is selected by default.</p> </li> <li> <p>JSON - Store data in a standard text-based JSON file format.</p> </li> </ul>
        storageCompressionFormat:
          allOf:
          - $ref: '#/components/schemas/StorageCompressionFormat'
          - description: By default, stored data is compressed as a .gzip file. Compressed files have a reduced file size, which can optimize the cost of data storage.
        prefix:
          allOf:
          - $ref: '#/components/schemas/Prefix'
          - description: <p>(Optional) Enter an S3 bucket prefix. The prefix is the string of characters after the bucket name and before the object name. You can use the prefix to organize data stored in Amazon S3 buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html">Organizing objects using prefixes</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <p>By default, Amazon Web Services IoT FleetWise sets the prefix <code>processed-data/year=YY/month=MM/date=DD/hour=HH/</code> (in UTC) to data it delivers to Amazon S3. You can enter a prefix to append it to this default prefix. For example, if you enter the prefix <code>vehicles</code>, the prefix will be <code>vehicles/processed-data/year=YY/month=MM/date=DD/hour=HH/</code>.</p>
      description: The Amazon S3 bucket where the Amazon Web Services IoT FleetWise campaign sends data. Amazon S3 is an object storage service that stores data as objects within buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html">Creating, configuring, and working with Amazon S3 buckets</a> in the <i>Amazon Simple Storage Service User Guide</i>.
    S3BucketArn:
      type: string
      pattern: arn:(aws[a-zA-Z0-9-]*):s3:::.+
      minLength: 16
      maxLength: 100
    NodePath:
      type: string
      pattern: '[a-zA-Z0-9_.]+'
      minLength: 1
      maxLength: 150
    TimestreamTableArn:
      type: string
      pattern: arn:(aws[a-zA-Z0-9-]*):timestream:[a-zA-Z0-9-]+:[0-9]{12}:database/[a-zA-Z0-9_.-]+/table/[a-zA-Z0-9_.-]+
      minLength: 20
      maxLength: 2048
    SignalInformationList:
      type: array
      items:
        $ref: '#/components/schemas/SignalInformation'
      minItems: 0
      maxItems: 1000
    campaignName:
      type: string
      pattern: '[a-zA-Z\d\-_:]+'
      minLength: 1
      maxLength: 100
    DiagnosticsMode:
      type: string
      enum:
      - 'OFF'
      - SEND_ACTIVE_DTCS
    description:
      type: string
      pattern: '[^\u0000-\u001F\u007F]+'
      minLength: 1
      maxLength: 2048
    IAMRoleArn:
      type: string
      pattern: arn:(aws[a-zA-Z0-9-]*):iam::(\d{12})?:(role((\u002F)|(\u002F[\u0021-\u007F]+\u002F))[\w+=,.@-]+)
      minLength: 20
      maxLength: 2048
    ResourceNotFoundException: {}
    SpoolingMode:
      type: string
      enum:
      - 'OFF'
      - TO_DISK
    AccessDeniedException: {}
    wildcardSignalName:
      type: string
      pattern: '[\w|*|-]+(\.[\w|*|-]+)*'
      minLength: 1
      maxLength: 150
    DataDestinationConfig:
      type: object
      properties:
        s3Config:
          allOf:
          - $ref: '#/components/schemas/S3Config'
          - description: The Amazon S3 bucket where the Amazon Web Services IoT FleetWise campaign sends data.
        timestreamConfig:
          allOf:
          - $ref: '#/components/schemas/TimestreamConfig'
          - description: The Amazon Timestream table where the campaign sends data.
      description: The destination where the Amazon Web Services IoT FleetWise campaign sends data. You can send data to be stored in Amazon S3 or Amazon Timestream.
    CampaignStatus:
      type: string
      enum:
      - CREATING
      - WAITING_FOR_APPROVAL
      - RUNNING
      - SUSPENDED
    ConditionBasedCollectionScheme:
      type: object
      required:
      - expression
      properties:
        expression:
          allOf:
          - $ref: '#/components/schemas/eventExpression'
          - description: The logical expression used to recognize what data to collect. For example, <code>$variable.Vehicle.OutsideAirTemperature &gt;= 105.0</code>.
        minimumTriggerIntervalMs:
          allOf:
          - $ref: '#/components/schemas/uint32'
          - description: <p>The minimum duration of time between two triggering events to collect data, in milliseconds.</p> <note> <p>If a signal changes often, you might want to collect data at a slower rate.</p> </note>
        triggerMode:
          allOf:
          - $ref: '#/components/schemas/TriggerMode'
          - description: Whether to collect data for all triggering events (<code>ALWAYS</code>). Specify (<code>RISING_EDGE</code>), or specify only when the condition first evaluates to false. For example, triggering on "AirbagDeployed"; Users aren't interested on triggering when the airbag is already exploded; they only care about the change from not deployed =&gt; deployed.
        conditionLanguageVersion:
          allOf:
          - $ref: '#/components/schemas/languageVersion'
          - description: Specifies the version of the conditional expression language.
      description: Information about a collection scheme that uses a simple logical expression to recognize what data to collect.
    ValidationException: {}
    TriggerMode:
      type: string
      enum:
      - ALWAYS
      - RISING_EDGE
    DataFormat:
      type: string
      enum:
      - JSON
      - PARQUET
    Prefix:
      type: string
      pattern: '[a-zA-Z0-9-_:./!*''()]+'
      minLength: 1
      maxLength: 512
    SignalInformation:
      type: object
      required:
      - name
      properties:
        name:
          allOf:
          - $ref: '#/components/schemas/wildcardSignalName'
          - description: The name of the signal.
        maxSampleCount:
          allOf:
          - $ref: '#/components/schemas/maxSampleCount'
          - description: The maximum number of samples to collect.
        minimumSamplingIntervalMs:
          allOf:
          - $ref: '#/components/schemas/uint32'
          - description: <p>The minimum duration of time (in milliseconds) between two triggering events to collect data.</p> <note> <p>If a signal changes often, you might want to collect data at a slower rate.</p> </note>
      description: Information about a signal.
    TimeBasedCollectionScheme:
      type: object
      required:
      - periodMs
      properties:
        periodMs:
          allOf:
          - $ref: '#/components/schemas/collectionPeriodMs'
          - description: The time period (in milliseconds) to decide how often to collect data. For example, if the time period is <code>60000</code>, the Edge Agent software collects data once every minute.
      description: Information about a collection scheme that uses a time period to decide how often to collect data.
    GetCampaignResponse:
      type: object
      properties:
        name:
          allOf:
          - $ref: '#/components/schemas/campaignName'
          - description: The name of the campaign.
        arn:
          allOf:
          - $ref: '#/components/schemas/arn'
          - description: ' The Amazon Resource Name (ARN) of the campaign. '
        description:
          allOf:
          - $ref: '#/components/schemas/description'
          - description: The description of the campaign.
        signalCatalogArn:
          allOf:
          - $ref: '#/components/schemas/arn'
          - description: ' The ARN of a signal catalog. '
        targetArn:
          allOf:
          - $ref: '#/components/schemas/arn'
          - description: ' The ARN of the vehicle or the fleet targeted by the campaign. '
        status:
          allOf:
          - $ref: '#/components/schemas/CampaignStatus'
          - description: 'The state of the campaign. The status can be one of: <code>CREATING</code>, <code>WAITING_FOR_APPROVAL</code>, <code>RUNNING</code>, and <code>SUSPENDED</code>. '
        startTime:
          allOf:
          - $ref: '#/components/schemas/timestamp'
          - description: ' The time, in milliseconds, to deliver a campaign after it was approved.'
        expiryTime:
          allOf:
          - $ref: '#/components/schemas/timestamp'
          - description: ' The time the campaign expires, in seconds since epoch (January 1, 1970 at midnight UTC time). Vehicle data won''t be collected after the campaign expires.'
        postTriggerCollectionDuration:
          allOf:
          - $ref: '#/components/schemas/uint32'
          - description: ' How long (in seconds) to collect raw data after a triggering event initiates the collection. '
        diagnosticsMode:
          allOf:
          - $ref: '#/components/schemas/DiagnosticsMode'
          - description: ' Option for a vehicle to send diagnostic trouble codes to Amazon Web Services IoT FleetWise. '
        spoolingMode:
          allOf:
          - $ref: '#/components/schemas/SpoolingMode'
          - description: ' Whether to store collected data after a vehicle lost a connection with the cloud. After a connection is re-established, the data is automatically forwarded to Amazon Web Services IoT FleetWise. '
        compression:
          allOf:
          - $ref: '#/components/schemas/Compression'
          - description: ' Whether to compress signals before transmitting data to Amazon Web Services IoT FleetWise. If <code>OFF</code> is specified, the signals aren''t compressed. If it''s not specified, <code>SNAPPY</code> is used. '
        priority:
          allOf:
          - $ref: '#/components/schemas/priority'
          - description: ' A number indicating the priority of one campaign over another campaign for a certain vehicle or fleet. A campaign with the lowest value is deployed to vehicles before any other campaigns.'
        signalsToCollect:
          allOf:
          - $ref: '#/components/schemas/SignalInformationList'
          - description: ' Information about a list of signals to collect data on. '
        collectionScheme:
          allOf:
          - $ref: '#/components/schemas/CollectionScheme'
          - description: ' Information about the data collection scheme associated with the campaign. '
        dataExtraDimensions:
          allOf:
          - $ref: '#/components/schemas/DataExtraDimensionNodePathList'
          - description: ' A list of vehicle attributes associated with the campaign. '
        creationTime:
          allOf:
          - $ref: '#/components/schemas/timestamp'
          - description: ' The time the campaign was created in seconds since epoch (January 1, 1970 at midnight UTC time). '
        lastModificationTime:
          allOf:
          - $ref: '#/components/schemas/timestamp'
          - description: The last time the campaign was modified.
        dataDestinationConfigs:
          allOf:
          - $ref: '#/components/schemas/DataDestinationConfigs'
          - description: <p>The destination where the campaign sends data. You can choose to send data to be stored in Amazon S3 or Amazon Timestream.</p> <p>Amazon S3 optimizes the cost of data storage and provides additional mechanisms to use vehicle data, such as data lakes, centralized data storage, data processing pipelines, and analytics. </p> <p>You can use Amazon Timestream to access and analyze time series data, and Timestream to query vehicle data so that you can identify trends and patterns.</p>
    maxSampleCount:
      type: integer
      minimum: 1
      maximum: 4294967295
  securitySchemes:
    hmac:
      type: apiKey
      name: Authorization
      in: header
      description: Amazon Signature authorization v4
      x-amazon-apigateway-authtype: awsSigv4
externalDocs:
  description: Amazon Web Services documentation
  url: https://docs.aws.amazon.com/iotfleetwise/
x-hasEquivalentPaths: true