REST Resource: projects.locations.instances.dataAccessScopes

Resource: DataAccessScope

A DataAccessScope is a boolean expression of data access labels used to restrict access to data for users.

JSON representation
{
  "name": string,
  "allowedDataAccessLabels": [
    {
      object (DataAccessLabelReference)
    }
  ],
  "deniedDataAccessLabels": [
    {
      object (DataAccessLabelReference)
    }
  ],
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "author": string,
  "lastEditor": string,
  "description": string,
  "allowAll": boolean
}
Fields
name

string

The unique full name of the data access scope. The name should comply with https://google.aip.dev/122 standards.

allowedDataAccessLabels[]

object (DataAccessLabelReference)

Optional. The allowed labels for the scope. Either allowAll or allowedDataAccessLabels needs to be provided. When provided, there has to be at least one label allowed for the scope to be valid. The logical operator for evaluation of the allowed labels is OR. E.g.: A customer with scope with allowed labels A and B will be able to see data with labeled with A or B or (A and B).

deniedDataAccessLabels[]

object (DataAccessLabelReference)

Optional. The denied labels for the scope. The logical operator for evaluation of the denied labels is AND. E.g.: A customer with scope with denied labels A and B won't be able to see data labeled with A and data labeled with B and data with labels A and B.

displayName

string

Output only. The name to be used for display to customers of the data access scope.

createTime

string (Timestamp format)

Output only. The time at which the data access scope was created.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. The time at which the data access scope was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

author

string

Output only. The user who created the data access scope.

lastEditor

string

Output only. The user who last updated the data access scope.

description

string

Optional. A description of the data access scope for a human reader.

allowAll

boolean

Optional. Whether or not the scope allows all labels, allowAll and allowedDataAccessLabels are mutually exclusive and one of them must be present. deniedDataAccessLabels can still be used along with allowAll. When combined with deniedDataAccessLabels, access will be granted to all data that doesn't have labels mentioned in deniedDataAccessLabels. E.g.: A customer with scope with denied labels A and B and allowAll will be able to see all data except data labeled with A and data labeled with B and data with labels A and B.

DataAccessLabelReference

Reference object to a data access label.

JSON representation
{
  "displayName": string,

  // Union field label can be only one of the following:
  "dataAccessLabel": string,
  "logType": string,
  "assetNamespace": string,
  "ingestionLabel": {
    object (IngestionLabel)
  }
  // End of list of possible types for union field label.
}
Fields
displayName

string

Output only. The display name of the label. Data access label and log types's name will match the display name of the resource. The asset namespace will match the namespace itself. The ingestion key value pair will match the key of the tuple.

Union field label. The unique identifier for the label. label can be only one of the following:
dataAccessLabel

string

The name of the data access label.

logType

string

The name of the log type.

assetNamespace

string

The asset namespace configured in the forwarder of the customer's events.

ingestionLabel

object (IngestionLabel)

The ingestion label configured in the forwarder of the customer's events.

IngestionLabel

Representation of an ingestion label type.

JSON representation
{
  "ingestionLabelKey": string,
  "ingestionLabelValue": string
}
Fields
ingestionLabelKey

string

Required. The key of the ingestion label. Always required.

ingestionLabelValue

string

Optional. The value of the ingestion label. Optional. An object with no provided value and some key provided would match against the given key and ANY value.

Methods

create

Creates a data access scope.

delete

Deletes a data access scope.

get

Retrieves an existing data access scope.

list

Lists all existing data access scopes for the customer.

patch

Updates a data access scope.