1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304
|
// Code generated by smithy-go-codegen DO NOT EDIT.
package route53resolver
import (
"context"
"fmt"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/service/route53resolver/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
)
// Creates a single DNS Firewall rule in the specified rule group, using the
// specified domain list.
func (c *Client) CreateFirewallRule(ctx context.Context, params *CreateFirewallRuleInput, optFns ...func(*Options)) (*CreateFirewallRuleOutput, error) {
if params == nil {
params = &CreateFirewallRuleInput{}
}
result, metadata, err := c.invokeOperation(ctx, "CreateFirewallRule", params, optFns, c.addOperationCreateFirewallRuleMiddlewares)
if err != nil {
return nil, err
}
out := result.(*CreateFirewallRuleOutput)
out.ResultMetadata = metadata
return out, nil
}
type CreateFirewallRuleInput struct {
// The action that DNS Firewall should take on a DNS query when it matches one of
// the domains in the rule's domain list:
//
// - ALLOW - Permit the request to go through.
//
// - ALERT - Permit the request and send metrics and logs to Cloud Watch.
//
// - BLOCK - Disallow the request. This option requires additional details in the
// rule's BlockResponse .
//
// This member is required.
Action types.Action
// A unique string that identifies the request and that allows you to retry failed
// requests without the risk of running the operation twice. CreatorRequestId can
// be any unique string, for example, a date/time stamp.
//
// This member is required.
CreatorRequestId *string
// The ID of the domain list that you want to use in the rule.
//
// This member is required.
FirewallDomainListId *string
// The unique identifier of the firewall rule group where you want to create the
// rule.
//
// This member is required.
FirewallRuleGroupId *string
// A name that lets you identify the rule in the rule group.
//
// This member is required.
Name *string
// The setting that determines the processing order of the rule in the rule group.
// DNS Firewall processes the rules in a rule group by order of priority, starting
// from the lowest setting.
//
// You must specify a unique priority for each rule in a rule group. To make it
// easier to insert rules later, leave space between the numbers, for example, use
// 100, 200, and so on. You can change the priority setting for the rules in a rule
// group at any time.
//
// This member is required.
Priority *int32
// The DNS record's type. This determines the format of the record value that you
// provided in BlockOverrideDomain . Used for the rule action BLOCK with a
// BlockResponse setting of OVERRIDE .
//
// This setting is required if the BlockResponse setting is OVERRIDE .
BlockOverrideDnsType types.BlockOverrideDnsType
// The custom DNS record to send back in response to the query. Used for the rule
// action BLOCK with a BlockResponse setting of OVERRIDE .
//
// This setting is required if the BlockResponse setting is OVERRIDE .
BlockOverrideDomain *string
// The recommended amount of time, in seconds, for the DNS resolver or web browser
// to cache the provided override record. Used for the rule action BLOCK with a
// BlockResponse setting of OVERRIDE .
//
// This setting is required if the BlockResponse setting is OVERRIDE .
BlockOverrideTtl *int32
// The way that you want DNS Firewall to block the request, used with the rule
// action setting BLOCK .
//
// - NODATA - Respond indicating that the query was successful, but no response
// is available for it.
//
// - NXDOMAIN - Respond indicating that the domain name that's in the query
// doesn't exist.
//
// - OVERRIDE - Provide a custom override in the response. This option requires
// custom handling details in the rule's BlockOverride* settings.
//
// This setting is required if the rule action setting is BLOCK .
BlockResponse types.BlockResponse
// How you want the the rule to evaluate DNS redirection in the DNS redirection
// chain, such as CNAME or DNAME.
//
// Inspect_Redirection_Domain (Default) inspects all domains in the redirection
// chain. The individual domains in the redirection chain must be added to the
// domain list.
//
// Trust_Redirection_Domain inspects only the first domain in the redirection
// chain. You don't need to add the subsequent domains in the domain in the
// redirection list to the domain list.
FirewallDomainRedirectionAction types.FirewallDomainRedirectionAction
// The DNS query type you want the rule to evaluate. Allowed values are;
//
// - A: Returns an IPv4 address.
//
// - AAAA: Returns an Ipv6 address.
//
// - CAA: Restricts CAs that can create SSL/TLS certifications for the domain.
//
// - CNAME: Returns another domain name.
//
// - DS: Record that identifies the DNSSEC signing key of a delegated zone.
//
// - MX: Specifies mail servers.
//
// - NAPTR: Regular-expression-based rewriting of domain names.
//
// - NS: Authoritative name servers.
//
// - PTR: Maps an IP address to a domain name.
//
// - SOA: Start of authority record for the zone.
//
// - SPF: Lists the servers authorized to send emails from a domain.
//
// - SRV: Application specific values that identify servers.
//
// - TXT: Verifies email senders and application-specific values.
//
// - A query type you define by using the DNS type ID, for example 28 for AAAA.
// The values must be defined as TYPENUMBER, where the NUMBER can be 1-65334, for
// example, TYPE28. For more information, see [List of DNS record types].
//
// [List of DNS record types]: https://en.wikipedia.org/wiki/List_of_DNS_record_types
Qtype *string
noSmithyDocumentSerde
}
type CreateFirewallRuleOutput struct {
// The firewall rule that you just created.
FirewallRule *types.FirewallRule
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationCreateFirewallRuleMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsAwsjson11_serializeOpCreateFirewallRule{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpCreateFirewallRule{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "CreateFirewallRule"); err != nil {
return fmt.Errorf("add protocol finalizers: %v", err)
}
if err = addlegacyEndpointContextSetter(stack, options); err != nil {
return err
}
if err = addSetLoggerMiddleware(stack, options); err != nil {
return err
}
if err = addClientRequestID(stack); err != nil {
return err
}
if err = addComputeContentLength(stack); err != nil {
return err
}
if err = addResolveEndpointMiddleware(stack, options); err != nil {
return err
}
if err = addComputePayloadSHA256(stack); err != nil {
return err
}
if err = addRetry(stack, options); err != nil {
return err
}
if err = addRawResponseToMetadata(stack); err != nil {
return err
}
if err = addRecordResponseTiming(stack); err != nil {
return err
}
if err = addClientUserAgent(stack, options); err != nil {
return err
}
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = addSetLegacyContextSigningOptionsMiddleware(stack); err != nil {
return err
}
if err = addTimeOffsetBuild(stack, c); err != nil {
return err
}
if err = addUserAgentRetryMode(stack, options); err != nil {
return err
}
if err = addIdempotencyToken_opCreateFirewallRuleMiddleware(stack, options); err != nil {
return err
}
if err = addOpCreateFirewallRuleValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateFirewallRule(options.Region), middleware.Before); err != nil {
return err
}
if err = addRecursionDetection(stack); err != nil {
return err
}
if err = addRequestIDRetrieverMiddleware(stack); err != nil {
return err
}
if err = addResponseErrorMiddleware(stack); err != nil {
return err
}
if err = addRequestResponseLogging(stack, options); err != nil {
return err
}
if err = addDisableHTTPSMiddleware(stack, options); err != nil {
return err
}
return nil
}
type idempotencyToken_initializeOpCreateFirewallRule struct {
tokenProvider IdempotencyTokenProvider
}
func (*idempotencyToken_initializeOpCreateFirewallRule) ID() string {
return "OperationIdempotencyTokenAutoFill"
}
func (m *idempotencyToken_initializeOpCreateFirewallRule) HandleInitialize(ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler) (
out middleware.InitializeOutput, metadata middleware.Metadata, err error,
) {
if m.tokenProvider == nil {
return next.HandleInitialize(ctx, in)
}
input, ok := in.Parameters.(*CreateFirewallRuleInput)
if !ok {
return out, metadata, fmt.Errorf("expected middleware input to be of type *CreateFirewallRuleInput ")
}
if input.CreatorRequestId == nil {
t, err := m.tokenProvider.GetIdempotencyToken()
if err != nil {
return out, metadata, err
}
input.CreatorRequestId = &t
}
return next.HandleInitialize(ctx, in)
}
func addIdempotencyToken_opCreateFirewallRuleMiddleware(stack *middleware.Stack, cfg Options) error {
return stack.Initialize.Add(&idempotencyToken_initializeOpCreateFirewallRule{tokenProvider: cfg.IdempotencyTokenProvider}, middleware.Before)
}
func newServiceMetadataMiddleware_opCreateFirewallRule(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "CreateFirewallRule",
}
}
|