ConnectCampaignService

Client

class ConnectCampaignService.Client

A low-level client representing AmazonConnectCampaignService

Provide APIs to create and manage Amazon Connect Campaigns.

client = session.create_client('connectcampaigns')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters:

operation_name (string) – The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you’d normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").

Returns:

True if the operation can be paginated, False otherwise.

close()

Closes underlying endpoint connections.

create_campaign(**kwargs)

Creates a campaign for the specified Amazon Connect account. This API is idempotent.

See also: AWS API Documentation

Request Syntax

response = client.create_campaign(
    connectInstanceId='string',
    dialerConfig={
        'predictiveDialerConfig': {
            'bandwidthAllocation': 123.0
        },
        'progressiveDialerConfig': {
            'bandwidthAllocation': 123.0
        }
    },
    name='string',
    outboundCallConfig={
        'answerMachineDetectionConfig': {
            'enableAnswerMachineDetection': True|False
        },
        'connectContactFlowId': 'string',
        'connectQueueId': 'string',
        'connectSourcePhoneNumber': 'string'
    },
    tags={
        'string': 'string'
    }
)
Parameters:
  • connectInstanceId (string) –

    [REQUIRED]

    Amazon Connect Instance Id

  • dialerConfig (dict) –

    [REQUIRED]

    The possible types of dialer config parameters

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: predictiveDialerConfig, progressiveDialerConfig.

    • predictiveDialerConfig (dict) –

      Predictive Dialer config

      • bandwidthAllocation (float) – [REQUIRED]

        The bandwidth allocation of a queue resource.

    • progressiveDialerConfig (dict) –

      Progressive Dialer config

      • bandwidthAllocation (float) – [REQUIRED]

        The bandwidth allocation of a queue resource.

  • name (string) –

    [REQUIRED]

    The name of an Amazon Connect Campaign name.

  • outboundCallConfig (dict) –

    [REQUIRED]

    The configuration used for outbound calls.

    • answerMachineDetectionConfig (dict) –

      Answering Machine Detection config

      • enableAnswerMachineDetection (boolean) – [REQUIRED]

        Enable or disable answering machine detection

    • connectContactFlowId (string) – [REQUIRED]

      The identifier of the contact flow for the outbound call.

    • connectQueueId (string) – [REQUIRED]

      The queue for the call. If you specify a queue, the phone displayed for caller ID is the phone number specified in the queue. If you do not specify a queue, the queue defined in the contact flow is used. If you do not specify a queue, you must specify a source phone number.

    • connectSourcePhoneNumber (string) –

      The phone number associated with the Amazon Connect instance, in E.164 format. If you do not specify a source phone number, you must specify a queue.

  • tags (dict) –

    Tag map with key and value.

    • (string) –

      Tag key.

      • (string) –

        Tag value.

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'id': 'string',
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) –

    The response for Create Campaign API

    • arn (string) –

      The resource name of an Amazon Connect campaign.

    • id (string) –

      Identifier representing a Campaign

    • tags (dict) –

      Tag map with key and value.

      • (string) –

        Tag key.

        • (string) –

          Tag value.

Exceptions

delete_campaign(**kwargs)

