/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.shield; import javax.annotation.Generated; import com.amazonaws.services.shield.model.*; /** * Interface for accessing AWS Shield asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.shield.AbstractAWSShieldAsync} instead. *
*
*
* This is the Shield Advanced API Reference. This guide is for developers who need detailed information about * the Shield Advanced API actions, data types, and errors. For detailed information about WAF and Shield Advanced * features and an overview of how to use the WAF and Shield Advanced APIs, see the WAF and Shield Developer Guide. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AWSShieldAsync extends AWSShield { /** ** Authorizes the Shield Response Team (SRT) to access the specified Amazon S3 bucket containing log data such as * Application Load Balancer access logs, CloudFront logs, or logs from third party sources. You can associate up to * 10 Amazon S3 buckets with your subscription. *
*
* To use the services of the SRT and make an AssociateDRTLogBucket
request, you must be subscribed to
* the Business Support plan or the Enterprise Support plan.
*
* Authorizes the Shield Response Team (SRT) to access the specified Amazon S3 bucket containing log data such as * Application Load Balancer access logs, CloudFront logs, or logs from third party sources. You can associate up to * 10 Amazon S3 buckets with your subscription. *
*
* To use the services of the SRT and make an AssociateDRTLogBucket
request, you must be subscribed to
* the Business Support plan or the Enterprise Support plan.
*
* Authorizes the Shield Response Team (SRT) using the specified role, to access your Amazon Web Services account to * assist with DDoS attack mitigation during potential attacks. This enables the SRT to inspect your WAF * configuration and create or update 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
managed policy to the role that you'll specify in the request. You can
* access this policy in the IAM console at AWSShieldDRTAccessPolicy. For more information see Adding and
* removing IAM identity permissions. The role must also trust the service principal
* drt.shield.amazonaws.com
. For more information, see IAM JSON
* policy elements: Principal.
*
* The SRT will have access only to your WAF and Shield resources. By submitting this request, you authorize the SRT * to inspect your WAF and Shield configuration and create and update WAF rules and web ACLs on your behalf. The SRT * takes these actions only if explicitly authorized by you. *
*
* You must have the iam:PassRole
permission to make an AssociateDRTRole
request. For more
* information, see Granting a
* user permissions to pass a role to an Amazon Web Services service.
*
* To use the services of the SRT and make an AssociateDRTRole
request, you must be subscribed to the
* Business Support plan or the Enterprise Support plan.
*
* Authorizes the Shield Response Team (SRT) using the specified role, to access your Amazon Web Services account to * assist with DDoS attack mitigation during potential attacks. This enables the SRT to inspect your WAF * configuration and create or update 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
managed policy to the role that you'll specify in the request. You can
* access this policy in the IAM console at AWSShieldDRTAccessPolicy. For more information see Adding and
* removing IAM identity permissions. The role must also trust the service principal
* drt.shield.amazonaws.com
. For more information, see IAM JSON
* policy elements: Principal.
*
* The SRT will have access only to your WAF and Shield resources. By submitting this request, you authorize the SRT * to inspect your WAF and Shield configuration and create and update WAF rules and web ACLs on your behalf. The SRT * takes these actions only if explicitly authorized by you. *
*
* You must have the iam:PassRole
permission to make an AssociateDRTRole
request. For more
* information, see Granting a
* user permissions to pass a role to an Amazon Web Services service.
*
* To use the services of the SRT and make an AssociateDRTRole
request, you must be subscribed to the
* Business Support plan or the Enterprise Support plan.
*
* Adds health-based detection to the Shield Advanced protection for a resource. Shield Advanced health-based * detection uses the health of your Amazon Web Services resource to improve responsiveness and accuracy in attack * detection and response. *
** 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 in the WAF Developer Guide. *
* * @param associateHealthCheckRequest * @return A Java Future containing the result of the AssociateHealthCheck operation returned by the service. * @sample AWSShieldAsync.AssociateHealthCheck * @see AWS * API Documentation */ java.util.concurrent.Future* Adds health-based detection to the Shield Advanced protection for a resource. Shield Advanced health-based * detection uses the health of your Amazon Web Services resource to improve responsiveness and accuracy in attack * detection and response. *
** 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 in the WAF Developer Guide. *
* * @param associateHealthCheckRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AssociateHealthCheck operation returned by the service. * @sample AWSShieldAsyncHandler.AssociateHealthCheck * @see AWS * API Documentation */ java.util.concurrent.Future* Initializes proactive engagement and sets the list of contacts for the Shield Response Team (SRT) 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 SRT can use to contact you for * escalations to the SRT 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.
*
* Initializes proactive engagement and sets the list of contacts for the Shield Response Team (SRT) 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 SRT can use to contact you for * escalations to the SRT 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.
*
* Enables Shield Advanced for a specific Amazon Web Services resource. The resource can be an Amazon CloudFront * distribution, Amazon Route 53 hosted zone, Global Accelerator standard accelerator, Elastic IP Address, * Application Load Balancer, or a Classic Load Balancer. You can protect Amazon EC2 instances and Network Load * Balancers by association with protected Amazon EC2 Elastic IP addresses. *
*
* You can add protection to only a single resource with each CreateProtection
request. You can add
* protection to multiple resources at once through the Shield Advanced console at https://console.aws.amazon.com/wafv2/shieldv2#/. For
* more information see Getting Started with
* Shield Advanced and Adding Shield Advanced
* protection to Amazon Web Services resources.
*
* Enables Shield Advanced for a specific Amazon Web Services resource. The resource can be an Amazon CloudFront * distribution, Amazon Route 53 hosted zone, Global Accelerator standard accelerator, Elastic IP Address, * Application Load Balancer, or a Classic Load Balancer. You can protect Amazon EC2 instances and Network Load * Balancers by association with protected Amazon EC2 Elastic IP addresses. *
*
* You can add protection to only a single resource with each CreateProtection
request. You can add
* protection to multiple resources at once through the Shield Advanced console at https://console.aws.amazon.com/wafv2/shieldv2#/. For
* more information see Getting Started with
* Shield Advanced and Adding Shield Advanced
* protection to Amazon Web Services resources.
*
* Creates a grouping of protected resources so they can be handled as a collective. This resource grouping improves * the accuracy of detection and reduces false positives. *
* * @param createProtectionGroupRequest * @return A Java Future containing the result of the CreateProtectionGroup operation returned by the service. * @sample AWSShieldAsync.CreateProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Creates a grouping of protected resources so they can be handled as a collective. This resource grouping improves * the accuracy of detection and reduces false positives. *
* * @param createProtectionGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateProtectionGroup operation returned by the service. * @sample AWSShieldAsyncHandler.CreateProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Activates Shield Advanced for an account. *
** For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against * the organization's payer account, regardless of whether the payer account itself is subscribed. *
*
* When you initially 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 UpdateSubscription
request.
*
* Activates Shield Advanced for an account. *
** For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against * the organization's payer account, regardless of whether the payer account itself is subscribed. *
*
* When you initially 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 UpdateSubscription
request.
*
* Deletes an Shield Advanced Protection. *
* * @param deleteProtectionRequest * @return A Java Future containing the result of the DeleteProtection operation returned by the service. * @sample AWSShieldAsync.DeleteProtection * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes an Shield Advanced Protection. *
* * @param deleteProtectionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteProtection operation returned by the service. * @sample AWSShieldAsyncHandler.DeleteProtection * @see AWS API * Documentation */ java.util.concurrent.Future* Removes the specified protection group. *
* * @param deleteProtectionGroupRequest * @return A Java Future containing the result of the DeleteProtectionGroup operation returned by the service. * @sample AWSShieldAsync.DeleteProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Removes the specified protection group. *
* * @param deleteProtectionGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteProtectionGroup operation returned by the service. * @sample AWSShieldAsyncHandler.DeleteProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Removes Shield Advanced from an account. Shield Advanced requires a 1-year subscription commitment. You cannot * delete a subscription prior to the completion of that commitment. *
* * @param deleteSubscriptionRequest * @return A Java Future containing the result of the DeleteSubscription operation returned by the service. * @sample AWSShieldAsync.DeleteSubscription * @see AWS API * Documentation */ @Deprecated java.util.concurrent.Future* Removes Shield Advanced from an account. Shield Advanced requires a 1-year subscription commitment. You cannot * delete a subscription prior to the completion of that commitment. *
* * @param deleteSubscriptionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteSubscription operation returned by the service. * @sample AWSShieldAsyncHandler.DeleteSubscription * @see AWS API * Documentation */ @Deprecated java.util.concurrent.Future* Describes the details of a DDoS attack. *
* * @param describeAttackRequest * @return A Java Future containing the result of the DescribeAttack operation returned by the service. * @sample AWSShieldAsync.DescribeAttack * @see AWS API * Documentation */ java.util.concurrent.Future* Describes the details of a DDoS attack. *
* * @param describeAttackRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeAttack operation returned by the service. * @sample AWSShieldAsyncHandler.DescribeAttack * @see AWS API * Documentation */ java.util.concurrent.Future* Provides information about the number and type of attacks Shield has detected in the last year for all resources * that belong to your account, regardless of whether you've defined Shield protections for them. This operation is * available to Shield customers as well as to Shield Advanced customers. *
*
* The operation returns data for the time range of midnight UTC, one year ago, to midnight UTC, today. For example,
* if the current time is 2020-10-26 15:39:32 PDT
, equal to 2020-10-26 22:39:32 UTC
, then
* the time range for the attack data returned is from 2019-10-26 00:00:00 UTC
to
* 2020-10-26 00:00:00 UTC
.
*
* The time range indicates the period covered by the attack statistics data items. *
* * @param describeAttackStatisticsRequest * @return A Java Future containing the result of the DescribeAttackStatistics operation returned by the service. * @sample AWSShieldAsync.DescribeAttackStatistics * @see AWS API Documentation */ java.util.concurrent.Future* Provides information about the number and type of attacks Shield has detected in the last year for all resources * that belong to your account, regardless of whether you've defined Shield protections for them. This operation is * available to Shield customers as well as to Shield Advanced customers. *
*
* The operation returns data for the time range of midnight UTC, one year ago, to midnight UTC, today. For example,
* if the current time is 2020-10-26 15:39:32 PDT
, equal to 2020-10-26 22:39:32 UTC
, then
* the time range for the attack data returned is from 2019-10-26 00:00:00 UTC
to
* 2020-10-26 00:00:00 UTC
.
*
* The time range indicates the period covered by the attack statistics data items. *
* * @param describeAttackStatisticsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeAttackStatistics operation returned by the service. * @sample AWSShieldAsyncHandler.DescribeAttackStatistics * @see AWS API Documentation */ java.util.concurrent.Future* Returns the current role and list of Amazon S3 log buckets used by the Shield Response Team (SRT) to access your * Amazon Web Services account while assisting with attack mitigation. *
* * @param describeDRTAccessRequest * @return A Java Future containing the result of the DescribeDRTAccess operation returned by the service. * @sample AWSShieldAsync.DescribeDRTAccess * @see AWS API * Documentation */ java.util.concurrent.Future* Returns the current role and list of Amazon S3 log buckets used by the Shield Response Team (SRT) to access your * Amazon Web Services account while assisting with attack mitigation. *
* * @param describeDRTAccessRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeDRTAccess operation returned by the service. * @sample AWSShieldAsyncHandler.DescribeDRTAccess * @see AWS API * Documentation */ java.util.concurrent.Future* A list of email addresses and phone numbers that the Shield Response Team (SRT) can use to contact you if you * have proactive engagement enabled, for escalations to the SRT and to initiate proactive customer support. *
* * @param describeEmergencyContactSettingsRequest * @return A Java Future containing the result of the DescribeEmergencyContactSettings operation returned by the * service. * @sample AWSShieldAsync.DescribeEmergencyContactSettings * @see AWS API Documentation */ java.util.concurrent.Future* A list of email addresses and phone numbers that the Shield Response Team (SRT) can use to contact you if you * have proactive engagement enabled, for escalations to the SRT and to initiate proactive customer support. *
* * @param describeEmergencyContactSettingsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeEmergencyContactSettings operation returned by the * service. * @sample AWSShieldAsyncHandler.DescribeEmergencyContactSettings * @see AWS API Documentation */ java.util.concurrent.Future* Lists the details of a Protection object. *
* * @param describeProtectionRequest * @return A Java Future containing the result of the DescribeProtection operation returned by the service. * @sample AWSShieldAsync.DescribeProtection * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the details of a Protection object. *
* * @param describeProtectionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeProtection operation returned by the service. * @sample AWSShieldAsyncHandler.DescribeProtection * @see AWS API * Documentation */ java.util.concurrent.Future* Returns the specification for the specified protection group. *
* * @param describeProtectionGroupRequest * @return A Java Future containing the result of the DescribeProtectionGroup operation returned by the service. * @sample AWSShieldAsync.DescribeProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Returns the specification for the specified protection group. *
* * @param describeProtectionGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeProtectionGroup operation returned by the service. * @sample AWSShieldAsyncHandler.DescribeProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Provides details about the Shield Advanced subscription for an account. *
* * @param describeSubscriptionRequest * @return A Java Future containing the result of the DescribeSubscription operation returned by the service. * @sample AWSShieldAsync.DescribeSubscription * @see AWS * API Documentation */ java.util.concurrent.Future* Provides details about the Shield Advanced subscription for an account. *
* * @param describeSubscriptionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeSubscription operation returned by the service. * @sample AWSShieldAsyncHandler.DescribeSubscription * @see AWS * API Documentation */ java.util.concurrent.Future* Disable the Shield Advanced automatic application layer DDoS mitigation feature for the protected resource. This * stops Shield Advanced from creating, verifying, and applying WAF rules for attacks that it detects for the * resource. *
* * @param disableApplicationLayerAutomaticResponseRequest * @return A Java Future containing the result of the DisableApplicationLayerAutomaticResponse operation returned by * the service. * @sample AWSShieldAsync.DisableApplicationLayerAutomaticResponse * @see AWS API Documentation */ java.util.concurrent.Future* Disable the Shield Advanced automatic application layer DDoS mitigation feature for the protected resource. This * stops Shield Advanced from creating, verifying, and applying WAF rules for attacks that it detects for the * resource. *
* * @param disableApplicationLayerAutomaticResponseRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisableApplicationLayerAutomaticResponse operation returned by * the service. * @sample AWSShieldAsyncHandler.DisableApplicationLayerAutomaticResponse * @see AWS API Documentation */ java.util.concurrent.Future* Removes authorization from the Shield Response Team (SRT) to notify contacts about escalations to the SRT and to * initiate proactive customer support. *
* * @param disableProactiveEngagementRequest * @return A Java Future containing the result of the DisableProactiveEngagement operation returned by the service. * @sample AWSShieldAsync.DisableProactiveEngagement * @see AWS API Documentation */ java.util.concurrent.Future* Removes authorization from the Shield Response Team (SRT) to notify contacts about escalations to the SRT and to * initiate proactive customer support. *
* * @param disableProactiveEngagementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisableProactiveEngagement operation returned by the service. * @sample AWSShieldAsyncHandler.DisableProactiveEngagement * @see AWS API Documentation */ java.util.concurrent.Future* Removes the Shield Response Team's (SRT) access to the specified Amazon S3 bucket containing the logs that you * shared previously. *
* * @param disassociateDRTLogBucketRequest * @return A Java Future containing the result of the DisassociateDRTLogBucket operation returned by the service. * @sample AWSShieldAsync.DisassociateDRTLogBucket * @see AWS API Documentation */ java.util.concurrent.Future* Removes the Shield Response Team's (SRT) access to the specified Amazon S3 bucket containing the logs that you * shared previously. *
* * @param disassociateDRTLogBucketRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisassociateDRTLogBucket operation returned by the service. * @sample AWSShieldAsyncHandler.DisassociateDRTLogBucket * @see AWS API Documentation */ java.util.concurrent.Future* Removes the Shield Response Team's (SRT) access to your Amazon Web Services account. *
* * @param disassociateDRTRoleRequest * @return A Java Future containing the result of the DisassociateDRTRole operation returned by the service. * @sample AWSShieldAsync.DisassociateDRTRole * @see AWS API * Documentation */ java.util.concurrent.Future* Removes the Shield Response Team's (SRT) access to your Amazon Web Services account. *
* * @param disassociateDRTRoleRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisassociateDRTRole operation returned by the service. * @sample AWSShieldAsyncHandler.DisassociateDRTRole * @see AWS API * Documentation */ java.util.concurrent.Future* Removes health-based detection from the Shield Advanced protection for a resource. Shield Advanced health-based * detection uses the health of your Amazon Web Services resource to improve responsiveness and accuracy in attack * detection and response. *
** 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 in the WAF Developer Guide. *
* * @param disassociateHealthCheckRequest * @return A Java Future containing the result of the DisassociateHealthCheck operation returned by the service. * @sample AWSShieldAsync.DisassociateHealthCheck * @see AWS * API Documentation */ java.util.concurrent.Future* Removes health-based detection from the Shield Advanced protection for a resource. Shield Advanced health-based * detection uses the health of your Amazon Web Services resource to improve responsiveness and accuracy in attack * detection and response. *
** 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 in the WAF Developer Guide. *
* * @param disassociateHealthCheckRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisassociateHealthCheck operation returned by the service. * @sample AWSShieldAsyncHandler.DisassociateHealthCheck * @see AWS * API Documentation */ java.util.concurrent.Future* Enable the Shield Advanced automatic application layer DDoS mitigation for the protected resource. *
** This feature is available for Amazon CloudFront distributions and Application Load Balancers only. *
** This causes Shield Advanced to create, verify, and apply WAF rules for DDoS attacks that it detects for the * resource. Shield Advanced applies the rules in a Shield rule group inside the web ACL that you've associated with * the resource. For information about how automatic mitigation works and the requirements for using it, see Shield * Advanced automatic application layer DDoS mitigation. *
** Don't use this action to make changes to automatic mitigation settings when it's already enabled for a resource. * Instead, use UpdateApplicationLayerAutomaticResponse. *
** To use this feature, you must associate a web ACL with the protected resource. The web ACL must be created using * the latest version of WAF (v2). You can associate the web ACL through the Shield Advanced console at https://console.aws.amazon.com/wafv2/shieldv2#/. For * more information, see Getting Started with * Shield Advanced. You can also associate the web ACL to the resource through the WAF console or the WAF API, * but you must manage Shield Advanced automatic mitigation through Shield Advanced. For information about WAF, see * WAF Developer Guide. *
* * @param enableApplicationLayerAutomaticResponseRequest * @return A Java Future containing the result of the EnableApplicationLayerAutomaticResponse operation returned by * the service. * @sample AWSShieldAsync.EnableApplicationLayerAutomaticResponse * @see AWS API Documentation */ java.util.concurrent.Future* Enable the Shield Advanced automatic application layer DDoS mitigation for the protected resource. *
** This feature is available for Amazon CloudFront distributions and Application Load Balancers only. *
** This causes Shield Advanced to create, verify, and apply WAF rules for DDoS attacks that it detects for the * resource. Shield Advanced applies the rules in a Shield rule group inside the web ACL that you've associated with * the resource. For information about how automatic mitigation works and the requirements for using it, see Shield * Advanced automatic application layer DDoS mitigation. *
** Don't use this action to make changes to automatic mitigation settings when it's already enabled for a resource. * Instead, use UpdateApplicationLayerAutomaticResponse. *
** To use this feature, you must associate a web ACL with the protected resource. The web ACL must be created using * the latest version of WAF (v2). You can associate the web ACL through the Shield Advanced console at https://console.aws.amazon.com/wafv2/shieldv2#/. For * more information, see Getting Started with * Shield Advanced. You can also associate the web ACL to the resource through the WAF console or the WAF API, * but you must manage Shield Advanced automatic mitigation through Shield Advanced. For information about WAF, see * WAF Developer Guide. *
* * @param enableApplicationLayerAutomaticResponseRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the EnableApplicationLayerAutomaticResponse operation returned by * the service. * @sample AWSShieldAsyncHandler.EnableApplicationLayerAutomaticResponse * @see AWS API Documentation */ java.util.concurrent.Future* Authorizes the Shield Response Team (SRT) to use email and phone to notify contacts about escalations to the SRT * and to initiate proactive customer support. *
* * @param enableProactiveEngagementRequest * @return A Java Future containing the result of the EnableProactiveEngagement operation returned by the service. * @sample AWSShieldAsync.EnableProactiveEngagement * @see AWS API Documentation */ java.util.concurrent.Future* Authorizes the Shield Response Team (SRT) to use email and phone to notify contacts about escalations to the SRT * and to initiate proactive customer support. *
* * @param enableProactiveEngagementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the EnableProactiveEngagement operation returned by the service. * @sample AWSShieldAsyncHandler.EnableProactiveEngagement * @see AWS API Documentation */ java.util.concurrent.Future
* Returns the SubscriptionState
, either Active
or Inactive
.
*
* Returns the SubscriptionState
, either Active
or Inactive
.
*
* Returns all ongoing DDoS attacks or all DDoS attacks during a specified time period. *
* * @param listAttacksRequest * @return A Java Future containing the result of the ListAttacks operation returned by the service. * @sample AWSShieldAsync.ListAttacks * @see AWS API * Documentation */ java.util.concurrent.Future* Returns all ongoing DDoS attacks or all DDoS attacks during a specified time period. *
* * @param listAttacksRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListAttacks operation returned by the service. * @sample AWSShieldAsyncHandler.ListAttacks * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves ProtectionGroup objects for the account. You can retrieve all protection groups or you can * provide filtering criteria and retrieve just the subset of protection groups that match the criteria. *
* * @param listProtectionGroupsRequest * @return A Java Future containing the result of the ListProtectionGroups operation returned by the service. * @sample AWSShieldAsync.ListProtectionGroups * @see AWS * API Documentation */ java.util.concurrent.Future* Retrieves ProtectionGroup objects for the account. You can retrieve all protection groups or you can * provide filtering criteria and retrieve just the subset of protection groups that match the criteria. *
* * @param listProtectionGroupsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListProtectionGroups operation returned by the service. * @sample AWSShieldAsyncHandler.ListProtectionGroups * @see AWS * API Documentation */ java.util.concurrent.Future* Retrieves Protection objects for the account. You can retrieve all protections or you can provide * filtering criteria and retrieve just the subset of protections that match the criteria. *
* * @param listProtectionsRequest * @return A Java Future containing the result of the ListProtections operation returned by the service. * @sample AWSShieldAsync.ListProtections * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves Protection objects for the account. You can retrieve all protections or you can provide * filtering criteria and retrieve just the subset of protections that match the criteria. *
* * @param listProtectionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListProtections operation returned by the service. * @sample AWSShieldAsyncHandler.ListProtections * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the resources that are included in the protection group. *
* * @param listResourcesInProtectionGroupRequest * @return A Java Future containing the result of the ListResourcesInProtectionGroup operation returned by the * service. * @sample AWSShieldAsync.ListResourcesInProtectionGroup * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves the resources that are included in the protection group. *
* * @param listResourcesInProtectionGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListResourcesInProtectionGroup operation returned by the * service. * @sample AWSShieldAsyncHandler.ListResourcesInProtectionGroup * @see AWS API Documentation */ java.util.concurrent.Future* Gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in Shield. *
* * @param listTagsForResourceRequest * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AWSShieldAsync.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* Gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in Shield. *
* * @param listTagsForResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AWSShieldAsyncHandler.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* Adds or updates tags for a resource in Shield. *
* * @param tagResourceRequest * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AWSShieldAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Adds or updates tags for a resource in Shield. *
* * @param tagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AWSShieldAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Removes tags from a resource in Shield. *
* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AWSShieldAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Removes tags from a resource in Shield. *
* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AWSShieldAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an existing Shield Advanced automatic application layer DDoS mitigation configuration for the specified * resource. *
* * @param updateApplicationLayerAutomaticResponseRequest * @return A Java Future containing the result of the UpdateApplicationLayerAutomaticResponse operation returned by * the service. * @sample AWSShieldAsync.UpdateApplicationLayerAutomaticResponse * @see AWS API Documentation */ java.util.concurrent.Future* Updates an existing Shield Advanced automatic application layer DDoS mitigation configuration for the specified * resource. *
* * @param updateApplicationLayerAutomaticResponseRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateApplicationLayerAutomaticResponse operation returned by * the service. * @sample AWSShieldAsyncHandler.UpdateApplicationLayerAutomaticResponse * @see AWS API Documentation */ java.util.concurrent.Future* Updates the details of the list of email addresses and phone numbers that the Shield Response Team (SRT) can use * to contact you if you have proactive engagement enabled, for escalations to the SRT and to initiate proactive * customer support. *
* * @param updateEmergencyContactSettingsRequest * @return A Java Future containing the result of the UpdateEmergencyContactSettings operation returned by the * service. * @sample AWSShieldAsync.UpdateEmergencyContactSettings * @see AWS API Documentation */ java.util.concurrent.Future* Updates the details of the list of email addresses and phone numbers that the Shield Response Team (SRT) can use * to contact you if you have proactive engagement enabled, for escalations to the SRT and to initiate proactive * customer support. *
* * @param updateEmergencyContactSettingsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateEmergencyContactSettings operation returned by the * service. * @sample AWSShieldAsyncHandler.UpdateEmergencyContactSettings * @see AWS API Documentation */ java.util.concurrent.Future* Updates an existing protection group. A protection group is a grouping of protected resources so they can be * handled as a collective. This resource grouping improves the accuracy of detection and reduces false positives. *
* * @param updateProtectionGroupRequest * @return A Java Future containing the result of the UpdateProtectionGroup operation returned by the service. * @sample AWSShieldAsync.UpdateProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Updates an existing protection group. A protection group is a grouping of protected resources so they can be * handled as a collective. This resource grouping improves the accuracy of detection and reduces false positives. *
* * @param updateProtectionGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateProtectionGroup operation returned by the service. * @sample AWSShieldAsyncHandler.UpdateProtectionGroup * @see AWS * API Documentation */ java.util.concurrent.Future* Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty * parameters are not updated. *
** For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against * the organization's payer account, regardless of whether the payer account itself is subscribed. *
** Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty * parameters are not updated. *
** For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against * the organization's payer account, regardless of whether the payer account itself is subscribed. *
*