Menu
AWS Greengrass
API Reference

CreateDeviceDefinitionVersion

Creates a version of a device definition that has already been defined.

URI: /greengrass/definition/devices/DeviceDefinitionId/versions

Operation: POST

Produces: application/json

Parameters:

  • DeviceDefinitionId

    The device definition Id.

    where used: path

    required: true

    type: string

  • CreateDeviceDefinitionVersionRequestBody

    where used: body

    required: true

    schema:

    DeviceDefinitionVersion

    type: object

    Information about a device definition version.

    properties:

    • Devices

      Devices in the definition version.

      type: array

      items:
      Device

      type: object

      Information about a Device.

      required: Id|ThingArn|CertificateArn

      properties:

      • Id:

        Element Id for this entry in the list.

        type: string

      • ThingArn:

        Thing ARN of the device.

        type: string

      • CertificateArn:

        Certificate ARN of the device.

        type: string

      • SyncShadow:

        If true, the local shadow value automatically syncs with the cloud's shadow state.

        type: boolean

    Example:

    Copy
    { "Devices": [ { "Id": "string", "ThingArn": "string", "CertificateArn": "string", "SyncShadow": true } ] }
  • X-Amzn-Client-Token

    The client token used to request idempotent operations.

    where used: header

    required: false

    type: string

Responses: