test_dns_answer async ¶

async def test_dns_answer(
    self,
    hosted_zone_id: "capo_route_53.types.resource_id.ResourceId",
    record_name: "capo_route_53.types.dns_name.DNSName",
    record_type: "capo_route_53.types.rr_type.RRType",
    *,
    config_overrides: Optional[AsyncRoute53ClientConfig] = None,
    resolver_ip: Optional["capo_route_53.types.ip_address.IPAddress"] = None,
    edns0_client_subnet_ip: Optional[
        "capo_route_53.types.ip_address.IPAddress"
    ] = None,
    edns0_client_subnet_mask: Optional[
        "capo_route_53.types.subnet_mask.SubnetMask"
    ] = None,
) -> "capo_route_53.types.test_dns_answer_response.TestDNSAnswerResponse":
    """<p>Gets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. You can optionally specify the IP address of a DNS resolver, an EDNS0 client subnet IP address, and a subnet mask. </p> <p>This call only supports querying public hosted zones.</p> <note> <p>The <code>TestDnsAnswer </code> returns information similar to what you would expect from the answer section of the <code>dig</code> command. Therefore, if you query for the name servers of a subdomain that point to the parent name servers, those will not be returned.</p> </note>

    Args:
        hosted_zone_id: <p>The ID of the hosted zone that you want Amazon Route 53 to simulate a query for.</p>
        record_name: <p>The name of the resource record set that you want Amazon Route 53 to simulate a query for.</p>
        record_type: <p>The type of the resource record set.</p>
        resolver_ip: <p>If you want to simulate a request from a specific DNS resolver, specify the IP address for that resolver. If you omit this value, <code>TestDnsAnswer</code> uses the IP address of a DNS resolver in the Amazon Web Services US East (N. Virginia) Region (<code>us-east-1</code>).</p>
        edns0_client_subnet_ip: <p>If the resolver that you specified for resolverip supports EDNS0, specify the IPv4 or IPv6 address of a client in the applicable location, for example, <code>192.0.2.44</code> or <code>2001:db8:85a3::8a2e:370:7334</code>.</p>
        edns0_client_subnet_mask: <p>If you specify an IP address for <code>edns0clientsubnetip</code>, you can optionally specify the number of bits of the IP address that you want the checking tool to include in the DNS query. For example, if you specify <code>192.0.2.44</code> for <code>edns0clientsubnetip</code> and <code>24</code> for <code>edns0clientsubnetmask</code>, the checking tool will simulate a request from 192.0.2.0/24. The default value is 24 bits for IPv4 addresses and 64 bits for IPv6 addresses.</p> <p>The range of valid values depends on whether <code>edns0clientsubnetip</code> is an IPv4 or an IPv6 address:</p> <ul> <li> <p> <b>IPv4</b>: Specify a value between 0 and 32</p> </li> <li> <p> <b>IPv6</b>: Specify a value between 0 and 128</p> </li> </ul>

    Raises:
        capo_route_53.errors.invalid_input.InvalidInput: <p>The input is not valid.</p>
        capo_route_53.errors.no_such_hosted_zone.NoSuchHostedZone: <p>No hosted zone exists with the ID that you specified.</p>
        capo_route_53.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_route_53.types.test_dns_answer_request.TestDNSAnswerRequest]",
    ) -> AsyncOperationResponse[
        "capo_route_53.types.test_dns_answer_response.TestDNSAnswerResponse"
    ]:
        import capo_route_53._operations.aws_dns_v20130401.test_dns_answer

        (
            output,
            http_response,
        ) = await capo_route_53._operations.aws_dns_v20130401.test_dns_answer.async_test_dns_answer(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("TestDNSAnswer")
    )
    input_: capo_route_53.types.test_dns_answer_request.TestDNSAnswerRequest = {
        "hosted_zone_id": hosted_zone_id,
        "record_name": record_name,
        "record_type": record_type,
    }
    if resolver_ip is not None:
        input_["resolver_ip"] = resolver_ip
    if edns0_client_subnet_ip is not None:
        input_["edns0_client_subnet_ip"] = edns0_client_subnet_ip
    if edns0_client_subnet_mask is not None:
        input_["edns0_client_subnet_mask"] = edns0_client_subnet_mask

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output