Class: Aws::S3::Waiters::BucketNotExists

Inherits:
Object
  • Object
show all
Defined in:
lib/aws-sdk-s3/waiters.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options) ⇒ BucketNotExists

Returns a new instance of BucketNotExists.

Parameters:

  • options (Hash)

Options Hash (options):

  • :client (required, Client)
  • :max_attempts (Integer) — default: 20
  • :delay (Integer) — default: 5
  • :before_attempt (Proc)
  • :before_wait (Proc) 


139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
 
# File 'lib/aws-sdk-s3/waiters.rb', line 139

def initialize(options)
  @client = options.fetch(:client)
  @waiter = Aws::Waiters::Waiter.new({
    max_attempts: 20,
    delay: 5,
    poller: Aws::Waiters::Poller.new(
      operation_name: :head_bucket,
      acceptors: [{
        "expected" => 404,
        "matcher" => "status",
        "state" => "success"
      }]
    )
  }.merge(options))
end

Instance Attribute Details

#waiter ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



162
163
164
 
# File 'lib/aws-sdk-s3/waiters.rb', line 162

def waiter
  @waiter
end

Instance Method Details

#wait(params = {}) ⇒ Struct

Returns an empty response.

Options Hash (params):

  • :bucket (required, String) —

    The bucket name.

    When using this API with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this operation with an access point through the AWS SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see [Using Access Points] in the *Amazon Simple Storage Service Developer Guide*.

    When using this API with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using this operation using S3 on Outposts through the AWS SDKs, you provide the Outposts bucket ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see [Using S3 on Outposts] in the *Amazon Simple Storage Service Developer Guide*.

    [1]: docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html [2]: docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html

  • :expected_bucket_owner (String) —

    The account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP ‘403 (Access Denied)` error.

Returns:

  • (Struct) —

    Returns an empty response.



157
158
159
 
# File 'lib/aws-sdk-s3/waiters.rb', line 157

def wait(params = {})
  @waiter.wait(client: @client, params: params)
end