import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * A Bigquery Analytics Hub Data Exchange subscription * * > **Warning:** This resource is in beta, and should be used with the terraform-provider-google-beta provider. * See Provider Versions for more details on beta resources. * * To get more information about DataExchangeSubscription, see: * * * [API documentation](https://cloud.google.com/bigquery/docs/reference/analytics-hub/rest/v1/projects.locations.subscriptions) * * How-to Guides * * [Official Documentation](https://cloud.google.com/bigquery/docs/analytics-hub-introduction) * * > **Note:** When importing the resource with `pulumi import`, provide the destination/subscriber's project and location * in the format projects/{{subscriber_project}}/locations/{{subscriber_location}}/subscriptions/{{subscription_id}} * ## Example Usage * * ### Bigquery Analyticshub Dataexchange Subscription Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const subscription = new gcp.bigqueryanalyticshub.DataExchange("subscription", { * location: "us", * dataExchangeId: "my_test_dataexchange", * displayName: "my_test_dataexchange", * description: "Test Data Exchange", * sharingEnvironmentConfig: { * dcrExchangeConfig: {}, * }, * }); * const subscriptionDataset = new gcp.bigquery.Dataset("subscription", { * datasetId: "listing_src_dataset", * friendlyName: "listing_src_dataset", * description: "Dataset for Listing", * location: "us", * }); * const subscriptionTable = new gcp.bigquery.Table("subscription", { * deletionProtection: false, * tableId: "listing_src_table", * datasetId: subscriptionDataset.datasetId, * schema: `[ * { * \\"name\\": \\"name\\", * \\"type\\": \\"STRING\\", * \\"mode\\": \\"NULLABLE\\" * }, * { * \\"name\\": \\"post_abbr\\", * \\"type\\": \\"STRING\\", * \\"mode\\": \\"NULLABLE\\" * }, * { * \\"name\\": \\"date\\", * \\"type\\": \\"DATE\\", * \\"mode\\": \\"NULLABLE\\" * } * ] * `, * }); * const subscriptionListing = new gcp.bigqueryanalyticshub.Listing("subscription", { * location: "us", * dataExchangeId: subscription.dataExchangeId, * listingId: "my_test_listing", * displayName: "my_test_listing", * description: "Test Listing", * restrictedExportConfig: { * enabled: true, * }, * bigqueryDataset: { * dataset: subscriptionDataset.id, * selectedResources: [{ * table: subscriptionTable.id, * }], * }, * }); * const subscriptionDataExchangeSubscription = new gcp.bigqueryanalyticshub.DataExchangeSubscription("subscription", { * project: subscriptionDataset.project, * location: "us", * dataExchangeProject: subscription.project, * dataExchangeLocation: subscription.location, * dataExchangeId: subscription.dataExchangeId, * subscriptionId: "my_subscription_id", * subscriberContact: "testuser@example.com", * destinationDataset: { * location: "us", * datasetReference: { * projectId: subscriptionDataset.project, * datasetId: "subscribed_dest_dataset", * }, * friendlyName: "Subscribed Destination Dataset", * description: "Destination dataset for subscription", * labels: { * environment: "development", * owner: "team-a", * }, * }, * refreshPolicy: "ON_READ", * }); * ``` * * ## Import * * DataExchangeSubscription can be imported using any of these accepted formats: * * * `projects/{{project}}/locations/{{location}}/subscriptions/{{subscription_id}}` * * `{{project}}/{{location}}/{{subscription_id}}` * * `{{location}}/{{subscription_id}}` * * When using the `pulumi import` command, DataExchangeSubscription can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:bigqueryanalyticshub/dataExchangeSubscription:DataExchangeSubscription default projects/{{project}}/locations/{{location}}/subscriptions/{{subscription_id}} * $ pulumi import gcp:bigqueryanalyticshub/dataExchangeSubscription:DataExchangeSubscription default {{project}}/{{location}}/{{subscription_id}} * $ pulumi import gcp:bigqueryanalyticshub/dataExchangeSubscription:DataExchangeSubscription default {{location}}/{{subscription_id}} * ``` */ export declare class DataExchangeSubscription extends pulumi.CustomResource { /** * Get an existing DataExchangeSubscription resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: DataExchangeSubscriptionState, opts?: pulumi.CustomResourceOptions): DataExchangeSubscription; /** * Returns true if the given object is an instance of DataExchangeSubscription. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is DataExchangeSubscription; /** * Timestamp when the subscription was created. */ readonly creationTime: pulumi.Output; /** * Output only. Resource name of the source Data Exchange. e.g. projects/123/locations/us/dataExchanges/456 */ readonly dataExchange: pulumi.Output; /** * The ID of the data exchange. Must contain only Unicode letters, numbers (0-9), underscores (_). Should not use characters that require URL-escaping, or characters outside of ASCII, spaces. */ readonly dataExchangeId: pulumi.Output; /** * The name of the location of the Data Exchange. */ readonly dataExchangeLocation: pulumi.Output; /** * The ID of the Google Cloud project where the Data Exchange is located. */ readonly dataExchangeProject: pulumi.Output; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ readonly deletionPolicy: pulumi.Output; /** * BigQuery destination dataset to create for the subscriber. * Structure is documented below. */ readonly destinationDataset: pulumi.Output; /** * Timestamp when the subscription was last modified. */ readonly lastModifyTime: pulumi.Output; /** * 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 Data Exchange subscriptions, this map may contain multiple entries if the Data Exchange has multiple listings. * Structure is documented below. */ readonly linkedDatasetMaps: pulumi.Output; /** * Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE. * Structure is documented below. */ readonly linkedResources: pulumi.Output; /** * The geographic location where the Subscription (and its linked dataset) should reside. * This is the subscriber's desired location for the created resources. * See https://cloud.google.com/bigquery/docs/locations for supported locations. */ readonly location: pulumi.Output; /** * Output only. By default, false. If true, the Subscriber agreed to the email sharing mandate that is enabled for DataExchange/Listing. */ readonly logLinkedDatasetQueryUserEmail: pulumi.Output; /** * The resource name of the subscription. e.g. "projects/myproject/locations/us/subscriptions/123" */ readonly name: pulumi.Output; /** * Display name of the project of this subscription. */ readonly organizationDisplayName: pulumi.Output; /** * Organization of the project this subscription belongs to. */ readonly organizationId: pulumi.Output; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * Controls when the subscription is automatically refreshed by the provider. * * `ON_READ`: Default value if not specified. The subscription will be refreshed every time Terraform performs a read operation (e.g., `pulumi preview`, `pulumi up`, `terraform refresh`). This ensures the state is always up-to-date. * * `ON_STALE`: The subscription will only be refreshed when its reported `state` (an output-only field from the API) is `STATE_STALE` during a Terraform read operation. * * `NEVER`: The provider will not automatically refresh the subscription. */ readonly refreshPolicy: pulumi.Output; /** * Listing shared asset type. */ readonly resourceType: pulumi.Output; /** * Current state of the subscription. */ readonly state: pulumi.Output; /** * Email of the subscriber. */ readonly subscriberContact: pulumi.Output; /** * Name of the subscription to create. */ readonly subscriptionId: pulumi.Output; /** * Create a DataExchangeSubscription resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: DataExchangeSubscriptionArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering DataExchangeSubscription resources. */ export interface DataExchangeSubscriptionState { /** * Timestamp when the subscription was created. */ creationTime?: pulumi.Input; /** * Output only. Resource name of the source Data Exchange. e.g. projects/123/locations/us/dataExchanges/456 */ dataExchange?: pulumi.Input; /** * The ID of the data exchange. Must contain only Unicode letters, numbers (0-9), underscores (_). Should not use characters that require URL-escaping, or characters outside of ASCII, spaces. */ dataExchangeId?: pulumi.Input; /** * The name of the location of the Data Exchange. */ dataExchangeLocation?: pulumi.Input; /** * The ID of the Google Cloud project where the Data Exchange is located. */ dataExchangeProject?: pulumi.Input; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ deletionPolicy?: pulumi.Input; /** * BigQuery destination dataset to create for the subscriber. * Structure is documented below. */ destinationDataset?: pulumi.Input; /** * Timestamp when the subscription was last modified. */ lastModifyTime?: pulumi.Input; /** * 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 Data Exchange subscriptions, this map may contain multiple entries if the Data Exchange has multiple listings. * Structure is documented below. */ linkedDatasetMaps?: pulumi.Input[] | undefined>; /** * Output only. Linked resources created in the subscription. Only contains values if state = STATE_ACTIVE. * Structure is documented below. */ linkedResources?: pulumi.Input[] | undefined>; /** * The geographic location where the Subscription (and its linked dataset) should reside. * This is the subscriber's desired location for the created resources. * See https://cloud.google.com/bigquery/docs/locations for supported locations. */ location?: pulumi.Input; /** * Output only. By default, false. If true, the Subscriber agreed to the email sharing mandate that is enabled for DataExchange/Listing. */ logLinkedDatasetQueryUserEmail?: pulumi.Input; /** * The resource name of the subscription. e.g. "projects/myproject/locations/us/subscriptions/123" */ name?: pulumi.Input; /** * Display name of the project of this subscription. */ organizationDisplayName?: pulumi.Input; /** * Organization of the project this subscription belongs to. */ organizationId?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * Controls when the subscription is automatically refreshed by the provider. * * `ON_READ`: Default value if not specified. The subscription will be refreshed every time Terraform performs a read operation (e.g., `pulumi preview`, `pulumi up`, `terraform refresh`). This ensures the state is always up-to-date. * * `ON_STALE`: The subscription will only be refreshed when its reported `state` (an output-only field from the API) is `STATE_STALE` during a Terraform read operation. * * `NEVER`: The provider will not automatically refresh the subscription. */ refreshPolicy?: pulumi.Input; /** * Listing shared asset type. */ resourceType?: pulumi.Input; /** * Current state of the subscription. */ state?: pulumi.Input; /** * Email of the subscriber. */ subscriberContact?: pulumi.Input; /** * Name of the subscription to create. */ subscriptionId?: pulumi.Input; } /** * The set of arguments for constructing a DataExchangeSubscription resource. */ export interface DataExchangeSubscriptionArgs { /** * The ID of the data exchange. Must contain only Unicode letters, numbers (0-9), underscores (_). Should not use characters that require URL-escaping, or characters outside of ASCII, spaces. */ dataExchangeId: pulumi.Input; /** * The name of the location of the Data Exchange. */ dataExchangeLocation: pulumi.Input; /** * The ID of the Google Cloud project where the Data Exchange is located. */ dataExchangeProject: pulumi.Input; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ deletionPolicy?: pulumi.Input; /** * BigQuery destination dataset to create for the subscriber. * Structure is documented below. */ destinationDataset?: pulumi.Input; /** * The geographic location where the Subscription (and its linked dataset) should reside. * This is the subscriber's desired location for the created resources. * See https://cloud.google.com/bigquery/docs/locations for supported locations. */ location: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * Controls when the subscription is automatically refreshed by the provider. * * `ON_READ`: Default value if not specified. The subscription will be refreshed every time Terraform performs a read operation (e.g., `pulumi preview`, `pulumi up`, `terraform refresh`). This ensures the state is always up-to-date. * * `ON_STALE`: The subscription will only be refreshed when its reported `state` (an output-only field from the API) is `STATE_STALE` during a Terraform read operation. * * `NEVER`: The provider will not automatically refresh the subscription. */ refreshPolicy?: pulumi.Input; /** * Email of the subscriber. */ subscriberContact?: pulumi.Input; /** * Name of the subscription to create. */ subscriptionId: pulumi.Input; } //# sourceMappingURL=dataExchangeSubscription.d.ts.map