Data Catalog v1 API - Class DataCatalogClient (2.3.0)

public abstract class DataCatalogClient

Reference documentation and code samples for the Data Catalog v1 API class DataCatalogClient.

DataCatalog client wrapper, for convenient use.

Inheritance

object > DataCatalogClient

Inherited Members

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ToString()

Derived Types

DataCatalogClientImpl

Namespace

GoogleCloudGoogle.Cloud.DataCatalogV1

Assembly

Google.Cloud.DataCatalog.V1.dll

Remarks

Data Catalog API service allows you to discover, understand, and manage your data.

Properties

DefaultEndpoint

public static string DefaultEndpoint { get; }

The default endpoint for the DataCatalog service, which is a host of "datacatalog.googleapis.com" and a port of 443.

Property Value

Type	Description
string

DefaultScopes

public static IReadOnlyList<string> DefaultScopes { get; }

The default DataCatalog scopes.

Property Value

Type	Description
IReadOnlyListstring

Remarks

The default DataCatalog scopes are:

• https://www.googleapis.com/auth/cloud-platform

GrpcClient

public virtual DataCatalog.DataCatalogClient GrpcClient { get; }

The underlying gRPC DataCatalog client

Property Value

Type	Description
DataCatalogDataCatalogClient

IAMPolicyClient

public virtual IAMPolicyClient IAMPolicyClient { get; }

The IAMPolicyClient associated with this client.

Property Value

Type	Description
IAMPolicyClient

ImportEntriesOperationsClient

public virtual OperationsClient ImportEntriesOperationsClient { get; }

The long-running operations client for ImportEntries.

Property Value

Type	Description
OperationsClient

ReconcileTagsOperationsClient

public virtual OperationsClient ReconcileTagsOperationsClient { get; }

The long-running operations client for ReconcileTags.

Property Value

Type	Description
OperationsClient

ServiceMetadata

public static ServiceMetadata ServiceMetadata { get; }

The service metadata associated with this client type.

Property Value

Type	Description
ServiceMetadata

Methods

Create()

public static DataCatalogClient Create()

Synchronously creates a DataCatalogClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use DataCatalogClientBuilder.

Returns

Type	Description
DataCatalogClient	The created DataCatalogClient.

CreateAsync(CancellationToken)

public static Task<DataCatalogClient> CreateAsync(CancellationToken cancellationToken = default)

Asynchronously creates a DataCatalogClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use DataCatalogClientBuilder.

Parameter

Name	Description
cancellationToken	CancellationToken The CancellationToken to use while creating the client.

Returns

Type	Description
TaskDataCatalogClient	The task representing the created DataCatalogClient.

CreateEntry(CreateEntryRequest, CallSettings)

public virtual Entry CreateEntry(CreateEntryRequest request, CallSettings callSettings = null)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
request	CreateEntryRequest The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
Entry	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
CreateEntryRequest request = new CreateEntryRequest
{
    ParentAsEntryGroupName = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]"),
    Entry = new Entry(),
    EntryId = "",
};
// Make the request
Entry response = dataCatalogClient.CreateEntry(request);

CreateEntry(EntryGroupName, string, Entry, CallSettings)

public virtual Entry CreateEntry(EntryGroupName parent, string entryId, Entry entry, CallSettings callSettings = null)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
parent	EntryGroupName Required. The name of the entry group this entry belongs to. Note: The entry itself and its child resources might not be stored in the location specified in its name.
entryId	string Required. The ID of the entry to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores (_). The maximum size is 64 bytes when encoded in UTF-8.
entry	Entry Required. The entry to create.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
Entry	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
EntryGroupName parent = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]");
string entryId = "";
Entry entry = new Entry();
// Make the request
Entry response = dataCatalogClient.CreateEntry(parent, entryId, entry);

CreateEntry(string, string, Entry, CallSettings)

public virtual Entry CreateEntry(string parent, string entryId, Entry entry, CallSettings callSettings = null)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
parent	string Required. The name of the entry group this entry belongs to. Note: The entry itself and its child resources might not be stored in the location specified in its name.
entryId	string Required. The ID of the entry to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores (_). The maximum size is 64 bytes when encoded in UTF-8.
entry	Entry Required. The entry to create.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
Entry	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/entryGroups/[ENTRY_GROUP]";
string entryId = "";
Entry entry = new Entry();
// Make the request
Entry response = dataCatalogClient.CreateEntry(parent, entryId, entry);

CreateEntryAsync(CreateEntryRequest, CallSettings)

