REST Resource: projects.locations.datasets.consentStores.consents

Resource: Consent

Represents an end user's consent.

JSON representation
{ "name": string, "revisionId": string, "revisionCreateTime": string, "userId": string, "policies": [ { object(Policy) } ], "consentArtifact": string, "state": enum(State), "metadata": { string: string, ... }, // Union field expiration can be only one of the following: "expireTime": string, "ttl": string // End of list of possible types for union field expiration. }

Fields
name	string Resource name of the Consent, of the form projects/{projectId}/locations/{locationId}/datasets/{datasetId}/consentStores/{consentStoreId}/consents/{consentId}.
revisionId	string Output only. The revision ID of the consent. The format is an 8-character hexadecimal string. Refer to a specific revision of a Consent by appending @{revisionId} to the Consent's resource name.
revisionCreateTime	string(Timestamp format) Output only. The timestamp that the revision was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
userId	string Required. User's UUID provided by the client.
policies[]	object(Policy) Represents an end user's consent in terms of the resources that can be accessed and under what conditions.
consentArtifact	string Required. The resource name of the consent artifact that contains proof of the end user's consent, of the form projects/{projectId}/locations/{locationId}/datasets/{datasetId}/consentStores/{consentStoreId}/consentArtifacts/{consent_artifact_id}.
state	enum(State) Indicates the current state of this consent.
metadata	map (key: string, value: string) User-supplied key-value pairs used to organize consent resources. Metadata keys must: be between 1 and 63 characters long have a UTF-8 encoding of maximum 128 bytes begin with a letter consist of up to 63 characters including lowercase letters, numeric characters, underscores, and dashes Metadata values must be: - be between 1 and 63 characters long - have a UTF-8 encoding of maximum 128 bytes - consist of up to 63 characters including lowercase letters, numeric characters, underscores, and dashes No more than 64 metadata entries can be associated with a given consent. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Union field expiration. Allows setting expiration time for Consents. Expired consents are ignored in access determination methods such as [CheckDataAccess]. This value overrides the expiration duration configured for the consent store. expiration can be only one of the following:
expireTime	string(Timestamp format) Timestamp in UTC of when this consent is considered expired. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
ttl	string(Duration format) Input only. The time to live for this consent from when it is created. A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

Policy

Represents an end user's consent in terms of the resources that can be accessed and under what conditions.

JSON representation
{ "resourceAttributes": [ { object(Attribute) } ], "authorizationRule": { object(Expr) } }

Fields
resourceAttributes[]	object(Attribute) The data resources that this policy applies to. A data resource is a match if it matches all the attributes listed here.
authorizationRule	object(Expr) The request conditions to meet to grant access. In addition to any supported comparison operators, authorization rules may have IN operator as well as at most 10 logical operators that are limited to AND(&&), OR(||).

State

The state of the consent resource.

Enums
STATE_UNSPECIFIED	No state specified.
ACTIVE	The consent is active and is considered when evaluating user's consent on resources.
ARCHIVED	When a consent is updated, the current version is archived and a new one is created with active state.
REVOKED	A revoked consent is not considered when evaluating user's consent on resources.
DRAFT	A draft consent is not considered when evaluating user's consent on resources unless explicitly asked.
REJECTED	When a draft consent is rejected by end user, it should be stored back with rejected state. A rejected consent is not considered when evaluating user's consent on resources.

Methods
activate	Activates the latest revision of the specified Consent by committing a new revision with state updated to ACTIVE.
create	Creates a new Consent in the parent Consent store.
delete	Deletes the Consent and its revisions.
deleteRevision	Deletes the specified revision of a Consent.
get	Gets the specified revision of a Consent, or the latest revision if revision_id is not specified in the resource name.
list	Lists the Consent in the given Consent store, returning each consent's latest revision.
listRevisions	Lists the revisions of the given Consent in reverse chronological order.
patch	Updates the latest revision of the specified Consent by committing a new revision with the changes.
reject	Rejects the latest revision of the specified Consent by committing a new revision with state updated to REJECTED.
revoke	Revokes the latest revision of the specified Consent by committing a new revision with state updated to REVOKED.