Class: Aws::S3::EndpointParameters

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-s3/endpoint_parameters.rb

Overview

Endpoint parameters used to influence endpoints per request.

Constant Summary collapse

PARAM_MAP =
{
  'Bucket' => :bucket,
  'Region' => :region,
  'UseFIPS' => :use_fips,
  'UseDualStack' => :use_dual_stack,
  'Endpoint' => :endpoint,
  'ForcePathStyle' => :force_path_style,
  'Accelerate' => :accelerate,
  'UseGlobalEndpoint' => :use_global_endpoint,
  'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
  'Key' => :key,
  'Prefix' => :prefix,
  'DisableAccessPoints' => :disable_access_points,
  'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
  'UseArnRegion' => :use_arn_region,
  'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
  'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ EndpointParameters

Returns a new instance of EndpointParameters.



135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 135

def initialize(options = {})
  self[:bucket] = options[:bucket]
  self[:region] = options[:region]
  self[:use_fips] = options[:use_fips]
  self[:use_fips] = false if self[:use_fips].nil?
  if self[:use_fips].nil?
    raise ArgumentError, "Missing required EndpointParameter: :use_fips"
  end
  self[:use_dual_stack] = options[:use_dual_stack]
  self[:use_dual_stack] = false if self[:use_dual_stack].nil?
  if self[:use_dual_stack].nil?
    raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
  end
  self[:endpoint] = options[:endpoint]
  self[:force_path_style] = options[:force_path_style]
  self[:force_path_style] = false if self[:force_path_style].nil?
  if self[:force_path_style].nil?
    raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
  end
  self[:accelerate] = options[:accelerate]
  self[:accelerate] = false if self[:accelerate].nil?
  if self[:accelerate].nil?
    raise ArgumentError, "Missing required EndpointParameter: :accelerate"
  end
  self[:use_global_endpoint] = options[:use_global_endpoint]
  self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
  if self[:use_global_endpoint].nil?
    raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
  end
  self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
  self[:key] = options[:key]
  self[:prefix] = options[:prefix]
  self[:disable_access_points] = options[:disable_access_points]
  self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
  self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
  if self[:disable_multi_region_access_points].nil?
    raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
  end
  self[:use_arn_region] = options[:use_arn_region]
  self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
  self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
end

Instance Attribute Details

#accelerateBoolean

When true, use S3 Accelerate. NOTE: Not all regions support S3 accelerate.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#bucketString

The S3 bucket used to send the request. This is an optional parameter that will be set automatically for operations that are scoped to an S3 bucket.

Returns:

  • (String)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#disable_access_pointsBoolean

Internal parameter to disable Access Point Buckets

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#disable_multi_region_access_pointsBoolean

Whether multi-region access points (MRAP) should be disabled.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#disable_s3_express_session_authBoolean

Parameter to indicate whether S3Express session auth should be disabled

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#endpointString

Override the endpoint used to send this request

Returns:

  • (String)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#force_path_styleBoolean

When true, force a path-style endpoint to be used where the bucket name is part of the path.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#keyString

The S3 Key used to send the request. This is an optional parameter that will be set automatically for operations that are scoped to an S3 Key.

Returns:

  • (String)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#prefixString

The S3 Prefix used to send the request. This is an optional parameter that will be set automatically for operations that are scoped to an S3 Prefix.

Returns:

  • (String)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#regionString

The AWS region used to dispatch the request.

Returns:

  • (String)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#use_arn_regionBoolean

When an Access Point ARN is provided and this flag is enabled, the SDK MUST use the ARN&#39;s region when constructing the endpoint instead of the client&#39;s configured region.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#use_dual_stackBoolean

When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#use_fipsBoolean

When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#use_global_endpointBoolean

Whether the global endpoint should be used, rather then the regional endpoint for us-east-1.

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#use_object_lambda_endpointBoolean

Internal parameter to use object lambda endpoint for an operation (eg: WriteGetObjectResponse)

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end

#use_s3_express_control_endpointBoolean

Internal parameter to indicate whether S3Express operation should use control plane, (ex. CreateBucket)

Returns:

  • (Boolean)


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# File 'lib/aws-sdk-s3/endpoint_parameters.rb', line 93

EndpointParameters = Struct.new(
  :bucket,
  :region,
  :use_fips,
  :use_dual_stack,
  :endpoint,
  :force_path_style,
  :accelerate,
  :use_global_endpoint,
  :use_object_lambda_endpoint,
  :key,
  :prefix,
  :disable_access_points,
  :disable_multi_region_access_points,
  :use_arn_region,
  :use_s3_express_control_endpoint,
  :disable_s3_express_session_auth,
) do
  include Aws::Structure

  # @api private
  class << self
    PARAM_MAP = {
      'Bucket' => :bucket,
      'Region' => :region,
      'UseFIPS' => :use_fips,
      'UseDualStack' => :use_dual_stack,
      'Endpoint' => :endpoint,
      'ForcePathStyle' => :force_path_style,
      'Accelerate' => :accelerate,
      'UseGlobalEndpoint' => :use_global_endpoint,
      'UseObjectLambdaEndpoint' => :use_object_lambda_endpoint,
      'Key' => :key,
      'Prefix' => :prefix,
      'DisableAccessPoints' => :disable_access_points,
      'DisableMultiRegionAccessPoints' => :disable_multi_region_access_points,
      'UseArnRegion' => :use_arn_region,
      'UseS3ExpressControlEndpoint' => :use_s3_express_control_endpoint,
      'DisableS3ExpressSessionAuth' => :disable_s3_express_session_auth,
    }.freeze
  end

  def initialize(options = {})
    self[:bucket] = options[:bucket]
    self[:region] = options[:region]
    self[:use_fips] = options[:use_fips]
    self[:use_fips] = false if self[:use_fips].nil?
    if self[:use_fips].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_fips"
    end
    self[:use_dual_stack] = options[:use_dual_stack]
    self[:use_dual_stack] = false if self[:use_dual_stack].nil?
    if self[:use_dual_stack].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
    end
    self[:endpoint] = options[:endpoint]
    self[:force_path_style] = options[:force_path_style]
    self[:force_path_style] = false if self[:force_path_style].nil?
    if self[:force_path_style].nil?
      raise ArgumentError, "Missing required EndpointParameter: :force_path_style"
    end
    self[:accelerate] = options[:accelerate]
    self[:accelerate] = false if self[:accelerate].nil?
    if self[:accelerate].nil?
      raise ArgumentError, "Missing required EndpointParameter: :accelerate"
    end
    self[:use_global_endpoint] = options[:use_global_endpoint]
    self[:use_global_endpoint] = false if self[:use_global_endpoint].nil?
    if self[:use_global_endpoint].nil?
      raise ArgumentError, "Missing required EndpointParameter: :use_global_endpoint"
    end
    self[:use_object_lambda_endpoint] = options[:use_object_lambda_endpoint]
    self[:key] = options[:key]
    self[:prefix] = options[:prefix]
    self[:disable_access_points] = options[:disable_access_points]
    self[:disable_multi_region_access_points] = options[:disable_multi_region_access_points]
    self[:disable_multi_region_access_points] = false if self[:disable_multi_region_access_points].nil?
    if self[:disable_multi_region_access_points].nil?
      raise ArgumentError, "Missing required EndpointParameter: :disable_multi_region_access_points"
    end
    self[:use_arn_region] = options[:use_arn_region]
    self[:use_s3_express_control_endpoint] = options[:use_s3_express_control_endpoint]
    self[:disable_s3_express_session_auth] = options[:disable_s3_express_session_auth]
  end
end