public virtual Task<Entry> CreateEntryAsync(CreateEntryRequest request, CallSettings callSettings = null)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
request	CreateEntryRequest The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
TaskEntry	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
CreateEntryRequest request = new CreateEntryRequest
{
    ParentAsEntryGroupName = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]"),
    Entry = new Entry(),
    EntryId = "",
};
// Make the request
Entry response = await dataCatalogClient.CreateEntryAsync(request);

CreateEntryAsync(CreateEntryRequest, CancellationToken)

public virtual Task<Entry> CreateEntryAsync(CreateEntryRequest request, CancellationToken cancellationToken)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
request	CreateEntryRequest The request object containing all of the parameters for the API call.
cancellationToken	CancellationToken A CancellationToken to use for this RPC.

Returns

Type	Description
TaskEntry	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
CreateEntryRequest request = new CreateEntryRequest
{
    ParentAsEntryGroupName = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]"),
    Entry = new Entry(),
    EntryId = "",
};
// Make the request
Entry response = await dataCatalogClient.CreateEntryAsync(request);

CreateEntryAsync(EntryGroupName, string, Entry, CallSettings)

public virtual Task<Entry> CreateEntryAsync(EntryGroupName parent, string entryId, Entry entry, CallSettings callSettings = null)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
parent	EntryGroupName Required. The name of the entry group this entry belongs to. Note: The entry itself and its child resources might not be stored in the location specified in its name.
entryId	string Required. The ID of the entry to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores (_). The maximum size is 64 bytes when encoded in UTF-8.
entry	Entry Required. The entry to create.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
TaskEntry	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
EntryGroupName parent = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]");
string entryId = "";
Entry entry = new Entry();
// Make the request
Entry response = await dataCatalogClient.CreateEntryAsync(parent, entryId, entry);

CreateEntryAsync(EntryGroupName, string, Entry, CancellationToken)

public virtual Task<Entry> CreateEntryAsync(EntryGroupName parent, string entryId, Entry entry, CancellationToken cancellationToken)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
parent	EntryGroupName Required. The name of the entry group this entry belongs to. Note: The entry itself and its child resources might not be stored in the location specified in its name.
entryId	string Required. The ID of the entry to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores (_). The maximum size is 64 bytes when encoded in UTF-8.
entry	Entry Required. The entry to create.
cancellationToken	CancellationToken A CancellationToken to use for this RPC.

Returns

Type	Description
TaskEntry	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
EntryGroupName parent = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]");
string entryId = "";
Entry entry = new Entry();
// Make the request
Entry response = await dataCatalogClient.CreateEntryAsync(parent, entryId, entry);

CreateEntryAsync(string, string, Entry, CallSettings)

public virtual Task<Entry> CreateEntryAsync(string parent, string entryId, Entry entry, CallSettings callSettings = null)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
parent	string Required. The name of the entry group this entry belongs to. Note: The entry itself and its child resources might not be stored in the location specified in its name.
entryId	string Required. The ID of the entry to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores (_). The maximum size is 64 bytes when encoded in UTF-8.
entry	Entry Required. The entry to create.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
TaskEntry	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/entryGroups/[ENTRY_GROUP]";
string entryId = "";
Entry entry = new Entry();
// Make the request
Entry response = await dataCatalogClient.CreateEntryAsync(parent, entryId, entry);

CreateEntryAsync(string, string, Entry, CancellationToken)

public virtual Task<Entry> CreateEntryAsync(string parent, string entryId, Entry entry, CancellationToken cancellationToken)

Creates an entry.

You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM', or custom types. Data Catalog automatically creates entries with other types during metadata ingestion from integrated systems.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

An entry group can have a maximum of 100,000 entries.

Parameters

Name	Description
parent	string Required. The name of the entry group this entry belongs to. Note: The entry itself and its child resources might not be stored in the location specified in its name.
entryId	string Required. The ID of the entry to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores (_). The maximum size is 64 bytes when encoded in UTF-8.
entry	Entry Required. The entry to create.
cancellationToken	CancellationToken A CancellationToken to use for this RPC.

Returns

Type	Description
TaskEntry	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/entryGroups/[ENTRY_GROUP]";
string entryId = "";
Entry entry = new Entry();
// Make the request
Entry response = await dataCatalogClient.CreateEntryAsync(parent, entryId, entry);

CreateEntryGroup(LocationName, string, EntryGroup, CallSettings)

public virtual EntryGroup CreateEntryGroup(LocationName parent, string entryGroupId, EntryGroup entryGroup, CallSettings callSettings = null)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
parent	LocationName Required. The names of the project and location that the new entry group belongs to. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
entryGroupId	string Required. The ID of the entry group to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
entryGroup	EntryGroup The entry group to create. Defaults to empty.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
EntryGroup	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
string entryGroupId = "";
EntryGroup entryGroup = new EntryGroup();
// Make the request
EntryGroup response = dataCatalogClient.CreateEntryGroup(parent, entryGroupId, entryGroup);

