associate_drt_log_bucket ¶

associate_drt_log_bucket(
    log_bucket: LogBucket, *, config_overrides: Optional[ShieldClientConfig] = None
) -> AssociateDRTLogBucketResponse

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.

Parameters:

log_bucket (LogBucket) –

The Amazon S3 bucket that contains the logs that you want to share.

Raises:

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.
UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_shield/_services/shield.py

def associate_drt_log_bucket(
    self,
    log_bucket: "capo_shield.types.log_bucket.LogBucket",
    *,
    config_overrides: Optional[ShieldClientConfig] = None,
) -> "capo_shield.types.associate_drt_log_bucket_response.AssociateDRTLogBucketResponse":
    """<p>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.</p> <p>To use the services of the SRT and make an <code>AssociateDRTLogBucket</code> request, you must be subscribed to the <a href="http://aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="http://aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>

    Args:
        log_bucket: <p>The Amazon S3 bucket that contains the logs that you want to share.</p>

    Raises:
        capo_shield.errors.access_denied_for_dependency_exception.AccessDeniedForDependencyException: <p>In order to grant the necessary access to the Shield Response Team (SRT) the user submitting the request must have the <code>iam:PassRole</code> permission. This error indicates the user did not have the appropriate permissions. 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 Amazon Web Services Service</a>. </p>
        capo_shield.errors.internal_error_exception.InternalErrorException: <p>Exception that indicates that a problem occurred with the service infrastructure. You can retry the request.</p>
        capo_shield.errors.invalid_operation_exception.InvalidOperationException: <p>Exception that indicates that the operation would not cause any change to occur.</p>
        capo_shield.errors.invalid_parameter_exception.InvalidParameterException: <p>Exception that indicates that the parameters passed to the API are invalid. If available, this exception includes details in additional properties. </p>
        capo_shield.errors.limits_exceeded_exception.LimitsExceededException: <p>Exception that indicates that the operation would exceed a limit.</p>
        capo_shield.errors.no_associated_role_exception.NoAssociatedRoleException: <p>The ARN of the role that you specified does not exist.</p>
        capo_shield.errors.optimistic_lock_exception.OptimisticLockException: <p>Exception that indicates that the resource state has been modified by another client. Retrieve the resource and then retry your request.</p>
        capo_shield.errors.resource_not_found_exception.ResourceNotFoundException: <p>Exception indicating the specified resource does not exist. If available, this exception includes details in additional properties. </p>
        capo_shield.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_shield.types.associate_drt_log_bucket_request.AssociateDRTLogBucketRequest]",
    ) -> OperationResponse[
        "capo_shield.types.associate_drt_log_bucket_response.AssociateDRTLogBucketResponse"
    ]:
        import capo_shield._operations.aws_shield_20160616.associate_drt_log_bucket

        output, http_response = (
            capo_shield._operations.aws_shield_20160616.associate_drt_log_bucket.associate_drt_log_bucket(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("AssociateDRTLogBucket")
    )
    input_: capo_shield.types.associate_drt_log_bucket_request.AssociateDRTLogBucketRequest = {
        "log_bucket": log_bucket
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output