AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginAssociateDRTLogBucket and EndAssociateDRTLogBucket.

Namespace: Amazon.Shield
Assembly: AWSSDK.Shield.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<AssociateDRTLogBucketResponse> AssociateDRTLogBucketAsync(
         AssociateDRTLogBucketRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.Shield.Model.AssociateDRTLogBucketRequest

Container for the necessary parameters to execute the AssociateDRTLogBucket service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the AssociateDRTLogBucket service method, as returned by Shield.

Exceptions

ExceptionCondition
AccessDeniedForDependencyException In order to grant the necessary access to the Shield Response Team (SRT) the user submitting the request must have the iam:PassRole permission. This error indicates the user did not have the appropriate permissions. For more information, see Granting a User Permissions to Pass a Role to an Amazon Web Services Service.
InternalErrorException Exception that indicates that a problem occurred with the service infrastructure. You can retry the request.
InvalidOperationException Exception that indicates that the operation would not cause any change to occur.
InvalidParameterException Exception that indicates that the parameters passed to the API are invalid. If available, this exception includes details in additional properties.
LimitsExceededException Exception that indicates that the operation would exceed a limit.
NoAssociatedRoleException The ARN of the role that you specified does not exist.
OptimisticLockException Exception that indicates that the resource state has been modified by another client. Retrieve the resource and then retry your request.
ResourceNotFoundException Exception indicating the specified resource does not exist. If available, this exception includes details in additional properties.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also