Google Cloud Storage v1 API - Class UrlSigner.PostPolicy (4.11.0)

public sealed class UrlSigner.PostPolicy

Reference documentation and code samples for the Google Cloud Storage v1 API class UrlSigner.PostPolicy.

Represents an unsigned post policy. It needs to be signed with Sign(PostPolicy, Options) before it is used to enforced policies when posting objects via form.

Inheritance

object > UrlSigner.PostPolicy

Namespace

Google.Cloud.Storage.V1

Assembly

Google.Cloud.Storage.V1.dll

Properties

Bucket

public string Bucket { get; }

Bucket name explicitly enforced by this policy, that is, if SetField<TElement, TValue>(TElement, TValue) has been called for BucketName. Otherwise, for instance, if the bucket name was specified as part of the Key element, this will return null.

Property Value
Type Description
string

Fields

public IReadOnlyDictionary<string, object> Fields { get; }

Collection of fields as defined by this policy. Post requests enforced by this policy should set, for each pair in this sequence, the given element to the exact given value.

Property Value
Type Description
IReadOnlyDictionarystringobject

Methods

ForBucketAndKey(string, string)

public static UrlSigner.PostPolicy ForBucketAndKey(string bucketName, string exactKeyValue)

Creates a new UrlSigner.PostPolicy instance which sets the BucketName and requires an exact match for the UrlSigner.Key element.

Parameters
Name Description
bucketName string

The exact value for the bucket name.

exactKeyValue string

The value to match against. Must not be null.

Returns
Type Description
UrlSignerPostPolicy

A new UrlSigner.PostPolicy instance.

ForBucketAndKeyStartsWith(string, string)

public static UrlSigner.PostPolicy ForBucketAndKeyStartsWith(string bucketName, string keyPrefix)

Creates a new UrlSigner.PostPolicy instance which sets the BucketName and requires a starts-with match for the Key element.

Parameters
Name Description
bucketName string

The exact value for the bucket name.

keyPrefix string

The value to match against. Must not be null.

Returns
Type Description
UrlSignerPostPolicy

A new UrlSigner.PostPolicy instance.

SetCustomField<TValue>(PostPolicyCustomElement, string, TValue, Func<TValue, object>)

public void SetCustomField<TValue>(UrlSigner.PostPolicyCustomElement element, string elementName, TValue value, Func<TValue, object> valueToObject = null)

Sets a required field value for element of name elementName. If any condition existed on this instance for element of name elementName it will be overriden with this required field value.

Parameters
Name Description
element UrlSignerPostPolicyCustomElement

The element for which to set a required field value.

elementName string

The custom element name.

value TValue

The value to set the element to.

valueToObject Funcobject

The function to convert value to the representation which with it should be included in the policy. May be null in which case TValue ToString() will be used.

Type Parameter
Name Description
TValue

The type of the value to set the element to.

SetCustomStartsWith(PostPolicyCustomElement, string, string)

public void SetCustomStartsWith(UrlSigner.PostPolicyCustomElement element, string elementName, string prefix)

Sets a starts-with condition for element of name elementName. If any condition existed on this instance for element of name elementName it will be overriden with this starts-with condition.

Parameters
Name Description
element UrlSignerPostPolicyCustomElement

The element for which to set an starts-with condition.

elementName string

The custom element name.

prefix string

The prefix to validate against.

SetField<TValue>(PostPolicyStandardElement, TValue)

public void SetField<TValue>(UrlSigner.PostPolicyStandardElement element, TValue value)

Sets a required field value for element. If any condition existed on this instance for element it will be overriden with this required field value.

Parameters
Name Description
element UrlSignerPostPolicyStandardElement

The element for which to set a required field value.

value TValue

The value to set the element to.

Type Parameter
Name Description
TValue

The type of the value to set the element to.

SetRange<TValue>(PostPolicyStandardElement, TValue, TValue)

public void SetRange<TValue>(UrlSigner.PostPolicyStandardElement element, TValue min, TValue max) where TValue : IComparable

Sets a range condition for element. If any condition existed on this instance for element it will be overriden with this range condition.

Parameters
Name Description
element UrlSignerPostPolicyStandardElement

The element for which to set a range condition.

min TValue

The range lower bound.

max TValue

The range upper bound.

Type Parameter
Name Description
TValue

The type of the values defining the range.

SetStartsWith(PostPolicyStandardElement, string)

public void SetStartsWith(UrlSigner.PostPolicyStandardElement element, string prefix)

Sets a starts-with condition for element. If any condition existed on this instance for element it will be overriden with this starts-with condition.

Parameters
Name Description
element UrlSignerPostPolicyStandardElement

The element for which to set an starts-with condition.

prefix string

The prefix to validate against.