CreateEntryGroup(CreateEntryGroupRequest, CallSettings)

public virtual EntryGroup CreateEntryGroup(CreateEntryGroupRequest request, CallSettings callSettings = null)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
request	CreateEntryGroupRequest The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
EntryGroup	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
CreateEntryGroupRequest request = new CreateEntryGroupRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    EntryGroup = new EntryGroup(),
    EntryGroupId = "",
};
// Make the request
EntryGroup response = dataCatalogClient.CreateEntryGroup(request);

CreateEntryGroup(string, string, EntryGroup, CallSettings)

public virtual EntryGroup CreateEntryGroup(string parent, string entryGroupId, EntryGroup entryGroup, CallSettings callSettings = null)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
parent	string Required. The names of the project and location that the new entry group belongs to. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
entryGroupId	string Required. The ID of the entry group to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
entryGroup	EntryGroup The entry group to create. Defaults to empty.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
EntryGroup	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
string entryGroupId = "";
EntryGroup entryGroup = new EntryGroup();
// Make the request
EntryGroup response = dataCatalogClient.CreateEntryGroup(parent, entryGroupId, entryGroup);

CreateEntryGroupAsync(LocationName, string, EntryGroup, CallSettings)

public virtual Task<EntryGroup> CreateEntryGroupAsync(LocationName parent, string entryGroupId, EntryGroup entryGroup, CallSettings callSettings = null)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
parent	LocationName Required. The names of the project and location that the new entry group belongs to. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
entryGroupId	string Required. The ID of the entry group to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
entryGroup	EntryGroup The entry group to create. Defaults to empty.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
TaskEntryGroup	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
string entryGroupId = "";
EntryGroup entryGroup = new EntryGroup();
// Make the request
EntryGroup response = await dataCatalogClient.CreateEntryGroupAsync(parent, entryGroupId, entryGroup);

CreateEntryGroupAsync(LocationName, string, EntryGroup, CancellationToken)

public virtual Task<EntryGroup> CreateEntryGroupAsync(LocationName parent, string entryGroupId, EntryGroup entryGroup, CancellationToken cancellationToken)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
parent	LocationName Required. The names of the project and location that the new entry group belongs to. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
entryGroupId	string Required. The ID of the entry group to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
entryGroup	EntryGroup The entry group to create. Defaults to empty.
cancellationToken	CancellationToken A CancellationToken to use for this RPC.

Returns

Type	Description
TaskEntryGroup	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
string entryGroupId = "";
EntryGroup entryGroup = new EntryGroup();
// Make the request
EntryGroup response = await dataCatalogClient.CreateEntryGroupAsync(parent, entryGroupId, entryGroup);

CreateEntryGroupAsync(CreateEntryGroupRequest, CallSettings)

public virtual Task<EntryGroup> CreateEntryGroupAsync(CreateEntryGroupRequest request, CallSettings callSettings = null)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
request	CreateEntryGroupRequest The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
TaskEntryGroup	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
CreateEntryGroupRequest request = new CreateEntryGroupRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    EntryGroup = new EntryGroup(),
    EntryGroupId = "",
};
// Make the request
EntryGroup response = await dataCatalogClient.CreateEntryGroupAsync(request);

CreateEntryGroupAsync(CreateEntryGroupRequest, CancellationToken)

public virtual Task<EntryGroup> CreateEntryGroupAsync(CreateEntryGroupRequest request, CancellationToken cancellationToken)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
request	CreateEntryGroupRequest The request object containing all of the parameters for the API call.
cancellationToken	CancellationToken A CancellationToken to use for this RPC.

Returns

Type	Description
TaskEntryGroup	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
CreateEntryGroupRequest request = new CreateEntryGroupRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    EntryGroup = new EntryGroup(),
    EntryGroupId = "",
};
// Make the request
EntryGroup response = await dataCatalogClient.CreateEntryGroupAsync(request);

CreateEntryGroupAsync(string, string, EntryGroup, CallSettings)

public virtual Task<EntryGroup> CreateEntryGroupAsync(string parent, string entryGroupId, EntryGroup entryGroup, CallSettings callSettings = null)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
parent	string Required. The names of the project and location that the new entry group belongs to. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
entryGroupId	string Required. The ID of the entry group to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
entryGroup	EntryGroup The entry group to create. Defaults to empty.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
TaskEntryGroup	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
string entryGroupId = "";
EntryGroup entryGroup = new EntryGroup();
// Make the request
EntryGroup response = await dataCatalogClient.CreateEntryGroupAsync(parent, entryGroupId, entryGroup);

