Google Cloud Storage v1 API - Class UrlSigner.PostPolicy (4.9.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

Inherited Members

object.GetHashCode()

object.GetType()

object.ToString()

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.