Cloud Storage API - Class Google::Cloud::Storage::PostObject (v1.44.0)

Reference documentation and code samples for the Cloud Storage API class Google::Cloud::Storage::PostObject.

PostObject represents the URL, fields, and values needed to upload objects via html forms.

Inherits

  • Object

Examples

Using Bucket#post_object (V2):

require "google/cloud/storage"

storage = Google::Cloud::Storage.new

bucket = storage.bucket "my-todo-app"
post = bucket.post_object "avatars/heidi/400x400.png"

post.url #=> "https://storage.googleapis.com"
post.fields[:key] #=> "my-todo-app/avatars/heidi/400x400.png"
post.fields[:GoogleAccessId] #=> "0123456789@gserviceaccount.com"
post.fields[:signature] #=> "ABC...XYZ="
post.fields[:policy] #=> "ABC...XYZ="

Using Bucket#generate_signed_post_policy_v4 (V4):

require "google/cloud/storage"

storage = Google::Cloud::Storage.new

bucket = storage.bucket "my-todo-app"
conditions = [["starts-with","$acl","public"]]
post = bucket.generate_signed_post_policy_v4 "avatars/heidi/400x400.png", expires: 10, conditions: conditions

post.url #=> "https://storage.googleapis.com/my-todo-app/"
post.fields["key"] #=> "my-todo-app/avatars/heidi/400x400.png"
post.fields["policy"] #=> "ABC...XYZ"
post.fields["x-goog-algorithm"] #=> "GOOG4-RSA-SHA256"
post.fields["x-goog-credential"] #=> "cred@pid.iam.gserviceaccount.com/20200123/auto/storage/goog4_request"
post.fields["x-goog-date"] #=> "20200128T000000Z"
post.fields["x-goog-signature"] #=> "4893a0e...cd82"

Methods

#fields

def fields() -> Hash

The input fields that must be included in the form. Each key/value pair should be set as an input tag's name and value.

Returns
  • (Hash) — the current value of fields

#url

def url() -> String

The URL the form must post to.

Returns
  • (String) — the current value of url