Route53Resolver / Client / associate_resolver_rule

associate_resolver_rule#

Route53Resolver.Client.associate_resolver_rule(**kwargs)#

Associates a Resolver rule with a VPC. When you associate a rule with a VPC, Resolver forwards all DNS queries for the domain name that is specified in the rule and that originate in the VPC. The queries are forwarded to the IP addresses for the DNS resolvers that are specified in the rule. For more information about rules, see CreateResolverRule.

See also: AWS API Documentation

Request Syntax

response = client.associate_resolver_rule(
    ResolverRuleId='string',
    Name='string',
    VPCId='string'
)
Parameters:

  • ResolverRuleId (string) –

    [REQUIRED]

    The ID of the Resolver rule that you want to associate with the VPC. To list the existing Resolver rules, use ListResolverRules.

  • Name (string) – A name for the association that you’re creating between a Resolver rule and a VPC.

  • VPCId (string) –

    [REQUIRED]

    The ID of the VPC that you want to associate the Resolver rule with.

Return type:

dict

Returns:

Response Syntax

{
    'ResolverRuleAssociation': {
        'Id': 'string',
        'ResolverRuleId': 'string',
        'Name': 'string',
        'VPCId': 'string',
        'Status': 'CREATING'|'COMPLETE'|'DELETING'|'FAILED'|'OVERRIDDEN',
        'StatusMessage': 'string'
    }
}

Response Structure

  • (dict) –

    • ResolverRuleAssociation (dict) –

      Information about the AssociateResolverRule request, including the status of the request.

      • Id (string) –

        The ID of the association between a Resolver rule and a VPC. Resolver assigns this value when you submit an AssociateResolverRule request.

      • ResolverRuleId (string) –

        The ID of the Resolver rule that you associated with the VPC that is specified by VPCId.

      • Name (string) –

        The name of an association between a Resolver rule and a VPC.

      • VPCId (string) –

        The ID of the VPC that you associated the Resolver rule with.

      • Status (string) –

        A code that specifies the current status of the association between a Resolver rule and a VPC.

      • StatusMessage (string) –

        A detailed description of the status of the association between a Resolver rule and a VPC.

Exceptions

  • Route53Resolver.Client.exceptions.ResourceNotFoundException

  • Route53Resolver.Client.exceptions.InvalidRequestException

  • Route53Resolver.Client.exceptions.LimitExceededException

  • Route53Resolver.Client.exceptions.InvalidParameterException

  • Route53Resolver.Client.exceptions.ResourceUnavailableException

  • Route53Resolver.Client.exceptions.ResourceExistsException

  • Route53Resolver.Client.exceptions.InternalServiceErrorException

  • Route53Resolver.Client.exceptions.ThrottlingException