ManagedintegrationsforIoTDeviceManagement / Client / create_destination

create_destination#

ManagedintegrationsforIoTDeviceManagement.Client.create_destination(**kwargs)#

Create a destination. IoT managed integrations uses the destination to determine where to deliver notifications for a device.

See also: AWS API Documentation

Request Syntax

response = client.create_destination(
    DeliveryDestinationArn='string',
    DeliveryDestinationType='KINESIS',
    Name='string',
    RoleArn='string',
    ClientToken='string',
    Description='string',
    Tags={
        'string': 'string'
    }
)
Parameters:
  • DeliveryDestinationArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the customer-managed destination.

  • DeliveryDestinationType (string) –

    [REQUIRED]

    The destination type for the customer-managed destination.

  • Name (string) –

    [REQUIRED]

    The name of the customer-managed destination.

  • RoleArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the delivery destination role.

  • ClientToken (string) –

    An idempotency token. If you retry a request that completed successfully initially using the same client token and parameters, then the retry attempt will succeed without performing any further actions.

    This field is autopopulated if not provided.

  • Description (string) – The description of the customer-managed destination.

  • Tags (dict) –

    A set of key/value pairs that are used to manage the destination.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Name': 'string'
}

Response Structure

  • (dict) –

    • Name (string) –

      The name of the customer-managed destination.

Exceptions

  • ManagedintegrationsforIoTDeviceManagement.Client.exceptions.AccessDeniedException

  • ManagedintegrationsforIoTDeviceManagement.Client.exceptions.ValidationException

  • ManagedintegrationsforIoTDeviceManagement.Client.exceptions.InternalServerException

  • ManagedintegrationsforIoTDeviceManagement.Client.exceptions.ConflictException

  • ManagedintegrationsforIoTDeviceManagement.Client.exceptions.ThrottlingException