Class FirewallRuleDomain
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<FirewallRuleDomain.Builder,FirewallRuleDomain>
A domain that DNS Firewall observed for an AutoAllowlist rule, with its review status and request volume. Counts are aggregated across all VPCs that use the rule group, through a rule group association or through a Route 53 Profile that includes the rule group, including VPCs in other accounts. The domain isn't attributed to the VPC or account in which it was observed.
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionfinal StringThe date and time when the domain was first observed and added, in RFC 3339 format.static FirewallRuleDomain.Builderbuilder()final StringThe domain name.final FirewallDomainStatusThe review status of the domain:final StringThe review status of the domain:final booleanfinal booleanequalsBySdkFields(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz) final inthashCode()final LongThe number of DNS requests observed for this domain in the last 24 hours.static Class<? extends FirewallRuleDomain.Builder> Take this object and create a builder that contains all of the current property values of this object.final StringtoString()Returns a string representation of this object.final LongThe 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.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
domainName
-
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 withREMOVE. 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 toALLOWEDwithin 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 withFirewallDomainListId. -
DENIED- The domain was denied with theDENYoperation 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 toALLOWED.
If the service returns an enum value that is not available in the current SDK version,
domainStatuswill returnFirewallDomainStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromdomainStatusAsString().- Returns:
- 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 withREMOVE. 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 toALLOWEDwithin 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 withFirewallDomainListId. -
DENIED- The domain was denied with theDENYoperation 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 toALLOWED.
-
- See Also:
-
-
domainStatusAsString
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 withREMOVE. 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 toALLOWEDwithin 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 withFirewallDomainListId. -
DENIED- The domain was denied with theDENYoperation 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 toALLOWED.
If the service returns an enum value that is not available in the current SDK version,
domainStatuswill returnFirewallDomainStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromdomainStatusAsString().- Returns:
- 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 withREMOVE. 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 toALLOWEDwithin 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 withFirewallDomainListId. -
DENIED- The domain was denied with theDENYoperation 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 toALLOWED.
-
- See Also:
-
-
last24HourRequests
The number of DNS requests observed for this domain in the last 24 hours.
- Returns:
- The number of DNS requests observed for this domain in the last 24 hours.
-
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:
- 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.
-
addedTime
The date and time when the domain was first observed and added, in RFC 3339 format.
- Returns:
- The date and time when the domain was first observed and added, in RFC 3339 format.
-
toBuilder
Description copied from interface:ToCopyableBuilderTake this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilderin interfaceToCopyableBuilder<FirewallRuleDomain.Builder,FirewallRuleDomain> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
-
equals
-
equalsBySdkFields
Description copied from interface:SdkPojoIndicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojoclass, and is generated based on a service model.If an
SdkPojoclass does not have any inherited fields,equalsBySdkFieldsandequalsare essentially the same.- Specified by:
equalsBySdkFieldsin interfaceSdkPojo- Parameters:
obj- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo- Returns:
- The mapping between the field name and its corresponding field.
-