RTBFabric

2025/10/22 - RTBFabric - 27 new api methods

Changes  Update for general availability of AWS RTB Fabric service.

DeleteRequesterGateway (new) Link ¶

Deletes a requester gateway.

See also: AWS API Documentation

Request Syntax

client.delete_requester_gateway(
    gatewayId='string'
)
type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • status (string) --

      The status of the request.

UpdateResponderGateway (new) Link ¶

Updates a responder gateway.

See also: AWS API Documentation

Request Syntax

client.update_responder_gateway(
    domainName='string',
    port=123,
    protocol='HTTP'|'HTTPS',
    trustStoreConfiguration={
        'certificateAuthorityCertificates': [
            'string',
        ]
    },
    managedEndpointConfiguration={
        'autoScalingGroups': {
            'autoScalingGroupNames': [
                'string',
            ],
            'roleArn': 'string'
        },
        'eksEndpoints': {
            'endpointsResourceName': 'string',
            'endpointsResourceNamespace': 'string',
            'clusterApiServerEndpointUri': 'string',
            'clusterApiServerCaCertificateChain': 'string',
            'clusterName': 'string',
            'roleArn': 'string'
        }
    },
    clientToken='string',
    gatewayId='string',
    description='string'
)
type domainName:

string

param domainName:

The domain name for the responder gateway.

type port:

integer

param port:

[REQUIRED]

The networking port to use.

type protocol:

string

param protocol:

[REQUIRED]

The networking protocol to use.

type trustStoreConfiguration:

dict

param trustStoreConfiguration:

The configuration of the trust store.

  • certificateAuthorityCertificates (list) -- [REQUIRED]

    The certificate authority certificate.

    • (string) --

type managedEndpointConfiguration:

dict

param managedEndpointConfiguration:

The configuration for the managed endpoint.

  • autoScalingGroups (dict) --

    Describes the configuration of an auto scaling group.

    • autoScalingGroupNames (list) -- [REQUIRED]

      The names of the auto scaling group.

      • (string) --

    • roleArn (string) -- [REQUIRED]

      The role ARN of the auto scaling group.

  • eksEndpoints (dict) --

    Describes the configuration of an Amazon Elastic Kubernetes Service endpoint.

    • endpointsResourceName (string) -- [REQUIRED]

      The name of the endpoint resource.

    • endpointsResourceNamespace (string) -- [REQUIRED]

      The namespace of the endpoint resource.

    • clusterApiServerEndpointUri (string) -- [REQUIRED]

      The URI of the cluster API server endpoint.

    • clusterApiServerCaCertificateChain (string) -- [REQUIRED]

      The CA certificate chain of the cluster API server.

    • clusterName (string) -- [REQUIRED]

      The name of the cluster.

    • roleArn (string) -- [REQUIRED]

      The role ARN for the cluster.

type clientToken:

string

param clientToken:

[REQUIRED]

The unique client token.

This field is autopopulated if not provided.

type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

type description:

string

param description:

An optional description for the responder gateway.

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • status (string) --

      The status of the request.

UpdateLinkModuleFlow (new) Link ¶

Updates a link module flow.

See also: AWS API Documentation

Request Syntax

client.update_link_module_flow(
    clientToken='string',
    gatewayId='string',
    linkId='string',
    modules=[
        {
            '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': ...
                }
            }
        },
    ]
)
type clientToken:

string

param clientToken:

[REQUIRED]

The unique client token.

This field is autopopulated if not provided.

type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

type linkId:

string

param linkId:

[REQUIRED]

The unique identifier of the link.

type modules:

list

param modules:

[REQUIRED]

The configuration of a module.

  • (dict) --

    Describes the configuration of a module.

    • version (string) --

      The version of the module.

    • name (string) -- [REQUIRED]

      The name of the module.

    • dependsOn (list) --

      The dependencies of the module.

      • (string) --

    • moduleParameters (dict) --

      Describes the parameters of a module.

      • 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) -- [REQUIRED]

          The filter type.

        • filterConfiguration (list) -- [REQUIRED]

          Describes the configuration of a filter.

          • (dict) --

            Describes the configuration of a filter.

            • criteria (list) -- [REQUIRED]

              Describes the criteria for a filter.

              • (dict) --

                Describes the criteria for a filter.

                • path (string) -- [REQUIRED]

                  The path to filter.

                • values (list) -- [REQUIRED]

                  The value to filter.

                  • (string) --

        • action (dict) -- [REQUIRED]

          Describes a bid action.

          • 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) -- [REQUIRED]

              The name of the bid action.

            • value (string) -- [REQUIRED]

              The value of the bid action.

        • holdbackPercentage (float) -- [REQUIRED]

          The hold back percentage.

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'linkId': 'string',
    'status': 'PENDING_CREATION'|'PENDING_REQUEST'|'REQUESTED'|'ACCEPTED'|'ACTIVE'|'REJECTED'|'FAILED'|'PENDING_DELETION'|'DELETED'|'PENDING_UPDATE'|'PENDING_ISOLATION'|'ISOLATED'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • linkId (string) --

      The unique identifier of the link.

    • status (string) --

      The status of the request.

