RTBFabric / Client / create_link

create_link

RTBFabric.Client.create_link(**kwargs)

Creates a new link between RTB applications.

Establishes a connection that allows RTB applications to communicate and exchange bid requests and responses.

See also: AWS API Documentation

Request Syntax

response = client.create_link(
    gatewayId='string',
    peerGatewayId='string',
    attributes={
        'responderErrorMasking': [
            {
                'httpCode': 'string',
                'action': 'NO_BID'|'PASSTHROUGH',
                'loggingTypes': [
                    'NONE'|'METRIC'|'RESPONSE',
                ],
                'responseLoggingPercentage': ...
            },
        ],
        'customerProvidedId': 'string'
    },
    httpResponderAllowed=True|False,
    tags={
        'string': 'string'
    },
    logSettings={
        'applicationLogs': {
            'sampling': {
                'errorLog': 123.0,
                'filterLog': 123.0
            }
        }
    }
)

Parameters:

• gatewayId (string) –

  [REQUIRED]

  The unique identifier of the gateway.

• peerGatewayId (string) –

  [REQUIRED]

  The unique identifier of the peer gateway.

• attributes (dict) –

  Attributes of the link.

  • responderErrorMasking (list) –

    Describes the masking for HTTP error codes.

    • (dict) –

      Describes the masking for HTTP error codes.

      • httpCode (string) – [REQUIRED]

        The HTTP error code.

      • action (string) – [REQUIRED]

        The action for the error..

      • loggingTypes (list) – [REQUIRED]

        The error log type.

        • (string) –

      • responseLoggingPercentage (float) –

        The percentage of response logging.

  • customerProvidedId (string) –

    The customer-provided unique identifier of the link.

• httpResponderAllowed (boolean) – Boolean to specify if an HTTP responder is allowed.

• tags (dict) –

  A map of the key-value pairs of the tag or tags to assign to the resource.

  • (string) –

    • (string) –

• logSettings (dict) –

  [REQUIRED]

  Settings for the application logs.

  • applicationLogs (dict) – [REQUIRED]

    Describes the configuration of a link application log.

    • sampling (dict) – [REQUIRED]

      Describes a link application log sample.

      • errorLog (float) – [REQUIRED]

        An error log entry.

      • filterLog (float) – [REQUIRED]

        A filter log entry.

Return type:

dict

Returns:

Response Syntax

{
    'gatewayId': 'string',
    'peerGatewayId': 'string',
    'status': 'PENDING_CREATION'|'PENDING_REQUEST'|'REQUESTED'|'ACCEPTED'|'ACTIVE'|'REJECTED'|'FAILED'|'PENDING_DELETION'|'DELETED'|'PENDING_UPDATE'|'PENDING_ISOLATION'|'ISOLATED'|'PENDING_RESTORATION',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1),
    'direction': 'RESPONSE'|'REQUEST',
    'flowModules': [
        {
            'version': 'string',
            'name': 'string',
            'dependsOn': [
                'string',
            ],
            'moduleParameters': {
                'noBid': {
                    'reason': 'string',
                    'reasonCode': 123,
                    'passThroughPercentage': ...
                },
                'openRtbAttribute': {
                    'filterType': 'INCLUDE'|'EXCLUDE',
                    'filterConfiguration': [
                        {
                            'criteria': [
                                {
                                    'path': 'string',
                                    'values': [
                                        'string',
                                    ]
                                },
                            ]
                        },
                    ],
                    'action': {
                        'noBid': {
                            'noBidReasonCode': 123
                        },
                        'headerTag': {
                            'name': 'string',
                            'value': 'string'
                        }
                    },
                    'holdbackPercentage': ...
                }
            }
        },
    ],
    'pendingFlowModules': [
        {
            'version': 'string',
            'name': 'string',
            'dependsOn': [
                'string',
            ],
            'moduleParameters': {
                'noBid': {
                    'reason': 'string',
                    'reasonCode': 123,
                    'passThroughPercentage': ...
                },
                'openRtbAttribute': {
                    'filterType': 'INCLUDE'|'EXCLUDE',
                    'filterConfiguration': [
                        {
                            'criteria': [
                                {
                                    'path': 'string',
                                    'values': [
                                        'string',
                                    ]
                                },
                            ]
                        },
                    ],
                    'action': {
                        'noBid': {
                            'noBidReasonCode': 123
                        },
                        'headerTag': {
                            'name': 'string',
                            'value': 'string'
                        }
                    },
                    'holdbackPercentage': ...
                }
            }
        },
    ],
    'attributes': {
        'responderErrorMasking': [
            {
                'httpCode': 'string',
                'action': 'NO_BID'|'PASSTHROUGH',
                'loggingTypes': [
                    'NONE'|'METRIC'|'RESPONSE',
                ],
                'responseLoggingPercentage': ...
            },
        ],
        'customerProvidedId': 'string'
    },
    'linkId': 'string',
    'customerProvidedId': 'string'
}

Response Structure

• (dict) –

  • gatewayId (string) –

    The unique identifier of the gateway.

  • peerGatewayId (string) –

    The unique identifier of the peer gateway.

  • status (string) –

    The status of the request.

  • createdAt (datetime) –

    The timestamp of when the link was created.

  • updatedAt (datetime) –

    The timestamp of when the link was updated.

  • direction (string) –

    The direction of the link.

  • flowModules (list) –

    The configuration of flow modules.

    • (dict) –

      Describes the configuration of a module.

      • version (string) –

        The version of the module.

      • name (string) –

        The name of the module.

      • dependsOn (list) –

        The dependencies of the module.

        • (string) –

      • moduleParameters (dict) –

        Describes the parameters of a module.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: noBid, openRtbAttribute. 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'}
        

        • noBid (dict) –

          Describes the parameters of a no bid module.

          • reason (string) –

            The reason description.

          • reasonCode (integer) –

            The reason code.

          • passThroughPercentage (float) –

            The pass through percentage.

        • openRtbAttribute (dict) –

          Describes the parameters of an open RTB attribute module.

          • filterType (string) –

            The filter type.

          • filterConfiguration (list) –

            Describes the configuration of a filter.

            • (dict) –

              Describes the configuration of a filter.

              • criteria (list) –

                Describes the criteria for a filter.

                • (dict) –

                  Describes the criteria for a filter.

                  • path (string) –

                    The path to filter.

                  • values (list) –

                    The value to filter.

                    • (string) –

          • action (dict) –

            Describes a bid action.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: noBid, headerTag. 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'}
            

            • noBid (dict) –

              Describes a no bid action.

              • noBidReasonCode (integer) –

                The reason code for the no bid action.

            • headerTag (dict) –

              Describes the header tag for a bid action.

              • name (string) –

                The name of the bid action.

              • value (string) –

                The value of the bid action.

          • holdbackPercentage (float) –

            The hold back percentage.

  • pendingFlowModules (list) –

    The configuration of pending flow modules.

    • (dict) –

      Describes the configuration of a module.

      • version (string) –

        The version of the module.

      • name (string) –

        The name of the module.

      • dependsOn (list) –

        The dependencies of the module.

        • (string) –

      • moduleParameters (dict) –

        Describes the parameters of a module.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: noBid, openRtbAttribute. 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'}
        

        • noBid (dict) –

          Describes the parameters of a no bid module.

          • reason (string) –

            The reason description.

          • reasonCode (integer) –

            The reason code.

          • passThroughPercentage (float) –

            The pass through percentage.

        • openRtbAttribute (dict) –

          Describes the parameters of an open RTB attribute module.

          • filterType (string) –

            The filter type.

          • filterConfiguration (list) –

            Describes the configuration of a filter.

            • (dict) –

              Describes the configuration of a filter.

              • criteria (list) –

                Describes the criteria for a filter.

                • (dict) –

                  Describes the criteria for a filter.

                  • path (string) –

                    The path to filter.

                  • values (list) –

                    The value to filter.

                    • (string) –

          • action (dict) –

            Describes a bid action.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: noBid, headerTag. 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'}
            

            • noBid (dict) –

              Describes a no bid action.

              • noBidReasonCode (integer) –

                The reason code for the no bid action.

            • headerTag (dict) –

              Describes the header tag for a bid action.

              • name (string) –

                The name of the bid action.

              • value (string) –

                The value of the bid action.

          • holdbackPercentage (float) –

            The hold back percentage.

  • attributes (dict) –

    Attributes of the link.

    • responderErrorMasking (list) –

      Describes the masking for HTTP error codes.

      • (dict) –

        Describes the masking for HTTP error codes.

        • httpCode (string) –

          The HTTP error code.

        • action (string) –

          The action for the error..

        • loggingTypes (list) –

          The error log type.

          • (string) –

        • responseLoggingPercentage (float) –

          The percentage of response logging.

    • customerProvidedId (string) –

      The customer-provided unique identifier of the link.

  • linkId (string) –

    The unique identifier of the link.

  • customerProvidedId (string) –

    The customer-provided unique identifier of the link.

Exceptions

• RTBFabric.Client.exceptions.ServiceQuotaExceededException

• RTBFabric.Client.exceptions.ResourceNotFoundException

• RTBFabric.Client.exceptions.ThrottlingException

• RTBFabric.Client.exceptions.AccessDeniedException

• RTBFabric.Client.exceptions.ConflictException

• RTBFabric.Client.exceptions.InternalServerException

• RTBFabric.Client.exceptions.ValidationException