The primary resources offered by this service are EntryGroups, EntryTypes, AspectTypes, and Entries.
They collectively let data administrators organize, manage, secure, and catalog data located across cloud projects in their organization in a variety of storage systems, including Cloud Storage and BigQuery.
Equality
Instances of this class created via copy-construction or copy-assignment always compare equal. Instances created with equal std::shared_ptr<*Connection>
objects compare equal. Objects that compare equal share the same underlying resources.
Performance
Creating a new instance of this class is a relatively expensive operation, new objects establish new connections to the service. In contrast, copy-construction, move-construction, and the corresponding assignment operations are relatively efficient as the copies share all underlying resources.
Thread Safety
Concurrent access to different instances of this class, even if they compare equal, is guaranteed to work. Two or more threads operating on the same instance of this class is not guaranteed to work. Since copy-construction and move-construction is a relatively efficient operation, consider using such a copy when using this class from multiple threads.
Constructors
CatalogServiceClient(CatalogServiceClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
CatalogServiceClient const &
|
CatalogServiceClient(CatalogServiceClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
CatalogServiceClient &&
|
CatalogServiceClient(std::shared_ptr< CatalogServiceConnection >, Options)
Parameters | |
---|---|
Name | Description |
connection |
std::shared_ptr< CatalogServiceConnection >
|
opts |
Options
|
Operators
operator=(CatalogServiceClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
CatalogServiceClient const &
|
Returns | |
---|---|
Type | Description |
CatalogServiceClient & |
operator=(CatalogServiceClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
CatalogServiceClient &&
|
Returns | |
---|---|
Type | Description |
CatalogServiceClient & |
Functions
CreateEntryType(std::string const &, google::cloud::dataplex::v1::EntryType const &, std::string const &, Options)
Creates an EntryType.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the EntryType, of the form: projects/{project_number}/locations/{location_id} where |
entry_type |
google::cloud::dataplex::v1::EntryType const &
Required. EntryType Resource. |
entry_type_id |
std::string const &
Required. EntryType identifier. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryType > > |
A |
CreateEntryType(NoAwaitTag, std::string const &, google::cloud::dataplex::v1::EntryType const &, std::string const &, Options)
Creates an EntryType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
entry_type |
google::cloud::dataplex::v1::EntryType const &
|
entry_type_id |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateEntryType(google::cloud::dataplex::v1::CreateEntryTypeRequest const &, Options)
Creates an EntryType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::CreateEntryTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryType > > |
A |
CreateEntryType(NoAwaitTag, google::cloud::dataplex::v1::CreateEntryTypeRequest const &, Options)
Creates an EntryType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::CreateEntryTypeRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateEntryType(google::longrunning::Operation const &, Options)
Creates an EntryType.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryType > > |
UpdateEntryType(google::cloud::dataplex::v1::EntryType const &, google::protobuf::FieldMask const &, Options)
Updates an EntryType.
Parameters | |
---|---|
Name | Description |
entry_type |
google::cloud::dataplex::v1::EntryType const &
Required. EntryType Resource. |
update_mask |
google::protobuf::FieldMask const &
Required. Mask of fields to update. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryType > > |
A |
UpdateEntryType(NoAwaitTag, google::cloud::dataplex::v1::EntryType const &, google::protobuf::FieldMask const &, Options)
Updates an EntryType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
entry_type |
google::cloud::dataplex::v1::EntryType const &
|
update_mask |
google::protobuf::FieldMask const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateEntryType(google::cloud::dataplex::v1::UpdateEntryTypeRequest const &, Options)
Updates an EntryType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::UpdateEntryTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryType > > |
A |
UpdateEntryType(NoAwaitTag, google::cloud::dataplex::v1::UpdateEntryTypeRequest const &, Options)
Updates an EntryType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::UpdateEntryTypeRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateEntryType(google::longrunning::Operation const &, Options)
Updates an EntryType.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryType > > |
DeleteEntryType(std::string const &, Options)
Deletes an EntryType.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the EntryType: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
A |
DeleteEntryType(NoAwaitTag, std::string const &, Options)
Deletes an EntryType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
name |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
DeleteEntryType(google::cloud::dataplex::v1::DeleteEntryTypeRequest const &, Options)
Deletes an EntryType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::DeleteEntryTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
A |
DeleteEntryType(NoAwaitTag, google::cloud::dataplex::v1::DeleteEntryTypeRequest const &, Options)
Deletes an EntryType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::DeleteEntryTypeRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
DeleteEntryType(google::longrunning::Operation const &, Options)
Deletes an EntryType.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
ListEntryTypes(std::string const &, Options)
Lists EntryType resources in a project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the EntryType location, of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::EntryType > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListEntryTypes(google::cloud::dataplex::v1::ListEntryTypesRequest, Options)
Lists EntryType resources in a project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::ListEntryTypesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::EntryType > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetEntryType(std::string const &, Options)
Gets an EntryType.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the EntryType: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::EntryType > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.EntryType) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetEntryType(google::cloud::dataplex::v1::GetEntryTypeRequest const &, Options)
Gets an EntryType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::GetEntryTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::EntryType > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.EntryType) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateAspectType(std::string const &, google::cloud::dataplex::v1::AspectType const &, std::string const &, Options)
Creates an AspectType.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the AspectType, of the form: projects/{project_number}/locations/{location_id} where |
aspect_type |
google::cloud::dataplex::v1::AspectType const &
Required. AspectType Resource. |
aspect_type_id |
std::string const &
Required. AspectType identifier. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::AspectType > > |
A |
CreateAspectType(NoAwaitTag, std::string const &, google::cloud::dataplex::v1::AspectType const &, std::string const &, Options)
Creates an AspectType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
aspect_type |
google::cloud::dataplex::v1::AspectType const &
|
aspect_type_id |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateAspectType(google::cloud::dataplex::v1::CreateAspectTypeRequest const &, Options)
Creates an AspectType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::CreateAspectTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::AspectType > > |
A |
CreateAspectType(NoAwaitTag, google::cloud::dataplex::v1::CreateAspectTypeRequest const &, Options)
Creates an AspectType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::CreateAspectTypeRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateAspectType(google::longrunning::Operation const &, Options)
Creates an AspectType.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::AspectType > > |
UpdateAspectType(google::cloud::dataplex::v1::AspectType const &, google::protobuf::FieldMask const &, Options)
Updates an AspectType.
Parameters | |
---|---|
Name | Description |
aspect_type |
google::cloud::dataplex::v1::AspectType const &
Required. AspectType Resource |
update_mask |
google::protobuf::FieldMask const &
Required. Mask of fields to update. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::AspectType > > |
A |
UpdateAspectType(NoAwaitTag, google::cloud::dataplex::v1::AspectType const &, google::protobuf::FieldMask const &, Options)
Updates an AspectType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
aspect_type |
google::cloud::dataplex::v1::AspectType const &
|
update_mask |
google::protobuf::FieldMask const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateAspectType(google::cloud::dataplex::v1::UpdateAspectTypeRequest const &, Options)
Updates an AspectType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::UpdateAspectTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::AspectType > > |
A |
UpdateAspectType(NoAwaitTag, google::cloud::dataplex::v1::UpdateAspectTypeRequest const &, Options)
Updates an AspectType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::UpdateAspectTypeRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateAspectType(google::longrunning::Operation const &, Options)
Updates an AspectType.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::AspectType > > |
DeleteAspectType(std::string const &, Options)
Deletes an AspectType.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the AspectType: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
A |
DeleteAspectType(NoAwaitTag, std::string const &, Options)
Deletes an AspectType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
name |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
DeleteAspectType(google::cloud::dataplex::v1::DeleteAspectTypeRequest const &, Options)
Deletes an AspectType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::DeleteAspectTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
A |
DeleteAspectType(NoAwaitTag, google::cloud::dataplex::v1::DeleteAspectTypeRequest const &, Options)
Deletes an AspectType.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::DeleteAspectTypeRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
DeleteAspectType(google::longrunning::Operation const &, Options)
Deletes an AspectType.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
ListAspectTypes(std::string const &, Options)
Lists AspectType resources in a project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the AspectType location, of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::AspectType > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListAspectTypes(google::cloud::dataplex::v1::ListAspectTypesRequest, Options)
Lists AspectType resources in a project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::ListAspectTypesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::AspectType > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetAspectType(std::string const &, Options)
Gets an AspectType.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the AspectType: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::AspectType > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.AspectType) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetAspectType(google::cloud::dataplex::v1::GetAspectTypeRequest const &, Options)
Gets an AspectType.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::GetAspectTypeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::AspectType > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.AspectType) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateEntryGroup(std::string const &, google::cloud::dataplex::v1::EntryGroup const &, std::string const &, Options)
Creates an EntryGroup.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the entryGroup, of the form: projects/{project_number}/locations/{location_id} where |
entry_group |
google::cloud::dataplex::v1::EntryGroup const &
Required. EntryGroup Resource. |
entry_group_id |
std::string const &
Required. EntryGroup identifier. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryGroup > > |
A |
CreateEntryGroup(NoAwaitTag, std::string const &, google::cloud::dataplex::v1::EntryGroup const &, std::string const &, Options)
Creates an EntryGroup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
entry_group |
google::cloud::dataplex::v1::EntryGroup const &
|
entry_group_id |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateEntryGroup(google::cloud::dataplex::v1::CreateEntryGroupRequest const &, Options)
Creates an EntryGroup.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::CreateEntryGroupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryGroup > > |
A |
CreateEntryGroup(NoAwaitTag, google::cloud::dataplex::v1::CreateEntryGroupRequest const &, Options)
Creates an EntryGroup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::CreateEntryGroupRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateEntryGroup(google::longrunning::Operation const &, Options)
Creates an EntryGroup.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryGroup > > |
UpdateEntryGroup(google::cloud::dataplex::v1::EntryGroup const &, google::protobuf::FieldMask const &, Options)
Updates an EntryGroup.
Parameters | |
---|---|
Name | Description |
entry_group |
google::cloud::dataplex::v1::EntryGroup const &
Required. EntryGroup Resource. |
update_mask |
google::protobuf::FieldMask const &
Required. Mask of fields to update. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryGroup > > |
A |
UpdateEntryGroup(NoAwaitTag, google::cloud::dataplex::v1::EntryGroup const &, google::protobuf::FieldMask const &, Options)
Updates an EntryGroup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
entry_group |
google::cloud::dataplex::v1::EntryGroup const &
|
update_mask |
google::protobuf::FieldMask const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateEntryGroup(google::cloud::dataplex::v1::UpdateEntryGroupRequest const &, Options)
Updates an EntryGroup.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::UpdateEntryGroupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryGroup > > |
A |
UpdateEntryGroup(NoAwaitTag, google::cloud::dataplex::v1::UpdateEntryGroupRequest const &, Options)
Updates an EntryGroup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::UpdateEntryGroupRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateEntryGroup(google::longrunning::Operation const &, Options)
Updates an EntryGroup.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::EntryGroup > > |
DeleteEntryGroup(std::string const &, Options)
Deletes an EntryGroup.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the EntryGroup: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
A |
DeleteEntryGroup(NoAwaitTag, std::string const &, Options)
Deletes an EntryGroup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
name |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
DeleteEntryGroup(google::cloud::dataplex::v1::DeleteEntryGroupRequest const &, Options)
Deletes an EntryGroup.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::DeleteEntryGroupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
A |
DeleteEntryGroup(NoAwaitTag, google::cloud::dataplex::v1::DeleteEntryGroupRequest const &, Options)
Deletes an EntryGroup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::DeleteEntryGroupRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
DeleteEntryGroup(google::longrunning::Operation const &, Options)
Deletes an EntryGroup.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::OperationMetadata > > |
ListEntryGroups(std::string const &, Options)
Lists EntryGroup resources in a project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the entryGroup location, of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::EntryGroup > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListEntryGroups(google::cloud::dataplex::v1::ListEntryGroupsRequest, Options)
Lists EntryGroup resources in a project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::ListEntryGroupsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::EntryGroup > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetEntryGroup(std::string const &, Options)
Gets an EntryGroup.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the EntryGroup: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::EntryGroup > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.EntryGroup) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetEntryGroup(google::cloud::dataplex::v1::GetEntryGroupRequest const &, Options)
Gets an EntryGroup.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::GetEntryGroupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::EntryGroup > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.EntryGroup) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateEntry(std::string const &, google::cloud::dataplex::v1::Entry const &, std::string const &, Options)
Creates an Entry.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the parent Entry Group: |
entry |
google::cloud::dataplex::v1::Entry const &
Required. Entry resource. |
entry_id |
std::string const &
Required. Entry identifier. It has to be unique within an Entry Group. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateEntry(google::cloud::dataplex::v1::CreateEntryRequest const &, Options)
Creates an Entry.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::CreateEntryRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateEntry(google::cloud::dataplex::v1::Entry const &, google::protobuf::FieldMask const &, Options)
Updates an Entry.
Parameters | |
---|---|
Name | Description |
entry |
google::cloud::dataplex::v1::Entry const &
Required. Entry resource. |
update_mask |
google::protobuf::FieldMask const &
Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects". |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateEntry(google::cloud::dataplex::v1::UpdateEntryRequest const &, Options)
Updates an Entry.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::UpdateEntryRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
DeleteEntry(std::string const &, Options)
Deletes an Entry.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the Entry: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
DeleteEntry(google::cloud::dataplex::v1::DeleteEntryRequest const &, Options)
Deletes an Entry.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::DeleteEntryRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListEntries(std::string const &, Options)
Lists Entries within an EntryGroup.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the parent Entry Group: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::Entry > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListEntries(google::cloud::dataplex::v1::ListEntriesRequest, Options)
Lists Entries within an EntryGroup.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::ListEntriesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::Entry > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetEntry(std::string const &, Options)
Gets an Entry.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the Entry: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetEntry(google::cloud::dataplex::v1::GetEntryRequest const &, Options)
Gets an Entry.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::GetEntryRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
LookupEntry(google::cloud::dataplex::v1::LookupEntryRequest const &, Options)
Looks up an entry by name using the permission on the source system.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::LookupEntryRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::Entry > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.Entry) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
SearchEntries(std::string const &, std::string const &, Options)
Searches for Entries matching the given query and scope.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The project to which the request should be attributed in the following form: |
query |
std::string const &
Required. The query against which entries in scope should be matched. The query syntax is defined in Search syntax for Dataplex Catalog. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::SearchEntriesResult > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
SearchEntries(google::cloud::dataplex::v1::SearchEntriesRequest, Options)
Searches for Entries matching the given query and scope.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::SearchEntriesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::SearchEntriesResult > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
CreateMetadataJob(std::string const &, google::cloud::dataplex::v1::MetadataJob const &, std::string const &, Options)
Creates a metadata job.
For example, use a metadata job to import Dataplex Catalog entries and aspects from a third-party system into Dataplex.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the parent location, in the format |
metadata_job |
google::cloud::dataplex::v1::MetadataJob const &
Required. The metadata job resource. |
metadata_job_id |
std::string const &
Optional. The metadata job ID. If not provided, a unique ID is generated with the prefix |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::MetadataJob > > |
A |
CreateMetadataJob(NoAwaitTag, std::string const &, google::cloud::dataplex::v1::MetadataJob const &, std::string const &, Options)
Creates a metadata job.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
metadata_job |
google::cloud::dataplex::v1::MetadataJob const &
|
metadata_job_id |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateMetadataJob(google::cloud::dataplex::v1::CreateMetadataJobRequest const &, Options)
Creates a metadata job.
For example, use a metadata job to import Dataplex Catalog entries and aspects from a third-party system into Dataplex.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::CreateMetadataJobRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::MetadataJob > > |
A |
CreateMetadataJob(NoAwaitTag, google::cloud::dataplex::v1::CreateMetadataJobRequest const &, Options)
Creates a metadata job.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::cloud::dataplex::v1::CreateMetadataJobRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateMetadataJob(google::longrunning::Operation const &, Options)
Creates a metadata job.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::dataplex::v1::MetadataJob > > |
GetMetadataJob(std::string const &, Options)
Gets a metadata job.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the metadata job, in the format |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::MetadataJob > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.MetadataJob) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetMetadataJob(google::cloud::dataplex::v1::GetMetadataJobRequest const &, Options)
Gets a metadata job.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::GetMetadataJobRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::dataplex::v1::MetadataJob > |
the result of the RPC. The response message type (google.cloud.dataplex.v1.MetadataJob) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListMetadataJobs(std::string const &, Options)
Lists metadata jobs.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The resource name of the parent location, in the format |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::MetadataJob > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListMetadataJobs(google::cloud::dataplex::v1::ListMetadataJobsRequest, Options)
Lists metadata jobs.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::ListMetadataJobsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::dataplex::v1::MetadataJob > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
CancelMetadataJob(std::string const &, Options)
Cancels a metadata job.
If you cancel a metadata import job that is in progress, the changes in the job might be partially applied. We recommend that you reset the state of the entry groups in your project by running another metadata job that reverts the changes from the canceled job.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The resource name of the job, in the format |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
CancelMetadataJob(google::cloud::dataplex::v1::CancelMetadataJobRequest const &, Options)
Cancels a metadata job.
If you cancel a metadata import job that is in progress, the changes in the job might be partially applied. We recommend that you reset the state of the entry groups in your project by running another metadata job that reverts the changes from the canceled job.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::dataplex::v1::CancelMetadataJobRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
ListLocations(google::cloud::location::ListLocationsRequest, Options)
Lists information about the supported locations for this service.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::location::ListLocationsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::location::Location > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetLocation(google::cloud::location::GetLocationRequest const &, Options)
Gets information about a location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::location::GetLocationRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::location::Location > |
the result of the RPC. The response message type (google.cloud.location.Location) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
SetIamPolicy(google::iam::v1::SetIamPolicyRequest const &, Options)
Sets the access control policy on the specified resource.
Replaces any existing policy.
Can return NOT_FOUND
, INVALID_ARGUMENT
, and PERMISSION_DENIED
errors.
Parameters | |
---|---|
Name | Description |
request |
google::iam::v1::SetIamPolicyRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetIamPolicy(google::iam::v1::GetIamPolicyRequest const &, Options)
Gets the access control policy for a resource.
Returns an empty policy if the resource exists and does not have a policy set.
Parameters | |
---|---|
Name | Description |
request |
google::iam::v1::GetIamPolicyRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
TestIamPermissions(google::iam::v1::TestIamPermissionsRequest const &, Options)
Returns permissions that a caller has on the specified resource.
If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND
error.
Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
Parameters | |
---|---|
Name | Description |
request |
google::iam::v1::TestIamPermissionsRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::TestIamPermissionsResponse > |
the result of the RPC. The response message type (google.iam.v1.TestIamPermissionsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListOperations(std::string const &, std::string const &, Options)
Lists operations that match the specified filter in the request.
If the server doesn't support this method, it returns UNIMPLEMENTED
.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
The name of the operation's parent resource. |
filter |
std::string const &
The standard list filter. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::longrunning::Operation > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListOperations(google::longrunning::ListOperationsRequest, Options)
Lists operations that match the specified filter in the request.
If the server doesn't support this method, it returns UNIMPLEMENTED
.
Parameters | |
---|---|
Name | Description |
request |
google::longrunning::ListOperationsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::longrunning::Operation > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetOperation(std::string const &, Options)
Gets the latest state of a long-running operation.
Clients can use this method to poll the operation result at intervals as recommended by the API service.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
The name of the operation resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
the result of the RPC. The response message type (google.longrunning.Operation) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetOperation(google::longrunning::GetOperationRequest const &, Options)
Gets the latest state of a long-running operation.
Clients can use this method to poll the operation result at intervals as recommended by the API service.
Parameters | |
---|---|
Name | Description |
request |
google::longrunning::GetOperationRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
the result of the RPC. The response message type (google.longrunning.Operation) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
DeleteOperation(std::string const &, Options)
Deletes a long-running operation.
This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
The name of the operation resource to be deleted. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
DeleteOperation(google::longrunning::DeleteOperationRequest const &, Options)
Deletes a long-running operation.
This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
.
Parameters | |
---|---|
Name | Description |
request |
google::longrunning::DeleteOperationRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
CancelOperation(std::string const &, Options)
Starts asynchronous cancellation on a long-running operation.
The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1
, corresponding to Code.CANCELLED
.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
The name of the operation resource to be cancelled. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
CancelOperation(google::longrunning::CancelOperationRequest const &, Options)
Starts asynchronous cancellation on a long-running operation.
The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1
, corresponding to Code.CANCELLED
.
Parameters | |
---|---|
Name | Description |
request |
google::longrunning::CancelOperationRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |