Resource: DataExchange
A data exchange is a container that lets you share data. Along with the descriptive information about the data exchange, it contains listings that reference shared datasets.
JSON representation |
---|
{ "name": string, "displayName": string, "description": string, "primaryContact": string, "documentation": string, "listingCount": integer, "icon": string, "sharingEnvironmentConfig": { object ( |
Fields | |
---|---|
name |
Output only. The resource name of the data exchange. e.g. |
displayName |
Required. Human-readable display name of the data exchange. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and must not start or end with spaces. Default value is an empty string. Max length: 63 bytes. |
description |
Optional. Description of the data exchange. The description must not contain Unicode non-characters as well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes. |
primaryContact |
Optional. Email or URL of the primary point of contact of the data exchange. Max Length: 1000 bytes. |
documentation |
Optional. Documentation describing the data exchange. |
listingCount |
Output only. Number of listings contained in the data exchange. |
icon |
Optional. Base64 encoded image representing the data exchange. Max Size: 3.0MiB Expected image dimensions are 512x512 pixels, however the API only performs validation on size of the encoded data. Note: For byte fields, the content of the fields are base64-encoded (which increases the size of the data by 33-36%) when using JSON on the wire. A base64-encoded string. |
sharingEnvironmentConfig |
Optional. Configurable data sharing environment option for a data exchange. |
discoveryType |
Optional. Type of discovery on the discovery page for all the listings under this exchange. Updating this field also updates (overwrites) the discoveryType field for all the listings under this exchange. |
SharingEnvironmentConfig
Sharing environment is a behavior model for sharing data within a data exchange. This option is configurable for a data exchange.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field
|
|
defaultExchangeConfig |
Default Analytics Hub data exchange, used for secured data sharing. |
dcrExchangeConfig |
Data Clean Room (DCR), used for privacy-safe and secured data sharing. |
DefaultExchangeConfig
This type has no fields.
Default Analytics Hub data exchange, used for secured data sharing.
DcrExchangeConfig
Data Clean Room (DCR), used for privacy-safe and secured data sharing.
JSON representation |
---|
{ "singleSelectedResourceSharingRestriction": boolean, "singleLinkedDatasetPerCleanroom": boolean } |
Fields | |
---|---|
singleSelectedResourceSharingRestriction |
Output only. If True, this DCR restricts the contributors to sharing only a single resource in a Listing. And no two resources should have the same IDs. So if a contributor adds a view with a conflicting name, the CreateListing API will reject the request. if False, the data contributor can publish an entire dataset (as before). This is not configurable, and by default, all new DCRs will have the restriction set to True. |
singleLinkedDatasetPerCleanroom |
Output only. If True, when subscribing to this DCR, it will create only one linked dataset containing all resources shared within the cleanroom. If False, when subscribing to this DCR, it will create 1 linked dataset per listing. This is not configurable, and by default, all new DCRs will have the restriction set to True. |
Methods |
|
---|---|
|
Creates a new data exchange. |
|
Deletes an existing data exchange. |
|
Gets the details of a data exchange. |
|
Gets the IAM policy. |
|
Lists all data exchanges in a given project and location. |
|
Lists all subscriptions on a given Data Exchange or Listing. |
|
Updates an existing data exchange. |
|
Sets the IAM policy. |
|
Creates a Subscription to a Data Exchange. |
|
Returns the permissions that a caller has. |