From e56e666bca2aa7ba5e1f22e76f57a6bfd3f74454 Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Tue, 9 Jan 2024 13:30:42 -0500 Subject: [PATCH] fix(deps): [Many APIs] Update the Java code generator (gapic-generator-java) to 2.31.0 (#10195) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * fix(deps): Update the Java code generator (gapic-generator-java) to 2.31.0 PiperOrigin-RevId: 596645164 Source-Link: https://github.com/googleapis/googleapis/commit/4a0e62ecde2a6459bea8722a33173cfce1e9fb50 Source-Link: https://github.com/googleapis/googleapis-gen/commit/a10ed6a77676c37e60799098d48d0afb16008613 Copy-Tag: eyJwIjoiamF2YS1iYXJlLW1ldGFsLXNvbHV0aW9uLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iYXRjaC8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9 Copy-Tag: eyJwIjoiamF2YS1iZXlvbmRjb3JwLWFwcGNvbm5lY3Rpb25zLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iZXlvbmRjb3JwLWFwcGNvbm5lY3RvcnMvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ== Copy-Tag: eyJwIjoiamF2YS1iZXlvbmRjb3JwLWFwcGdhdGV3YXlzLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iZXlvbmRjb3JwLWNsaWVudGNvbm5lY3RvcnNlcnZpY2VzLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iZXlvbmRjb3JwLWNsaWVudGdhdGV3YXlzLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iaWdsYWtlLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iaWdxdWVyeS1kYXRhLWV4Y2hhbmdlLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iaWdxdWVyeWNvbm5lY3Rpb24vLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ== Copy-Tag: eyJwIjoiamF2YS1iaWdxdWVyeWRhdGFwb2xpY3kvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ== Copy-Tag: eyJwIjoiamF2YS1iaWdxdWVyeWRhdGF0cmFuc2Zlci8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9 Copy-Tag: eyJwIjoiamF2YS1iaWdxdWVyeW1pZ3JhdGlvbi8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9 Copy-Tag: eyJwIjoiamF2YS1iaWdxdWVyeXJlc2VydmF0aW9uLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iaWxsaW5nLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1iaWxsaW5nYnVkZ2V0cy8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9 Copy-Tag: eyJwIjoiamF2YS1iaW5hcnktYXV0aG9yaXphdGlvbi8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9 Copy-Tag: eyJwIjoiamF2YS1jZXJ0aWZpY2F0ZS1tYW5hZ2VyLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1jaGFubmVsLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= Copy-Tag: eyJwIjoiamF2YS1jbG91ZGJ1aWxkLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0= * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot --- java-bare-metal-solution/README.md | 2 +- .../v2/BareMetalSolutionClient.java | 907 +++++++++++- .../stub/BareMetalSolutionStubSettings.java | 6 + java-batch/README.md | 2 +- .../cloud/batch/v1/BatchServiceClient.java | 164 ++- .../v1/stub/BatchServiceStubSettings.java | 6 + .../batch/v1alpha/BatchServiceClient.java | 164 ++- .../stub/BatchServiceStubSettings.java | 6 + java-beyondcorp-appconnections/README.md | 2 +- .../v1/AppConnectionsServiceClient.java | 211 ++- .../AppConnectionsServiceStubSettings.java | 6 + java-beyondcorp-appconnectors/README.md | 2 +- .../v1/AppConnectorsServiceClient.java | 211 ++- .../AppConnectorsServiceStubSettings.java | 6 + java-beyondcorp-appgateways/README.md | 2 +- .../v1/AppGatewaysServiceClient.java | 172 ++- .../stub/AppGatewaysServiceStubSettings.java | 6 + .../README.md | 2 +- .../ClientConnectorServicesServiceClient.java | 191 ++- ...tConnectorServicesServiceStubSettings.java | 6 + java-beyondcorp-clientgateways/README.md | 2 +- .../v1/ClientGatewaysServiceClient.java | 172 ++- .../ClientGatewaysServiceStubSettings.java | 6 + java-biglake/README.md | 2 +- .../biglake/v1/MetastoreServiceClient.java | 308 +++- .../v1/stub/MetastoreServiceStubSettings.java | 6 + .../v1alpha1/MetastoreServiceClient.java | 385 ++++- .../stub/MetastoreServiceStubSettings.java | 6 + java-bigquery-data-exchange/README.md | 2 +- .../v1beta1/AnalyticsHubServiceClient.java | 320 ++++- .../stub/AnalyticsHubServiceStubSettings.java | 6 + java-bigqueryconnection/README.md | 2 +- .../v1beta1/ConnectionServiceClient.java | 192 ++- .../stub/ConnectionServiceStubSettings.java | 6 + .../v1/ConnectionServiceClient.java | 175 ++- .../stub/ConnectionServiceStubSettings.java | 6 + java-bigquerydatapolicy/README.md | 2 +- .../v1/DataPolicyServiceClient.java | 175 ++- .../stub/DataPolicyServiceStubSettings.java | 6 + .../v1beta1/DataPolicyServiceClient.java | 157 ++- .../stub/DataPolicyServiceStubSettings.java | 6 + java-bigquerydatatransfer/README.md | 2 +- .../v1/DataTransferServiceClient.java | 330 ++++- .../stub/DataTransferServiceStubSettings.java | 6 + java-bigquerymigration/README.md | 2 +- .../migration/v2/MigrationServiceClient.java | 155 +- .../v2/stub/MigrationServiceStubSettings.java | 6 + .../v2alpha/MigrationServiceClient.java | 155 +- .../v2alpha/SqlTranslationServiceClient.java | 39 +- .../stub/MigrationServiceStubSettings.java | 6 + .../SqlTranslationServiceStubSettings.java | 6 + java-bigqueryreservation/README.md | 2 +- .../v1/ReservationServiceClient.java | 471 ++++++- .../stub/ReservationServiceStubSettings.java | 6 + java-billing/README.md | 2 +- .../cloud/billing/v1/CloudBillingClient.java | 234 ++- .../cloud/billing/v1/CloudCatalogClient.java | 59 +- .../v1/stub/CloudBillingStubSettings.java | 6 + .../v1/stub/CloudCatalogStubSettings.java | 6 + java-billingbudgets/README.md | 2 +- .../budgets/v1/BudgetServiceClient.java | 118 +- .../v1/stub/BudgetServiceStubSettings.java | 6 + .../budgets/v1beta1/BudgetServiceClient.java | 94 +- .../stub/BudgetServiceStubSettings.java | 6 + java-binary-authorization/README.md | 2 +- ...inauthzManagementServiceV1Beta1Client.java | 153 +- .../v1beta1/SystemPolicyV1Beta1Client.java | 39 +- ...zManagementServiceV1Beta1StubSettings.java | 6 + .../stub/SystemPolicyV1Beta1StubSettings.java | 6 + .../v1/BinauthzManagementServiceV1Client.java | 153 +- .../v1/SystemPolicyV1Client.java | 39 +- .../v1/ValidationHelperV1Client.java | 34 +- ...nauthzManagementServiceV1StubSettings.java | 6 + .../v1/stub/SystemPolicyV1StubSettings.java | 6 + .../stub/ValidationHelperV1StubSettings.java | 6 + java-certificate-manager/README.md | 2 +- .../v1/CertificateManagerClient.java | 520 ++++++- .../stub/CertificateManagerStubSettings.java | 6 + .../v1/CloudChannelReportsServiceClient.java | 88 +- .../channel/v1/CloudChannelServiceClient.java | 1250 ++++++++++++++++- ...loudChannelReportsServiceStubSettings.java | 6 + .../stub/CloudChannelServiceStubSettings.java | 6 + java-cloudbuild/README.md | 2 +- .../cloudbuild/v1/CloudBuildClient.java | 380 ++++- .../v1/stub/CloudBuildStubSettings.java | 6 + .../v2/RepositoryManagerClient.java | 330 ++++- .../stub/RepositoryManagerStubSettings.java | 6 + versions.txt | 2 +- 88 files changed, 8327 insertions(+), 462 deletions(-) diff --git a/java-bare-metal-solution/README.md b/java-bare-metal-solution/README.md index 9e84f93862df..d933122361b8 100644 --- a/java-bare-metal-solution/README.md +++ b/java-bare-metal-solution/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bare-metal-solution.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bare-metal-solution/0.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bare-metal-solution/0.32.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/BareMetalSolutionClient.java b/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/BareMetalSolutionClient.java index 8dd0e8ac2d35..3e6f9c04fe71 100644 --- a/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/BareMetalSolutionClient.java +++ b/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/BareMetalSolutionClient.java @@ -72,19 +72,900 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListInstances

List servers in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listInstances(ListInstancesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listInstances(LocationName parent) + *
  • listInstances(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listInstancesPagedCallable() + *
  • listInstancesCallable() + *
+ *
GetInstance

Get details about a single server.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getInstance(GetInstanceRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getInstance(InstanceName name) + *
  • getInstance(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getInstanceCallable() + *
+ *
UpdateInstance

Update details of a single server.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateInstanceAsync(UpdateInstanceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateInstanceAsync(Instance instance, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateInstanceOperationCallable() + *
  • updateInstanceCallable() + *
+ *
RenameInstance

RenameInstance sets a new name for an instance. Use with caution, previous names become immediately invalidated.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameInstance(RenameInstanceRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameInstance(InstanceName name, String newInstanceId) + *
  • renameInstance(String name, String newInstanceId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameInstanceCallable() + *
+ *
ResetInstance

Perform an ungraceful, hard reset on a server. Equivalent to shutting the power off and then turning it back on.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • resetInstanceAsync(ResetInstanceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • resetInstanceAsync(InstanceName name) + *
  • resetInstanceAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • resetInstanceOperationCallable() + *
  • resetInstanceCallable() + *
+ *
StartInstance

Starts a server that was shutdown.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • startInstanceAsync(StartInstanceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • startInstanceAsync(InstanceName name) + *
  • startInstanceAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • startInstanceOperationCallable() + *
  • startInstanceCallable() + *
+ *
StopInstance

Stop a running server.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • stopInstanceAsync(StopInstanceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • stopInstanceAsync(InstanceName name) + *
  • stopInstanceAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • stopInstanceOperationCallable() + *
  • stopInstanceCallable() + *
+ *
EnableInteractiveSerialConsole

Enable the interactive serial console feature on an instance.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • enableInteractiveSerialConsoleAsync(EnableInteractiveSerialConsoleRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • enableInteractiveSerialConsoleAsync(InstanceName name) + *
  • enableInteractiveSerialConsoleAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • enableInteractiveSerialConsoleOperationCallable() + *
  • enableInteractiveSerialConsoleCallable() + *
+ *
DisableInteractiveSerialConsole

Disable the interactive serial console feature on an instance.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • disableInteractiveSerialConsoleAsync(DisableInteractiveSerialConsoleRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • disableInteractiveSerialConsoleAsync(InstanceName name) + *
  • disableInteractiveSerialConsoleAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • disableInteractiveSerialConsoleOperationCallable() + *
  • disableInteractiveSerialConsoleCallable() + *
+ *
DetachLun

Detach LUN from Instance.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • detachLunAsync(DetachLunRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • detachLunAsync(InstanceName instance, LunName lun) + *
  • detachLunAsync(InstanceName instance, String lun) + *
  • detachLunAsync(String instance, LunName lun) + *
  • detachLunAsync(String instance, String lun) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • detachLunOperationCallable() + *
  • detachLunCallable() + *
+ *
ListSSHKeys

Lists the public SSH keys registered for the specified project. These SSH keys are used only for the interactive serial console feature.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listSSHKeys(ListSSHKeysRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listSSHKeys(LocationName parent) + *
  • listSSHKeys(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listSSHKeysPagedCallable() + *
  • listSSHKeysCallable() + *
+ *
CreateSSHKey

Register a public SSH key in the specified project for use with the interactive serial console feature.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createSSHKey(CreateSSHKeyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createSSHKey(LocationName parent, SSHKey sshKey, String sshKeyId) + *
  • createSSHKey(String parent, SSHKey sshKey, String sshKeyId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createSSHKeyCallable() + *
+ *
DeleteSSHKey

Deletes a public SSH key registered in the specified project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteSSHKey(DeleteSSHKeyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteSSHKey(SshKeyName name) + *
  • deleteSSHKey(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteSSHKeyCallable() + *
+ *
ListVolumes

List storage volumes in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listVolumes(ListVolumesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listVolumes(LocationName parent) + *
  • listVolumes(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listVolumesPagedCallable() + *
  • listVolumesCallable() + *
+ *
GetVolume

Get details of a single storage volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getVolume(GetVolumeRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getVolume(VolumeName name) + *
  • getVolume(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getVolumeCallable() + *
+ *
UpdateVolume

Update details of a single storage volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateVolumeAsync(UpdateVolumeRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateVolumeAsync(Volume volume, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateVolumeOperationCallable() + *
  • updateVolumeCallable() + *
+ *
RenameVolume

RenameVolume sets a new name for a volume. Use with caution, previous names become immediately invalidated.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameVolume(RenameVolumeRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameVolume(VolumeName name, String newVolumeId) + *
  • renameVolume(String name, String newVolumeId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameVolumeCallable() + *
+ *
EvictVolume

Skips volume's cooloff and deletes it now. Volume must be in cooloff state.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • evictVolumeAsync(EvictVolumeRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • evictVolumeAsync(VolumeName name) + *
  • evictVolumeAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • evictVolumeOperationCallable() + *
  • evictVolumeCallable() + *
+ *
ResizeVolume

Emergency Volume resize.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • resizeVolumeAsync(ResizeVolumeRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • resizeVolumeAsync(VolumeName volume, long sizeGib) + *
  • resizeVolumeAsync(String volume, long sizeGib) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • resizeVolumeOperationCallable() + *
  • resizeVolumeCallable() + *
+ *
ListNetworks

List network in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listNetworks(ListNetworksRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listNetworks(LocationName parent) + *
  • listNetworks(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listNetworksPagedCallable() + *
  • listNetworksCallable() + *
+ *
ListNetworkUsage

List all Networks (and used IPs for each Network) in the vendor account associated with the specified project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listNetworkUsage(ListNetworkUsageRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listNetworkUsage(LocationName location) + *
  • listNetworkUsage(String location) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listNetworkUsageCallable() + *
+ *
GetNetwork

Get details of a single network.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getNetwork(GetNetworkRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getNetwork(NetworkName name) + *
  • getNetwork(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getNetworkCallable() + *
+ *
UpdateNetwork

Update details of a single network.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateNetworkAsync(UpdateNetworkRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateNetworkAsync(Network network, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateNetworkOperationCallable() + *
  • updateNetworkCallable() + *
+ *
CreateVolumeSnapshot

Takes a snapshot of a boot volume. Returns INVALID_ARGUMENT if called for a non-boot volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createVolumeSnapshot(CreateVolumeSnapshotRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createVolumeSnapshot(VolumeName parent, VolumeSnapshot volumeSnapshot) + *
  • createVolumeSnapshot(String parent, VolumeSnapshot volumeSnapshot) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createVolumeSnapshotCallable() + *
+ *
RestoreVolumeSnapshot

Uses the specified snapshot to restore its parent volume. Returns INVALID_ARGUMENT if called for a non-boot volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • restoreVolumeSnapshotAsync(RestoreVolumeSnapshotRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • restoreVolumeSnapshotAsync(VolumeSnapshotName volumeSnapshot) + *
  • restoreVolumeSnapshotAsync(String volumeSnapshot) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • restoreVolumeSnapshotOperationCallable() + *
  • restoreVolumeSnapshotCallable() + *
+ *
DeleteVolumeSnapshot

Deletes a volume snapshot. Returns INVALID_ARGUMENT if called for a non-boot volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteVolumeSnapshot(DeleteVolumeSnapshotRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteVolumeSnapshot(VolumeSnapshotName name) + *
  • deleteVolumeSnapshot(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteVolumeSnapshotCallable() + *
+ *
GetVolumeSnapshot

Returns the specified snapshot resource. Returns INVALID_ARGUMENT if called for a non-boot volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getVolumeSnapshot(GetVolumeSnapshotRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getVolumeSnapshot(VolumeSnapshotName name) + *
  • getVolumeSnapshot(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getVolumeSnapshotCallable() + *
+ *
ListVolumeSnapshots

Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listVolumeSnapshots(ListVolumeSnapshotsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listVolumeSnapshots(VolumeName parent) + *
  • listVolumeSnapshots(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listVolumeSnapshotsPagedCallable() + *
  • listVolumeSnapshotsCallable() + *
+ *
GetLun

Get details of a single storage logical unit number(LUN).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLun(GetLunRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getLun(LunName name) + *
  • getLun(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLunCallable() + *
+ *
ListLuns

List storage volume luns for given storage volume.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLuns(ListLunsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listLuns(VolumeName parent) + *
  • listLuns(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLunsPagedCallable() + *
  • listLunsCallable() + *
+ *
EvictLun

Skips lun's cooloff and deletes it now. Lun must be in cooloff state.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • evictLunAsync(EvictLunRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • evictLunAsync(LunName name) + *
  • evictLunAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • evictLunOperationCallable() + *
  • evictLunCallable() + *
+ *
GetNfsShare

Get details of a single NFS share.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getNfsShare(GetNfsShareRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getNfsShare(NFSShareName name) + *
  • getNfsShare(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getNfsShareCallable() + *
+ *
ListNfsShares

List NFS shares.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listNfsShares(ListNfsSharesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listNfsShares(LocationName parent) + *
  • listNfsShares(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listNfsSharesPagedCallable() + *
  • listNfsSharesCallable() + *
+ *
UpdateNfsShare

Update details of a single NFS share.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateNfsShareAsync(UpdateNfsShareRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateNfsShareAsync(NfsShare nfsShare, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateNfsShareOperationCallable() + *
  • updateNfsShareCallable() + *
+ *
CreateNfsShare

Create an NFS share.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createNfsShareAsync(CreateNfsShareRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createNfsShareAsync(LocationName parent, NfsShare nfsShare) + *
  • createNfsShareAsync(String parent, NfsShare nfsShare) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createNfsShareOperationCallable() + *
  • createNfsShareCallable() + *
+ *
RenameNfsShare

RenameNfsShare sets a new name for an nfsshare. Use with caution, previous names become immediately invalidated.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameNfsShare(RenameNfsShareRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameNfsShare(NFSShareName name, String newNfsshareId) + *
  • renameNfsShare(String name, String newNfsshareId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameNfsShareCallable() + *
+ *
DeleteNfsShare

Delete an NFS share. The underlying volume is automatically deleted.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteNfsShareAsync(DeleteNfsShareRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteNfsShareAsync(NFSShareName name) + *
  • deleteNfsShareAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteNfsShareOperationCallable() + *
  • deleteNfsShareCallable() + *
+ *
ListProvisioningQuotas

List the budget details to provision resources on a given project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listProvisioningQuotas(ListProvisioningQuotasRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listProvisioningQuotas(LocationName parent) + *
  • listProvisioningQuotas(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listProvisioningQuotasPagedCallable() + *
  • listProvisioningQuotasCallable() + *
+ *
SubmitProvisioningConfig

Submit a provisiong configuration for a given project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • submitProvisioningConfig(SubmitProvisioningConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • submitProvisioningConfig(LocationName parent, ProvisioningConfig provisioningConfig) + *
  • submitProvisioningConfig(String parent, ProvisioningConfig provisioningConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • submitProvisioningConfigCallable() + *
+ *
GetProvisioningConfig

Get ProvisioningConfig by name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getProvisioningConfig(GetProvisioningConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getProvisioningConfig(ProvisioningConfigName name) + *
  • getProvisioningConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getProvisioningConfigCallable() + *
+ *
CreateProvisioningConfig

Create new ProvisioningConfig.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createProvisioningConfig(CreateProvisioningConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createProvisioningConfig(LocationName parent, ProvisioningConfig provisioningConfig) + *
  • createProvisioningConfig(String parent, ProvisioningConfig provisioningConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createProvisioningConfigCallable() + *
+ *
UpdateProvisioningConfig

Update existing ProvisioningConfig.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateProvisioningConfig(UpdateProvisioningConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateProvisioningConfig(ProvisioningConfig provisioningConfig, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateProvisioningConfigCallable() + *
+ *
RenameNetwork

RenameNetwork sets a new name for a network. Use with caution, previous names become immediately invalidated.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameNetwork(RenameNetworkRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameNetwork(NetworkName name, String newNetworkId) + *
  • renameNetwork(String name, String newNetworkId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameNetworkCallable() + *
+ *
ListOSImages

Retrieves the list of OS images which are currently approved.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listOSImages(ListOSImagesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listOSImages(LocationName parent) + *
  • listOSImages(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listOSImagesPagedCallable() + *
  • listOSImagesCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/stub/BareMetalSolutionStubSettings.java b/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/stub/BareMetalSolutionStubSettings.java index 046936c0ca4c..9479488d7661 100644 --- a/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/stub/BareMetalSolutionStubSettings.java +++ b/java-bare-metal-solution/google-cloud-bare-metal-solution/src/main/java/com/google/cloud/baremetalsolution/v2/stub/BareMetalSolutionStubSettings.java @@ -1229,6 +1229,12 @@ public BareMetalSolutionStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "baremetalsolution"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-batch/README.md b/java-batch/README.md index bb5382717bfd..16df37b97670 100644 --- a/java-batch/README.md +++ b/java-batch/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-batch.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-batch/0.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-batch/0.32.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/BatchServiceClient.java b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/BatchServiceClient.java index b81b80bae622..02db90bad713 100644 --- a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/BatchServiceClient.java +++ b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/BatchServiceClient.java @@ -67,19 +67,157 @@ *

Note: close() needs to be called on the BatchServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateJob

Create a Job.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createJob(CreateJobRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createJob(LocationName parent, Job job, String jobId) + *
  • createJob(String parent, Job job, String jobId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createJobCallable() + *
+ *
GetJob

Get a Job specified by its resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getJob(GetJobRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getJob(JobName name) + *
  • getJob(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getJobCallable() + *
+ *
DeleteJob

Delete a Job.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteJobAsync(DeleteJobRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteJobAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteJobOperationCallable() + *
  • deleteJobCallable() + *
+ *
ListJobs

List all Jobs for a project within a region.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listJobs(ListJobsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listJobs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listJobsPagedCallable() + *
  • listJobsCallable() + *
+ *
GetTask

Return a single Task.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getTask(GetTaskRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getTask(TaskName name) + *
  • getTask(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getTaskCallable() + *
+ *
ListTasks

List Tasks associated with a job.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTasks(ListTasksRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTasks(TaskGroupName parent) + *
  • listTasks(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTasksPagedCallable() + *
  • listTasksCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/stub/BatchServiceStubSettings.java b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/stub/BatchServiceStubSettings.java index d17ff8001795..923c45f2ff0e 100644 --- a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/stub/BatchServiceStubSettings.java +++ b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1/stub/BatchServiceStubSettings.java @@ -356,6 +356,12 @@ public BatchServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "batch"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/BatchServiceClient.java b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/BatchServiceClient.java index 32921d394f87..d56fe99ee7fd 100644 --- a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/BatchServiceClient.java +++ b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/BatchServiceClient.java @@ -67,19 +67,157 @@ *

Note: close() needs to be called on the BatchServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateJob

Create a Job.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createJob(CreateJobRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createJob(LocationName parent, Job job, String jobId) + *
  • createJob(String parent, Job job, String jobId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createJobCallable() + *
+ *
GetJob

Get a Job specified by its resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getJob(GetJobRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getJob(JobName name) + *
  • getJob(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getJobCallable() + *
+ *
DeleteJob

Delete a Job.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteJobAsync(DeleteJobRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteJobAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteJobOperationCallable() + *
  • deleteJobCallable() + *
+ *
ListJobs

List all Jobs for a project within a region.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listJobs(ListJobsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listJobs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listJobsPagedCallable() + *
  • listJobsCallable() + *
+ *
GetTask

Return a single Task.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getTask(GetTaskRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getTask(TaskName name) + *
  • getTask(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getTaskCallable() + *
+ *
ListTasks

List Tasks associated with a job.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTasks(ListTasksRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTasks(TaskGroupName parent) + *
  • listTasks(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTasksPagedCallable() + *
  • listTasksCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/stub/BatchServiceStubSettings.java b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/stub/BatchServiceStubSettings.java index 1f039cefb6a3..50eea212259d 100644 --- a/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/stub/BatchServiceStubSettings.java +++ b/java-batch/google-cloud-batch/src/main/java/com/google/cloud/batch/v1alpha/stub/BatchServiceStubSettings.java @@ -357,6 +357,12 @@ public BatchServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "batch"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-beyondcorp-appconnections/README.md b/java-beyondcorp-appconnections/README.md index 6c54de8be85d..9aa13ae9d1bf 100644 --- a/java-beyondcorp-appconnections/README.md +++ b/java-beyondcorp-appconnections/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-beyondcorp-appconnections.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-appconnections/0.28.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-appconnections/0.30.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/AppConnectionsServiceClient.java b/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/AppConnectionsServiceClient.java index 8706af248deb..25ff29e2f622 100644 --- a/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/AppConnectionsServiceClient.java +++ b/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/AppConnectionsServiceClient.java @@ -85,19 +85,204 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListAppConnections

Lists AppConnections in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listAppConnections(ListAppConnectionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listAppConnections(LocationName parent) + *
  • listAppConnections(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listAppConnectionsPagedCallable() + *
  • listAppConnectionsCallable() + *
+ *
GetAppConnection

Gets details of a single AppConnection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getAppConnection(GetAppConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getAppConnection(AppConnectionName name) + *
  • getAppConnection(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getAppConnectionCallable() + *
+ *
CreateAppConnection

Creates a new AppConnection in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createAppConnectionAsync(CreateAppConnectionRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createAppConnectionAsync(LocationName parent, AppConnection appConnection, String appConnectionId) + *
  • createAppConnectionAsync(String parent, AppConnection appConnection, String appConnectionId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createAppConnectionOperationCallable() + *
  • createAppConnectionCallable() + *
+ *
UpdateAppConnection

Updates the parameters of a single AppConnection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateAppConnectionAsync(UpdateAppConnectionRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateAppConnectionAsync(AppConnection appConnection, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateAppConnectionOperationCallable() + *
  • updateAppConnectionCallable() + *
+ *
DeleteAppConnection

Deletes a single AppConnection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteAppConnectionAsync(DeleteAppConnectionRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteAppConnectionAsync(AppConnectionName name) + *
  • deleteAppConnectionAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteAppConnectionOperationCallable() + *
  • deleteAppConnectionCallable() + *
+ *
ResolveAppConnections

Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • resolveAppConnections(ResolveAppConnectionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • resolveAppConnections(LocationName parent) + *
  • resolveAppConnections(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • resolveAppConnectionsPagedCallable() + *
  • resolveAppConnectionsCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. + *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/stub/AppConnectionsServiceStubSettings.java b/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/stub/AppConnectionsServiceStubSettings.java index f2fbe6734583..99d63d7d55c0 100644 --- a/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/stub/AppConnectionsServiceStubSettings.java +++ b/java-beyondcorp-appconnections/google-cloud-beyondcorp-appconnections/src/main/java/com/google/cloud/beyondcorp/appconnections/v1/stub/AppConnectionsServiceStubSettings.java @@ -433,6 +433,12 @@ public AppConnectionsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "beyondcorp"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-beyondcorp-appconnectors/README.md b/java-beyondcorp-appconnectors/README.md index 6d1797149523..57db7120860b 100644 --- a/java-beyondcorp-appconnectors/README.md +++ b/java-beyondcorp-appconnectors/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-beyondcorp-appconnectors.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-appconnectors/0.28.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-appconnectors/0.30.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/AppConnectorsServiceClient.java b/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/AppConnectorsServiceClient.java index 8c065bc93acd..847403466c64 100644 --- a/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/AppConnectorsServiceClient.java +++ b/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/AppConnectorsServiceClient.java @@ -85,19 +85,204 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListAppConnectors

Lists AppConnectors in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listAppConnectors(ListAppConnectorsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listAppConnectors(LocationName parent) + *
  • listAppConnectors(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listAppConnectorsPagedCallable() + *
  • listAppConnectorsCallable() + *
+ *
GetAppConnector

Gets details of a single AppConnector.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getAppConnector(GetAppConnectorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getAppConnector(AppConnectorName name) + *
  • getAppConnector(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getAppConnectorCallable() + *
+ *
CreateAppConnector

Creates a new AppConnector in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createAppConnectorAsync(CreateAppConnectorRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createAppConnectorAsync(LocationName parent, AppConnector appConnector, String appConnectorId) + *
  • createAppConnectorAsync(String parent, AppConnector appConnector, String appConnectorId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createAppConnectorOperationCallable() + *
  • createAppConnectorCallable() + *
+ *
UpdateAppConnector

Updates the parameters of a single AppConnector.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateAppConnectorAsync(UpdateAppConnectorRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateAppConnectorAsync(AppConnector appConnector, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateAppConnectorOperationCallable() + *
  • updateAppConnectorCallable() + *
+ *
DeleteAppConnector

Deletes a single AppConnector.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteAppConnectorAsync(DeleteAppConnectorRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteAppConnectorAsync(AppConnectorName name) + *
  • deleteAppConnectorAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteAppConnectorOperationCallable() + *
  • deleteAppConnectorCallable() + *
+ *
ReportStatus

Report status for a given connector.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • reportStatusAsync(ReportStatusRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • reportStatusAsync(AppConnectorName appConnector, ResourceInfo resourceInfo) + *
  • reportStatusAsync(String appConnector, ResourceInfo resourceInfo) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • reportStatusOperationCallable() + *
  • reportStatusCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. + *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/stub/AppConnectorsServiceStubSettings.java b/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/stub/AppConnectorsServiceStubSettings.java index d74759f0d93c..c4a2640f19df 100644 --- a/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/stub/AppConnectorsServiceStubSettings.java +++ b/java-beyondcorp-appconnectors/google-cloud-beyondcorp-appconnectors/src/main/java/com/google/cloud/beyondcorp/appconnectors/v1/stub/AppConnectorsServiceStubSettings.java @@ -358,6 +358,12 @@ public AppConnectorsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "beyondcorp"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-beyondcorp-appgateways/README.md b/java-beyondcorp-appgateways/README.md index 1eb52bf8927c..d6d9dd994a6e 100644 --- a/java-beyondcorp-appgateways/README.md +++ b/java-beyondcorp-appgateways/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-beyondcorp-appgateways.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-appgateways/0.28.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-appgateways/0.30.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/AppGatewaysServiceClient.java b/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/AppGatewaysServiceClient.java index 53c0343d660b..d6c5c80348b8 100644 --- a/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/AppGatewaysServiceClient.java +++ b/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/AppGatewaysServiceClient.java @@ -83,19 +83,165 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListAppGateways

Lists AppGateways in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listAppGateways(ListAppGatewaysRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listAppGateways(LocationName parent) + *
  • listAppGateways(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listAppGatewaysPagedCallable() + *
  • listAppGatewaysCallable() + *
+ *
GetAppGateway

Gets details of a single AppGateway.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getAppGateway(GetAppGatewayRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getAppGateway(AppGatewayName name) + *
  • getAppGateway(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getAppGatewayCallable() + *
+ *
CreateAppGateway

Creates a new AppGateway in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createAppGatewayAsync(CreateAppGatewayRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createAppGatewayAsync(LocationName parent, AppGateway appGateway, String appGatewayId) + *
  • createAppGatewayAsync(String parent, AppGateway appGateway, String appGatewayId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createAppGatewayOperationCallable() + *
  • createAppGatewayCallable() + *
+ *
DeleteAppGateway

Deletes a single AppGateway.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteAppGatewayAsync(DeleteAppGatewayRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteAppGatewayAsync(AppGatewayName name) + *
  • deleteAppGatewayAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteAppGatewayOperationCallable() + *
  • deleteAppGatewayCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. + *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/stub/AppGatewaysServiceStubSettings.java b/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/stub/AppGatewaysServiceStubSettings.java index 618aa0d6fd47..6e96e32a4f66 100644 --- a/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/stub/AppGatewaysServiceStubSettings.java +++ b/java-beyondcorp-appgateways/google-cloud-beyondcorp-appgateways/src/main/java/com/google/cloud/beyondcorp/appgateways/v1/stub/AppGatewaysServiceStubSettings.java @@ -317,6 +317,12 @@ public AppGatewaysServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "beyondcorp"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-beyondcorp-clientconnectorservices/README.md b/java-beyondcorp-clientconnectorservices/README.md index 872ad42049fc..7554519c2f24 100644 --- a/java-beyondcorp-clientconnectorservices/README.md +++ b/java-beyondcorp-clientconnectorservices/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-beyondcorp-clientconnectorservices.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-clientconnectorservices/0.28.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-clientconnectorservices/0.30.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/ClientConnectorServicesServiceClient.java b/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/ClientConnectorServicesServiceClient.java index af43d285fc2d..0f877581f854 100644 --- a/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/ClientConnectorServicesServiceClient.java +++ b/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/ClientConnectorServicesServiceClient.java @@ -84,19 +84,184 @@ * up resources such as threads. In the example above, try-with-resources is used, which * automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListClientConnectorServices

Lists ClientConnectorServices in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listClientConnectorServices(ListClientConnectorServicesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listClientConnectorServices(LocationName parent) + *
  • listClientConnectorServices(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listClientConnectorServicesPagedCallable() + *
  • listClientConnectorServicesCallable() + *
+ *
GetClientConnectorService

Gets details of a single ClientConnectorService.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getClientConnectorService(GetClientConnectorServiceRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getClientConnectorService(ClientConnectorServiceName name) + *
  • getClientConnectorService(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getClientConnectorServiceCallable() + *
+ *
CreateClientConnectorService

Creates a new ClientConnectorService in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createClientConnectorServiceAsync(CreateClientConnectorServiceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createClientConnectorServiceAsync(LocationName parent, ClientConnectorService clientConnectorService, String clientConnectorServiceId) + *
  • createClientConnectorServiceAsync(String parent, ClientConnectorService clientConnectorService, String clientConnectorServiceId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createClientConnectorServiceOperationCallable() + *
  • createClientConnectorServiceCallable() + *
+ *
UpdateClientConnectorService

Updates the parameters of a single ClientConnectorService.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateClientConnectorServiceAsync(UpdateClientConnectorServiceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateClientConnectorServiceAsync(ClientConnectorService clientConnectorService, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateClientConnectorServiceOperationCallable() + *
  • updateClientConnectorServiceCallable() + *
+ *
DeleteClientConnectorService

Deletes a single ClientConnectorService.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteClientConnectorServiceAsync(DeleteClientConnectorServiceRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteClientConnectorServiceAsync(ClientConnectorServiceName name) + *
  • deleteClientConnectorServiceAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteClientConnectorServiceOperationCallable() + *
  • deleteClientConnectorServiceCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. + *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/stub/ClientConnectorServicesServiceStubSettings.java b/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/stub/ClientConnectorServicesServiceStubSettings.java index 2af389590242..4241f2618537 100644 --- a/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/stub/ClientConnectorServicesServiceStubSettings.java +++ b/java-beyondcorp-clientconnectorservices/google-cloud-beyondcorp-clientconnectorservices/src/main/java/com/google/cloud/beyondcorp/clientconnectorservices/v1/stub/ClientConnectorServicesServiceStubSettings.java @@ -381,6 +381,12 @@ public ClientConnectorServicesServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "beyondcorp"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-beyondcorp-clientgateways/README.md b/java-beyondcorp-clientgateways/README.md index 734fe521d88d..29be2f1513f6 100644 --- a/java-beyondcorp-clientgateways/README.md +++ b/java-beyondcorp-clientgateways/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-beyondcorp-clientgateways.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-clientgateways/0.28.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-beyondcorp-clientgateways/0.30.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/ClientGatewaysServiceClient.java b/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/ClientGatewaysServiceClient.java index bcda879a9b34..964c9430f04f 100644 --- a/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/ClientGatewaysServiceClient.java +++ b/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/ClientGatewaysServiceClient.java @@ -81,19 +81,165 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListClientGateways

Lists ClientGateways in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listClientGateways(ListClientGatewaysRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listClientGateways(LocationName parent) + *
  • listClientGateways(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listClientGatewaysPagedCallable() + *
  • listClientGatewaysCallable() + *
+ *
GetClientGateway

Gets details of a single ClientGateway.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getClientGateway(GetClientGatewayRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getClientGateway(ClientGatewayName name) + *
  • getClientGateway(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getClientGatewayCallable() + *
+ *
CreateClientGateway

Creates a new ClientGateway in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createClientGatewayAsync(CreateClientGatewayRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createClientGatewayAsync(LocationName parent, ClientGateway clientGateway, String clientGatewayId) + *
  • createClientGatewayAsync(String parent, ClientGateway clientGateway, String clientGatewayId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createClientGatewayOperationCallable() + *
  • createClientGatewayCallable() + *
+ *
DeleteClientGateway

Deletes a single ClientGateway.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteClientGatewayAsync(DeleteClientGatewayRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteClientGatewayAsync(ClientGatewayName name) + *
  • deleteClientGatewayAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteClientGatewayOperationCallable() + *
  • deleteClientGatewayCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. + *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/stub/ClientGatewaysServiceStubSettings.java b/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/stub/ClientGatewaysServiceStubSettings.java index ef5acfd02b28..136764458b4a 100644 --- a/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/stub/ClientGatewaysServiceStubSettings.java +++ b/java-beyondcorp-clientgateways/google-cloud-beyondcorp-clientgateways/src/main/java/com/google/cloud/beyondcorp/clientgateways/v1/stub/ClientGatewaysServiceStubSettings.java @@ -327,6 +327,12 @@ public ClientGatewaysServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "beyondcorp"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-biglake/README.md b/java-biglake/README.md index 55f1bdb91b17..cfbd1b7a5bec 100644 --- a/java-biglake/README.md +++ b/java-biglake/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-biglake/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-biglake.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-biglake/0.18.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-biglake/0.20.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/MetastoreServiceClient.java b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/MetastoreServiceClient.java index 7f892d339956..be3175d71d59 100644 --- a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/MetastoreServiceClient.java +++ b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/MetastoreServiceClient.java @@ -69,19 +69,301 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateCatalog

Creates a new catalog.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCatalog(CreateCatalogRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createCatalog(LocationName parent, Catalog catalog, String catalogId) + *
  • createCatalog(String parent, Catalog catalog, String catalogId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCatalogCallable() + *
+ *
DeleteCatalog

Deletes an existing catalog specified by the catalog ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCatalog(DeleteCatalogRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteCatalog(CatalogName name) + *
  • deleteCatalog(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCatalogCallable() + *
+ *
GetCatalog

Gets the catalog specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCatalog(GetCatalogRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCatalog(CatalogName name) + *
  • getCatalog(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCatalogCallable() + *
+ *
ListCatalogs

List all catalogs in a specified project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCatalogs(ListCatalogsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCatalogs(LocationName parent) + *
  • listCatalogs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCatalogsPagedCallable() + *
  • listCatalogsCallable() + *
+ *
CreateDatabase

Creates a new database.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createDatabase(CreateDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createDatabase(CatalogName parent, Database database, String databaseId) + *
  • createDatabase(String parent, Database database, String databaseId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createDatabaseCallable() + *
+ *
DeleteDatabase

Deletes an existing database specified by the database ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteDatabase(DeleteDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteDatabase(DatabaseName name) + *
  • deleteDatabase(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteDatabaseCallable() + *
+ *
UpdateDatabase

Updates an existing database specified by the database ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateDatabase(UpdateDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateDatabase(Database database, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateDatabaseCallable() + *
+ *
GetDatabase

Gets the database specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDatabase(GetDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDatabase(DatabaseName name) + *
  • getDatabase(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDatabaseCallable() + *
+ *
ListDatabases

List all databases in a specified catalog.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDatabases(ListDatabasesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDatabases(CatalogName parent) + *
  • listDatabases(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDatabasesPagedCallable() + *
  • listDatabasesCallable() + *
+ *
CreateTable

Creates a new table.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createTable(CreateTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createTable(DatabaseName parent, Table table, String tableId) + *
  • createTable(String parent, Table table, String tableId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createTableCallable() + *
+ *
DeleteTable

Deletes an existing table specified by the table ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteTable(DeleteTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteTable(TableName name) + *
  • deleteTable(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteTableCallable() + *
+ *
UpdateTable

Updates an existing table specified by the table ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateTable(UpdateTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateTable(Table table, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateTableCallable() + *
+ *
RenameTable

Renames an existing table specified by the table ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameTable(RenameTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameTable(TableName name, TableName newName) + *
  • renameTable(TableName name, String newName) + *
  • renameTable(String name, TableName newName) + *
  • renameTable(String name, String newName) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameTableCallable() + *
+ *
GetTable

Gets the table specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getTable(GetTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getTable(TableName name) + *
  • getTable(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getTableCallable() + *
+ *
ListTables

List all tables in a specified database.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTables(ListTablesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTables(DatabaseName parent) + *
  • listTables(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTablesPagedCallable() + *
  • listTablesCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/stub/MetastoreServiceStubSettings.java b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/stub/MetastoreServiceStubSettings.java index 7547f24853d8..3ab1ca0d702d 100644 --- a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/stub/MetastoreServiceStubSettings.java +++ b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1/stub/MetastoreServiceStubSettings.java @@ -395,6 +395,12 @@ public MetastoreServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "biglake"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/MetastoreServiceClient.java b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/MetastoreServiceClient.java index 85a6b46b75bc..48eb18c1a3e6 100644 --- a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/MetastoreServiceClient.java +++ b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/MetastoreServiceClient.java @@ -71,19 +71,378 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateCatalog

Creates a new catalog.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCatalog(CreateCatalogRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createCatalog(LocationName parent, Catalog catalog, String catalogId) + *
  • createCatalog(String parent, Catalog catalog, String catalogId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCatalogCallable() + *
+ *
DeleteCatalog

Deletes an existing catalog specified by the catalog ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCatalog(DeleteCatalogRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteCatalog(CatalogName name) + *
  • deleteCatalog(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCatalogCallable() + *
+ *
GetCatalog

Gets the catalog specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCatalog(GetCatalogRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCatalog(CatalogName name) + *
  • getCatalog(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCatalogCallable() + *
+ *
ListCatalogs

List all catalogs in a specified project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCatalogs(ListCatalogsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCatalogs(LocationName parent) + *
  • listCatalogs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCatalogsPagedCallable() + *
  • listCatalogsCallable() + *
+ *
CreateDatabase

Creates a new database.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createDatabase(CreateDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createDatabase(CatalogName parent, Database database, String databaseId) + *
  • createDatabase(String parent, Database database, String databaseId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createDatabaseCallable() + *
+ *
DeleteDatabase

Deletes an existing database specified by the database ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteDatabase(DeleteDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteDatabase(DatabaseName name) + *
  • deleteDatabase(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteDatabaseCallable() + *
+ *
UpdateDatabase

Updates an existing database specified by the database ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateDatabase(UpdateDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateDatabase(Database database, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateDatabaseCallable() + *
+ *
GetDatabase

Gets the database specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDatabase(GetDatabaseRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDatabase(DatabaseName name) + *
  • getDatabase(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDatabaseCallable() + *
+ *
ListDatabases

List all databases in a specified catalog.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDatabases(ListDatabasesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDatabases(CatalogName parent) + *
  • listDatabases(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDatabasesPagedCallable() + *
  • listDatabasesCallable() + *
+ *
CreateTable

Creates a new table.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createTable(CreateTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createTable(DatabaseName parent, Table table, String tableId) + *
  • createTable(String parent, Table table, String tableId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createTableCallable() + *
+ *
DeleteTable

Deletes an existing table specified by the table ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteTable(DeleteTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteTable(TableName name) + *
  • deleteTable(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteTableCallable() + *
+ *
UpdateTable

Updates an existing table specified by the table ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateTable(UpdateTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateTable(Table table, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateTableCallable() + *
+ *
RenameTable

Renames an existing table specified by the table ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameTable(RenameTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameTable(TableName name, TableName newName) + *
  • renameTable(TableName name, String newName) + *
  • renameTable(String name, TableName newName) + *
  • renameTable(String name, String newName) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameTableCallable() + *
+ *
GetTable

Gets the table specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getTable(GetTableRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getTable(TableName name) + *
  • getTable(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getTableCallable() + *
+ *
ListTables

List all tables in a specified database.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTables(ListTablesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTables(DatabaseName parent) + *
  • listTables(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTablesPagedCallable() + *
  • listTablesCallable() + *
+ *
CreateLock

Creates a new lock.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createLock(CreateLockRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createLock(DatabaseName parent, Lock lock) + *
  • createLock(String parent, Lock lock) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createLockCallable() + *
+ *
DeleteLock

Deletes an existing lock specified by the lock ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteLock(DeleteLockRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteLock(LockName name) + *
  • deleteLock(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteLockCallable() + *
+ *
CheckLock

Checks the state of a lock specified by the lock ID.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • checkLock(CheckLockRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • checkLock(LockName name) + *
  • checkLock(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • checkLockCallable() + *
+ *
ListLocks

List all locks in a specified database.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocks(ListLocksRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listLocks(DatabaseName parent) + *
  • listLocks(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocksPagedCallable() + *
  • listLocksCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/stub/MetastoreServiceStubSettings.java b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/stub/MetastoreServiceStubSettings.java index af8864eb9bac..02ec4527096a 100644 --- a/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/stub/MetastoreServiceStubSettings.java +++ b/java-biglake/google-cloud-biglake/src/main/java/com/google/cloud/bigquery/biglake/v1alpha1/stub/MetastoreServiceStubSettings.java @@ -483,6 +483,12 @@ public MetastoreServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "biglake"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquery-data-exchange/README.md b/java-bigquery-data-exchange/README.md index bc54335f408b..83cb06c0b3f6 100644 --- a/java-bigquery-data-exchange/README.md +++ b/java-bigquery-data-exchange/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigquery-data-exchange.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquery-data-exchange/2.25.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquery-data-exchange/2.27.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/AnalyticsHubServiceClient.java b/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/AnalyticsHubServiceClient.java index b3dd5b5d0911..4d167fc2c873 100644 --- a/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/AnalyticsHubServiceClient.java +++ b/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/AnalyticsHubServiceClient.java @@ -71,19 +71,313 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListDataExchanges

Lists all data exchanges in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDataExchanges(ListDataExchangesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDataExchanges(LocationName parent) + *
  • listDataExchanges(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDataExchangesPagedCallable() + *
  • listDataExchangesCallable() + *
+ *
ListOrgDataExchanges

Lists all data exchanges from projects in a given organization and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listOrgDataExchanges(ListOrgDataExchangesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listOrgDataExchanges(String organization) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listOrgDataExchangesPagedCallable() + *
  • listOrgDataExchangesCallable() + *
+ *
GetDataExchange

Gets the details of a data exchange.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDataExchange(GetDataExchangeRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDataExchange(DataExchangeName name) + *
  • getDataExchange(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDataExchangeCallable() + *
+ *
CreateDataExchange

Creates a new data exchange.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createDataExchange(CreateDataExchangeRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createDataExchange(LocationName parent, DataExchange dataExchange) + *
  • createDataExchange(String parent, DataExchange dataExchange) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createDataExchangeCallable() + *
+ *
UpdateDataExchange

Updates an existing data exchange.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateDataExchange(UpdateDataExchangeRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateDataExchange(DataExchange dataExchange, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateDataExchangeCallable() + *
+ *
DeleteDataExchange

Deletes an existing data exchange.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteDataExchange(DeleteDataExchangeRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteDataExchange(DataExchangeName name) + *
  • deleteDataExchange(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteDataExchangeCallable() + *
+ *
ListListings

Lists all listings in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listListings(ListListingsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listListings(DataExchangeName parent) + *
  • listListings(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listListingsPagedCallable() + *
  • listListingsCallable() + *
+ *
GetListing

Gets the details of a listing.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getListing(GetListingRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getListing(ListingName name) + *
  • getListing(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getListingCallable() + *
+ *
CreateListing

Creates a new listing.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createListing(CreateListingRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createListing(DataExchangeName parent, Listing listing) + *
  • createListing(String parent, Listing listing) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createListingCallable() + *
+ *
UpdateListing

Updates an existing listing.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateListing(UpdateListingRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateListing(Listing listing, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateListingCallable() + *
+ *
DeleteListing

Deletes a listing.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteListing(DeleteListingRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteListing(ListingName name) + *
  • deleteListing(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteListingCallable() + *
+ *
SubscribeListing

Subscribes to a listing. + *

Currently, with Analytics Hub, you can create listings that reference only BigQuery datasets. Upon subscription to a listing for a BigQuery dataset, Analytics Hub creates a linked dataset in the subscriber's project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • subscribeListing(SubscribeListingRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • subscribeListing(ListingName name) + *
  • subscribeListing(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • subscribeListingCallable() + *
+ *
GetIamPolicy

Gets the IAM policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
SetIamPolicy

Sets the IAM policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
TestIamPermissions

Returns the permissions that a caller has.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/stub/AnalyticsHubServiceStubSettings.java b/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/stub/AnalyticsHubServiceStubSettings.java index bda2539343fb..497351753a88 100644 --- a/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/stub/AnalyticsHubServiceStubSettings.java +++ b/java-bigquery-data-exchange/google-cloud-bigquery-data-exchange/src/main/java/com/google/cloud/bigquery/dataexchange/v1beta1/stub/AnalyticsHubServiceStubSettings.java @@ -504,6 +504,12 @@ public AnalyticsHubServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "analyticshub"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigqueryconnection/README.md b/java-bigqueryconnection/README.md index dc7c534c41fe..8081710b2a01 100644 --- a/java-bigqueryconnection/README.md +++ b/java-bigqueryconnection/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigqueryconnection.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigqueryconnection/2.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigqueryconnection/2.34.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/ConnectionServiceClient.java b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/ConnectionServiceClient.java index d54e2c317bdd..a1b506d27e97 100644 --- a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/ConnectionServiceClient.java +++ b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/ConnectionServiceClient.java @@ -62,19 +62,185 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateConnection

Creates a new connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createConnection(ConnectionProto.CreateConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createConnection(LocationName parent, ConnectionProto.Connection connection, String connectionId) + *
  • createConnection(String parent, ConnectionProto.Connection connection, String connectionId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createConnectionCallable() + *
+ *
GetConnection

Returns specified connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getConnection(ConnectionProto.GetConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getConnection(ConnectionName name) + *
  • getConnection(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getConnectionCallable() + *
+ *
ListConnections

Returns a list of connections in the given project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listConnections(ConnectionProto.ListConnectionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listConnections(LocationName parent, UInt32Value maxResults) + *
  • listConnections(String parent, UInt32Value maxResults) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listConnectionsCallable() + *
+ *
UpdateConnection

Updates the specified connection. For security reasons, also resets credential if connection properties are in the update field mask.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateConnection(ConnectionProto.UpdateConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateConnection(ConnectionName name, ConnectionProto.Connection connection, FieldMask updateMask) + *
  • updateConnection(String name, ConnectionProto.Connection connection, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateConnectionCallable() + *
+ *
UpdateConnectionCredential

Sets the credential for the specified connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateConnectionCredential(ConnectionProto.UpdateConnectionCredentialRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateConnectionCredential(String name, ConnectionProto.ConnectionCredential credential) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateConnectionCredentialCallable() + *
+ *
DeleteConnection

Deletes connection and associated credential.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteConnection(ConnectionProto.DeleteConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteConnection(ConnectionName name) + *
  • deleteConnection(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteConnectionCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getIamPolicy(ResourceName resource, GetPolicyOptions options) + *
  • getIamPolicy(String resource, GetPolicyOptions options) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replaces any existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • setIamPolicy(ResourceName resource, Policy policy) + *
  • setIamPolicy(String resource, Policy policy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
TestIamPermissions

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.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • testIamPermissions(ResourceName resource, List permissions) + *
  • testIamPermissions(String resource, List permissions) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStubSettings.java b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStubSettings.java index 42cfc577a07e..22ef341d21f6 100644 --- a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStubSettings.java +++ b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigquery/connection/v1beta1/stub/ConnectionServiceStubSettings.java @@ -188,6 +188,12 @@ public ConnectionServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigqueryconnection"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/ConnectionServiceClient.java b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/ConnectionServiceClient.java index ef00721d991c..728eb9fb5ea8 100644 --- a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/ConnectionServiceClient.java +++ b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/ConnectionServiceClient.java @@ -76,19 +76,168 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateConnection

Creates a new connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createConnection(CreateConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createConnection(LocationName parent, Connection connection, String connectionId) + *
  • createConnection(String parent, Connection connection, String connectionId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createConnectionCallable() + *
+ *
GetConnection

Returns specified connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getConnection(GetConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getConnection(ConnectionName name) + *
  • getConnection(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getConnectionCallable() + *
+ *
ListConnections

Returns a list of connections in the given project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listConnections(ListConnectionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listConnections(LocationName parent) + *
  • listConnections(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listConnectionsPagedCallable() + *
  • listConnectionsCallable() + *
+ *
UpdateConnection

Updates the specified connection. For security reasons, also resets credential if connection properties are in the update field mask.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateConnection(UpdateConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateConnection(ConnectionName name, Connection connection, FieldMask updateMask) + *
  • updateConnection(String name, Connection connection, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateConnectionCallable() + *
+ *
DeleteConnection

Deletes connection and associated credential.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteConnection(DeleteConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteConnection(ConnectionName name) + *
  • deleteConnection(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteConnectionCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getIamPolicy(ResourceName resource, GetPolicyOptions options) + *
  • getIamPolicy(String resource, GetPolicyOptions options) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replaces any existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • setIamPolicy(ResourceName resource, Policy policy) + *
  • setIamPolicy(String resource, Policy policy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
TestIamPermissions

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.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • testIamPermissions(ResourceName resource, List permissions) + *
  • testIamPermissions(String resource, List permissions) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/stub/ConnectionServiceStubSettings.java b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/stub/ConnectionServiceStubSettings.java index 146c1089b63a..8b4594c6e6de 100644 --- a/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/stub/ConnectionServiceStubSettings.java +++ b/java-bigqueryconnection/google-cloud-bigqueryconnection/src/main/java/com/google/cloud/bigqueryconnection/v1/stub/ConnectionServiceStubSettings.java @@ -240,6 +240,12 @@ public ConnectionServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigqueryconnection"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquerydatapolicy/README.md b/java-bigquerydatapolicy/README.md index 638f898db113..003eb97e1526 100644 --- a/java-bigquerydatapolicy/README.md +++ b/java-bigquerydatapolicy/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigquerydatapolicy.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerydatapolicy/0.27.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerydatapolicy/0.29.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/DataPolicyServiceClient.java b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/DataPolicyServiceClient.java index bdbe744bc429..628d7abd77f2 100644 --- a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/DataPolicyServiceClient.java +++ b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/DataPolicyServiceClient.java @@ -63,19 +63,168 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateDataPolicy

Creates a new data policy under a project with the given `dataPolicyId` (used as the display name), policy tag, and data policy type.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createDataPolicy(CreateDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createDataPolicy(LocationName parent, DataPolicy dataPolicy) + *
  • createDataPolicy(String parent, DataPolicy dataPolicy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createDataPolicyCallable() + *
+ *
UpdateDataPolicy

Updates the metadata for an existing data policy. The target data policy can be specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateDataPolicy(UpdateDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateDataPolicy(DataPolicy dataPolicy, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateDataPolicyCallable() + *
+ *
RenameDataPolicy

Renames the id (display name) of the specified data policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • renameDataPolicy(RenameDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • renameDataPolicy(String name, String newDataPolicyId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • renameDataPolicyCallable() + *
+ *
DeleteDataPolicy

Deletes the data policy specified by its resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteDataPolicy(DeleteDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteDataPolicy(DataPolicyName name) + *
  • deleteDataPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteDataPolicyCallable() + *
+ *
GetDataPolicy

Gets the data policy specified by its resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDataPolicy(GetDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDataPolicy(DataPolicyName name) + *
  • getDataPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDataPolicyCallable() + *
+ *
ListDataPolicies

List all of the data policies in the specified parent project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDataPolicies(ListDataPoliciesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDataPolicies(LocationName parent) + *
  • listDataPolicies(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDataPoliciesPagedCallable() + *
  • listDataPoliciesCallable() + *
+ *
GetIamPolicy

Gets the IAM policy for the specified data policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
SetIamPolicy

Sets the IAM policy for the specified data policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
TestIamPermissions

Returns the caller's permission on the specified data policy resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/stub/DataPolicyServiceStubSettings.java b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/stub/DataPolicyServiceStubSettings.java index b30d6c6f10e9..787551b42130 100644 --- a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/stub/DataPolicyServiceStubSettings.java +++ b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1/stub/DataPolicyServiceStubSettings.java @@ -249,6 +249,12 @@ public DataPolicyServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigquerydatapolicy"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/DataPolicyServiceClient.java b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/DataPolicyServiceClient.java index cf86a89b9eab..e6ba7f078939 100644 --- a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/DataPolicyServiceClient.java +++ b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/DataPolicyServiceClient.java @@ -64,19 +64,150 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateDataPolicy

Creates a new data policy under a project with the given `dataPolicyId` (used as the display name), policy tag, and data policy type.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createDataPolicy(CreateDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createDataPolicy(LocationName parent, DataPolicy dataPolicy) + *
  • createDataPolicy(String parent, DataPolicy dataPolicy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createDataPolicyCallable() + *
+ *
UpdateDataPolicy

Updates the metadata for an existing data policy. The target data policy can be specified by the resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateDataPolicy(UpdateDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateDataPolicy(DataPolicy dataPolicy, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateDataPolicyCallable() + *
+ *
DeleteDataPolicy

Deletes the data policy specified by its resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteDataPolicy(DeleteDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteDataPolicy(DataPolicyName name) + *
  • deleteDataPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteDataPolicyCallable() + *
+ *
GetDataPolicy

Gets the data policy specified by its resource name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDataPolicy(GetDataPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDataPolicy(DataPolicyName name) + *
  • getDataPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDataPolicyCallable() + *
+ *
ListDataPolicies

List all of the data policies in the specified parent project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDataPolicies(ListDataPoliciesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDataPolicies(LocationName parent) + *
  • listDataPolicies(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDataPoliciesPagedCallable() + *
  • listDataPoliciesCallable() + *
+ *
GetIamPolicy

Gets the IAM policy for the specified data policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
SetIamPolicy

Sets the IAM policy for the specified data policy.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
TestIamPermissions

Returns the caller's permission on the specified data policy resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/stub/DataPolicyServiceStubSettings.java b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/stub/DataPolicyServiceStubSettings.java index 198364f9c85f..af276feb3da2 100644 --- a/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/stub/DataPolicyServiceStubSettings.java +++ b/java-bigquerydatapolicy/google-cloud-bigquerydatapolicy/src/main/java/com/google/cloud/bigquery/datapolicies/v1beta1/stub/DataPolicyServiceStubSettings.java @@ -243,6 +243,12 @@ public DataPolicyServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigquerydatapolicy"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquerydatatransfer/README.md b/java-bigquerydatatransfer/README.md index 2c10d4c35902..57ba99eb4afa 100644 --- a/java-bigquerydatatransfer/README.md +++ b/java-bigquerydatatransfer/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigquerydatatransfer.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerydatatransfer/2.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerydatatransfer/2.32.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceClient.java b/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceClient.java index ad89d8313fe3..047a56e17e6e 100644 --- a/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceClient.java +++ b/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceClient.java @@ -64,19 +64,323 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetDataSource

Retrieves a supported data source and returns its settings.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDataSource(GetDataSourceRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDataSource(DataSourceName name) + *
  • getDataSource(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDataSourceCallable() + *
+ *
ListDataSources

Lists supported data sources and returns their settings.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDataSources(ListDataSourcesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDataSources(LocationName parent) + *
  • listDataSources(ProjectName parent) + *
  • listDataSources(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDataSourcesPagedCallable() + *
  • listDataSourcesCallable() + *
+ *
CreateTransferConfig

Creates a new data transfer configuration.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createTransferConfig(CreateTransferConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createTransferConfig(LocationName parent, TransferConfig transferConfig) + *
  • createTransferConfig(ProjectName parent, TransferConfig transferConfig) + *
  • createTransferConfig(String parent, TransferConfig transferConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createTransferConfigCallable() + *
+ *
UpdateTransferConfig

Updates a data transfer configuration. All fields must be set, even if they are not updated.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateTransferConfig(UpdateTransferConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateTransferConfig(TransferConfig transferConfig, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateTransferConfigCallable() + *
+ *
DeleteTransferConfig

Deletes a data transfer configuration, including any associated transfer runs and logs.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteTransferConfig(DeleteTransferConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteTransferConfig(TransferConfigName name) + *
  • deleteTransferConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteTransferConfigCallable() + *
+ *
GetTransferConfig

Returns information about a data transfer config.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getTransferConfig(GetTransferConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getTransferConfig(TransferConfigName name) + *
  • getTransferConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getTransferConfigCallable() + *
+ *
ListTransferConfigs

Returns information about all transfer configs owned by a project in the specified location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTransferConfigs(ListTransferConfigsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTransferConfigs(LocationName parent) + *
  • listTransferConfigs(ProjectName parent) + *
  • listTransferConfigs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTransferConfigsPagedCallable() + *
  • listTransferConfigsCallable() + *
+ *
ScheduleTransferRuns

Creates transfer runs for a time range [start_time, end_time]. For each date - or whatever granularity the data source supports - in the range, one transfer run is created. Note that runs are created per UTC time in the time range. DEPRECATED: use StartManualTransferRuns instead.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • scheduleTransferRuns(ScheduleTransferRunsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • scheduleTransferRuns(TransferConfigName parent, Timestamp startTime, Timestamp endTime) + *
  • scheduleTransferRuns(String parent, Timestamp startTime, Timestamp endTime) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • scheduleTransferRunsCallable() + *
+ *
StartManualTransferRuns

Start manual transfer runs to be executed now with schedule_time equal to current time. The transfer runs can be created for a time range where the run_time is between start_time (inclusive) and end_time (exclusive), or for a specific run_time.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • startManualTransferRuns(StartManualTransferRunsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • startManualTransferRunsCallable() + *
+ *
GetTransferRun

Returns information about the particular transfer run.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getTransferRun(GetTransferRunRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getTransferRun(RunName name) + *
  • getTransferRun(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getTransferRunCallable() + *
+ *
DeleteTransferRun

Deletes the specified transfer run.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteTransferRun(DeleteTransferRunRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteTransferRun(RunName name) + *
  • deleteTransferRun(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteTransferRunCallable() + *
+ *
ListTransferRuns

Returns information about running and completed transfer runs.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTransferRuns(ListTransferRunsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTransferRuns(TransferConfigName parent) + *
  • listTransferRuns(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTransferRunsPagedCallable() + *
  • listTransferRunsCallable() + *
+ *
ListTransferLogs

Returns log messages for the transfer run.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTransferLogs(ListTransferLogsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listTransferLogs(RunName parent) + *
  • listTransferLogs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTransferLogsPagedCallable() + *
  • listTransferLogsCallable() + *
+ *
CheckValidCreds

Returns true if valid credentials exist for the given data source and requesting user.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • checkValidCreds(CheckValidCredsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • checkValidCreds(DataSourceName name) + *
  • checkValidCreds(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • checkValidCredsCallable() + *
+ *
EnrollDataSources

Enroll data sources in a user project. This allows users to create transfer configurations for these data sources. They will also appear in the ListDataSources RPC and as such, will appear in the [BigQuery UI](https://console.cloud.google.com/bigquery), and the documents can be found in the public guide for [BigQuery Web UI](https://cloud.google.com/bigquery/bigquery-web-ui) and [Data Transfer Service](https://cloud.google.com/bigquery/docs/working-with-transfers).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • enrollDataSources(EnrollDataSourcesRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • enrollDataSourcesCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/stub/DataTransferServiceStubSettings.java b/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/stub/DataTransferServiceStubSettings.java index 0438998ab367..23867e3995b7 100644 --- a/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/stub/DataTransferServiceStubSettings.java +++ b/java-bigquerydatatransfer/google-cloud-bigquerydatatransfer/src/main/java/com/google/cloud/bigquery/datatransfer/v1/stub/DataTransferServiceStubSettings.java @@ -574,6 +574,12 @@ public DataTransferServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigquerydatatransfer"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquerymigration/README.md b/java-bigquerymigration/README.md index d1aa584b07ad..322bfb31edab 100644 --- a/java-bigquerymigration/README.md +++ b/java-bigquerymigration/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigquerymigration.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerymigration/0.33.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigquerymigration/0.35.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/MigrationServiceClient.java b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/MigrationServiceClient.java index f9e7306865f0..ecba70fefe79 100644 --- a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/MigrationServiceClient.java +++ b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/MigrationServiceClient.java @@ -58,19 +58,148 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateMigrationWorkflow

Creates a migration workflow.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createMigrationWorkflow(CreateMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createMigrationWorkflow(LocationName parent, MigrationWorkflow migrationWorkflow) + *
  • createMigrationWorkflow(String parent, MigrationWorkflow migrationWorkflow) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createMigrationWorkflowCallable() + *
+ *
GetMigrationWorkflow

Gets a previously created migration workflow.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getMigrationWorkflow(GetMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getMigrationWorkflow(MigrationWorkflowName name) + *
  • getMigrationWorkflow(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getMigrationWorkflowCallable() + *
+ *
ListMigrationWorkflows

Lists previously created migration workflow.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listMigrationWorkflows(ListMigrationWorkflowsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listMigrationWorkflows(LocationName parent) + *
  • listMigrationWorkflows(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listMigrationWorkflowsPagedCallable() + *
  • listMigrationWorkflowsCallable() + *
+ *
DeleteMigrationWorkflow

Deletes a migration workflow by name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteMigrationWorkflow(DeleteMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteMigrationWorkflow(MigrationWorkflowName name) + *
  • deleteMigrationWorkflow(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteMigrationWorkflowCallable() + *
+ *
StartMigrationWorkflow

Starts a previously created migration workflow. I.e., the state transitions from DRAFT to RUNNING. This is a no-op if the state is already RUNNING. An error will be signaled if the state is anything other than DRAFT or RUNNING.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • startMigrationWorkflow(StartMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • startMigrationWorkflow(MigrationWorkflowName name) + *
  • startMigrationWorkflow(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • startMigrationWorkflowCallable() + *
+ *
GetMigrationSubtask

Gets a previously created migration subtask.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getMigrationSubtask(GetMigrationSubtaskRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getMigrationSubtask(MigrationSubtaskName name) + *
  • getMigrationSubtask(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getMigrationSubtaskCallable() + *
+ *
ListMigrationSubtasks

Lists previously created migration subtasks.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listMigrationSubtasks(ListMigrationSubtasksRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listMigrationSubtasks(MigrationWorkflowName parent) + *
  • listMigrationSubtasks(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listMigrationSubtasksPagedCallable() + *
  • listMigrationSubtasksCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/stub/MigrationServiceStubSettings.java b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/stub/MigrationServiceStubSettings.java index 939fbe0f8100..f9dd344de624 100644 --- a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/stub/MigrationServiceStubSettings.java +++ b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2/stub/MigrationServiceStubSettings.java @@ -328,6 +328,12 @@ public MigrationServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigquerymigration"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/MigrationServiceClient.java b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/MigrationServiceClient.java index a46a8fd8dee8..370ffc730727 100644 --- a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/MigrationServiceClient.java +++ b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/MigrationServiceClient.java @@ -59,19 +59,148 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateMigrationWorkflow

Creates a migration workflow.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createMigrationWorkflow(CreateMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createMigrationWorkflow(LocationName parent, MigrationWorkflow migrationWorkflow) + *
  • createMigrationWorkflow(String parent, MigrationWorkflow migrationWorkflow) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createMigrationWorkflowCallable() + *
+ *
GetMigrationWorkflow

Gets a previously created migration workflow.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getMigrationWorkflow(GetMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getMigrationWorkflow(MigrationWorkflowName name) + *
  • getMigrationWorkflow(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getMigrationWorkflowCallable() + *
+ *
ListMigrationWorkflows

Lists previously created migration workflow.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listMigrationWorkflows(ListMigrationWorkflowsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listMigrationWorkflows(LocationName parent) + *
  • listMigrationWorkflows(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listMigrationWorkflowsPagedCallable() + *
  • listMigrationWorkflowsCallable() + *
+ *
DeleteMigrationWorkflow

Deletes a migration workflow by name.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteMigrationWorkflow(DeleteMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteMigrationWorkflow(MigrationWorkflowName name) + *
  • deleteMigrationWorkflow(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteMigrationWorkflowCallable() + *
+ *
StartMigrationWorkflow

Starts a previously created migration workflow. I.e., the state transitions from DRAFT to RUNNING. This is a no-op if the state is already RUNNING. An error will be signaled if the state is anything other than DRAFT or RUNNING.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • startMigrationWorkflow(StartMigrationWorkflowRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • startMigrationWorkflow(MigrationWorkflowName name) + *
  • startMigrationWorkflow(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • startMigrationWorkflowCallable() + *
+ *
GetMigrationSubtask

Gets a previously created migration subtask.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getMigrationSubtask(GetMigrationSubtaskRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getMigrationSubtask(MigrationSubtaskName name) + *
  • getMigrationSubtask(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getMigrationSubtaskCallable() + *
+ *
ListMigrationSubtasks

Lists previously created migration subtasks.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listMigrationSubtasks(ListMigrationSubtasksRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listMigrationSubtasks(MigrationWorkflowName parent) + *
  • listMigrationSubtasks(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listMigrationSubtasksPagedCallable() + *
  • listMigrationSubtasksCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/SqlTranslationServiceClient.java b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/SqlTranslationServiceClient.java index 520322c7a653..321bd26294d1 100644 --- a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/SqlTranslationServiceClient.java +++ b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/SqlTranslationServiceClient.java @@ -53,19 +53,32 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
TranslateQuery

Translates input queries from source dialects to GoogleSQL.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • translateQuery(TranslateQueryRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • translateQuery(LocationName parent, TranslateQueryRequest.SqlTranslationSourceDialect sourceDialect, String query) + *
  • translateQuery(String parent, TranslateQueryRequest.SqlTranslationSourceDialect sourceDialect, String query) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • translateQueryCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/MigrationServiceStubSettings.java b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/MigrationServiceStubSettings.java index 1ecce293dadd..8b1e85d19059 100644 --- a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/MigrationServiceStubSettings.java +++ b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/MigrationServiceStubSettings.java @@ -329,6 +329,12 @@ public MigrationServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigquerymigration"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/SqlTranslationServiceStubSettings.java b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/SqlTranslationServiceStubSettings.java index f9891bd05bcc..32d456041935 100644 --- a/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/SqlTranslationServiceStubSettings.java +++ b/java-bigquerymigration/google-cloud-bigquerymigration/src/main/java/com/google/cloud/bigquery/migration/v2alpha/stub/SqlTranslationServiceStubSettings.java @@ -115,6 +115,12 @@ public SqlTranslationServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigquerymigration"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-bigqueryreservation/README.md b/java-bigqueryreservation/README.md index 50fcd9899372..495091226788 100644 --- a/java-bigqueryreservation/README.md +++ b/java-bigqueryreservation/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-bigqueryreservation.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigqueryreservation/2.25.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-bigqueryreservation/2.33.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceClient.java b/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceClient.java index c2d2fedbe149..92b62b46d3c0 100644 --- a/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceClient.java +++ b/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceClient.java @@ -72,19 +72,464 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateReservation

Creates a new reservation resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createReservation(CreateReservationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createReservation(LocationName parent, Reservation reservation, String reservationId) + *
  • createReservation(String parent, Reservation reservation, String reservationId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createReservationCallable() + *
+ *
ListReservations

Lists all the reservations for the project in the specified location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listReservations(ListReservationsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listReservations(LocationName parent) + *
  • listReservations(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listReservationsPagedCallable() + *
  • listReservationsCallable() + *
+ *
GetReservation

Returns information about the reservation.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getReservation(GetReservationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getReservation(ReservationName name) + *
  • getReservation(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getReservationCallable() + *
+ *
DeleteReservation

Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has assignments.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteReservation(DeleteReservationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteReservation(ReservationName name) + *
  • deleteReservation(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteReservationCallable() + *
+ *
UpdateReservation

Updates an existing reservation resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateReservation(UpdateReservationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateReservation(Reservation reservation, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateReservationCallable() + *
+ *
CreateCapacityCommitment

Creates a new capacity commitment resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCapacityCommitment(CreateCapacityCommitmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createCapacityCommitment(LocationName parent, CapacityCommitment capacityCommitment) + *
  • createCapacityCommitment(String parent, CapacityCommitment capacityCommitment) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCapacityCommitmentCallable() + *
+ *
ListCapacityCommitments

Lists all the capacity commitments for the admin project.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCapacityCommitments(ListCapacityCommitmentsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCapacityCommitments(LocationName parent) + *
  • listCapacityCommitments(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCapacityCommitmentsPagedCallable() + *
  • listCapacityCommitmentsCallable() + *
+ *
GetCapacityCommitment

Returns information about the capacity commitment.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCapacityCommitment(GetCapacityCommitmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCapacityCommitment(CapacityCommitmentName name) + *
  • getCapacityCommitment(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCapacityCommitmentCallable() + *
+ *
DeleteCapacityCommitment

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCapacityCommitment(DeleteCapacityCommitmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteCapacityCommitment(CapacityCommitmentName name) + *
  • deleteCapacityCommitment(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCapacityCommitmentCallable() + *
+ *
UpdateCapacityCommitment

Updates an existing capacity commitment. + *

Only `plan` and `renewal_plan` fields can be updated. + *

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateCapacityCommitment(UpdateCapacityCommitmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateCapacityCommitment(CapacityCommitment capacityCommitment, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateCapacityCommitmentCallable() + *
+ *
SplitCapacityCommitment

Splits capacity commitment to two commitments of the same plan and `commitment_end_time`. + *

A common use case is to enable downgrading commitments. + *

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • splitCapacityCommitment(SplitCapacityCommitmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • splitCapacityCommitment(CapacityCommitmentName name, long slotCount) + *
  • splitCapacityCommitment(String name, long slotCount) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • splitCapacityCommitmentCallable() + *
+ *
MergeCapacityCommitments

Merges capacity commitments of the same plan into a single commitment. + *

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments. + *

Attempting to merge capacity commitments of different plan will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • mergeCapacityCommitments(MergeCapacityCommitmentsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • mergeCapacityCommitments(LocationName parent, List capacityCommitmentIds) + *
  • mergeCapacityCommitments(String parent, List capacityCommitmentIds) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • mergeCapacityCommitmentsCallable() + *
+ *
CreateAssignment

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation. + *

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type. + *

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query. + *

When creating assignments, it does not matter if other assignments exist at higher levels. + *

Example: + *

    + *
  • The organization `organizationA` contains two projects, `project1` and `project2`. + *
  • Assignments for all three entities (`organizationA`, `project1`, and `project2`) could all be created and mapped to the same or different reservations. + *
+ *

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: `projects/myproject/locations/US/reservations/none`. + *

Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation. + *

Returns `google.rpc.Code.INVALID_ARGUMENT` when location of the assignment does not match location of the reservation.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createAssignment(CreateAssignmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createAssignment(ReservationName parent, Assignment assignment) + *
  • createAssignment(String parent, Assignment assignment) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createAssignmentCallable() + *
+ *
ListAssignments

Lists assignments. + *

Only explicitly created assignments will be returned. + *

Example: + *

    + *
  • Organization `organizationA` contains two projects, `project1` and `project2`. + *
  • Reservation `res1` exists and was created previously. + *
  • CreateAssignment was used previously to define the following associations between entities and reservations: `<organizationA, res1>` and `<project1, res1>` + *
+ *

In this example, ListAssignments will just return the above two assignments for reservation `res1`, and no expansion/merge will happen. + *

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed. + *

**Note** "-" cannot be used for projects nor locations.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listAssignments(ListAssignmentsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listAssignments(ReservationName parent) + *
  • listAssignments(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listAssignmentsPagedCallable() + *
  • listAssignmentsCallable() + *
+ *
DeleteAssignment

Deletes a assignment. No expansion will happen. + *

Example: + *

    + *
  • Organization `organizationA` contains two projects, `project1` and `project2`. + *
  • Reservation `res1` exists and was created previously. + *
  • CreateAssignment was used previously to define the following associations between entities and reservations: `<organizationA, res1>` and `<project1, res1>` + *
+ *

In this example, deletion of the `<organizationA, res1>` assignment won't affect the other assignment `<project1, res1>`. After said deletion, queries from `project1` will still use `res1` while queries from `project2` will switch to use on-demand mode.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteAssignment(DeleteAssignmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteAssignment(AssignmentName name) + *
  • deleteAssignment(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteAssignmentCallable() + *
+ *
SearchAssignments

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project: + *

1. Assignments created on the project will be returned if they exist. 2. Otherwise assignments created on the closest ancestor will be returned. 3. Assignments for different JobTypes will all be returned. + *

The same logic applies if the request is about a folder. + *

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors). + *

Comparing to ListAssignments, there are some behavior differences: + *

1. permission on the assignee will be verified in this API. 2. Hierarchy lookup (project->folder->organization) happens in this API. 3. Parent here is `projects/*/locations/*`, instead of `projects/*/locations/*reservations/*`. + *

**Note** "-" cannot be used for projects nor locations.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • searchAssignments(SearchAssignmentsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • searchAssignments(LocationName parent, String query) + *
  • searchAssignments(String parent, String query) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • searchAssignmentsPagedCallable() + *
  • searchAssignmentsCallable() + *
+ *
SearchAllAssignments

Looks up assignments for a specified resource for a particular region. If the request is about a project: + *

1. Assignments created on the project will be returned if they exist. 2. Otherwise assignments created on the closest ancestor will be returned. 3. Assignments for different JobTypes will all be returned. + *

The same logic applies if the request is about a folder. + *

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors). + *

Comparing to ListAssignments, there are some behavior differences: + *

1. permission on the assignee will be verified in this API. 2. Hierarchy lookup (project->folder->organization) happens in this API. 3. Parent here is `projects/*/locations/*`, instead of `projects/*/locations/*reservations/*`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • searchAllAssignments(SearchAllAssignmentsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • searchAllAssignments(LocationName parent, String query) + *
  • searchAllAssignments(String parent, String query) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • searchAllAssignmentsPagedCallable() + *
  • searchAllAssignmentsCallable() + *
+ *
MoveAssignment

Moves an assignment under a new reservation. + *

This differs from removing an existing assignment and recreating a new one by providing a transactional change that ensures an assignee always has an associated reservation.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • moveAssignment(MoveAssignmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • moveAssignment(AssignmentName name, ReservationName destinationId) + *
  • moveAssignment(AssignmentName name, String destinationId) + *
  • moveAssignment(String name, ReservationName destinationId) + *
  • moveAssignment(String name, String destinationId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • moveAssignmentCallable() + *
+ *
UpdateAssignment

Updates an existing assignment. + *

Only the `priority` field can be updated.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateAssignment(UpdateAssignmentRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateAssignment(Assignment assignment, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateAssignmentCallable() + *
+ *
GetBiReservation

Retrieves a BI reservation.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getBiReservation(GetBiReservationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getBiReservation(BiReservationName name) + *
  • getBiReservation(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getBiReservationCallable() + *
+ *
UpdateBiReservation

Updates a BI reservation. + *

Only fields specified in the `field_mask` are updated. + *

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateBiReservation(UpdateBiReservationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateBiReservation(BiReservation biReservation, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateBiReservationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/stub/ReservationServiceStubSettings.java b/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/stub/ReservationServiceStubSettings.java index 48e536d29b3c..b1c94ff676ac 100644 --- a/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/stub/ReservationServiceStubSettings.java +++ b/java-bigqueryreservation/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/stub/ReservationServiceStubSettings.java @@ -637,6 +637,12 @@ public ReservationServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "bigqueryreservation"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-billing/README.md b/java-billing/README.md index a0b8d6eebb46..161794d6d832 100644 --- a/java-billing/README.md +++ b/java-billing/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-billing.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billing/2.31.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billing/2.32.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudBillingClient.java b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudBillingClient.java index 22ee164c654f..c0435e0f09fd 100644 --- a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudBillingClient.java +++ b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudBillingClient.java @@ -61,19 +61,227 @@ *

Note: close() needs to be called on the CloudBillingClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetBillingAccount

Gets information about a billing account. The current authenticated user must be a [viewer of the billing account](https://cloud.google.com/billing/docs/how-to/billing-access).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getBillingAccount(GetBillingAccountRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getBillingAccount(BillingAccountName name) + *
  • getBillingAccount(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getBillingAccountCallable() + *
+ *
ListBillingAccounts

Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listBillingAccounts(ListBillingAccountsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listBillingAccounts() + *
  • listBillingAccounts(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listBillingAccountsPagedCallable() + *
  • listBillingAccountsCallable() + *
+ *
UpdateBillingAccount

Updates a billing account's fields. Currently the only field that can be edited is `display_name`. The current authenticated user must have the `billing.accounts.update` IAM permission, which is typically given to the [administrator](https://cloud.google.com/billing/docs/how-to/billing-access) of the billing account.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateBillingAccount(UpdateBillingAccountRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateBillingAccount(BillingAccountName name, BillingAccount account) + *
  • updateBillingAccount(String name, BillingAccount account) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateBillingAccountCallable() + *
+ *
CreateBillingAccount

This method creates [billing subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts). + *

Google Cloud resellers should use the Channel Services APIs, [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create). + *

When creating a subaccount, the current authenticated user must have the `billing.accounts.update` IAM permission on the parent account, which is typically given to billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). This method will return an error if the parent account has not been provisioned for subaccounts.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createBillingAccount(CreateBillingAccountRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createBillingAccount(BillingAccount billingAccount) + *
  • createBillingAccount(BillingAccount billingAccount, String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createBillingAccountCallable() + *
+ *
ListProjectBillingInfo

Lists the projects associated with a billing account. The current authenticated user must have the `billing.resourceAssociations.list` IAM permission, which is often given to billing account [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listProjectBillingInfo(ListProjectBillingInfoRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listProjectBillingInfo(BillingAccountName name) + *
  • listProjectBillingInfo(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listProjectBillingInfoPagedCallable() + *
  • listProjectBillingInfoCallable() + *
+ *
GetProjectBillingInfo

Gets the billing information for a project. The current authenticated user must have the `resourcemanager.projects.get` permission for the project, which can be granted by assigning the [Project Viewer](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) role.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getProjectBillingInfo(GetProjectBillingInfoRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getProjectBillingInfo(ProjectName name) + *
  • getProjectBillingInfo(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getProjectBillingInfoCallable() + *
+ *
UpdateProjectBillingInfo

Sets or updates the billing account associated with a project. You specify the new billing account by setting the `billing_account_name` in the `ProjectBillingInfo` resource to the resource name of a billing account. Associating a project with an open billing account enables billing on the project and allows charges for resource usage. If the project already had a billing account, this method changes the billing account used for resource usage charges. + *

*Note:* Incurred charges that have not yet been reported in the transaction history of the Google Cloud Console might be billed to the new billing account, even if the charge occurred before the new billing account was assigned to the project. + *

The current authenticated user must have ownership privileges for both the [project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo ) and the [billing account](https://cloud.google.com/billing/docs/how-to/billing-access). + *

You can disable billing on the project by setting the `billing_account_name` field to empty. This action disassociates the current billing account from the project. Any billable activity of your in-use services will stop, and your application could stop functioning as expected. Any unbilled charges to date will be billed to the previously associated account. The current authenticated user must be either an owner of the project or an owner of the billing account for the project. + *

Note that associating a project with a *closed* billing account will have much the same effect as disabling billing on the project: any paid resources used by the project will be shut down. Thus, unless you wish to disable billing, you should always call this method with the name of an + *

    + *
  • open* billing account. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateProjectBillingInfo(UpdateProjectBillingInfoRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateProjectBillingInfo(String name, ProjectBillingInfo projectBillingInfo) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateProjectBillingInfoCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a billing account. The caller must have the `billing.accounts.getIamPolicy` permission on the account, which is often given to billing account [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getIamPolicy(ResourceName resource) + *
  • getIamPolicy(String resource) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
SetIamPolicy

Sets the access control policy for a billing account. Replaces any existing policy. The caller must have the `billing.accounts.setIamPolicy` permission on the account, which is often given to billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • setIamPolicy(ResourceName resource, Policy policy) + *
  • setIamPolicy(String resource, Policy policy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
TestIamPermissions

Tests the access control policy for a billing account. This method takes the resource and a set of permissions as input and returns the subset of the input permissions that the caller is allowed for that resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • testIamPermissions(ResourceName resource, List permissions) + *
  • testIamPermissions(String resource, List permissions) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
MoveBillingAccount

Changes which parent organization a billing account belongs to.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • moveBillingAccount(MoveBillingAccountRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • moveBillingAccountCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudCatalogClient.java b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudCatalogClient.java index 6d54070fc0a6..1ea6b2d4027e 100644 --- a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudCatalogClient.java +++ b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudCatalogClient.java @@ -56,19 +56,52 @@ *

Note: close() needs to be called on the CloudCatalogClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListServices

Lists all public cloud services.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listServices(ListServicesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listServices() + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listServicesPagedCallable() + *
  • listServicesCallable() + *
+ *
ListSkus

Lists all publicly available SKUs for a given cloud service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listSkus(ListSkusRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listSkus(ServiceName parent) + *
  • listSkus(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listSkusPagedCallable() + *
  • listSkusCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudBillingStubSettings.java b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudBillingStubSettings.java index 5bf5b1cd87e0..286769f09fd7 100644 --- a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudBillingStubSettings.java +++ b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudBillingStubSettings.java @@ -355,6 +355,12 @@ public CloudBillingStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudbilling"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudCatalogStubSettings.java b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudCatalogStubSettings.java index 1a99d72ccc0c..e31e7bb79934 100644 --- a/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudCatalogStubSettings.java +++ b/java-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/stub/CloudCatalogStubSettings.java @@ -245,6 +245,12 @@ public CloudCatalogStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudbilling"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-billingbudgets/README.md b/java-billingbudgets/README.md index bc5203ec12e7..089edf05ff07 100644 --- a/java-billingbudgets/README.md +++ b/java-billingbudgets/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-billingbudgets.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billingbudgets/2.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billingbudgets/2.32.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/BudgetServiceClient.java b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/BudgetServiceClient.java index 85075d965760..74fbb18ad720 100644 --- a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/BudgetServiceClient.java +++ b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/BudgetServiceClient.java @@ -58,19 +58,111 @@ *

Note: close() needs to be called on the BudgetServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateBudget

Creates a new budget. See [Quotas and limits](https://cloud.google.com/billing/quotas) for more information on the limits of the number of budgets you can create.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createBudget(CreateBudgetRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createBudget(BillingAccountName parent, Budget budget) + *
  • createBudget(String parent, Budget budget) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createBudgetCallable() + *
+ *
UpdateBudget

Updates a budget and returns the updated budget. + *

WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. Budget fields that are not exposed in this API will not be changed by this method.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateBudget(UpdateBudgetRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateBudget(Budget budget, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateBudgetCallable() + *
+ *
GetBudget

Returns a budget. + *

WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getBudget(GetBudgetRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getBudget(BudgetName name) + *
  • getBudget(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getBudgetCallable() + *
+ *
ListBudgets

Returns a list of budgets for a billing account. + *

WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listBudgets(ListBudgetsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listBudgets(BillingAccountName parent) + *
  • listBudgets(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listBudgetsPagedCallable() + *
  • listBudgetsCallable() + *
+ *
DeleteBudget

Deletes a budget. Returns successfully if already deleted.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteBudget(DeleteBudgetRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteBudget(BudgetName name) + *
  • deleteBudget(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteBudgetCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/stub/BudgetServiceStubSettings.java b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/stub/BudgetServiceStubSettings.java index a83c3bdb3ab4..1b4b7bc150e4 100644 --- a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/stub/BudgetServiceStubSettings.java +++ b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1/stub/BudgetServiceStubSettings.java @@ -209,6 +209,12 @@ public BudgetServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "billingbudgets"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java index 7b15cfcc1592..f595610212c2 100644 --- a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java +++ b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java @@ -61,19 +61,87 @@ *

Note: close() needs to be called on the BudgetServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateBudget

Creates a new budget. See [Quotas and limits](https://cloud.google.com/billing/quotas) for more information on the limits of the number of budgets you can create.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createBudget(CreateBudgetRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createBudgetCallable() + *
+ *
UpdateBudget

Updates a budget and returns the updated budget. + *

WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. Budget fields that are not exposed in this API will not be changed by this method.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateBudget(UpdateBudgetRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateBudgetCallable() + *
+ *
GetBudget

Returns a budget. + *

WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getBudget(GetBudgetRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getBudgetCallable() + *
+ *
ListBudgets

Returns a list of budgets for a billing account. + *

WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listBudgets(ListBudgetsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listBudgetsPagedCallable() + *
  • listBudgetsCallable() + *
+ *
DeleteBudget

Deletes a budget. Returns successfully if already deleted.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteBudget(DeleteBudgetRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteBudgetCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/stub/BudgetServiceStubSettings.java b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/stub/BudgetServiceStubSettings.java index 347c1259b82b..e74e6a3be012 100644 --- a/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/stub/BudgetServiceStubSettings.java +++ b/java-billingbudgets/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/stub/BudgetServiceStubSettings.java @@ -202,6 +202,12 @@ public BudgetServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "billingbudgets"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-binary-authorization/README.md b/java-binary-authorization/README.md index 89a452a3de27..4edc5537bf75 100644 --- a/java-binary-authorization/README.md +++ b/java-binary-authorization/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-binary-authorization.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-binary-authorization/1.29.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-binary-authorization/1.31.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/BinauthzManagementServiceV1Beta1Client.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/BinauthzManagementServiceV1Beta1Client.java index 97b1e1a26bda..d07434b03a67 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/BinauthzManagementServiceV1Beta1Client.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/BinauthzManagementServiceV1Beta1Client.java @@ -66,19 +66,146 @@ * up resources such as threads. In the example above, try-with-resources is used, which * automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetPolicy

A [policy][google.cloud.binaryauthorization.v1beta1.Policy] specifies the [attestors][google.cloud.binaryauthorization.v1beta1.Attestor] that must attest to a container image, before the project is allowed to deploy that image. There is at most one policy per project. All image admission requests are permitted if a project has no policy. + *

Gets the [policy][google.cloud.binaryauthorization.v1beta1.Policy] for this project. Returns a default [policy][google.cloud.binaryauthorization.v1beta1.Policy] if the project does not have one.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getPolicy(GetPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getPolicy(PolicyName name) + *
  • getPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getPolicyCallable() + *
+ *
UpdatePolicy

Creates or updates a project's [policy][google.cloud.binaryauthorization.v1beta1.Policy], and returns a copy of the new [policy][google.cloud.binaryauthorization.v1beta1.Policy]. A policy is always updated as a whole, to avoid race conditions with concurrent policy enforcement (or management!) requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT if the request is malformed.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updatePolicy(UpdatePolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updatePolicy(Policy policy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updatePolicyCallable() + *
+ *
CreateAttestor

Creates an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor], and returns a copy of the new [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] already exists.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createAttestor(CreateAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createAttestor(ProjectName parent, String attestorId, Attestor attestor) + *
  • createAttestor(String parent, String attestorId, Attestor attestor) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createAttestorCallable() + *
+ *
GetAttestor

Gets an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. Returns NOT_FOUND if the [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getAttestor(GetAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getAttestor(AttestorName name) + *
  • getAttestor(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getAttestorCallable() + *
+ *
UpdateAttestor

Updates an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. Returns NOT_FOUND if the [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateAttestor(UpdateAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateAttestor(Attestor attestor) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateAttestorCallable() + *
+ *
ListAttestors

Lists [attestors][google.cloud.binaryauthorization.v1beta1.Attestor]. Returns INVALID_ARGUMENT if the project does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listAttestors(ListAttestorsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listAttestors(ProjectName parent) + *
  • listAttestors(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listAttestorsPagedCallable() + *
  • listAttestorsCallable() + *
+ *
DeleteAttestor

Deletes an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. Returns NOT_FOUND if the [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteAttestor(DeleteAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteAttestor(AttestorName name) + *
  • deleteAttestor(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteAttestorCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/SystemPolicyV1Beta1Client.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/SystemPolicyV1Beta1Client.java index cbe36da01ba8..ff0da36a39bc 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/SystemPolicyV1Beta1Client.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/SystemPolicyV1Beta1Client.java @@ -48,19 +48,32 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetSystemPolicy

Gets the current system policy in the specified location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getSystemPolicy(GetSystemPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getSystemPolicy(PolicyName name) + *
  • getSystemPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getSystemPolicyCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/BinauthzManagementServiceV1Beta1StubSettings.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/BinauthzManagementServiceV1Beta1StubSettings.java index ead6523babc0..8bf5410ecfde 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/BinauthzManagementServiceV1Beta1StubSettings.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/BinauthzManagementServiceV1Beta1StubSettings.java @@ -226,6 +226,12 @@ public BinauthzManagementServiceV1Beta1Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "binaryauthorization"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/SystemPolicyV1Beta1StubSettings.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/SystemPolicyV1Beta1StubSettings.java index 736cce837884..5692f19e0936 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/SystemPolicyV1Beta1StubSettings.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/cloud/binaryauthorization/v1beta1/stub/SystemPolicyV1Beta1StubSettings.java @@ -113,6 +113,12 @@ public SystemPolicyV1Beta1Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "binaryauthorization"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/BinauthzManagementServiceV1Client.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/BinauthzManagementServiceV1Client.java index abae1185649b..5d06bc69c0ff 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/BinauthzManagementServiceV1Client.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/BinauthzManagementServiceV1Client.java @@ -65,19 +65,146 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetPolicy

A [policy][google.cloud.binaryauthorization.v1.Policy] specifies the [attestors][google.cloud.binaryauthorization.v1.Attestor] that must attest to a container image, before the project is allowed to deploy that image. There is at most one policy per project. All image admission requests are permitted if a project has no policy. + *

Gets the [policy][google.cloud.binaryauthorization.v1.Policy] for this project. Returns a default [policy][google.cloud.binaryauthorization.v1.Policy] if the project does not have one.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getPolicy(Service.GetPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getPolicy(PolicyName name) + *
  • getPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getPolicyCallable() + *
+ *
UpdatePolicy

Creates or updates a project's [policy][google.cloud.binaryauthorization.v1.Policy], and returns a copy of the new [policy][google.cloud.binaryauthorization.v1.Policy]. A policy is always updated as a whole, to avoid race conditions with concurrent policy enforcement (or management!) requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT if the request is malformed.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updatePolicy(Service.UpdatePolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updatePolicy(Resources.Policy policy) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updatePolicyCallable() + *
+ *
CreateAttestor

Creates an [attestor][google.cloud.binaryauthorization.v1.Attestor], and returns a copy of the new [attestor][google.cloud.binaryauthorization.v1.Attestor]. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the [attestor][google.cloud.binaryauthorization.v1.Attestor] already exists.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createAttestor(Service.CreateAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createAttestor(ProjectName parent, String attestorId, Resources.Attestor attestor) + *
  • createAttestor(String parent, String attestorId, Resources.Attestor attestor) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createAttestorCallable() + *
+ *
GetAttestor

Gets an [attestor][google.cloud.binaryauthorization.v1.Attestor]. Returns NOT_FOUND if the [attestor][google.cloud.binaryauthorization.v1.Attestor] does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getAttestor(Service.GetAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getAttestor(AttestorName name) + *
  • getAttestor(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getAttestorCallable() + *
+ *
UpdateAttestor

Updates an [attestor][google.cloud.binaryauthorization.v1.Attestor]. Returns NOT_FOUND if the [attestor][google.cloud.binaryauthorization.v1.Attestor] does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateAttestor(Service.UpdateAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateAttestor(Resources.Attestor attestor) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateAttestorCallable() + *
+ *
ListAttestors

Lists [attestors][google.cloud.binaryauthorization.v1.Attestor]. Returns INVALID_ARGUMENT if the project does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listAttestors(Service.ListAttestorsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listAttestors(ProjectName parent) + *
  • listAttestors(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listAttestorsPagedCallable() + *
  • listAttestorsCallable() + *
+ *
DeleteAttestor

Deletes an [attestor][google.cloud.binaryauthorization.v1.Attestor]. Returns NOT_FOUND if the [attestor][google.cloud.binaryauthorization.v1.Attestor] does not exist.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteAttestor(Service.DeleteAttestorRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteAttestor(AttestorName name) + *
  • deleteAttestor(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteAttestorCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/SystemPolicyV1Client.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/SystemPolicyV1Client.java index 32e0266f9faa..790c0b1cc526 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/SystemPolicyV1Client.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/SystemPolicyV1Client.java @@ -46,19 +46,32 @@ *

Note: close() needs to be called on the SystemPolicyV1Client object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetSystemPolicy

Gets the current system policy in the specified location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getSystemPolicy(Service.GetSystemPolicyRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getSystemPolicy(PolicyName name) + *
  • getSystemPolicy(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getSystemPolicyCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/ValidationHelperV1Client.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/ValidationHelperV1Client.java index 8e6617ef61d8..f0dafe05799a 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/ValidationHelperV1Client.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/ValidationHelperV1Client.java @@ -54,19 +54,27 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ValidateAttestationOccurrence

Returns whether the given Attestation for the given image URI was signed by the given Attestor

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • validateAttestationOccurrence(Service.ValidateAttestationOccurrenceRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • validateAttestationOccurrenceCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/BinauthzManagementServiceV1StubSettings.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/BinauthzManagementServiceV1StubSettings.java index 78984a459af5..40ed2c1b897f 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/BinauthzManagementServiceV1StubSettings.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/BinauthzManagementServiceV1StubSettings.java @@ -234,6 +234,12 @@ public BinauthzManagementServiceV1Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "binaryauthorization"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/SystemPolicyV1StubSettings.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/SystemPolicyV1StubSettings.java index b70eedb7b1d9..6d803350c706 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/SystemPolicyV1StubSettings.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/SystemPolicyV1StubSettings.java @@ -113,6 +113,12 @@ public SystemPolicyV1Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "binaryauthorization"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/ValidationHelperV1StubSettings.java b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/ValidationHelperV1StubSettings.java index 6f4d059583ea..51627b5c28c8 100644 --- a/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/ValidationHelperV1StubSettings.java +++ b/java-binary-authorization/google-cloud-binary-authorization/src/main/java/com/google/protos/google/cloud/binaryauthorization/v1/stub/ValidationHelperV1StubSettings.java @@ -117,6 +117,12 @@ public ValidationHelperV1Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "binaryauthorization"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-certificate-manager/README.md b/java-certificate-manager/README.md index fe5603daa8f8..1a9df34b3a36 100644 --- a/java-certificate-manager/README.md +++ b/java-certificate-manager/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-certificate-manager.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-certificate-manager/0.33.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-certificate-manager/0.35.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/CertificateManagerClient.java b/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/CertificateManagerClient.java index f25fd621e069..8438841ea206 100644 --- a/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/CertificateManagerClient.java +++ b/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/CertificateManagerClient.java @@ -90,19 +90,513 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListCertificates

Lists Certificates in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCertificates(ListCertificatesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCertificates(LocationName parent) + *
  • listCertificates(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCertificatesPagedCallable() + *
  • listCertificatesCallable() + *
+ *
GetCertificate

Gets details of a single Certificate.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCertificate(GetCertificateRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCertificate(CertificateName name) + *
  • getCertificate(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCertificateCallable() + *
+ *
CreateCertificate

Creates a new Certificate in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCertificateAsync(CreateCertificateRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createCertificateAsync(LocationName parent, Certificate certificate, String certificateId) + *
  • createCertificateAsync(String parent, Certificate certificate, String certificateId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCertificateOperationCallable() + *
  • createCertificateCallable() + *
+ *
UpdateCertificate

Updates a Certificate.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateCertificateAsync(UpdateCertificateRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateCertificateAsync(Certificate certificate, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateCertificateOperationCallable() + *
  • updateCertificateCallable() + *
+ *
DeleteCertificate

Deletes a single Certificate.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCertificateAsync(DeleteCertificateRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteCertificateAsync(CertificateName name) + *
  • deleteCertificateAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCertificateOperationCallable() + *
  • deleteCertificateCallable() + *
+ *
ListCertificateMaps

Lists CertificateMaps in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCertificateMaps(ListCertificateMapsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCertificateMaps(LocationName parent) + *
  • listCertificateMaps(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCertificateMapsPagedCallable() + *
  • listCertificateMapsCallable() + *
+ *
GetCertificateMap

Gets details of a single CertificateMap.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCertificateMap(GetCertificateMapRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCertificateMap(CertificateMapName name) + *
  • getCertificateMap(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCertificateMapCallable() + *
+ *
CreateCertificateMap

Creates a new CertificateMap in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCertificateMapAsync(CreateCertificateMapRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createCertificateMapAsync(LocationName parent, CertificateMap certificateMap, String certificateMapId) + *
  • createCertificateMapAsync(String parent, CertificateMap certificateMap, String certificateMapId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCertificateMapOperationCallable() + *
  • createCertificateMapCallable() + *
+ *
UpdateCertificateMap

Updates a CertificateMap.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateCertificateMapAsync(UpdateCertificateMapRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateCertificateMapAsync(CertificateMap certificateMap, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateCertificateMapOperationCallable() + *
  • updateCertificateMapCallable() + *
+ *
DeleteCertificateMap

Deletes a single CertificateMap. A Certificate Map can't be deleted if it contains Certificate Map Entries. Remove all the entries from the map before calling this method.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCertificateMapAsync(DeleteCertificateMapRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteCertificateMapAsync(CertificateMapName name) + *
  • deleteCertificateMapAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCertificateMapOperationCallable() + *
  • deleteCertificateMapCallable() + *
+ *
ListCertificateMapEntries

Lists CertificateMapEntries in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCertificateMapEntries(ListCertificateMapEntriesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCertificateMapEntries(CertificateMapName parent) + *
  • listCertificateMapEntries(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCertificateMapEntriesPagedCallable() + *
  • listCertificateMapEntriesCallable() + *
+ *
GetCertificateMapEntry

Gets details of a single CertificateMapEntry.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCertificateMapEntry(GetCertificateMapEntryRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCertificateMapEntry(CertificateMapEntryName name) + *
  • getCertificateMapEntry(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCertificateMapEntryCallable() + *
+ *
CreateCertificateMapEntry

Creates a new CertificateMapEntry in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCertificateMapEntryAsync(CreateCertificateMapEntryRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createCertificateMapEntryAsync(CertificateMapName parent, CertificateMapEntry certificateMapEntry, String certificateMapEntryId) + *
  • createCertificateMapEntryAsync(String parent, CertificateMapEntry certificateMapEntry, String certificateMapEntryId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCertificateMapEntryOperationCallable() + *
  • createCertificateMapEntryCallable() + *
+ *
UpdateCertificateMapEntry

Updates a CertificateMapEntry.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateCertificateMapEntryAsync(UpdateCertificateMapEntryRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateCertificateMapEntryAsync(CertificateMapEntry certificateMapEntry, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateCertificateMapEntryOperationCallable() + *
  • updateCertificateMapEntryCallable() + *
+ *
DeleteCertificateMapEntry

Deletes a single CertificateMapEntry.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCertificateMapEntryAsync(DeleteCertificateMapEntryRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteCertificateMapEntryAsync(CertificateMapEntryName name) + *
  • deleteCertificateMapEntryAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCertificateMapEntryOperationCallable() + *
  • deleteCertificateMapEntryCallable() + *
+ *
ListDnsAuthorizations

Lists DnsAuthorizations in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listDnsAuthorizations(ListDnsAuthorizationsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listDnsAuthorizations(LocationName parent) + *
  • listDnsAuthorizations(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listDnsAuthorizationsPagedCallable() + *
  • listDnsAuthorizationsCallable() + *
+ *
GetDnsAuthorization

Gets details of a single DnsAuthorization.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getDnsAuthorization(GetDnsAuthorizationRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getDnsAuthorization(DnsAuthorizationName name) + *
  • getDnsAuthorization(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getDnsAuthorizationCallable() + *
+ *
CreateDnsAuthorization

Creates a new DnsAuthorization in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createDnsAuthorizationAsync(CreateDnsAuthorizationRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createDnsAuthorizationAsync(LocationName parent, DnsAuthorization dnsAuthorization, String dnsAuthorizationId) + *
  • createDnsAuthorizationAsync(String parent, DnsAuthorization dnsAuthorization, String dnsAuthorizationId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createDnsAuthorizationOperationCallable() + *
  • createDnsAuthorizationCallable() + *
+ *
UpdateDnsAuthorization

Updates a DnsAuthorization.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateDnsAuthorizationAsync(UpdateDnsAuthorizationRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateDnsAuthorizationAsync(DnsAuthorization dnsAuthorization, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateDnsAuthorizationOperationCallable() + *
  • updateDnsAuthorizationCallable() + *
+ *
DeleteDnsAuthorization

Deletes a single DnsAuthorization.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteDnsAuthorizationAsync(DeleteDnsAuthorizationRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteDnsAuthorizationAsync(DnsAuthorizationName name) + *
  • deleteDnsAuthorizationAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteDnsAuthorizationOperationCallable() + *
  • deleteDnsAuthorizationCallable() + *
+ *
ListCertificateIssuanceConfigs

Lists CertificateIssuanceConfigs in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCertificateIssuanceConfigs(ListCertificateIssuanceConfigsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCertificateIssuanceConfigs(LocationName parent) + *
  • listCertificateIssuanceConfigs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCertificateIssuanceConfigsPagedCallable() + *
  • listCertificateIssuanceConfigsCallable() + *
+ *
GetCertificateIssuanceConfig

Gets details of a single CertificateIssuanceConfig.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCertificateIssuanceConfig(GetCertificateIssuanceConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCertificateIssuanceConfig(CertificateIssuanceConfigName name) + *
  • getCertificateIssuanceConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCertificateIssuanceConfigCallable() + *
+ *
CreateCertificateIssuanceConfig

Creates a new CertificateIssuanceConfig in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCertificateIssuanceConfigAsync(CreateCertificateIssuanceConfigRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createCertificateIssuanceConfigAsync(LocationName parent, CertificateIssuanceConfig certificateIssuanceConfig, String certificateIssuanceConfigId) + *
  • createCertificateIssuanceConfigAsync(String parent, CertificateIssuanceConfig certificateIssuanceConfig, String certificateIssuanceConfigId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCertificateIssuanceConfigOperationCallable() + *
  • createCertificateIssuanceConfigCallable() + *
+ *
DeleteCertificateIssuanceConfig

Deletes a single CertificateIssuanceConfig.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCertificateIssuanceConfigAsync(DeleteCertificateIssuanceConfigRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteCertificateIssuanceConfigAsync(CertificateIssuanceConfigName name) + *
  • deleteCertificateIssuanceConfigAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCertificateIssuanceConfigOperationCallable() + *
  • deleteCertificateIssuanceConfigCallable() + *
+ *
ListLocations

Lists information about the supported locations for this service.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listLocations(ListLocationsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ *
GetLocation

Gets information about a location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getLocation(GetLocationRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getLocationCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/stub/CertificateManagerStubSettings.java b/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/stub/CertificateManagerStubSettings.java index b3459778b1d0..e7c1dc9077be 100644 --- a/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/stub/CertificateManagerStubSettings.java +++ b/java-certificate-manager/google-cloud-certificate-manager/src/main/java/com/google/cloud/certificatemanager/v1/stub/CertificateManagerStubSettings.java @@ -899,6 +899,12 @@ public CertificateManagerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "certificatemanager"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelReportsServiceClient.java b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelReportsServiceClient.java index 1de37faa4e66..b22487bfa714 100644 --- a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelReportsServiceClient.java +++ b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelReportsServiceClient.java @@ -73,19 +73,81 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
RunReportJob

Begins generation of data for a given report. The report identifier is a UID (for example, `613bf59q`). + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The user doesn't have access to this report. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The report identifier was not found. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata contains an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. + *

To get the results of report generation, call [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults] with the [RunReportJobResponse.report_job][google.cloud.channel.v1.RunReportJobResponse.report_job]. + *

Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • runReportJobAsync(RunReportJobRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • runReportJobOperationCallable() + *
  • runReportJobCallable() + *
+ *
FetchReportResults

Retrieves data generated by [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. + *

Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • fetchReportResults(FetchReportResultsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • fetchReportResults(ReportJobName reportJob) + *
  • fetchReportResults(String reportJob) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • fetchReportResultsPagedCallable() + *
  • fetchReportResultsCallable() + *
+ *
ListReports

Lists the reports that RunReportJob can run. These reports include an ID, a description, and the list of columns that will be in the result. + *

Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listReports(ListReportsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listReports(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listReportsPagedCallable() + *
  • listReportsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java index b9ab372099c9..0e4d5ceb240c 100644 --- a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java +++ b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java @@ -77,19 +77,1243 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListCustomers

List [Customer][google.cloud.channel.v1.Customer]s. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Return value: List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCustomers(ListCustomersRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCustomersPagedCallable() + *
  • listCustomersCallable() + *
+ *
GetCustomer

Returns the requested [Customer][google.cloud.channel.v1.Customer] resource. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The customer resource doesn't exist. Usually the result of an invalid name parameter. + *
+ *

Return value: The [Customer][google.cloud.channel.v1.Customer] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCustomer(GetCustomerRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCustomer(CustomerName name) + *
  • getCustomer(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCustomerCallable() + *
+ *
CheckCloudIdentityAccountsExist

Confirms the existence of Cloud Identity accounts based on the domain and if the Cloud Identity accounts are owned by the reseller. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • INVALID_VALUE: Invalid domain value in the request. + *
+ *

Return value: A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be empty) + *

Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • checkCloudIdentityAccountsExist(CheckCloudIdentityAccountsExistRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • checkCloudIdentityAccountsExistCallable() + *
+ *
CreateCustomer

Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor account. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The reseller account making the request is different from the reseller account in the API request. * You are not authorized to create a customer. See https://support.google.com/channelservices/answer/9759265 + *
  • INVALID_ARGUMENT: * Required request parameters are missing or invalid. * Domain field value doesn't match the primary email domain. + *
+ *

Return value: The newly created [Customer][google.cloud.channel.v1.Customer] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCustomer(CreateCustomerRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCustomerCallable() + *
+ *
UpdateCustomer

Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or distributor. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request. + *
+ *

Return value: The updated [Customer][google.cloud.channel.v1.Customer] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateCustomer(UpdateCustomerRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateCustomerCallable() + *
+ *
DeleteCustomer

Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The account making the request does not own this customer. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • FAILED_PRECONDITION: The customer has existing entitlements. + *
  • NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCustomer(DeleteCustomerRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteCustomer(CustomerName name) + *
  • deleteCustomer(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCustomerCallable() + *
+ *
ImportCustomer

Imports a [Customer][google.cloud.channel.v1.Customer] from the Cloud Identity associated with the provided Cloud Identity ID or domain before a TransferEntitlements call. If a linked Customer already exists and overwrite_if_exists is true, it will update that Customer's data. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The reseller account making the request is different from the reseller account in the API request. * You are not authorized to import the customer. See https://support.google.com/channelservices/answer/9759265 + *
  • NOT_FOUND: Cloud Identity doesn't exist or was deleted. + *
  • INVALID_ARGUMENT: Required parameters are missing, or the auth_token is expired or invalid. + *
  • ALREADY_EXISTS: A customer already exists and has conflicting critical fields. Requires an overwrite. + *
+ *

Return value: The [Customer][google.cloud.channel.v1.Customer].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • importCustomer(ImportCustomerRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • importCustomerCallable() + *
+ *
ProvisionCloudIdentity

Creates a Cloud Identity for the given customer using the customer's information, or the information provided here. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The customer doesn't belong to the reseller. * You are not authorized to provision cloud identity id. See https://support.google.com/channelservices/answer/9759265 + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The customer was not found. + *
  • ALREADY_EXISTS: The customer's primary email already exists. Retry after changing the customer's primary contact email. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata contains an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • provisionCloudIdentityAsync(ProvisionCloudIdentityRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • provisionCloudIdentityOperationCallable() + *
  • provisionCloudIdentityCallable() + *
+ *
ListEntitlements

Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Return value: A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listEntitlements(ListEntitlementsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listEntitlementsPagedCallable() + *
  • listEntitlementsCallable() + *
+ *
ListTransferableSkus

List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or Customer Name in the request. + *

Use this method to list the entitlements information of an unowned customer. You should provide the customer's Cloud Identity ID or Customer Name. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The customer doesn't belong to the reseller and has no auth token. * The supplied auth token is invalid. * The reseller account making the request is different from the reseller account in the query. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Return value: A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTransferableSkus(ListTransferableSkusRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTransferableSkusPagedCallable() + *
  • listTransferableSkusCallable() + *
+ *
ListTransferableOffers

List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or Customer Name in the request. + *

Use this method when a reseller gets the entitlement information of an unowned customer. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The customer doesn't belong to the reseller and has no auth token. * The customer provided incorrect reseller information when generating auth token. * The reseller account making the request is different from the reseller account in the query. * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Return value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listTransferableOffers(ListTransferableOffersRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listTransferableOffersPagedCallable() + *
  • listTransferableOffersCallable() + *
+ *
GetEntitlement

Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The customer entitlement was not found. + *
+ *

Return value: The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getEntitlement(GetEntitlementRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getEntitlementCallable() + *
+ *
CreateEntitlement

Creates an entitlement for a customer. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The customer doesn't belong to the reseller. * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 + *
  • INVALID_ARGUMENT: * Required request parameters are missing or invalid. * There is already a customer entitlement for a SKU from the same product family. + *
  • INVALID_VALUE: Make sure the OfferId is valid. If it is, contact Google Channel support for further troubleshooting. + *
  • NOT_FOUND: The customer or offer resource was not found. + *
  • ALREADY_EXISTS: * The SKU was already purchased for the customer. * The customer's primary email already exists. Retry after changing the customer's primary contact email. + *
  • CONDITION_NOT_MET or FAILED_PRECONDITION: * The domain required for purchasing a SKU has not been verified. * A pre-requisite SKU required to purchase an Add-On SKU is missing. For example, Google Workspace Business Starter is required to purchase Vault or Drive. * (Developer accounts only) Reseller and resold domain must meet the following naming requirements: * Domain names must start with goog-test. * Domain names must include the reseller domain. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createEntitlementAsync(CreateEntitlementRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createEntitlementOperationCallable() + *
  • createEntitlementCallable() + *
+ *
ChangeParameters

Change parameters of the entitlement. + *

An entitlement update is a long-running operation and it updates the entitlement as a result of fulfillment. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. For example, the number of seats being changed is greater than the allowed number of max seats, or decreasing seats for a commitment based plan. + *
  • NOT_FOUND: Entitlement resource not found. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • changeParametersAsync(ChangeParametersRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • changeParametersOperationCallable() + *
  • changeParametersCallable() + *
+ *
ChangeRenewalSettings

Updates the renewal settings for an existing customer entitlement. + *

An entitlement update is a long-running operation and it updates the entitlement as a result of fulfillment. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Entitlement resource not found. + *
  • NOT_COMMITMENT_PLAN: Renewal Settings are only applicable for a commitment plan. Can't enable or disable renewals for non-commitment plans. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • changeRenewalSettingsAsync(ChangeRenewalSettingsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • changeRenewalSettingsOperationCallable() + *
  • changeRenewalSettingsCallable() + *
+ *
ChangeOffer

Updates the Offer for an existing customer entitlement. + *

An entitlement update is a long-running operation and it updates the entitlement as a result of fulfillment. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Offer or Entitlement resource not found. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • changeOfferAsync(ChangeOfferRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • changeOfferOperationCallable() + *
  • changeOfferCallable() + *
+ *
StartPaidService

Starts paid service for a trial entitlement. + *

Starts paid service for a trial entitlement immediately. This method is only applicable if a plan is set up for a trial entitlement but has some trial days remaining. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Entitlement resource not found. + *
  • FAILED_PRECONDITION/NOT_IN_TRIAL: This method only works for entitlement on trial plans. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • startPaidServiceAsync(StartPaidServiceRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • startPaidServiceOperationCallable() + *
  • startPaidServiceCallable() + *
+ *
SuspendEntitlement

Suspends a previously fulfilled entitlement. + *

An entitlement suspension is a long-running operation. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Entitlement resource not found. + *
  • NOT_ACTIVE: Entitlement is not active. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • suspendEntitlementAsync(SuspendEntitlementRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • suspendEntitlementOperationCallable() + *
  • suspendEntitlementCallable() + *
+ *
CancelEntitlement

Cancels a previously fulfilled entitlement. + *

An entitlement cancellation is a long-running operation. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • FAILED_PRECONDITION: There are Google Cloud projects linked to the Google Cloud entitlement's Cloud Billing subaccount. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Entitlement resource not found. + *
  • DELETION_TYPE_NOT_ALLOWED: Cancel is only allowed for Google Workspace add-ons, or entitlements for Google Cloud's development platform. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The response will contain google.protobuf.Empty on success. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • cancelEntitlementAsync(CancelEntitlementRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • cancelEntitlementOperationCallable() + *
  • cancelEntitlementCallable() + *
+ *
ActivateEntitlement

Activates a previously suspended entitlement. Entitlements suspended for pending ToS acceptance can't be activated using this method. + *

An entitlement activation is a long-running operation and it updates the state of the customer entitlement. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Entitlement resource not found. + *
  • SUSPENSION_NOT_RESELLER_INITIATED: Can only activate reseller-initiated suspensions and entitlements that have accepted the TOS. + *
  • NOT_SUSPENDED: Can only activate suspended entitlements not in an ACTIVE state. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • activateEntitlementAsync(ActivateEntitlementRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • activateEntitlementOperationCallable() + *
  • activateEntitlementCallable() + *
+ *
TransferEntitlements

Transfers customer entitlements to new reseller. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The customer doesn't belong to the reseller. * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The customer or offer resource was not found. + *
  • ALREADY_EXISTS: The SKU was already transferred for the customer. + *
  • CONDITION_NOT_MET or FAILED_PRECONDITION: * The SKU requires domain verification to transfer, but the domain is not verified. * An Add-On SKU (example, Vault or Drive) is missing the pre-requisite SKU (example, G Suite Basic). * (Developer accounts only) Reseller and resold domain must meet the following naming requirements: * Domain names must start with goog-test. * Domain names must include the reseller domain. * Specify all transferring entitlements. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • transferEntitlementsAsync(TransferEntitlementsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • transferEntitlementsOperationCallable() + *
  • transferEntitlementsCallable() + *
+ *
TransferEntitlementsToGoogle

Transfers customer entitlements from their current reseller to Google. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The customer or offer resource was not found. + *
  • ALREADY_EXISTS: The SKU was already transferred for the customer. + *
  • CONDITION_NOT_MET or FAILED_PRECONDITION: * The SKU requires domain verification to transfer, but the domain is not verified. * An Add-On SKU (example, Vault or Drive) is missing the pre-requisite SKU (example, G Suite Basic). * (Developer accounts only) Reseller and resold domain must meet the following naming requirements: * Domain names must start with goog-test. * Domain names must include the reseller domain. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The ID of a long-running operation. + *

To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The response will contain google.protobuf.Empty on success. The Operation metadata will contain an instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • transferEntitlementsToGoogleAsync(TransferEntitlementsToGoogleRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • transferEntitlementsToGoogleOperationCallable() + *
  • transferEntitlementsToGoogleCallable() + *
+ *
ListChannelPartnerLinks

List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor. You must be a distributor to call this method. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Return value: The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listChannelPartnerLinks(ListChannelPartnerLinksRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listChannelPartnerLinksPagedCallable() + *
  • listChannelPartnerLinksCallable() + *
+ *
GetChannelPartnerLink

Returns the requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. You must be a distributor to call this method. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: ChannelPartnerLink resource not found because of an invalid channel partner link name. + *
+ *

Return value: The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getChannelPartnerLink(GetChannelPartnerLinkRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getChannelPartnerLinkCallable() + *
+ *
CreateChannelPartnerLink

Initiates a channel partner link between a distributor and a reseller, or between resellers in an n-tier reseller channel. Invited partners need to follow the invite_link_uri provided in the response to accept. After accepting the invitation, a link is set up between the two parties. You must be a distributor to call this method. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • ALREADY_EXISTS: The ChannelPartnerLink sent in the request already exists. + *
  • NOT_FOUND: No Cloud Identity customer exists for provided domain. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createChannelPartnerLink(CreateChannelPartnerLinkRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createChannelPartnerLinkCallable() + *
+ *
UpdateChannelPartnerLink

Updates a channel partner link. Distributors call this method to change a link's status. For example, to suspend a partner link. You must be a distributor to call this method. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. + *
  • INVALID_ARGUMENT: * Required request parameters are missing or invalid. * Link state cannot change from invited to active or suspended. * Cannot send reseller_cloud_identity_id, invite_url, or name in update mask. + *
  • NOT_FOUND: ChannelPartnerLink resource not found. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateChannelPartnerLink(UpdateChannelPartnerLinkRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateChannelPartnerLinkCallable() + *
+ *
GetCustomerRepricingConfig

Gets information about how a Reseller modifies their bill before sending it to a Customer. + *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] was not found. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resource, otherwise returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getCustomerRepricingConfig(GetCustomerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getCustomerRepricingConfig(CustomerRepricingConfigName name) + *
  • getCustomerRepricingConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getCustomerRepricingConfigCallable() + *
+ *
ListCustomerRepricingConfigs

Lists information about how a Reseller modifies their bill before sending it to a Customer. + *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] specified does not exist or is not associated with the given account. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resources. The data for each resource is displayed in the ascending order of: + *

    + *
  • Customer ID + *
  • [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement] + *
  • [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + *
  • [CustomerRepricingConfig.update_time][google.cloud.channel.v1.CustomerRepricingConfig.update_time] + *
+ *

If unsuccessful, returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listCustomerRepricingConfigs(ListCustomerRepricingConfigsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listCustomerRepricingConfigs(CustomerName parent) + *
  • listCustomerRepricingConfigs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listCustomerRepricingConfigsPagedCallable() + *
  • listCustomerRepricingConfigsCallable() + *
+ *
CreateCustomerRepricingConfig

Creates a CustomerRepricingConfig. Call this method to set modifications for a specific customer's bill. You can only create configs if the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a future month. If needed, you can create a config for the current month, with some restrictions. + *

When creating a config for a future month, make sure there are no existing configs for that [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + *

The following restrictions are for creating configs in the current month. + *

    + *
  • This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. + *
  • The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. + *
  • There is a limit of ten configs for any [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement], for any [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + *
  • The contained [CustomerRepricingConfig.repricing_config][google.cloud.channel.v1.CustomerRepricingConfig.repricing_config] value must be different from the value used in the current config for a [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement]. + *
+ *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. + *
  • NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] specified does not exist or is not associated with the given account. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the updated [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resource, otherwise returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createCustomerRepricingConfig(CreateCustomerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createCustomerRepricingConfig(CustomerName parent, CustomerRepricingConfig customerRepricingConfig) + *
  • createCustomerRepricingConfig(String parent, CustomerRepricingConfig customerRepricingConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createCustomerRepricingConfigCallable() + *
+ *
UpdateCustomerRepricingConfig

Updates a CustomerRepricingConfig. Call this method to set modifications for a specific customer's bill. This method overwrites the existing CustomerRepricingConfig. + *

You can only update configs if the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a future month. To make changes to configs for the current month, use [CreateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateCustomerRepricingConfig], taking note of its restrictions. You cannot update the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + *

When updating a config in the future: + *

    + *
  • This config must already exist. + *
+ *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. + *
  • NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] specified does not exist or is not associated with the given account. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the updated [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resource, otherwise returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateCustomerRepricingConfig(UpdateCustomerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateCustomerRepricingConfig(CustomerRepricingConfig customerRepricingConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateCustomerRepricingConfigCallable() + *
+ *
DeleteCustomerRepricingConfig

Deletes the given [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] permanently. You can only delete configs if their [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is set to a date after the current month. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The account making the request does not own this customer. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • FAILED_PRECONDITION: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] is active or in the past. + *
  • NOT_FOUND: No [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] found for the name in the request. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteCustomerRepricingConfig(DeleteCustomerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteCustomerRepricingConfig(CustomerRepricingConfigName name) + *
  • deleteCustomerRepricingConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteCustomerRepricingConfigCallable() + *
+ *
GetChannelPartnerRepricingConfig

Gets information about how a Distributor modifies their bill before sending it to a ChannelPartner. + *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] was not found. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resource, otherwise returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getChannelPartnerRepricingConfig(GetChannelPartnerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getChannelPartnerRepricingConfig(ChannelPartnerRepricingConfigName name) + *
  • getChannelPartnerRepricingConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getChannelPartnerRepricingConfigCallable() + *
+ *
ListChannelPartnerRepricingConfigs

Lists information about how a Reseller modifies their bill before sending it to a ChannelPartner. + *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] specified does not exist or is not associated with the given account. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resources. The data for each resource is displayed in the ascending order of: + *

    + *
  • Channel Partner ID + *
  • [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + *
  • [ChannelPartnerRepricingConfig.update_time][google.cloud.channel.v1.ChannelPartnerRepricingConfig.update_time] + *
+ *

If unsuccessful, returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listChannelPartnerRepricingConfigs(ListChannelPartnerRepricingConfigsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listChannelPartnerRepricingConfigs(ChannelPartnerLinkName parent) + *
  • listChannelPartnerRepricingConfigs(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listChannelPartnerRepricingConfigsPagedCallable() + *
  • listChannelPartnerRepricingConfigsCallable() + *
+ *
CreateChannelPartnerRepricingConfig

Creates a ChannelPartnerRepricingConfig. Call this method to set modifications for a specific ChannelPartner's bill. You can only create configs if the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a future month. If needed, you can create a config for the current month, with some restrictions. + *

When creating a config for a future month, make sure there are no existing configs for that [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + *

The following restrictions are for creating configs in the current month. + *

    + *
  • This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. + *
  • The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. + *
  • There is a limit of ten configs for any ChannelPartner or [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement], for any [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + *
  • The contained [ChannelPartnerRepricingConfig.repricing_config][google.cloud.channel.v1.ChannelPartnerRepricingConfig.repricing_config] value must be different from the value used in the current config for a ChannelPartner. + *
+ *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. + *
  • NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] specified does not exist or is not associated with the given account. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the updated [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resource, otherwise returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createChannelPartnerRepricingConfig(CreateChannelPartnerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createChannelPartnerRepricingConfig(ChannelPartnerLinkName parent, ChannelPartnerRepricingConfig channelPartnerRepricingConfig) + *
  • createChannelPartnerRepricingConfig(String parent, ChannelPartnerRepricingConfig channelPartnerRepricingConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createChannelPartnerRepricingConfigCallable() + *
+ *
UpdateChannelPartnerRepricingConfig

Updates a ChannelPartnerRepricingConfig. Call this method to set modifications for a specific ChannelPartner's bill. This method overwrites the existing CustomerRepricingConfig. + *

You can only update configs if the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a future month. To make changes to configs for the current month, use [CreateChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerRepricingConfig], taking note of its restrictions. You cannot update the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + *

When updating a config in the future: + *

    + *
  • This config must already exist. + *
+ *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different. + *
  • INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. + *
  • NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] specified does not exist or is not associated with the given account. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the updated [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resource, otherwise returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateChannelPartnerRepricingConfig(UpdateChannelPartnerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateChannelPartnerRepricingConfig(ChannelPartnerRepricingConfig channelPartnerRepricingConfig) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateChannelPartnerRepricingConfigCallable() + *
+ *
DeleteChannelPartnerRepricingConfig

Deletes the given [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] permanently. You can only delete configs if their [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is set to a date after the current month. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The account making the request does not own this customer. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • FAILED_PRECONDITION: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] is active or in the past. + *
  • NOT_FOUND: No [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] found for the name in the request. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteChannelPartnerRepricingConfig(DeleteChannelPartnerRepricingConfigRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteChannelPartnerRepricingConfig(ChannelPartnerRepricingConfigName name) + *
  • deleteChannelPartnerRepricingConfig(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteChannelPartnerRepricingConfigCallable() + *
+ *
ListSkuGroups

Lists the Rebilling supported SKU groups the account is authorized to sell. Reference: https://cloud.google.com/skus/sku-groups + *

Possible Error Codes: + *

    + *
  • PERMISSION_DENIED: If the account making the request and the account being queried are different, or the account doesn't exist. + *
  • INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. + *
+ *

Return Value: If successful, the [SkuGroup][google.cloud.channel.v1.SkuGroup] resources. The data for each resource is displayed in the alphabetical order of SKU group display name. The data for each resource is displayed in the ascending order of [SkuGroup.display_name][google.cloud.channel.v1.SkuGroup.display_name] + *

If unsuccessful, returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listSkuGroups(ListSkuGroupsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listSkuGroups(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listSkuGroupsPagedCallable() + *
  • listSkuGroupsCallable() + *
+ *
ListSkuGroupBillableSkus

Lists the Billable SKUs in a given SKU group. + *

Possible error codes: PERMISSION_DENIED: If the account making the request and the account being queried for are different, or the account doesn't exist. INVALID_ARGUMENT: Missing or invalid required parameters in the request. INTERNAL: Any non-user error related to technical issue in the backend. In this case, contact cloud channel support. + *

Return Value: If successful, the [BillableSku][google.cloud.channel.v1.BillableSku] resources. The data for each resource is displayed in the ascending order of: + *

    + *
  • [BillableSku.service_display_name][google.cloud.channel.v1.BillableSku.service_display_name] + *
  • [BillableSku.sku_display_name][google.cloud.channel.v1.BillableSku.sku_display_name] + *
+ *

If unsuccessful, returns an error.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listSkuGroupBillableSkus(ListSkuGroupBillableSkusRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listSkuGroupBillableSkus(SkuGroupName parent) + *
  • listSkuGroupBillableSkus(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listSkuGroupBillableSkusPagedCallable() + *
  • listSkuGroupBillableSkusCallable() + *
+ *
LookupOffer

Returns the requested [Offer][google.cloud.channel.v1.Offer] resource. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The entitlement doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: Entitlement or offer was not found. + *
+ *

Return value: The [Offer][google.cloud.channel.v1.Offer] resource.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • lookupOffer(LookupOfferRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • lookupOfferCallable() + *
+ *
ListProducts

Lists the Products the reseller is authorized to sell. + *

Possible error codes: + *

    + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listProducts(ListProductsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listProductsPagedCallable() + *
  • listProductsCallable() + *
+ *
ListSkus

Lists the SKUs for a product the reseller is authorized to sell. + *

Possible error codes: + *

    + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listSkus(ListSkusRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listSkusPagedCallable() + *
  • listSkusCallable() + *
+ *
ListOffers

Lists the Offers the reseller can sell. + *

Possible error codes: + *

    + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listOffers(ListOffersRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listOffersPagedCallable() + *
  • listOffersCallable() + *
+ *
ListPurchasableSkus

Lists the following: + *

    + *
  • SKUs that you can purchase for a customer + *
  • SKUs that you can upgrade or downgrade for an entitlement. + *
+ *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listPurchasableSkus(ListPurchasableSkusRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listPurchasableSkusPagedCallable() + *
  • listPurchasableSkusCallable() + *
+ *
ListPurchasableOffers

Lists the following: + *

    + *
  • Offers that you can purchase for a customer. + *
  • Offers that you can change for an entitlement. + *
+ *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: * The customer doesn't belong to the reseller * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listPurchasableOffers(ListPurchasableOffersRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listPurchasableOffersPagedCallable() + *
  • listPurchasableOffersCallable() + *
+ *
QueryEligibleBillingAccounts

Lists the billing accounts that are eligible to purchase particular SKUs for a given customer. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The customer doesn't belong to the reseller. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
+ *

Return value: Based on the provided list of SKUs, returns a list of SKU groups that must be purchased using the same billing account and the billing accounts eligible to purchase each SKU group.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • queryEligibleBillingAccounts(QueryEligibleBillingAccountsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • queryEligibleBillingAccountsCallable() + *
+ *
RegisterSubscriber

Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account. After you create a subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The topic name with the registered service email address.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • registerSubscriber(RegisterSubscriberRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • registerSubscriberCallable() + *
+ *
UnregisterSubscriber

Unregisters a service account with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The topic resource doesn't exist. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • unregisterSubscriber(UnregisterSubscriberRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • unregisterSubscriberCallable() + *
+ *
ListSubscribers

Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. + *
  • INVALID_ARGUMENT: Required request parameters are missing or invalid. + *
  • NOT_FOUND: The topic resource doesn't exist. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. + *
+ *

Return value: A list of service email addresses.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listSubscribers(ListSubscribersRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listSubscribersPagedCallable() + *
  • listSubscribersCallable() + *
+ *
ListEntitlementChanges

List entitlement history. + *

Possible error codes: + *

    + *
  • PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different. + *
  • INVALID_ARGUMENT: Missing or invalid required fields in the request. + *
  • NOT_FOUND: The parent resource doesn't exist. Usually the result of an invalid name parameter. + *
  • INTERNAL: Any non-user error related to a technical issue in the backend. In this case, contact CloudChannel support. + *
  • UNKNOWN: Any non-user error related to a technical issue in the backend. In this case, contact Cloud Channel support. + *
+ *

Return value: List of [EntitlementChange][google.cloud.channel.v1.EntitlementChange]s.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listEntitlementChanges(ListEntitlementChangesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listEntitlementChanges(EntitlementName parent) + *
  • listEntitlementChanges(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listEntitlementChangesPagedCallable() + *
  • listEntitlementChangesCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelReportsServiceStubSettings.java b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelReportsServiceStubSettings.java index 44f044bc0d77..cd2c6d7d748d 100644 --- a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelReportsServiceStubSettings.java +++ b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelReportsServiceStubSettings.java @@ -293,6 +293,12 @@ public CloudChannelReportsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudchannel"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelServiceStubSettings.java b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelServiceStubSettings.java index ddf760dcfc60..55e97c593545 100644 --- a/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelServiceStubSettings.java +++ b/java-channel/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelServiceStubSettings.java @@ -1757,6 +1757,12 @@ public CloudChannelServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudchannel"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-cloudbuild/README.md b/java-cloudbuild/README.md index 9809cb0e64ed..b360e0353dc7 100644 --- a/java-cloudbuild/README.md +++ b/java-cloudbuild/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-build.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-build/3.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-build/3.34.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java index 716758c04276..b66f896d8ddd 100644 --- a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java +++ b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/CloudBuildClient.java @@ -101,19 +101,373 @@ *

Note: close() needs to be called on the CloudBuildClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateBuild

Starts a build with the specified configuration. + *

This method returns a long-running `Operation`, which includes the build ID. Pass the build ID to `GetBuild` to determine the build status (such as `SUCCESS` or `FAILURE`).

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createBuildAsync(CreateBuildRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createBuildAsync(String projectId, Build build) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createBuildOperationCallable() + *
  • createBuildCallable() + *
+ *
GetBuild

Returns information about a previously requested build. + *

The `Build` that is returned includes its status (such as `SUCCESS`, `FAILURE`, or `WORKING`), and timing information.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getBuild(GetBuildRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getBuild(String projectId, String id) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getBuildCallable() + *
+ *
ListBuilds

Lists previously requested builds. + *

Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listBuilds(ListBuildsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listBuilds(String projectId, String filter) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listBuildsPagedCallable() + *
  • listBuildsCallable() + *
+ *
CancelBuild

Cancels a build in progress.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • cancelBuild(CancelBuildRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • cancelBuild(String projectId, String id) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • cancelBuildCallable() + *
+ *
RetryBuild

Creates a new build based on the specified build. + *

This method creates a new build using the original build request, which may or may not result in an identical build. + *

For triggered builds: + *

    + *
  • Triggered builds resolve to a precise revision; therefore a retry of a triggered build will result in a build that uses the same revision. + *
+ *

For non-triggered builds that specify `RepoSource`: + *

    + *
  • If the original build built from the tip of a branch, the retried build will build from the tip of that branch, which may not be the same revision as the original build. + *
  • If the original build specified a commit sha or revision ID, the retried build will use the identical source. + *
+ *

For builds that specify `StorageSource`: + *

    + *
  • If the original build pulled source from Cloud Storage without specifying the generation of the object, the new build will use the current object, which may be different from the original build source. + *
  • If the original build pulled source from Cloud Storage and specified the generation of the object, the new build will attempt to use the same object, which may or may not be available depending on the bucket's lifecycle management settings. + *
+ *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • retryBuildAsync(RetryBuildRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • retryBuildAsync(String projectId, String id) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • retryBuildOperationCallable() + *
  • retryBuildCallable() + *
+ *
ApproveBuild

Approves or rejects a pending build. + *

If approved, the returned LRO will be analogous to the LRO returned from a CreateBuild call. + *

If rejected, the returned LRO will be immediately done.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • approveBuildAsync(ApproveBuildRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • approveBuildAsync(String name, ApprovalResult approvalResult) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • approveBuildOperationCallable() + *
  • approveBuildCallable() + *
+ *
CreateBuildTrigger

Creates a new `BuildTrigger`. + *

This API is experimental.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createBuildTrigger(CreateBuildTriggerRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • createBuildTrigger(String projectId, BuildTrigger trigger) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createBuildTriggerCallable() + *
+ *
GetBuildTrigger

Returns information about a `BuildTrigger`. + *

This API is experimental.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getBuildTrigger(GetBuildTriggerRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getBuildTrigger(String projectId, String triggerId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getBuildTriggerCallable() + *
+ *
ListBuildTriggers

Lists existing `BuildTrigger`s. + *

This API is experimental.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listBuildTriggers(ListBuildTriggersRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listBuildTriggers(String projectId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listBuildTriggersPagedCallable() + *
  • listBuildTriggersCallable() + *
+ *
DeleteBuildTrigger

Deletes a `BuildTrigger` by its project ID and trigger ID. + *

This API is experimental.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteBuildTrigger(DeleteBuildTriggerRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • deleteBuildTrigger(String projectId, String triggerId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteBuildTriggerCallable() + *
+ *
UpdateBuildTrigger

Updates a `BuildTrigger` by its project ID and trigger ID. + *

This API is experimental.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateBuildTrigger(UpdateBuildTriggerRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • updateBuildTrigger(String projectId, String triggerId, BuildTrigger trigger) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateBuildTriggerCallable() + *
+ *
RunBuildTrigger

Runs a `BuildTrigger` at a particular source revision. + *

To run a regional or global trigger, use the POST request that includes the location endpoint in the path (ex. v1/projects/{projectId}/locations/{region}/triggers/{triggerId}:run). The POST request that does not include the location endpoint in the path can only be used when running global triggers.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • runBuildTriggerAsync(RunBuildTriggerRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • runBuildTriggerAsync(String projectId, String triggerId, RepoSource source) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • runBuildTriggerOperationCallable() + *
  • runBuildTriggerCallable() + *
+ *
ReceiveTriggerWebhook

ReceiveTriggerWebhook [Experimental] is called when the API receives a webhook request targeted at a specific trigger.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • receiveTriggerWebhook(ReceiveTriggerWebhookRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • receiveTriggerWebhookCallable() + *
+ *
CreateWorkerPool

Creates a `WorkerPool`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createWorkerPoolAsync(CreateWorkerPoolRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createWorkerPoolAsync(LocationName parent, WorkerPool workerPool, String workerPoolId) + *
  • createWorkerPoolAsync(String parent, WorkerPool workerPool, String workerPoolId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createWorkerPoolOperationCallable() + *
  • createWorkerPoolCallable() + *
+ *
GetWorkerPool

Returns details of a `WorkerPool`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getWorkerPool(GetWorkerPoolRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getWorkerPool(WorkerPoolName name) + *
  • getWorkerPool(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getWorkerPoolCallable() + *
+ *
DeleteWorkerPool

Deletes a `WorkerPool`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteWorkerPoolAsync(DeleteWorkerPoolRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteWorkerPoolAsync(WorkerPoolName name) + *
  • deleteWorkerPoolAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteWorkerPoolOperationCallable() + *
  • deleteWorkerPoolCallable() + *
+ *
UpdateWorkerPool

Updates a `WorkerPool`.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateWorkerPoolAsync(UpdateWorkerPoolRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateWorkerPoolAsync(WorkerPool workerPool, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateWorkerPoolOperationCallable() + *
  • updateWorkerPoolCallable() + *
+ *
ListWorkerPools

Lists `WorkerPool`s.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listWorkerPools(ListWorkerPoolsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listWorkerPools(LocationName parent) + *
  • listWorkerPools(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listWorkerPoolsPagedCallable() + *
  • listWorkerPoolsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStubSettings.java b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStubSettings.java index 87e0b92c6938..886b03e6c449 100644 --- a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStubSettings.java +++ b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v1/stub/CloudBuildStubSettings.java @@ -501,6 +501,12 @@ public CloudBuildStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudbuild"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/RepositoryManagerClient.java b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/RepositoryManagerClient.java index 2b68a0a6ac71..8cfe9407ca2c 100644 --- a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/RepositoryManagerClient.java +++ b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/RepositoryManagerClient.java @@ -94,19 +94,323 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
CreateConnection

Creates a Connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createConnectionAsync(CreateConnectionRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createConnectionAsync(LocationName parent, Connection connection, String connectionId) + *
  • createConnectionAsync(String parent, Connection connection, String connectionId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createConnectionOperationCallable() + *
  • createConnectionCallable() + *
+ *
GetConnection

Gets details of a single connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getConnection(GetConnectionRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getConnection(ConnectionName name) + *
  • getConnection(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getConnectionCallable() + *
+ *
ListConnections

Lists Connections in a given project and location.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listConnections(ListConnectionsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listConnections(LocationName parent) + *
  • listConnections(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listConnectionsPagedCallable() + *
  • listConnectionsCallable() + *
+ *
UpdateConnection

Updates a single connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • updateConnectionAsync(UpdateConnectionRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • updateConnectionAsync(Connection connection, FieldMask updateMask) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • updateConnectionOperationCallable() + *
  • updateConnectionCallable() + *
+ *
DeleteConnection

Deletes a single connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteConnectionAsync(DeleteConnectionRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteConnectionAsync(ConnectionName name) + *
  • deleteConnectionAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteConnectionOperationCallable() + *
  • deleteConnectionCallable() + *
+ *
CreateRepository

Creates a Repository.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • createRepositoryAsync(CreateRepositoryRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • createRepositoryAsync(ConnectionName parent, Repository repository, String repositoryId) + *
  • createRepositoryAsync(String parent, Repository repository, String repositoryId) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • createRepositoryOperationCallable() + *
  • createRepositoryCallable() + *
+ *
BatchCreateRepositories

Creates multiple repositories inside a connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • batchCreateRepositoriesAsync(ConnectionName parent, List requests) + *
  • batchCreateRepositoriesAsync(String parent, List requests) + *
  • batchCreateRepositoriesAsync(BatchCreateRepositoriesRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • batchCreateRepositoriesOperationCallable() + *
  • batchCreateRepositoriesCallable() + *
+ *
GetRepository

Gets details of a single repository.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getRepository(GetRepositoryRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • getRepository(RepositoryName name) + *
  • getRepository(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getRepositoryCallable() + *
+ *
ListRepositories

Lists Repositories in a given connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • listRepositories(ListRepositoriesRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • listRepositories(ConnectionName parent) + *
  • listRepositories(String parent) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • listRepositoriesPagedCallable() + *
  • listRepositoriesCallable() + *
+ *
DeleteRepository

Deletes a single repository.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • deleteRepositoryAsync(DeleteRepositoryRequest request) + *
+ *

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

+ *
    + *
  • deleteRepositoryAsync(RepositoryName name) + *
  • deleteRepositoryAsync(String name) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • deleteRepositoryOperationCallable() + *
  • deleteRepositoryCallable() + *
+ *
FetchReadWriteToken

Fetches read/write token of a given repository.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • fetchReadWriteToken(FetchReadWriteTokenRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • fetchReadWriteToken(RepositoryName repository) + *
  • fetchReadWriteToken(String repository) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • fetchReadWriteTokenCallable() + *
+ *
FetchReadToken

Fetches read token of a given repository.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • fetchReadToken(FetchReadTokenRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • fetchReadToken(RepositoryName repository) + *
  • fetchReadToken(String repository) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • fetchReadTokenCallable() + *
+ *
FetchLinkableRepositories

FetchLinkableRepositories get repositories from SCM that are accessible and could be added to the connection.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • fetchLinkableRepositories(FetchLinkableRepositoriesRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • fetchLinkableRepositoriesPagedCallable() + *
  • fetchLinkableRepositoriesCallable() + *
+ *
FetchGitRefs

Fetch the list of branches or tags for a given repository.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • fetchGitRefs(FetchGitRefsRequest request) + *
+ *

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

+ *
    + *
  • fetchGitRefs(RepositoryName repository) + *
  • fetchGitRefs(String repository) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • fetchGitRefsCallable() + *
+ *
SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. + *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • setIamPolicyCallable() + *
+ *
GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • getIamPolicyCallable() + *
+ *
TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. + *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 + *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

+ *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

+ *
    + *
  • testIamPermissionsCallable() + *
+ *
* *

See the individual methods for example code. * diff --git a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/stub/RepositoryManagerStubSettings.java b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/stub/RepositoryManagerStubSettings.java index 2fd02816bb1c..3ea4682558f7 100644 --- a/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/stub/RepositoryManagerStubSettings.java +++ b/java-cloudbuild/google-cloud-build/src/main/java/com/google/cloud/devtools/cloudbuild/v2/stub/RepositoryManagerStubSettings.java @@ -512,6 +512,12 @@ public RepositoryManagerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudbuild"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/versions.txt b/versions.txt index a56fc1dda0a1..a9d99c13b1b9 100644 --- a/versions.txt +++ b/versions.txt @@ -712,4 +712,4 @@ proto-google-cloud-edgenetwork-v1:0.0.0:0.0.1-SNAPSHOT grpc-google-cloud-edgenetwork-v1:0.0.0:0.0.1-SNAPSHOT google-cloud-cloudquotas:0.0.0:0.0.1-SNAPSHOT proto-google-cloud-cloudquotas-v1:0.0.0:0.0.1-SNAPSHOT -grpc-google-cloud-cloudquotas-v1:0.0.0:0.0.1-SNAPSHOT \ No newline at end of file +grpc-google-cloud-cloudquotas-v1:0.0.0:0.0.1-SNAPSHOT