REST Resource: projects.locations.subscriptions

Resource: Subscription

A subscription represents a subscribers' access to a particular set of published data. It contains references to associated listings, data exchanges, and linked datasets.

JSON representation
{
  "name": string,
  "creationTime": string,
  "lastModifyTime": string,
  "organizationId": string,
  "organizationDisplayName": string,
  "state": enum (State),
  "linkedDatasetMap": {
    string: {
      object (LinkedResource)
    },
    ...
  },
  "subscriberContact": string,
  "linkedResources": [
    {
      object (LinkedResource)
    }
  ],
  "resourceType": enum (SharedResourceType),

  // Union field resource_name can be only one of the following:
  "listing": string,
  "dataExchange": string
  // End of list of possible types for union field resource_name.
}
Fields
name

string

Output only. The resource name of the subscription. e.g. projects/myproject/locations/US/subscriptions/123.

creationTime

string (Timestamp format)

Output only. Timestamp when the subscription 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".

lastModifyTime

string (Timestamp format)

Output only. Timestamp when the subscription was last modified.

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".

organizationId

string

Output only. Organization of the project this subscription belongs to.

organizationDisplayName

string

Output only. Display name of the project of this subscription.

state

enum (State)

Output only. Current state of the subscription.

linkedDatasetMap

map (key: string, value: object (LinkedResource))

Output only. Map of listing resource names to associated linked resource, e.g. projects/123/locations/US/dataExchanges/456/listings/789 -> projects/123/datasets/my_dataset

For listing-level subscriptions, this is a map of size 1. Only contains values if state == STATE_ACTIVE.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

subscriberContact

string

Output only. Email of the subscriber.

linkedResources[]

object (LinkedResource)

Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE.

resourceType

enum (SharedResourceType)

Output only. Listing shared asset type.

Union field resource_name.

resource_name can be only one of the following:

listing

string

Output only. Resource name of the source Listing. e.g. projects/123/locations/US/dataExchanges/456/listings/789

dataExchange

string

Output only. Resource name of the source Data Exchange. e.g. projects/123/locations/US/dataExchanges/456

Methods

delete

Deletes a subscription.

get

Gets the details of a Subscription.

getIamPolicy

Gets the IAM policy.

list

Lists all subscriptions in a given project and location.

refresh

Refreshes a Subscription to a Data Exchange.

revoke

Revokes a given subscription.

setIamPolicy

Sets the IAM policy.