CreateEntryGroupAsync(string, string, EntryGroup, CancellationToken)

public virtual Task<EntryGroup> CreateEntryGroupAsync(string parent, string entryGroupId, EntryGroup entryGroup, CancellationToken cancellationToken)

Creates an entry group.

An entry group contains logically related entries together with Cloud Identity and Access Management policies. These policies specify users who can create, edit, and view entries within entry groups.

Data Catalog automatically creates entry groups with names that start with the @ symbol for the following resources:

• BigQuery entries (@bigquery)
• Pub/Sub topics (@pubsub)
• Dataproc Metastore services (@dataproc_metastore_{SERVICE_NAME_HASH})

You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the @ symbol, it is reserved for automatically created groups.

Entry groups, like entries, can be searched.

A maximum of 10,000 entry groups may be created per organization across all locations.

You must enable the Data Catalog API in the project identified by the parent parameter. For more information, see Data Catalog resource project.

Parameters

Name	Description
parent	string Required. The names of the project and location that the new entry group belongs to. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
entryGroupId	string Required. The ID of the entry group to create. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and must start with a letter or underscore. The maximum size is 64 bytes when encoded in UTF-8.
entryGroup	EntryGroup The entry group to create. Defaults to empty.
cancellationToken	CancellationToken A CancellationToken to use for this RPC.

Returns

Type	Description
TaskEntryGroup	A Task containing the RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = await DataCatalogClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
string entryGroupId = "";
EntryGroup entryGroup = new EntryGroup();
// Make the request
EntryGroup response = await dataCatalogClient.CreateEntryGroupAsync(parent, entryGroupId, entryGroup);

CreateTag(CreateTagRequest, CallSettings)

public virtual Tag CreateTag(CreateTagRequest request, CallSettings callSettings = null)

Creates a tag and assigns it to:

• An [Entry][google.cloud.datacatalog.v1.Entry] if the method name is projects.locations.entryGroups.entries.tags.create.
• Or [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]if the method name is projects.locations.entryGroups.tags.create.

Note: The project identified by the parent parameter for the tag and the tag template used to create the tag must be in the same organization.

Parameters

Name	Description
request	CreateTagRequest The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
Tag	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
CreateTagRequest request = new CreateTagRequest
{
    ParentAsEntryName = EntryName.FromProjectLocationEntryGroupEntry("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]"),
    Tag = new Tag(),
};
// Make the request
Tag response = dataCatalogClient.CreateTag(request);

CreateTag(EntryName, Tag, CallSettings)

public virtual Tag CreateTag(EntryName parent, Tag tag, CallSettings callSettings = null)

Creates a tag and assigns it to:

• An [Entry][google.cloud.datacatalog.v1.Entry] if the method name is projects.locations.entryGroups.entries.tags.create.
• Or [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]if the method name is projects.locations.entryGroups.tags.create.

Note: The project identified by the parent parameter for the tag and the tag template used to create the tag must be in the same organization.

Parameters

Name	Description
parent	EntryName Required. The name of the resource to attach this tag to. Tags can be attached to entries or entry groups. An entry can have up to 1000 attached tags. Note: The tag and its child resources might not be stored in the location specified in its name.
tag	Tag Required. The tag to create.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
Tag	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
EntryName parent = EntryName.FromProjectLocationEntryGroupEntry("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]");
Tag tag = new Tag();
// Make the request
Tag response = dataCatalogClient.CreateTag(parent, tag);

CreateTag(string, Tag, CallSettings)

public virtual Tag CreateTag(string parent, Tag tag, CallSettings callSettings = null)

Creates a tag and assigns it to:

• An [Entry][google.cloud.datacatalog.v1.Entry] if the method name is projects.locations.entryGroups.entries.tags.create.
• Or [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]if the method name is projects.locations.entryGroups.tags.create.

Note: The project identified by the parent parameter for the tag and the tag template used to create the tag must be in the same organization.

Parameters

Name	Description
parent	string Required. The name of the resource to attach this tag to. Tags can be attached to entries or entry groups. An entry can have up to 1000 attached tags. Note: The tag and its child resources might not be stored in the location specified in its name.
tag	Tag Required. The tag to create.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns

Type	Description
Tag	The RPC response.

Example

// Create client
DataCatalogClient dataCatalogClient = DataCatalogClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/entryGroups/[ENTRY_GROUP]/entries/[ENTRY]";
Tag tag = new Tag();
// Make the request
Tag response = dataCatalogClient.CreateTag(parent, tag);

CreateTagAsync(CreateTagRequest, CallSettings)

<