CreateResponderGateway (new) Link ¶

Creates a responder gateway.

See also: AWS API Documentation

Request Syntax

client.create_responder_gateway(
    vpcId='string',
    subnetIds=[
        'string',
    ],
    securityGroupIds=[
        'string',
    ],
    domainName='string',
    port=123,
    protocol='HTTP'|'HTTPS',
    trustStoreConfiguration={
        'certificateAuthorityCertificates': [
            'string',
        ]
    },
    managedEndpointConfiguration={
        'autoScalingGroups': {
            'autoScalingGroupNames': [
                'string',
            ],
            'roleArn': 'string'
        },
        'eksEndpoints': {
            'endpointsResourceName': 'string',
            'endpointsResourceNamespace': 'string',
            'clusterApiServerEndpointUri': 'string',
            'clusterApiServerCaCertificateChain': 'string',
            'clusterName': 'string',
            'roleArn': 'string'
        }
    },
    clientToken='string',
    description='string',
    tags={
        'string': 'string'
    }
)
type vpcId:

string

param vpcId:

[REQUIRED]

The unique identifier of the Virtual Private Cloud (VPC).

type subnetIds:

list

param subnetIds:

[REQUIRED]

The unique identifiers of the subnets.

  • (string) --

type securityGroupIds:

list

param securityGroupIds:

[REQUIRED]

The unique identifiers of the security groups.

  • (string) --

type domainName:

string

param domainName:

The domain name for the responder gateway.

type port:

integer

param port:

[REQUIRED]

The networking port to use.

type protocol:

string

param protocol:

[REQUIRED]

The networking protocol to use.

type trustStoreConfiguration:

dict

param trustStoreConfiguration:

The configuration of the trust store.

  • certificateAuthorityCertificates (list) -- [REQUIRED]

    The certificate authority certificate.

    • (string) --

type managedEndpointConfiguration:

dict

param managedEndpointConfiguration:

The configuration for the managed endpoint.

  • autoScalingGroups (dict) --

    Describes the configuration of an auto scaling group.

    • autoScalingGroupNames (list) -- [REQUIRED]

      The names of the auto scaling group.

      • (string) --

    • roleArn (string) -- [REQUIRED]

      The role ARN of the auto scaling group.

  • eksEndpoints (dict) --

    Describes the configuration of an Amazon Elastic Kubernetes Service endpoint.

    • endpointsResourceName (string) -- [REQUIRED]

      The name of the endpoint resource.

    • endpointsResourceNamespace (string) -- [REQUIRED]

      The namespace of the endpoint resource.

    • clusterApiServerEndpointUri (string) -- [REQUIRED]

      The URI of the cluster API server endpoint.

    • clusterApiServerCaCertificateChain (string) -- [REQUIRED]

      The CA certificate chain of the cluster API server.

    • clusterName (string) -- [REQUIRED]

      The name of the cluster.

    • roleArn (string) -- [REQUIRED]

      The role ARN for the cluster.

type clientToken:

string

param clientToken:

[REQUIRED]

The unique client token.

This field is autopopulated if not provided.

type description:

string

param description:

An optional description for the responder gateway.

type tags:

dict

param tags:

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

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • status (string) --

      The status of the request.

GetRequesterGateway (new) Link ¶

Retrieves information about a requester gateway.

See also: AWS API Documentation

Request Syntax

client.get_requester_gateway(
    gatewayId='string'
)
type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

rtype:

dict

returns:

Response Syntax

{
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION',
    'domainName': 'string',
    'description': 'string',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1),
    'vpcId': 'string',
    'subnetIds': [
        'string',
    ],
    'securityGroupIds': [
        'string',
    ],
    'gatewayId': 'string',
    'tags': {
        'string': 'string'
    },
    'activeLinksCount': 123,
    'totalLinksCount': 123
}

