Documentation
¶
Index ¶
- Constants
- func AddResolveEndpointMiddleware(stack *middleware.Stack, options ResolveEndpointMiddlewareOptions)
- func NewDefaultEndpointResolver() *internalendpoints.Resolver
- func RemoveResolveEndpointMiddleware(stack *middleware.Stack) error
- type AssociateDRTLogBucketInput
- type AssociateDRTLogBucketOutput
- type AssociateDRTRoleInput
- type AssociateDRTRoleOutput
- type AssociateHealthCheckInput
- type AssociateHealthCheckOutput
- type AssociateProactiveEngagementDetailsInput
- type AssociateProactiveEngagementDetailsOutput
- type Client
- func (c *Client) AssociateDRTLogBucket(ctx context.Context, params *AssociateDRTLogBucketInput, ...) (*AssociateDRTLogBucketOutput, error)
- func (c *Client) AssociateDRTRole(ctx context.Context, params *AssociateDRTRoleInput, optFns ...func(*Options)) (*AssociateDRTRoleOutput, error)
- func (c *Client) AssociateHealthCheck(ctx context.Context, params *AssociateHealthCheckInput, ...) (*AssociateHealthCheckOutput, error)
- func (c *Client) AssociateProactiveEngagementDetails(ctx context.Context, params *AssociateProactiveEngagementDetailsInput, ...) (*AssociateProactiveEngagementDetailsOutput, error)
- func (c *Client) CreateProtection(ctx context.Context, params *CreateProtectionInput, optFns ...func(*Options)) (*CreateProtectionOutput, error)
- func (c *Client) CreateSubscription(ctx context.Context, params *CreateSubscriptionInput, optFns ...func(*Options)) (*CreateSubscriptionOutput, error)
- func (c *Client) DeleteProtection(ctx context.Context, params *DeleteProtectionInput, optFns ...func(*Options)) (*DeleteProtectionOutput, error)
- func (c *Client) DeleteSubscription(ctx context.Context, params *DeleteSubscriptionInput, optFns ...func(*Options)) (*DeleteSubscriptionOutput, error)
- func (c *Client) DescribeAttack(ctx context.Context, params *DescribeAttackInput, optFns ...func(*Options)) (*DescribeAttackOutput, error)
- func (c *Client) DescribeDRTAccess(ctx context.Context, params *DescribeDRTAccessInput, optFns ...func(*Options)) (*DescribeDRTAccessOutput, error)
- func (c *Client) DescribeEmergencyContactSettings(ctx context.Context, params *DescribeEmergencyContactSettingsInput, ...) (*DescribeEmergencyContactSettingsOutput, error)
- func (c *Client) DescribeProtection(ctx context.Context, params *DescribeProtectionInput, optFns ...func(*Options)) (*DescribeProtectionOutput, error)
- func (c *Client) DescribeSubscription(ctx context.Context, params *DescribeSubscriptionInput, ...) (*DescribeSubscriptionOutput, error)
- func (c *Client) DisableProactiveEngagement(ctx context.Context, params *DisableProactiveEngagementInput, ...) (*DisableProactiveEngagementOutput, error)
- func (c *Client) DisassociateDRTLogBucket(ctx context.Context, params *DisassociateDRTLogBucketInput, ...) (*DisassociateDRTLogBucketOutput, error)
- func (c *Client) DisassociateDRTRole(ctx context.Context, params *DisassociateDRTRoleInput, ...) (*DisassociateDRTRoleOutput, error)
- func (c *Client) DisassociateHealthCheck(ctx context.Context, params *DisassociateHealthCheckInput, ...) (*DisassociateHealthCheckOutput, error)
- func (c *Client) EnableProactiveEngagement(ctx context.Context, params *EnableProactiveEngagementInput, ...) (*EnableProactiveEngagementOutput, error)
- func (c *Client) GetSubscriptionState(ctx context.Context, params *GetSubscriptionStateInput, ...) (*GetSubscriptionStateOutput, error)
- func (c *Client) ListAttacks(ctx context.Context, params *ListAttacksInput, optFns ...func(*Options)) (*ListAttacksOutput, error)
- func (c *Client) ListProtections(ctx context.Context, params *ListProtectionsInput, optFns ...func(*Options)) (*ListProtectionsOutput, error)
- func (c *Client) UpdateEmergencyContactSettings(ctx context.Context, params *UpdateEmergencyContactSettingsInput, ...) (*UpdateEmergencyContactSettingsOutput, error)
- func (c *Client) UpdateSubscription(ctx context.Context, params *UpdateSubscriptionInput, optFns ...func(*Options)) (*UpdateSubscriptionOutput, error)
- type CreateProtectionInput
- type CreateProtectionOutput
- type CreateSubscriptionInput
- type CreateSubscriptionOutput
- type DeleteProtectionInput
- type DeleteProtectionOutput
- type DeleteSubscriptionInput
- type DeleteSubscriptionOutput
- type DescribeAttackInput
- type DescribeAttackOutput
- type DescribeDRTAccessInput
- type DescribeDRTAccessOutput
- type DescribeEmergencyContactSettingsInput
- type DescribeEmergencyContactSettingsOutput
- type DescribeProtectionInput
- type DescribeProtectionOutput
- type DescribeSubscriptionInput
- type DescribeSubscriptionOutput
- type DisableProactiveEngagementInput
- type DisableProactiveEngagementOutput
- type DisassociateDRTLogBucketInput
- type DisassociateDRTLogBucketOutput
- type DisassociateDRTRoleInput
- type DisassociateDRTRoleOutput
- type DisassociateHealthCheckInput
- type DisassociateHealthCheckOutput
- type EnableProactiveEngagementInput
- type EnableProactiveEngagementOutput
- type EndpointResolver
- type EndpointResolverFunc
- type GetSubscriptionStateInput
- type GetSubscriptionStateOutput
- type HTTPClient
- type HTTPSignerV4
- type ListAttacksInput
- type ListAttacksOutput
- type ListProtectionsInput
- type ListProtectionsOutput
- type Options
- func (o Options) Copy() Options
- func (o Options) GetCredentials() aws.CredentialsProvider
- func (o Options) GetEndpointOptions() ResolverOptions
- func (o Options) GetEndpointResolver() EndpointResolver
- func (o Options) GetHTTPSignerV4() HTTPSignerV4
- func (o Options) GetRegion() string
- func (o Options) GetRetryer() retry.Retryer
- type ResolveEndpoint
- type ResolveEndpointMiddlewareOptions
- type ResolverOptions
- type UpdateEmergencyContactSettingsInput
- type UpdateEmergencyContactSettingsOutput
- type UpdateSubscriptionInput
- type UpdateSubscriptionOutput
Constants ¶
const ServiceAPIVersion = "2016-06-02"
const ServiceID = "Shield"
Variables ¶
This section is empty.
Functions ¶
func AddResolveEndpointMiddleware ¶
func AddResolveEndpointMiddleware(stack *middleware.Stack, options ResolveEndpointMiddlewareOptions)
func NewDefaultEndpointResolver ¶
func NewDefaultEndpointResolver() *internalendpoints.Resolver
NewDefaultEndpointResolver constructs a new service endpoint resolver
func RemoveResolveEndpointMiddleware ¶
func RemoveResolveEndpointMiddleware(stack *middleware.Stack) error
Types ¶
type AssociateDRTLogBucketInput ¶
type AssociateDRTLogBucketInput struct { // The Amazon S3 bucket that contains your AWS WAF logs. LogBucket *string }
type AssociateDRTLogBucketOutput ¶
type AssociateDRTLogBucketOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type AssociateDRTRoleInput ¶
type AssociateDRTRoleInput struct { // The Amazon Resource Name (ARN) of the role the DRT will use to access your AWS // account. Prior to making the AssociateDRTRole request, you must attach the // AWSShieldDRTAccessPolicy // (https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/service-role/AWSShieldDRTAccessPolicy) // managed policy to this role. For more information see Attaching and Detaching // IAM Policies // (https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html). RoleArn *string }
type AssociateDRTRoleOutput ¶
type AssociateDRTRoleOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type AssociateHealthCheckOutput ¶
type AssociateHealthCheckOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type AssociateProactiveEngagementDetailsInput ¶
type AssociateProactiveEngagementDetailsInput struct { // A list of email addresses and phone numbers that the DDoS Response Team (DRT) // can use to contact you for escalations to the DRT and to initiate proactive // customer support. To enable proactive engagement, the contact list must include // at least one phone number. The contacts that you provide here replace any // contacts that were already defined. If you already have contacts defined and // want to use them, retrieve the list using DescribeEmergencyContactSettings and // then provide it here. EmergencyContactList []*types.EmergencyContact }
type AssociateProactiveEngagementDetailsOutput ¶
type AssociateProactiveEngagementDetailsOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
AWS Shield Advanced This is the AWS Shield Advanced API Reference. This guide is for developers who need detailed information about the AWS Shield Advanced API actions, data types, and errors. For detailed information about AWS WAF and AWS Shield Advanced features and an overview of how to use the AWS WAF and AWS Shield Advanced APIs, see the AWS WAF and AWS Shield Developer Guide (https://docs.aws.amazon.com/waf/latest/developerguide/).
func New ¶
New returns an initialized Client based on the functional options. Provide additional functional options to further configure the behavior of the client, such as changing the client's endpoint or adding custom middleware behavior.
func NewFromConfig ¶
NewFromConfig returns a new client from the provided config.
func (*Client) AssociateDRTLogBucket ¶
func (c *Client) AssociateDRTLogBucket(ctx context.Context, params *AssociateDRTLogBucketInput, optFns ...func(*Options)) (*AssociateDRTLogBucketOutput, error)
Authorizes the DDoS Response Team (DRT) to access the specified Amazon S3 bucket containing your AWS WAF logs. You can associate up to 10 Amazon S3 buckets with your subscription. To use the services of the DRT and make an AssociateDRTLogBucket request, you must be subscribed to the Business Support plan (https://aws.amazon.com/premiumsupport/business-support/) or the Enterprise Support plan (https://aws.amazon.com/premiumsupport/enterprise-support/).
func (*Client) AssociateDRTRole ¶
func (c *Client) AssociateDRTRole(ctx context.Context, params *AssociateDRTRoleInput, optFns ...func(*Options)) (*AssociateDRTRoleOutput, error)
Authorizes the DDoS Response Team (DRT), using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks. This enables the DRT to inspect your AWS WAF configuration and create or update AWS WAF rules and web ACLs. You can associate only one RoleArn with your subscription. If you submit an AssociateDRTRole request for an account that already has an associated role, the new RoleArn will replace the existing RoleArn. Prior to making the AssociateDRTRole request, you must attach the AWSShieldDRTAccessPolicy (https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/service-role/AWSShieldDRTAccessPolicy) managed policy to the role you will specify in the request. For more information see Attaching and Detaching IAM Policies (https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html). The role must also trust the service principal drt.shield.amazonaws.com. For more information, see IAM JSON Policy Elements: Principal (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html). <p>The DRT will have access only to your AWS WAF and Shield resources. By submitting this request, you authorize the DRT to inspect your AWS WAF and Shield configuration and create and update AWS WAF rules and web ACLs on your behalf. The DRT takes these actions only if explicitly authorized by you.</p> <p>You must have the <code>iam:PassRole</code> permission to make an <code>AssociateDRTRole</code> request. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">Granting a User Permissions to Pass a Role to an AWS Service</a>. </p> <p>To use the services of the DRT and make an <code>AssociateDRTRole</code> request, you must be subscribed to the <a href="https://aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="https://aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
func (*Client) AssociateHealthCheck ¶
func (c *Client) AssociateHealthCheck(ctx context.Context, params *AssociateHealthCheckInput, optFns ...func(*Options)) (*AssociateHealthCheckOutput, error)
Adds health-based detection to the Shield Advanced protection for a resource. Shield Advanced health-based detection uses the health of your AWS resource to improve responsiveness and accuracy in attack detection and mitigation. You define the health check in Route 53 and then associate it with your Shield Advanced protection. For more information, see Shield Advanced Health-Based Detection (https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html#ddos-advanced-health-check-option) in the AWS WAF and AWS Shield Developer Guide (https://docs.aws.amazon.com/waf/latest/developerguide/).
func (*Client) AssociateProactiveEngagementDetails ¶
func (c *Client) AssociateProactiveEngagementDetails(ctx context.Context, params *AssociateProactiveEngagementDetailsInput, optFns ...func(*Options)) (*AssociateProactiveEngagementDetailsOutput, error)
Initializes proactive engagement and sets the list of contacts for the DDoS Response Team (DRT) to use. You must provide at least one phone number in the emergency contact list. After you have initialized proactive engagement using this call, to disable or enable proactive engagement, use the calls DisableProactiveEngagement and EnableProactiveEngagement. This call defines the list of email addresses and phone numbers that the DDoS Response Team (DRT) can use to contact you for escalations to the DRT and to initiate proactive customer support. The contacts that you provide in the request replace any contacts that were already defined. If you already have contacts defined and want to use them, retrieve the list using DescribeEmergencyContactSettings and then provide it to this call.
func (*Client) CreateProtection ¶
func (c *Client) CreateProtection(ctx context.Context, params *CreateProtectionInput, optFns ...func(*Options)) (*CreateProtectionOutput, error)
Enables AWS Shield Advanced for a specific AWS resource. The resource can be an Amazon CloudFront distribution, Elastic Load Balancing load balancer, AWS Global Accelerator accelerator, Elastic IP Address, or an Amazon Route 53 hosted zone. You can add protection to only a single resource with each CreateProtection request. If you want to add protection to multiple resources at once, use the AWS WAF console (https://console.aws.amazon.com/waf/). For more information see Getting Started with AWS Shield Advanced (https://docs.aws.amazon.com/waf/latest/developerguide/getting-started-ddos.html) and Add AWS Shield Advanced Protection to more AWS Resources (https://docs.aws.amazon.com/waf/latest/developerguide/configure-new-protection.html).
func (*Client) CreateSubscription ¶
func (c *Client) CreateSubscription(ctx context.Context, params *CreateSubscriptionInput, optFns ...func(*Options)) (*CreateSubscriptionOutput, error)
Activates AWS Shield Advanced for an account. <p>When you initally create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an <code>UpdateSubscription</code> request. </p>
func (*Client) DeleteProtection ¶
func (c *Client) DeleteProtection(ctx context.Context, params *DeleteProtectionInput, optFns ...func(*Options)) (*DeleteProtectionOutput, error)
Deletes an AWS Shield Advanced Protection ().
func (*Client) DeleteSubscription ¶
func (c *Client) DeleteSubscription(ctx context.Context, params *DeleteSubscriptionInput, optFns ...func(*Options)) (*DeleteSubscriptionOutput, error)
Removes AWS Shield Advanced from an account. AWS Shield Advanced requires a 1-year subscription commitment. You cannot delete a subscription prior to the completion of that commitment.
func (*Client) DescribeAttack ¶
func (c *Client) DescribeAttack(ctx context.Context, params *DescribeAttackInput, optFns ...func(*Options)) (*DescribeAttackOutput, error)
Describes the details of a DDoS attack.
func (*Client) DescribeDRTAccess ¶
func (c *Client) DescribeDRTAccess(ctx context.Context, params *DescribeDRTAccessInput, optFns ...func(*Options)) (*DescribeDRTAccessOutput, error)
Returns the current role and list of Amazon S3 log buckets used by the DDoS Response Team (DRT) to access your AWS account while assisting with attack mitigation.
func (*Client) DescribeEmergencyContactSettings ¶
func (c *Client) DescribeEmergencyContactSettings(ctx context.Context, params *DescribeEmergencyContactSettingsInput, optFns ...func(*Options)) (*DescribeEmergencyContactSettingsOutput, error)
A list of email addresses and phone numbers that the DDoS Response Team (DRT) can use to contact you if you have proactive engagement enabled, for escalations to the DRT and to initiate proactive customer support.
func (*Client) DescribeProtection ¶
func (c *Client) DescribeProtection(ctx context.Context, params *DescribeProtectionInput, optFns ...func(*Options)) (*DescribeProtectionOutput, error)
Lists the details of a Protection () object.
func (*Client) DescribeSubscription ¶
func (c *Client) DescribeSubscription(ctx context.Context, params *DescribeSubscriptionInput, optFns ...func(*Options)) (*DescribeSubscriptionOutput, error)
Provides details about the AWS Shield Advanced subscription for an account.
func (*Client) DisableProactiveEngagement ¶
func (c *Client) DisableProactiveEngagement(ctx context.Context, params *DisableProactiveEngagementInput, optFns ...func(*Options)) (*DisableProactiveEngagementOutput, error)
Removes authorization from the DDoS Response Team (DRT) to notify contacts about escalations to the DRT and to initiate proactive customer support.
func (*Client) DisassociateDRTLogBucket ¶
func (c *Client) DisassociateDRTLogBucket(ctx context.Context, params *DisassociateDRTLogBucketInput, optFns ...func(*Options)) (*DisassociateDRTLogBucketOutput, error)
Removes the DDoS Response Team's (DRT) access to the specified Amazon S3 bucket containing your AWS WAF logs. To make a DisassociateDRTLogBucket request, you must be subscribed to the Business Support plan (https://aws.amazon.com/premiumsupport/business-support/) or the Enterprise Support plan (https://aws.amazon.com/premiumsupport/enterprise-support/). However, if you are not subscribed to one of these support plans, but had been previously and had granted the DRT access to your account, you can submit a DisassociateDRTLogBucket request to remove this access.
func (*Client) DisassociateDRTRole ¶
func (c *Client) DisassociateDRTRole(ctx context.Context, params *DisassociateDRTRoleInput, optFns ...func(*Options)) (*DisassociateDRTRoleOutput, error)
Removes the DDoS Response Team's (DRT) access to your AWS account. To make a DisassociateDRTRole request, you must be subscribed to the Business Support plan (https://aws.amazon.com/premiumsupport/business-support/) or the Enterprise Support plan (https://aws.amazon.com/premiumsupport/enterprise-support/). However, if you are not subscribed to one of these support plans, but had been previously and had granted the DRT access to your account, you can submit a DisassociateDRTRole request to remove this access.
func (*Client) DisassociateHealthCheck ¶
func (c *Client) DisassociateHealthCheck(ctx context.Context, params *DisassociateHealthCheckInput, optFns ...func(*Options)) (*DisassociateHealthCheckOutput, error)
Removes health-based detection from the Shield Advanced protection for a resource. Shield Advanced health-based detection uses the health of your AWS resource to improve responsiveness and accuracy in attack detection and mitigation. You define the health check in Route 53 and then associate or disassociate it with your Shield Advanced protection. For more information, see Shield Advanced Health-Based Detection (https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html#ddos-advanced-health-check-option) in the AWS WAF and AWS Shield Developer Guide (https://docs.aws.amazon.com/waf/latest/developerguide/).
func (*Client) EnableProactiveEngagement ¶
func (c *Client) EnableProactiveEngagement(ctx context.Context, params *EnableProactiveEngagementInput, optFns ...func(*Options)) (*EnableProactiveEngagementOutput, error)
Authorizes the DDoS Response Team (DRT) to use email and phone to notify contacts about escalations to the DRT and to initiate proactive customer support.
func (*Client) GetSubscriptionState ¶
func (c *Client) GetSubscriptionState(ctx context.Context, params *GetSubscriptionStateInput, optFns ...func(*Options)) (*GetSubscriptionStateOutput, error)
Returns the SubscriptionState, either Active or Inactive.
func (*Client) ListAttacks ¶
func (c *Client) ListAttacks(ctx context.Context, params *ListAttacksInput, optFns ...func(*Options)) (*ListAttacksOutput, error)
Returns all ongoing DDoS attacks or all DDoS attacks during a specified time period.
func (*Client) ListProtections ¶
func (c *Client) ListProtections(ctx context.Context, params *ListProtectionsInput, optFns ...func(*Options)) (*ListProtectionsOutput, error)
Lists all Protection () objects for the account.
func (*Client) UpdateEmergencyContactSettings ¶
func (c *Client) UpdateEmergencyContactSettings(ctx context.Context, params *UpdateEmergencyContactSettingsInput, optFns ...func(*Options)) (*UpdateEmergencyContactSettingsOutput, error)
Updates the details of the list of email addresses and phone numbers that the DDoS Response Team (DRT) can use to contact you if you have proactive engagement enabled, for escalations to the DRT and to initiate proactive customer support.
func (*Client) UpdateSubscription ¶
func (c *Client) UpdateSubscription(ctx context.Context, params *UpdateSubscriptionInput, optFns ...func(*Options)) (*UpdateSubscriptionOutput, error)
Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty parameters are not updated.
type CreateProtectionInput ¶
type CreateProtectionInput struct { // The ARN (Amazon Resource Name) of the resource to be protected. The ARN should // be in one of the following formats: // // * For an Application Load Balancer: // arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id // // // * For an Elastic Load Balancer (Classic Load Balancer): // arn:aws:elasticloadbalancing:region:account-id:loadbalancer/load-balancer-name // // // * For an AWS CloudFront distribution: // arn:aws:cloudfront::account-id:distribution/distribution-id // // * For an AWS // Global Accelerator accelerator: // arn:aws:globalaccelerator::account-id:accelerator/accelerator-id // // * For // Amazon Route 53: arn:aws:route53:::hostedzone/hosted-zone-id // // * For an // Elastic IP address: arn:aws:ec2:region:account-id:eip-allocation/allocation-id ResourceArn *string // Friendly name for the Protection you are creating. Name *string }
type CreateProtectionOutput ¶
type CreateProtectionOutput struct { // The unique identifier (ID) for the Protection () object that is created. ProtectionId *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type CreateSubscriptionInput ¶
type CreateSubscriptionInput struct { }
type CreateSubscriptionOutput ¶
type CreateSubscriptionOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteProtectionInput ¶
type DeleteProtectionInput struct { // The unique identifier (ID) for the Protection () object to be deleted. ProtectionId *string }
type DeleteProtectionOutput ¶
type DeleteProtectionOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteSubscriptionInput ¶
type DeleteSubscriptionInput struct { }
type DeleteSubscriptionOutput ¶
type DeleteSubscriptionOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DescribeAttackInput ¶
type DescribeAttackInput struct { // The unique identifier (ID) for the attack that to be described. AttackId *string }
type DescribeAttackOutput ¶
type DescribeAttackOutput struct { // The attack that is described. Attack *types.AttackDetail // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DescribeDRTAccessInput ¶
type DescribeDRTAccessInput struct { }
type DescribeDRTAccessOutput ¶
type DescribeDRTAccessOutput struct { // The Amazon Resource Name (ARN) of the role the DRT used to access your AWS // account. RoleArn *string // The list of Amazon S3 buckets accessed by the DRT. LogBucketList []*string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DescribeEmergencyContactSettingsInput ¶
type DescribeEmergencyContactSettingsInput struct { }
type DescribeEmergencyContactSettingsOutput ¶
type DescribeEmergencyContactSettingsOutput struct { // A list of email addresses and phone numbers that the DDoS Response Team (DRT) // can use to contact you if you have proactive engagement enabled, for escalations // to the DRT and to initiate proactive customer support. EmergencyContactList []*types.EmergencyContact // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DescribeProtectionInput ¶
type DescribeProtectionInput struct { // The ARN (Amazon Resource Name) of the AWS resource for the Protection () object // that is described. When submitting the DescribeProtection request you must // provide either the ResourceArn or the ProtectionID, but not both. ResourceArn *string // The unique identifier (ID) for the Protection () object that is described. When // submitting the DescribeProtection request you must provide either the // ResourceArn or the ProtectionID, but not both. ProtectionId *string }
type DescribeProtectionOutput ¶
type DescribeProtectionOutput struct { // The Protection () object that is described. Protection *types.Protection // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DescribeSubscriptionInput ¶
type DescribeSubscriptionInput struct { }
type DescribeSubscriptionOutput ¶
type DescribeSubscriptionOutput struct { // The AWS Shield Advanced subscription details for an account. Subscription *types.Subscription // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DisableProactiveEngagementInput ¶
type DisableProactiveEngagementInput struct { }
type DisableProactiveEngagementOutput ¶
type DisableProactiveEngagementOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DisassociateDRTLogBucketInput ¶
type DisassociateDRTLogBucketInput struct { // The Amazon S3 bucket that contains your AWS WAF logs. LogBucket *string }
type DisassociateDRTLogBucketOutput ¶
type DisassociateDRTLogBucketOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DisassociateDRTRoleInput ¶
type DisassociateDRTRoleInput struct { }
type DisassociateDRTRoleOutput ¶
type DisassociateDRTRoleOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DisassociateHealthCheckOutput ¶
type DisassociateHealthCheckOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type EnableProactiveEngagementInput ¶
type EnableProactiveEngagementInput struct { }
type EnableProactiveEngagementOutput ¶
type EnableProactiveEngagementOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type EndpointResolver ¶
type EndpointResolver interface {
ResolveEndpoint(region string, options ResolverOptions) (aws.Endpoint, error)
}
EndpointResolver interface for resolving service endpoints.
func WithEndpointResolver ¶
func WithEndpointResolver(awsResolver aws.EndpointResolver, fallbackResolver EndpointResolver) EndpointResolver
WithEndpointResolver returns an EndpointResolver that first delegates endpoint resolution to the awsResolver. If awsResolver returns aws.EndpointNotFoundError error, the resolver will use the the provided fallbackResolver for resolution. awsResolver and fallbackResolver must not be nil
type EndpointResolverFunc ¶
type EndpointResolverFunc func(region string, options ResolverOptions) (aws.Endpoint, error)
EndpointResolverFunc is a helper utility that wraps a function so it satisfies the EndpointResolver interface. This is useful when you want to add additional endpoint resolving logic, or stub out specific endpoints with custom values.
func (EndpointResolverFunc) ResolveEndpoint ¶
func (fn EndpointResolverFunc) ResolveEndpoint(region string, options ResolverOptions) (endpoint aws.Endpoint, err error)
type GetSubscriptionStateInput ¶
type GetSubscriptionStateInput struct { }
type GetSubscriptionStateOutput ¶
type GetSubscriptionStateOutput struct { // The status of the subscription. SubscriptionState types.SubscriptionState // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type HTTPSignerV4 ¶
type ListAttacksInput ¶
type ListAttacksInput struct { // The ListAttacksRequest.NextMarker value from a previous call to // ListAttacksRequest. Pass null if this is the first call. NextToken *string // The ARN (Amazon Resource Name) of the resource that was attacked. If this is // left blank, all applicable resources for this account will be included. ResourceArns []*string // The end of the time period for the attacks. This is a timestamp type. The sample // request above indicates a number type because the default used by WAF is Unix // time in seconds. However any valid timestamp format // (http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types) // is allowed. EndTime *types.TimeRange // The maximum number of AttackSummary () objects to be returned. If this is left // blank, the first 20 results will be returned. This is a maximum value; it is // possible that AWS WAF will return the results in smaller batches. That is, the // number of AttackSummary () objects returned could be less than MaxResults, even // if there are still more AttackSummary () objects yet to return. If there are // more AttackSummary () objects to return, AWS WAF will always also return a // NextToken. MaxResults *int32 // The start of the time period for the attacks. This is a timestamp type. The // sample request above indicates a number type because the default used by WAF is // Unix time in seconds. However any valid timestamp format // (http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types) // is allowed. StartTime *types.TimeRange }
type ListAttacksOutput ¶
type ListAttacksOutput struct { // The token returned by a previous call to indicate that there is more data // available. If not null, more results are available. Pass this value for the // NextMarker parameter in a subsequent call to ListAttacks to retrieve the next // set of items. AWS WAF might return the list of AttackSummary () objects in // batches smaller than the number specified by MaxResults. If there are more // AttackSummary () objects to return, AWS WAF will always also return a NextToken. NextToken *string // The attack information for the specified time range. AttackSummaries []*types.AttackSummary // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListProtectionsInput ¶
type ListProtectionsInput struct { // The ListProtectionsRequest.NextToken value from a previous call to // ListProtections. Pass null if this is the first call. NextToken *string // The maximum number of Protection () objects to be returned. If this is left // blank the first 20 results will be returned. This is a maximum value; it is // possible that AWS WAF will return the results in smaller batches. That is, the // number of Protection () objects returned could be less than MaxResults, even if // there are still more Protection () objects yet to return. If there are more // Protection () objects to return, AWS WAF will always also return a NextToken. MaxResults *int32 }
type ListProtectionsOutput ¶
type ListProtectionsOutput struct { // If you specify a value for MaxResults and you have more Protections than the // value of MaxResults, AWS Shield Advanced returns a NextToken value in the // response that allows you to list another group of Protections. For the second // and subsequent ListProtections requests, specify the value of NextToken from the // previous response to get information about another batch of Protections. AWS WAF // might return the list of Protection () objects in batches smaller than the // number specified by MaxResults. If there are more Protection () objects to // return, AWS WAF will always also return a NextToken. NextToken *string // The array of enabled Protection () objects. Protections []*types.Protection // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type Options ¶
type Options struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // The credentials object to use when signing requests. Credentials aws.CredentialsProvider // The endpoint options to be used when attempting to resolve an endpoint. EndpointOptions ResolverOptions // The service endpoint resolver. EndpointResolver EndpointResolver // Signature Version 4 (SigV4) Signer HTTPSignerV4 HTTPSignerV4 // The region to send requests to. (Required) Region string // Retryer guides how HTTP requests should be retried in case of recoverable // failures. When nil the API client will use a default retryer. Retryer retry.Retryer // The HTTP client to invoke API calls with. Defaults to client's default HTTP // implementation if nil. HTTPClient HTTPClient }
func (Options) GetCredentials ¶
func (o Options) GetCredentials() aws.CredentialsProvider
func (Options) GetEndpointOptions ¶
func (o Options) GetEndpointOptions() ResolverOptions
func (Options) GetEndpointResolver ¶
func (o Options) GetEndpointResolver() EndpointResolver
func (Options) GetHTTPSignerV4 ¶
func (o Options) GetHTTPSignerV4() HTTPSignerV4
func (Options) GetRetryer ¶
type ResolveEndpoint ¶
type ResolveEndpoint struct { Resolver EndpointResolver Options ResolverOptions }
func (*ResolveEndpoint) HandleSerialize ¶
func (m *ResolveEndpoint) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) ( out middleware.SerializeOutput, metadata middleware.Metadata, err error, )
func (*ResolveEndpoint) ID ¶
func (*ResolveEndpoint) ID() string
type ResolveEndpointMiddlewareOptions ¶
type ResolveEndpointMiddlewareOptions interface { GetEndpointResolver() EndpointResolver GetEndpointOptions() ResolverOptions }
type ResolverOptions ¶
type ResolverOptions = internalendpoints.Options
ResolverOptions is the service endpoint resolver options
type UpdateEmergencyContactSettingsInput ¶
type UpdateEmergencyContactSettingsInput struct { // A list of email addresses and phone numbers that the DDoS Response Team (DRT) // can use to contact you if you have proactive engagement enabled, for escalations // to the DRT and to initiate proactive customer support. If you have proactive // engagement enabled, the contact list must include at least one phone number. EmergencyContactList []*types.EmergencyContact }
type UpdateEmergencyContactSettingsOutput ¶
type UpdateEmergencyContactSettingsOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdateSubscriptionInput ¶
type UpdateSubscriptionInput struct { // When you initally create a subscription, AutoRenew is set to ENABLED. If // ENABLED, the subscription will be automatically renewed at the end of the // existing subscription period. You can change this by submitting an // UpdateSubscription request. If the UpdateSubscription request does not included // a value for AutoRenew, the existing value for AutoRenew remains unchanged. AutoRenew types.AutoRenew }
type UpdateSubscriptionOutput ¶
type UpdateSubscriptionOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
Source Files
¶
- api_client.go
- api_op_AssociateDRTLogBucket.go
- api_op_AssociateDRTRole.go
- api_op_AssociateHealthCheck.go
- api_op_AssociateProactiveEngagementDetails.go
- api_op_CreateProtection.go
- api_op_CreateSubscription.go
- api_op_DeleteProtection.go
- api_op_DeleteSubscription.go
- api_op_DescribeAttack.go
- api_op_DescribeDRTAccess.go
- api_op_DescribeEmergencyContactSettings.go
- api_op_DescribeProtection.go
- api_op_DescribeSubscription.go
- api_op_DisableProactiveEngagement.go
- api_op_DisassociateDRTLogBucket.go
- api_op_DisassociateDRTRole.go
- api_op_DisassociateHealthCheck.go
- api_op_EnableProactiveEngagement.go
- api_op_GetSubscriptionState.go
- api_op_ListAttacks.go
- api_op_ListProtections.go
- api_op_UpdateEmergencyContactSettings.go
- api_op_UpdateSubscription.go
- deserializers.go
- endpoints.go
- serializers.go
- validators.go