Deletes a campaign from the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.delete_campaign(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Returns:

None

Exceptions

delete_connect_instance_config(**kwargs)

Deletes a connect instance config from the specified AWS account.

See also: AWS API Documentation

Request Syntax

response = client.delete_connect_instance_config(
    connectInstanceId='string'
)
Parameters:

connectInstanceId (string) –

[REQUIRED]

Amazon Connect Instance Id

Returns:

None

Exceptions

delete_instance_onboarding_job(**kwargs)

Delete the Connect Campaigns onboarding job for the specified Amazon Connect instance.

See also: AWS API Documentation

Request Syntax

response = client.delete_instance_onboarding_job(
    connectInstanceId='string'
)
Parameters:

connectInstanceId (string) –

[REQUIRED]

Amazon Connect Instance Id

Returns:

None

Exceptions

describe_campaign(**kwargs)

Describes the specific campaign.

See also: AWS API Documentation

Request Syntax

response = client.describe_campaign(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Return type:

dict

Returns:

Response Syntax

{
    'campaign': {
        'arn': 'string',
        'connectInstanceId': 'string',
        'dialerConfig': {
            'predictiveDialerConfig': {
                'bandwidthAllocation': 123.0
            },
            'progressiveDialerConfig': {
                'bandwidthAllocation': 123.0
            }
        },
        'id': 'string',
        'name': 'string',
        'outboundCallConfig': {
            'answerMachineDetectionConfig': {
                'enableAnswerMachineDetection': True|False
            },
            'connectContactFlowId': 'string',
            'connectQueueId': 'string',
            'connectSourcePhoneNumber': 'string'
        },
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) –

    DescribeCampaignResponse

    • campaign (dict) –

      An Amazon Connect campaign.

      • arn (string) –

        The resource name of an Amazon Connect campaign.

      • connectInstanceId (string) –

        Amazon Connect Instance Id

      • dialerConfig (dict) –

        The possible types of dialer config parameters

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: predictiveDialerConfig, progressiveDialerConfig. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        
        • predictiveDialerConfig (dict) –

          Predictive Dialer config

          • bandwidthAllocation (float) –

            The bandwidth allocation of a queue resource.

        • progressiveDialerConfig (dict) –

          Progressive Dialer config

          • bandwidthAllocation (float) –

            The bandwidth allocation of a queue resource.

      • id (string) –

        Identifier representing a Campaign

      • name (string) –

        The name of an Amazon Connect Campaign name.

      • outboundCallConfig (dict) –

        The configuration used for outbound calls.

        • answerMachineDetectionConfig (dict) –

          Answering Machine Detection config

          • enableAnswerMachineDetection (boolean) –

            Enable or disable answering machine detection

        • connectContactFlowId (string) –

          The identifier of the contact flow for the outbound call.

        • connectQueueId (string) –

          The queue for the call. If you specify a queue, the phone displayed for caller ID is the phone number specified in the queue. If you do not specify a queue, the queue defined in the contact flow is used. If you do not specify a queue, you must specify a source phone number.

        • connectSourcePhoneNumber (string) –

          The phone number associated with the Amazon Connect instance, in E.164 format. If you do not specify a source phone number, you must specify a queue.

      • tags (dict) –

        Tag map with key and value.

        • (string) –

          Tag key.

          • (string) –

            Tag value.

Exceptions

get_campaign_state(**kwargs)

Get state of a campaign for the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.get_campaign_state(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Return type:

dict

Returns:

Response Syntax

{
    'state': 'Initialized'|'Running'|'Paused'|'Stopped'|'Failed'
}

Response Structure

  • (dict) –

    GetCampaignStateResponse

    • state (string) –

      State of a campaign

Exceptions

get_campaign_state_batch(**kwargs)

Get state of campaigns for the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.get_campaign_state_batch(
    campaignIds=[
        'string',
    ]
)
Parameters:

campaignIds (list) –

[REQUIRED]

List of CampaignId

  • (string) –

    Identifier representing a Campaign

Return type:

dict

Returns:

Response Syntax

{
    'failedRequests': [
        {
            'campaignId': 'string',
            'failureCode': 'ResourceNotFound'|'UnknownError'
        },
    ],
    'successfulRequests': [
        {
            'campaignId': 'string',
            'state': 'Initialized'|'Running'|'Paused'|'Stopped'|'Failed'
        },
    ]
}

Response Structure

  • (dict) –

    GetCampaignStateBatchResponse

    • failedRequests (list) –

      List of failed requests of campaign state

      • (dict) –

        Failed response of campaign state

        • campaignId (string) –

          Identifier representing a Campaign

        • failureCode (string) –

          A predefined code indicating the error that caused the failure in getting state of campaigns

    • successfulRequests (list) –

      List of successful response of campaign state

      • (dict) –

        Successful response of campaign state

        • campaignId (string) –

          Identifier representing a Campaign

        • state (string) –

          State of a campaign

Exceptions

get_connect_instance_config(**kwargs)

Get the specific Connect instance config.

See also: AWS API Documentation

Request Syntax

response = client.get_connect_instance_config(
    connectInstanceId='string'
)
Parameters:

connectInstanceId (string) –

[REQUIRED]

Amazon Connect Instance Id

Return type:

dict

Returns:

Response Syntax

{
    'connectInstanceConfig': {
        'connectInstanceId': 'string',
        'encryptionConfig': {
            'enabled': True|False,
            'encryptionType': 'KMS',
            'keyArn': 'string'
        },
        'serviceLinkedRoleArn': 'string'
    }
}

Response Structure

  • (dict) –

    GetConnectInstanceConfigResponse

    • connectInstanceConfig (dict) –

      Instance config object

      • connectInstanceId (string) –

        Amazon Connect Instance Id

      • encryptionConfig (dict) –

        Encryption config for Connect Instance. Note that sensitive data will always be encrypted. If disabled, service will perform encryption with its own key. If enabled, a KMS key id needs to be provided and KMS charges will apply. KMS is only type supported

        • enabled (boolean) –

          Boolean to indicate if custom encryption has been enabled.

        • encryptionType (string) –

          Server-side encryption type.

        • keyArn (string) –

          KMS key id/arn for encryption config.

      • serviceLinkedRoleArn (string) –

        Service linked role arn

Exceptions

get_instance_onboarding_job_status(**kwargs)

Get the specific instance onboarding job status.

See also: AWS API Documentation

Request Syntax

response = client.get_instance_onboarding_job_status(
    connectInstanceId='string'
)
Parameters:

connectInstanceId (string) –

[REQUIRED]

Amazon Connect Instance Id

Return type:

dict

Returns:

Response Syntax

{
    'connectInstanceOnboardingJobStatus': {
        'connectInstanceId': 'string',
        'failureCode': 'EVENT_BRIDGE_ACCESS_DENIED'|'EVENT_BRIDGE_MANAGED_RULE_LIMIT_EXCEEDED'|'IAM_ACCESS_DENIED'|'KMS_ACCESS_DENIED'|'KMS_KEY_NOT_FOUND'|'INTERNAL_FAILURE',
        'status': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED'
    }
}

Response Structure

  • (dict) –

    GetInstanceOnboardingJobStatusResponse

    • connectInstanceOnboardingJobStatus (dict) –

      Instance onboarding job status object

      • connectInstanceId (string) –

        Amazon Connect Instance Id

      • failureCode (string) –

        Enumeration of the possible failure codes for instance onboarding job

      • status (string) –

        Enumeration of the possible states for instance onboarding job

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters:

operation_name (string) – The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you’d normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").

Raises:

OperationNotPageableError – Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.

Return type:

L{botocore.paginate.Paginator}

Returns:

A paginator object.

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters:

waiter_name (str) – The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.

Returns:

The specified waiter object.

Return type:

botocore.waiter.Waiter

list_campaigns(**kwargs)

Provides summary information about the campaigns under the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.list_campaigns(
    filters={
        'instanceIdFilter': {
            'operator': 'Eq',
            'value': 'string'
        }
    },
    maxResults=123,
    nextToken='string'
)
Parameters:
  • filters (dict) –

    Filter model by type

    • instanceIdFilter (dict) –

      Connect instance identifier filter

      • operator (string) – [REQUIRED]

        Operators for Connect instance identifier filter

      • value (string) – [REQUIRED]

        Amazon Connect Instance Id

  • maxResults (integer) – The maximum number of results to return per page.

  • nextToken (string) – The token for the next set of results.

Return type:

dict

Returns:

Response Syntax

{
    'campaignSummaryList': [
        {
            'arn': 'string',
            'connectInstanceId': 'string',
            'id': 'string',
            'name': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    ListCampaignsResponse

    • campaignSummaryList (list) –

      A list of Amazon Connect campaigns.

      • (dict) –

        An Amazon Connect campaign summary.

        • arn (string) –

          The resource name of an Amazon Connect campaign.

        • connectInstanceId (string) –

          Amazon Connect Instance Id

        • id (string) –

          Identifier representing a Campaign

        • name (string) –

          The name of an Amazon Connect Campaign name.

    • nextToken (string) –

      The token for the next set of results.

Exceptions

list_tags_for_resource(**kwargs)

List tags for a resource.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    arn='string'
)
Parameters:

arn (string) –

[REQUIRED]

Arn

Return type:

dict

Returns:

Response Syntax

{
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) –

    ListTagsForResponse

    • tags (dict) –

      Tag map with key and value.

      • (string) –

        Tag key.

        • (string) –

          Tag value.

Exceptions

pause_campaign(**kwargs)

Pauses a campaign for the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.pause_campaign(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Returns:

None

Exceptions

put_dial_request_batch(**kwargs)

Creates dials requests for the specified campaign Amazon Connect account. This API is idempotent.

See also: AWS API Documentation

Request Syntax

response = client.put_dial_request_batch(
    dialRequests=[
        {
            'attributes': {
                'string': 'string'
            },
            'clientToken': 'string',
            'expirationTime': datetime(2015, 1, 1),
            'phoneNumber': 'string'
        },
    ],
    id='string'
)
Parameters:
  • dialRequests (list) –

    [REQUIRED]

    A list of dial requests.

    • (dict) –

      A dial request for a campaign.

      • attributes (dict) – [REQUIRED]

        A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in contact flows just like any other contact attributes.

        • (string) –

          The key of the attribute. Attribute keys can include only alphanumeric, dash, and underscore characters.

          • (string) –

            The value of the attribute.

      • clientToken (string) – [REQUIRED]

        Client provided parameter used for idempotency. Its value must be unique for each request.

      • expirationTime (datetime) – [REQUIRED]

        Timestamp with no UTC offset or timezone

      • phoneNumber (string) – [REQUIRED]

        The phone number of the customer, in E.164 format.

  • id (string) –

    [REQUIRED]

    Identifier representing a Campaign

Return type:

dict

Returns:

Response Syntax

{
    'failedRequests': [
        {
            'clientToken': 'string',
            'failureCode': 'InvalidInput'|'RequestThrottled'|'UnknownError',
            'id': 'string'
        },
    ],
    'successfulRequests': [
        {
            'clientToken': 'string',
            'id': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    PutDialRequestBatchResponse

    • failedRequests (list) –

      A list of failed requests.

      • (dict) –

        A failed request identified by the unique client token.

        • clientToken (string) –

          Client provided parameter used for idempotency. Its value must be unique for each request.

        • failureCode (string) –

          A predefined code indicating the error that caused the failure.

        • id (string) –

          Identifier representing a Dial request

    • successfulRequests (list) –

      A list of successful requests identified by the unique client token.

      • (dict) –

        A successful request identified by the unique client token.

        • clientToken (string) –

          Client provided parameter used for idempotency. Its value must be unique for each request.

        • id (string) –

          Identifier representing a Dial request

Exceptions

resume_campaign(**kwargs)

Stops a campaign for the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.resume_campaign(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Returns:

None

Exceptions

start_campaign(**kwargs)

Starts a campaign for the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.start_campaign(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Returns:

None

Exceptions

start_instance_onboarding_job(**kwargs)

Onboard the specific Amazon Connect instance to Connect Campaigns.

See also: AWS API Documentation

Request Syntax

response = client.start_instance_onboarding_job(
    connectInstanceId='string',
    encryptionConfig={
        'enabled': True|False,
        'encryptionType': 'KMS',
        'keyArn': 'string'
    }
)
Parameters:
  • connectInstanceId (string) –

    [REQUIRED]

    Amazon Connect Instance Id

  • encryptionConfig (dict) –

    [REQUIRED]

    Encryption config for Connect Instance. Note that sensitive data will always be encrypted. If disabled, service will perform encryption with its own key. If enabled, a KMS key id needs to be provided and KMS charges will apply. KMS is only type supported

    • enabled (boolean) – [REQUIRED]

      Boolean to indicate if custom encryption has been enabled.

    • encryptionType (string) –

      Server-side encryption type.

    • keyArn (string) –

      KMS key id/arn for encryption config.

Return type:

dict

Returns:

Response Syntax

{
    'connectInstanceOnboardingJobStatus': {
        'connectInstanceId': 'string',
        'failureCode': 'EVENT_BRIDGE_ACCESS_DENIED'|'EVENT_BRIDGE_MANAGED_RULE_LIMIT_EXCEEDED'|'IAM_ACCESS_DENIED'|'KMS_ACCESS_DENIED'|'KMS_KEY_NOT_FOUND'|'INTERNAL_FAILURE',
        'status': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED'
    }
}

Response Structure

  • (dict) –

    The response for StartInstanceOnboardingJob API.

    • connectInstanceOnboardingJobStatus (dict) –

      Instance onboarding job status object

      • connectInstanceId (string) –

        Amazon Connect Instance Id

      • failureCode (string) –

        Enumeration of the possible failure codes for instance onboarding job

      • status (string) –

        Enumeration of the possible states for instance onboarding job

Exceptions

stop_campaign(**kwargs)

Stops a campaign for the specified Amazon Connect account.

See also: AWS API Documentation

Request Syntax

response = client.stop_campaign(
    id='string'
)
Parameters:

id (string) –

[REQUIRED]

Identifier representing a Campaign

Returns:

None

Exceptions

tag_resource(**kwargs)

Tag a resource.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    arn='string',
    tags={
        'string': 'string'
    }
)
Parameters:
  • arn (string) –

    [REQUIRED]

    Arn

  • tags (dict) –

    [REQUIRED]

    Tag map with key and value.

    • (string) –

      Tag key.

      • (string) –

        Tag value.

Returns:

None

Exceptions

untag_resource(**kwargs)

Untag a resource.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    arn='string',
    tagKeys=[
        'string',
    ]
)
Parameters:
  • arn (string) –

    [REQUIRED]

    Arn

  • tagKeys (list) –

    [REQUIRED]

    List of tag keys.

    • (string) –

      Tag key.

Returns:

None

Exceptions

update_campaign_dialer_config(**kwargs)

Updates the dialer config of a campaign. This API is idempotent.

See also: AWS API Documentation

Request Syntax

response = client.update_campaign_dialer_config(
    dialerConfig={
        'predictiveDialerConfig': {
            'bandwidthAllocation': 123.0
        },
        'progressiveDialerConfig': {
            'bandwidthAllocation': 123.0
        }
    },
    id='string'
)
Parameters:
  • dialerConfig (dict) –

    [REQUIRED]

    The possible types of dialer config parameters

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: predictiveDialerConfig, progressiveDialerConfig.

    • predictiveDialerConfig (dict) –

      Predictive Dialer config

      • bandwidthAllocation (float) – [REQUIRED]

        The bandwidth allocation of a queue resource.

    • progressiveDialerConfig (dict) –

      Progressive Dialer config

      • bandwidthAllocation (float) – [REQUIRED]

        The bandwidth allocation of a queue resource.

  • id (string) –

    [REQUIRED]

    Identifier representing a Campaign

Returns:

None

Exceptions

update_campaign_name(**kwargs)

Updates the name of a campaign. This API is idempotent.

See also: AWS API Documentation

Request Syntax

response = client.update_campaign_name(
    id='string',
    name='string'
)
Parameters:
  • id (string) –

    [REQUIRED]

    Identifier representing a Campaign

  • name (string) –

    [REQUIRED]

    The name of an Amazon Connect Campaign name.

Returns:

None

Exceptions

update_campaign_outbound_call_config(**kwargs)

Updates the outbound call config of a campaign. This API is idempotent.

See also: AWS API Documentation

Request Syntax

response = client.update_campaign_outbound_call_config(
    answerMachineDetectionConfig={
        'enableAnswerMachineDetection': True|False
    },
    connectContactFlowId='string',
    connectSourcePhoneNumber='string',
    id='string'
)
Parameters:
  • answerMachineDetectionConfig (dict) –

    Answering Machine Detection config

    • enableAnswerMachineDetection (boolean) – [REQUIRED]

      Enable or disable answering machine detection

  • connectContactFlowId (string) – The identifier of the contact flow for the outbound call.

  • connectSourcePhoneNumber (string) – The phone number associated with the Amazon Connect instance, in E.164 format. If you do not specify a source phone number, you must specify a queue.

  • id (string) –

    [REQUIRED]

    Identifier representing a Campaign

Returns:

None

Exceptions

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

class ConnectCampaignService.Client.exceptions.AccessDeniedException

You do not have sufficient access to perform this action.

Example

try:
  ...
except client.exceptions.AccessDeniedException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    You do not have sufficient access to perform this action.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.ConflictException

The request could not be processed because of conflict in the current state of the resource.

Example

try:
  ...
except client.exceptions.ConflictException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    The request could not be processed because of conflict in the current state of the resource.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.InternalServerException

Request processing failed because of an error or failure with the service.

Example

try:
  ...
except client.exceptions.InternalServerException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    Request processing failed because of an error or failure with the service.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.InvalidCampaignStateException

The request could not be processed because of conflict in the current state of the campaign.

Example

try:
  ...
except client.exceptions.InvalidCampaignStateException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'state': 'Initialized'|'Running'|'Paused'|'Stopped'|'Failed',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    The request could not be processed because of conflict in the current state of the campaign.

    • message (string) –

    • state (string) –

      State of a campaign

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.InvalidStateException

The request could not be processed because of conflict in the current state.

Example

try:
  ...
except client.exceptions.InvalidStateException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    The request could not be processed because of conflict in the current state.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.ResourceNotFoundException

The specified resource was not found.

Example

try:
  ...
except client.exceptions.ResourceNotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    The specified resource was not found.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.ServiceQuotaExceededException

Request would cause a service quota to be exceeded.

Example

try:
  ...
except client.exceptions.ServiceQuotaExceededException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    Request would cause a service quota to be exceeded.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.ThrottlingException

The request was denied due to request throttling.

Example

try:
  ...
except client.exceptions.ThrottlingException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    The request was denied due to request throttling.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

class ConnectCampaignService.Client.exceptions.ValidationException

The input fails to satisfy the constraints specified by an AWS service.

Example

try:
  ...
except client.exceptions.ValidationException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'xAmzErrorType': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) –

    The input fails to satisfy the constraints specified by an AWS service.

    • message (string) –

    • xAmzErrorType (string) –

      A header that defines the error encountered while processing the request.

    • Error (dict) – Normalized access to common exception attributes.

      • Code (string) – An identifier specifying the exception type.

      • Message (string) – A descriptive message explaining why the exception occured.

Paginators

The available paginators are:

class ConnectCampaignService.Paginator.ListCampaigns
paginator = client.get_paginator('list_campaigns')
paginate(**kwargs)

Creates an iterator that will paginate through responses from ConnectCampaignService.Client.list_campaigns().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    filters={
        'instanceIdFilter': {
            'operator': 'Eq',
            'value': 'string'
        }
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • filters (dict) –

    Filter model by type

    • instanceIdFilter (dict) –

      Connect instance identifier filter

      • operator (string) – [REQUIRED]

        Operators for Connect instance identifier filter

      • value (string) – [REQUIRED]

        Amazon Connect Instance Id

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'campaignSummaryList': [
        {
            'arn': 'string',
            'connectInstanceId': 'string',
            'id': 'string',
            'name': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    ListCampaignsResponse

    • campaignSummaryList (list) –

      A list of Amazon Connect campaigns.

      • (dict) –

        An Amazon Connect campaign summary.

        • arn (string) –

          The resource name of an Amazon Connect campaign.

        • connectInstanceId (string) –

          Amazon Connect Instance Id

        • id (string) –

          Identifier representing a Campaign

        • name (string) –

          The name of an Amazon Connect Campaign name.

    • NextToken (string) –

      A token to resume pagination.