Response Structure

  • (dict) --

    • status (string) --

      The status of the request.

    • domainName (string) --

      The domain name of the requester gateway.

    • description (string) --

      The description of the requester gateway.

    • createdAt (datetime) --

      The timestamp of when the requester gateway was created.

    • updatedAt (datetime) --

      The timestamp of when the requester gateway was updated.

    • vpcId (string) --

      The unique identifier of the Virtual Private Cloud (VPC).

    • subnetIds (list) --

      The unique identifiers of the subnets.

      • (string) --

    • securityGroupIds (list) --

      The unique identifiers of the security groups.

      • (string) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • tags (dict) --

      A map of the key-value pairs for the tag or tags assigned to the specified resource.

      • (string) --

        • (string) --

    • activeLinksCount (integer) --

      The count of active links for the requester gateway.

    • totalLinksCount (integer) --

      The total count of links for the requester gateway.

ListResponderGateways (new) Link ¶

Lists reponder gateways.

See also: AWS API Documentation

Request Syntax

client.list_responder_gateways(
    maxResults=123,
    nextToken='string'
)
type maxResults:

integer

param maxResults:

The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results.

This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.

type nextToken:

string

param nextToken:

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

rtype:

dict

returns:

Response Syntax

{
    'gatewayIds': [
        'string',
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • gatewayIds (list) --

      The unique identifier of the gateways.

      • (string) --

    • nextToken (string) --

      If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

UpdateRequesterGateway (new) Link ¶

Updates a requester gateway.

See also: AWS API Documentation

Request Syntax

client.update_requester_gateway(
    clientToken='string',
    gatewayId='string',
    description='string'
)
type clientToken:

string

param clientToken:

[REQUIRED]

The unique client token.

This field is autopopulated if not provided.

type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

type description:

string

param description:

An optional description for the requester gateway.

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • status (string) --

      The status of the request.

GetResponderGateway (new) Link ¶

Retrieves information about a responder gateway.

See also: AWS API Documentation

Request Syntax

client.get_responder_gateway(
    gatewayId='string'
)
type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

rtype:

dict

returns:

Response Syntax

{
    'vpcId': 'string',
    'subnetIds': [
        'string',
    ],
    'securityGroupIds': [
        'string',
    ],
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION',
    'description': 'string',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1),
    'domainName': 'string',
    'port': 123,
    'protocol': 'HTTP'|'HTTPS',
    'trustStoreConfiguration': {
        'certificateAuthorityCertificates': [
            'string',
        ]
    },
    'managedEndpointConfiguration': {
        'autoScalingGroups': {
            'autoScalingGroupNames': [
                'string',
            ],
            'roleArn': 'string'
        },
        'eksEndpoints': {
            'endpointsResourceName': 'string',
            'endpointsResourceNamespace': 'string',
            'clusterApiServerEndpointUri': 'string',
            'clusterApiServerCaCertificateChain': 'string',
            'clusterName': 'string',
            'roleArn': 'string'
        }
    },
    'gatewayId': 'string',
    'tags': {
        'string': 'string'
    },
    'activeLinksCount': 123,
    'totalLinksCount': 123,
    'inboundLinksCount': 123
}

Response Structure

  • (dict) --

    • vpcId (string) --

      The unique identifier of the Virtual Private Cloud (VPC).

    • subnetIds (list) --

      The unique identifiers of the subnets.

      • (string) --

    • securityGroupIds (list) --

      The unique identifiers of the security groups.

      • (string) --

    • status (string) --

      The status of the request.

    • description (string) --

      The description of the responder gateway.

    • createdAt (datetime) --

      The timestamp of when the responder gateway was created.

    • updatedAt (datetime) --

      The timestamp of when the responder gateway was updated.

    • domainName (string) --

      The domain name of the responder gateway.

    • port (integer) --

      The networking port.

    • protocol (string) --

      The networking protocol.

    • trustStoreConfiguration (dict) --

      The configuration of the trust store.

      • certificateAuthorityCertificates (list) --

        The certificate authority certificate.

        • (string) --

    • managedEndpointConfiguration (dict) --

      The configuration of the managed endpoint.

      • autoScalingGroups (dict) --

        Describes the configuration of an auto scaling group.

        • autoScalingGroupNames (list) --

          The names of the auto scaling group.

          • (string) --

        • roleArn (string) --

          The role ARN of the auto scaling group.

      • eksEndpoints (dict) --

        Describes the configuration of an Amazon Elastic Kubernetes Service endpoint.

        • endpointsResourceName (string) --

          The name of the endpoint resource.

        • endpointsResourceNamespace (string) --

          The namespace of the endpoint resource.

        • clusterApiServerEndpointUri (string) --

          The URI of the cluster API server endpoint.

        • clusterApiServerCaCertificateChain (string) --

          The CA certificate chain of the cluster API server.

        • clusterName (string) --

          The name of the cluster.

        • roleArn (string) --

          The role ARN for the cluster.

    • gatewayId (string) --

      The unique identifier of the gateway.

    • tags (dict) --

      A map of the key-value pairs for the tag or tags assigned to the specified resource.

      • (string) --

        • (string) --

    • activeLinksCount (integer) --

      The count of active links for the responder gateway.

    • totalLinksCount (integer) --

      The total count of links for the responder gateway.

    • inboundLinksCount (integer) --

      The count of inbound links for the responder gateway.

ListTagsForResource (new) Link ¶

Lists tags for a resource.

See also: AWS API Documentation

Request Syntax

client.list_tags_for_resource(
    resourceArn='string'
)
type resourceArn:

string

param resourceArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the resource for which you want to retrieve tags.

rtype:

dict

returns:

Response Syntax

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

Response Structure

  • (dict) --

    • tags (dict) --

      A map of the key-value pairs for the tag or tags assigned to the specified resource.

      • (string) --

        • (string) --

TagResource (new) Link ¶

Assigns one or more tags (key-value pairs) to the specified resource.

See also: AWS API Documentation

Request Syntax

client.tag_resource(
    resourceArn='string',
    tags={
        'string': 'string'
    }
)
type resourceArn:

string

param resourceArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the resource that you want to tag.

type tags:

dict

param tags:

[REQUIRED]

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

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

DeleteResponderGateway (new) Link ¶

Deletes a responder gateway.

See also: AWS API Documentation

Request Syntax

client.delete_responder_gateway(
    gatewayId='string'
)
type gatewayId:

string

param gatewayId:

[REQUIRED]

The unique identifier of the gateway.

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • status (string) --

      The status of the request.

CreateRequesterGateway (new) Link ¶

Creates a requester gateway.

See also: AWS API Documentation

Request Syntax

client.create_requester_gateway(
    vpcId='string',
    subnetIds=[
        'string',
    ],
    securityGroupIds=[
        'string',
    ],
    clientToken='string',
    description='string',
    tags={
        'string': 'string'
    }
)
type vpcId:

string

param vpcId:

[REQUIRED]

The unique identifier of the Virtual Private Cloud (VPC).

type subnetIds:

list

param subnetIds:

[REQUIRED]

The unique identifiers of the subnets.

  • (string) --

type securityGroupIds:

list

param securityGroupIds:

[REQUIRED]

The unique identifiers of the security groups.

  • (string) --

type clientToken:

string

param clientToken:

[REQUIRED]

The unique client token.

This field is autopopulated if not provided.

type description:

string

param description:

An optional description for the requester gateway.

type tags:

dict

param tags:

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

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'gatewayId': 'string',
    'domainName': 'string',
    'status': 'PENDING_CREATION'|'ACTIVE'|'PENDING_DELETION'|'DELETED'|'ERROR'|'PENDING_UPDATE'|'ISOLATED'|'PENDING_ISOLATION'|'PENDING_RESTORATION'
}

Response Structure

  • (dict) --

    • gatewayId (string) --

      The unique identifier of the gateway.

    • domainName (string) --

      The domain name of the requester gateway.

    • status (string) --

      The status of the request.

ListRequesterGateways (new) Link ¶

Lists requester gateways.

See also: AWS API Documentation

Request Syntax

client.list_requester_gateways(
    maxResults=123,
    nextToken='string'
)
type maxResults:

integer

param maxResults:

The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results.

This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.

type nextToken:

string

param nextToken:

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

rtype:

dict

returns:

Response Syntax

{
    'gatewayIds': [
        'string',
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • gatewayIds (list) --

      The unique identifier of the gateways.

      • (string) --

    • nextToken (string) --

      If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

UntagResource (new) Link ¶

Removes a tag or tags from a resource.

See also: AWS API Documentation

Request Syntax

client.untag_resource(
    resourceArn='string',
    tagKeys=[
        'string',
    ]
)
type resourceArn:

string

param resourceArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the resource that you want to untag.

type tagKeys:

list

param tagKeys:

[REQUIRED]

The keys of the key-value pairs for the tag or tags you want to remove from the specified resource.

  • (string) --

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --