Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://docs.aws.amazon.com/sdkforruby/api/Aws/S3/PresignedPost.html below:

PresignedPost — AWS SDK for Ruby V2

To generate a presigned post, you need AWS credentials, the region your bucket is in, and the name of your bucket. You can apply constraints to the post object as options to #initialize or by calling methods such as #key and #content_length_range.

The following two examples are equivalent.

post = Aws::S3::PresignedPost.new(creds, region, bucket, {
  key: '/uploaded/object/key',
  content_length_range: 0..1024,
  acl: 'public-read',
  metadata: {
    'original-filename' => '${filename}'
  }
})
post.fields

post = Aws::S3::PresignedPost.new(creds, region, bucket).
  key('/uploaded/object/key').
  content_length_range(0..1024).
  acl('public-read').
  metadata('original-filename' => '${filename}').
  fields

You can use a PresignedPost object to build an HTML form. It is recommended to use some helper to build the form tag and input tags that properly escapes values.

To upload a file to Amazon S3 using a browser, you need to create a post form. The #url method returns the value you should use as the form action.

<form action="<%= @post.url %>" method="post" enctype="multipart/form-data">
  ...
</form>

The follow attributes must be set on the form:

• action - This must be the #url.
• method - This must be post.
• enctype - This must be multipart/form-data.

The #fields method returns a hash of form fields to render inside the form. Typically these are rendered as hidden input fields.

<% @post.fields.each do |name, value| %>
  <input type="hidden" name="<%= name %>" value="<%= value %>"/>
<% end %>

Lastly, the form must have a file field with the name file.

<input type="file" name="file"/>

When you construct a PresignedPost, you must specify every form field name that will be posted by the browser. If you omit a form field sent by the browser, Amazon S3 will reject the request. You can specify accepted form field values three ways:

• Specify exactly what the value must be.
• Specify what value the field starts with.
• Specify the field may have any value.

You can specify that a form field must be a certain value. Simply pass an option like :content_type to the constructor, or call the associated method.

post = Aws::S3::PresignedPost.new(creds, region, bucket).
post.content_type('text/plain')

If any of the given values are changed by the user in the form, then Amazon S3 will reject the POST request.

You can specify prefix values for many of the POST form fields. To specify a required prefix, use the :<fieldname>_starts_with option or call the associated #<field_name>_starts_with method.

post = Aws::S3::PresignedPost.new(creds, region, bucket, {
  key_starts_with: '/images/',
  content_type_starts_with: 'image/',
  })

When using starts with, the form must contain a field where the user can specify the value. The PresignedPost will not add a value for these fields.

To white-list a form field to send any value, you can name that field with :allow_any or #allow_any.

post = Aws::S3::PresignedPost.new(creds, region, bucket, {
  key: 'object-key',
  allow_any: ['Filename'],
  })

You can add rules for metadata fields using :metadata, #metadata, :metadata_starts_with and #metadata_starts_with. Unlike other form fields, you pass a hash value to these options/methods:

post = Aws::S3::PresignedPost.new(creds, region, bucket).
  key('/fixed/key').
  metadata(foo: 'bar')

post.fields['x-amz-meta-foo']

The string ${filename} is automatically replaced with the name of the file provided by the user and is recognized by all form fields. It is not supported with starts_with conditions.

If the browser or client provides a full or partial path to the file, only the text following the last slash (/) or backslash () will be used (e.g., "C:\Program Files\directory1\file.txt" will be interpreted as "file.txt"). If no file or file name is provided, the variable is replaced with an empty string.

In the following example, we use ${filename} to store the original filename in the x-amz-meta- hash with the uploaded object.

post = Aws::S3::PresignedPost.new(creds, region, bucket, {
  key: '/fixed/key',
  metadata: {
    'original-filename': '${filename}'
  }
})

Specify the cannedl ACL (access control list) for the object. May be one of the following values:

• private
• public-read
• public-read-write
• authenticated-read
• bucket-owner-read
• bucket-owner-full-control

317

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 317

define_field(:acl, starts_with: true)

317

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 317

define_field(:acl, starts_with: true)

A list of form fields to white-list with any value.

247
248
249
250
251
252
253

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 247

def allow_any(*field_names)
  field_names.flatten.each do |field_name|
    @key_set = true if field_name.to_s == 'key'
    starts_with(field_name, '')
  end
  self
end

Specify caching behavior along the request/reply chain.

329

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 329

define_field(:cache_control, 'Cache-Control', starts_with: true)

329

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 329

define_field(:cache_control, 'Cache-Control', starts_with: true)

Specifies presentational information for the object.

354

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 354

define_field(:content_disposition, 'Content-Disposition', starts_with: true)

354

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 354

define_field(:content_disposition, 'Content-Disposition', starts_with: true)

Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

368

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 368

define_field(:content_encoding, 'Content-Encoding', starts_with: true)

368

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 368

define_field(:content_encoding, 'Content-Encoding', starts_with: true)

The minimum and maximum allowable size for the uploaded content.

