Google Cloud Storage v1 API - Class UrlSigner.PostPolicy (4.6.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
TypeDescription
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
TypeDescription
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
NameDescription
bucketNamestring

The exact value for the bucket name.

exactKeyValuestring

The value to match against. Must not be null.

Returns
TypeDescription
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
NameDescription
bucketNamestring

The exact value for the bucket name.

keyPrefixstring

The value to match against. Must not be null.

Returns
TypeDescription
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
NameDescription
elementUrlSignerPostPolicyCustomElement

The element for which to set a required field value.

elementNamestring

The custom element name.

valueTValue

The value to set the element to.

valueToObjectFuncobject

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
NameDescription
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
NameDescription
elementUrlSignerPostPolicyCustomElement

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

elementNamestring

The custom element name.

prefixstring

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
NameDescription
elementUrlSignerPostPolicyStandardElement

The element for which to set a required field value.

valueTValue

The value to set the element to.

Type Parameter
NameDescription
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
NameDescription
elementUrlSignerPostPolicyStandardElement

The element for which to set a range condition.

minTValue

The range lower bound.

maxTValue

The range upper bound.

Type Parameter
NameDescription
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
NameDescription
elementUrlSignerPostPolicyStandardElement

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

prefixstring

The prefix to validate against.