Interface FirewallRuleDomain.Builder

  • Method Details

    • domainName

      FirewallRuleDomain.Builder domainName(String domainName)

      The domain name.

      Parameters:
      domainName - The domain name.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • domainStatus

      FirewallRuleDomain.Builder domainStatus(String domainStatus)

      The review status of the domain:

      • OBSERVED - DNS Firewall saw the domain in the VPCs' DNS traffic and you haven't allowed or denied it. The look-back window seeds the initial observed domains. After that, a domain becomes observed when any DNS Firewall rule blocks a query for it from a VPC that uses the rule group, including rules in other rule groups, or when you remove it from the managed domain list with REMOVE. To keep observing new domains, place a rule that blocks the domains you haven't approved after the AutoAllowlist rule. Domains from the look-back period that keep being queried and aren't blocked move to ALLOWED within about a day after the rule is created. Observed domains aren't evaluated for safety, so review them before you allow them.

      • ALLOWED - DNS Firewall allowed queries for the domain, whether or not the domain is in the rule's managed domain list. To get the domains in the managed domain list (the allowlist that the rule enforces), call ListFirewallRuleDomains with FirewallDomainListId.

      • DENIED - The domain was denied with the DENY operation of UpdateFirewallDomains, which also removes it from the managed domain list if it was there. A denied domain that is still queried and not blocked can move to ALLOWED.

      Parameters:
      domainStatus - The review status of the domain:

      • OBSERVED - DNS Firewall saw the domain in the VPCs' DNS traffic and you haven't allowed or denied it. The look-back window seeds the initial observed domains. After that, a domain becomes observed when any DNS Firewall rule blocks a query for it from a VPC that uses the rule group, including rules in other rule groups, or when you remove it from the managed domain list with REMOVE. To keep observing new domains, place a rule that blocks the domains you haven't approved after the AutoAllowlist rule. Domains from the look-back period that keep being queried and aren't blocked move to ALLOWED within about a day after the rule is created. Observed domains aren't evaluated for safety, so review them before you allow them.

      • ALLOWED - DNS Firewall allowed queries for the domain, whether or not the domain is in the rule's managed domain list. To get the domains in the managed domain list (the allowlist that the rule enforces), call ListFirewallRuleDomains with FirewallDomainListId.

      • DENIED - The domain was denied with the DENY operation of UpdateFirewallDomains, which also removes it from the managed domain list if it was there. A denied domain that is still queried and not blocked can move to ALLOWED.

      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • domainStatus

      The review status of the domain:

      • OBSERVED - DNS Firewall saw the domain in the VPCs' DNS traffic and you haven't allowed or denied it. The look-back window seeds the initial observed domains. After that, a domain becomes observed when any DNS Firewall rule blocks a query for it from a VPC that uses the rule group, including rules in other rule groups, or when you remove it from the managed domain list with REMOVE. To keep observing new domains, place a rule that blocks the domains you haven't approved after the AutoAllowlist rule. Domains from the look-back period that keep being queried and aren't blocked move to ALLOWED within about a day after the rule is created. Observed domains aren't evaluated for safety, so review them before you allow them.

      • ALLOWED - DNS Firewall allowed queries for the domain, whether or not the domain is in the rule's managed domain list. To get the domains in the managed domain list (the allowlist that the rule enforces), call ListFirewallRuleDomains with FirewallDomainListId.

      • DENIED - The domain was denied with the DENY operation of UpdateFirewallDomains, which also removes it from the managed domain list if it was there. A denied domain that is still queried and not blocked can move to ALLOWED.

      Parameters:
      domainStatus - The review status of the domain:

      • OBSERVED - DNS Firewall saw the domain in the VPCs' DNS traffic and you haven't allowed or denied it. The look-back window seeds the initial observed domains. After that, a domain becomes observed when any DNS Firewall rule blocks a query for it from a VPC that uses the rule group, including rules in other rule groups, or when you remove it from the managed domain list with REMOVE. To keep observing new domains, place a rule that blocks the domains you haven't approved after the AutoAllowlist rule. Domains from the look-back period that keep being queried and aren't blocked move to ALLOWED within about a day after the rule is created. Observed domains aren't evaluated for safety, so review them before you allow them.

      • ALLOWED - DNS Firewall allowed queries for the domain, whether or not the domain is in the rule's managed domain list. To get the domains in the managed domain list (the allowlist that the rule enforces), call ListFirewallRuleDomains with FirewallDomainListId.

      • DENIED - The domain was denied with the DENY operation of UpdateFirewallDomains, which also removes it from the managed domain list if it was there. A denied domain that is still queried and not blocked can move to ALLOWED.

      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • last24HourRequests

      FirewallRuleDomain.Builder last24HourRequests(Long last24HourRequests)

      The number of DNS requests observed for this domain in the last 24 hours.

      Parameters:
      last24HourRequests - The number of DNS requests observed for this domain in the last 24 hours.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • totalRequests

      FirewallRuleDomain.Builder totalRequests(Long totalRequests)

      The total number of DNS requests observed for this domain since it was first added, including the requests in the look-back window that seeded the rule.

      Parameters:
      totalRequests - The total number of DNS requests observed for this domain since it was first added, including the requests in the look-back window that seeded the rule.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • addedTime

      FirewallRuleDomain.Builder addedTime(String addedTime)

      The date and time when the domain was first observed and added, in RFC 3339 format.

      Parameters:
      addedTime - The date and time when the domain was first observed and added, in RFC 3339 format.
      Returns:
      Returns a reference to this object so that method calls can be chained together.