390
391
392
393
394
395
396

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 390

def content_length_range(byte_range)
  min = byte_range.begin
  max = byte_range.end
  max -= 1 if byte_range.exclude_end?
  @conditions << ['content-length-range', min, max]
  self
end

A standard MIME type describing the format of the contents.

342

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 342

define_field(:content_type, 'Content-Type', starts_with: true)

342

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 342

define_field(:content_type, 'Content-Type', starts_with: true)

This does not affect the expiration of the presigned post signature.

The date and time at which the object is no longer cacheable.

376
377
378

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 376

def expires(time)
  with('Expires', time.httpdate)
end

383
384
385

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 383

def expires_starts_with(prefix)
  starts_with('Expires', prefix)
end

Returns A hash of fields to render in an HTML form as hidden input fields.

235
236
237
238
239
240
241
242

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 235

def fields
  check_required_values!
  datetime = Time.now.utc.strftime("%Y%m%dT%H%M%SZ")
  fields = @fields.dup
  fields.update('policy' => policy(datetime))
  fields.update(signature_fields(datetime))
  fields.update('x-amz-signature' => signature(datetime, fields['policy']))
end

The key to use for the uploaded object. Use can use ${filename} as a variable in the key. This will be replaced with the name of the file as provided by the user.

For example, if the key is given as /user/betty/${filename} and the file uploaded is named lolcatz.jpg, the resultant key will be /user/betty/lolcatz.jpg.

284
285
286
287

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 284

def key(key)
  @key_set = true
  with('key', key)
end

Specify a prefix the uploaded

293
294
295
296

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 293

def key_starts_with(prefix)
  @key_set = true
  starts_with('key', prefix)
end

Metadata hash to store with the uploaded object. Hash keys will be prefixed with "x-amz-meta-".

469
470
471
472
473
474

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 469

def metadata(hash)
  hash.each do |key, value|
    with("x-amz-meta-#{key}", value)
  end
  self
end

Specify allowable prefix for each key in the metadata hash.

480
481
482
483
484
485

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 480

def metadata_starts_with(hash)
  hash.each do |key, value|
    starts_with("x-amz-meta-#{key}", value)
  end
  self
end

Specifies a server-side encryption algorithm to use when Amazon S3 creates an object. Valid values include:

• aws:kms
• AES256

500

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 500

define_field(:server_side_encryption, 'x-amz-server-side-encryption')

If #server_side_encryption is called with the value of aws:kms, this method specifies the ID of the AWS Key Management Service (KMS) master encryption key to use for the object.

508

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 508

define_field(:server_side_encryption_aws_kms_key_id, 'x-amz-server-side-encryption-aws-kms-key-id')

Specifies the algorithm to use to when encrypting the object. Must be set to AES256 when using customer-provided encryption keys. Must also call #server_side_encryption_customer_key.

521

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 521

define_field(:server_side_encryption_customer_algorithm, 'x-amz-server-side-encryption-customer-algorithm')

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key.

You must also call #server_side_encryption_customer_algorithm.

532
533
534
535
536

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 532

def server_side_encryption_customer_key(value)
  field_name = 'x-amz-server-side-encryption-customer-key'
  with(field_name, base64(value))
  with(field_name + '-MD5', base64(OpenSSL::Digest::MD5.digest(value)))
end

541
542
543
544

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 541

def server_side_encryption_customer_key_starts_with(prefix)
  field_name = 'x-amz-server-side-encryption-customer-key'
  starts_with(field_name, prefix)
end

Storage class to use for storing the object. Defaults to STANDARD. Must be one of:

• STANDARD
• REDUCED_REDUNDANCY

You cannot specify GLACIER as the storage class. To transition objects to the GLACIER storage class you can use lifecycle configuration.

447

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 447

define_field(:storage_class, 'x-amz-storage-class')

The URL to which the client is redirected upon successful upload. If #success_action_redirect is not specified, Amazon S3 returns the empty document type specified by #success_action_status.

If Amazon S3 cannot interpret the URL, it acts as if the field is not present. If the upload fails, Amazon S3 displays an error and does not redirect the user to a URL.

415

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 415

define_field(:success_action_redirect, starts_with: true)

415

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 415

define_field(:success_action_redirect, starts_with: true)

The status code returned to the client upon successful upload if #success_action_redirect is not specified.

Accepts the values 200, 201, or 204 (default).

If the value is set to 200 or 204, Amazon S3 returns an empty document with a 200 or 204 status code. If the value is set to 201, Amazon S3 returns an XML document with a 201 status code.

If the value is not set or if it is set to an invalid value, Amazon S3 returns an empty document with a 204 status code.

433

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 433

define_field(:success_action_status)

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores this value in the object metadata.

The value must be prefixed by, "/", "http://" or "https://". The length of the value is limited to 2K.

463

# File 'aws-sdk-resources/lib/aws-sdk-resources/services/s3/presigned_post.rb', line 463

define_field(:website_redirect_location, 'x-amz-website-redirect-location')

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4