{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName name = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* Database response = databaseAdminClient.getDatabase(name);
@@ -128,8 +131,11 @@
* To customize credentials:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* DatabaseAdminSettings databaseAdminSettings =
* DatabaseAdminSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -140,8 +146,11 @@
* To customize the endpoint:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* DatabaseAdminSettings databaseAdminSettings =
* DatabaseAdminSettings.newBuilder().setEndpoint(myEndpoint).build();
* DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create(databaseAdminSettings);
@@ -151,8 +160,11 @@
* the wire:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* DatabaseAdminSettings databaseAdminSettings =
* DatabaseAdminSettings.newBuilder()
* .setTransportChannelProvider(
@@ -245,8 +257,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* for (Database element : databaseAdminClient.listDatabases(parent).iterateAll()) {
@@ -274,8 +289,11 @@ public final ListDatabasesPagedResponse listDatabases(InstanceName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* for (Database element : databaseAdminClient.listDatabases(parent).iterateAll()) {
@@ -300,8 +318,11 @@ public final ListDatabasesPagedResponse listDatabases(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabasesRequest request =
* ListDatabasesRequest.newBuilder()
@@ -329,8 +350,11 @@ public final ListDatabasesPagedResponse listDatabases(ListDatabasesRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabasesRequest request =
* ListDatabasesRequest.newBuilder()
@@ -359,8 +383,11 @@ public final ListDatabasesPagedResponse listDatabases(ListDatabasesRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabasesRequest request =
* ListDatabasesRequest.newBuilder()
@@ -400,8 +427,11 @@ public final UnaryCallable listData
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* String createStatement = "createStatement744686547";
@@ -441,8 +471,11 @@ public final OperationFuture createDatabaseAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* String createStatement = "createStatement744686547";
@@ -482,8 +515,11 @@ public final OperationFuture createDatabaseAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CreateDatabaseRequest request =
* CreateDatabaseRequest.newBuilder()
@@ -518,8 +554,11 @@ public final OperationFuture createDatabaseAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CreateDatabaseRequest request =
* CreateDatabaseRequest.newBuilder()
@@ -554,8 +593,11 @@ public final OperationFuture createDatabaseAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CreateDatabaseRequest request =
* CreateDatabaseRequest.newBuilder()
@@ -583,8 +625,11 @@ public final UnaryCallable createDatabaseCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName name = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* Database response = databaseAdminClient.getDatabase(name);
@@ -608,8 +653,11 @@ public final Database getDatabase(DatabaseName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String name = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]").toString();
* Database response = databaseAdminClient.getDatabase(name);
@@ -632,8 +680,11 @@ public final Database getDatabase(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetDatabaseRequest request =
* GetDatabaseRequest.newBuilder()
@@ -657,8 +708,11 @@ public final Database getDatabase(GetDatabaseRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetDatabaseRequest request =
* GetDatabaseRequest.newBuilder()
@@ -687,8 +741,11 @@ public final UnaryCallable getDatabaseCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName database = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* List statements = new ArrayList<>();
@@ -723,8 +780,11 @@ public final OperationFuture updateDatabaseDdl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String database = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]").toString();
* List statements = new ArrayList<>();
@@ -759,8 +819,11 @@ public final OperationFuture updateDatabaseDdl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* UpdateDatabaseDdlRequest request =
* UpdateDatabaseDdlRequest.newBuilder()
@@ -793,8 +856,11 @@ public final OperationFuture updateDatabaseDdl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* UpdateDatabaseDdlRequest request =
* UpdateDatabaseDdlRequest.newBuilder()
@@ -827,8 +893,11 @@ public final OperationFuture updateDatabaseDdl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* UpdateDatabaseDdlRequest request =
* UpdateDatabaseDdlRequest.newBuilder()
@@ -856,8 +925,11 @@ public final UnaryCallable updateDatabaseDd
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName database = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* databaseAdminClient.dropDatabase(database);
@@ -884,8 +956,11 @@ public final void dropDatabase(DatabaseName database) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String database = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]").toString();
* databaseAdminClient.dropDatabase(database);
@@ -909,8 +984,11 @@ public final void dropDatabase(String database) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DropDatabaseRequest request =
* DropDatabaseRequest.newBuilder()
@@ -936,8 +1014,11 @@ public final void dropDatabase(DropDatabaseRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DropDatabaseRequest request =
* DropDatabaseRequest.newBuilder()
@@ -962,8 +1043,11 @@ public final UnaryCallable dropDatabaseCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName database = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* GetDatabaseDdlResponse response = databaseAdminClient.getDatabaseDdl(database);
@@ -991,8 +1075,11 @@ public final GetDatabaseDdlResponse getDatabaseDdl(DatabaseName database) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String database = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]").toString();
* GetDatabaseDdlResponse response = databaseAdminClient.getDatabaseDdl(database);
@@ -1018,8 +1105,11 @@ public final GetDatabaseDdlResponse getDatabaseDdl(String database) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetDatabaseDdlRequest request =
* GetDatabaseDdlRequest.newBuilder()
@@ -1045,8 +1135,11 @@ public final GetDatabaseDdlResponse getDatabaseDdl(GetDatabaseDdlRequest request
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetDatabaseDdlRequest request =
* GetDatabaseDdlRequest.newBuilder()
@@ -1076,8 +1169,11 @@ public final GetDatabaseDdlResponse getDatabaseDdl(GetDatabaseDdlRequest request
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ResourceName resource = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]");
* Policy policy = Policy.newBuilder().build();
@@ -1113,8 +1209,11 @@ public final Policy setIamPolicy(ResourceName resource, Policy policy) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String resource = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]").toString();
* Policy policy = Policy.newBuilder().build();
@@ -1147,8 +1246,11 @@ public final Policy setIamPolicy(String resource, Policy policy) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1179,8 +1281,11 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1211,8 +1316,11 @@ public final UnaryCallable setIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ResourceName resource = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]");
* Policy response = databaseAdminClient.getIamPolicy(resource);
@@ -1244,8 +1352,11 @@ public final Policy getIamPolicy(ResourceName resource) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String resource = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]").toString();
* Policy response = databaseAdminClient.getIamPolicy(resource);
@@ -1274,8 +1385,11 @@ public final Policy getIamPolicy(String resource) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1306,8 +1420,11 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1337,8 +1454,11 @@ public final UnaryCallable getIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ResourceName resource = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]");
* List permissions = new ArrayList<>();
@@ -1377,8 +1497,11 @@ public final TestIamPermissionsResponse testIamPermissions(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String resource = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]").toString();
* List permissions = new ArrayList<>();
@@ -1417,8 +1540,11 @@ public final TestIamPermissionsResponse testIamPermissions(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
@@ -1449,8 +1575,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
@@ -1485,8 +1614,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* Backup backup = Backup.newBuilder().build();
@@ -1532,8 +1664,11 @@ public final OperationFuture createBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* Backup backup = Backup.newBuilder().build();
@@ -1579,8 +1714,11 @@ public final OperationFuture createBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CreateBackupRequest request =
* CreateBackupRequest.newBuilder()
@@ -1617,8 +1755,11 @@ public final OperationFuture createBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CreateBackupRequest request =
* CreateBackupRequest.newBuilder()
@@ -1655,8 +1796,11 @@ public final OperationFuture createBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CreateBackupRequest request =
* CreateBackupRequest.newBuilder()
@@ -1691,8 +1835,11 @@ public final UnaryCallable createBackupCallable(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* String backupId = "backupId2121930365";
@@ -1746,8 +1893,11 @@ public final OperationFuture copyBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* String backupId = "backupId2121930365";
@@ -1801,8 +1951,11 @@ public final OperationFuture copyBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* String backupId = "backupId2121930365";
@@ -1856,8 +2009,11 @@ public final OperationFuture copyBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* String backupId = "backupId2121930365";
@@ -1911,8 +2067,11 @@ public final OperationFuture copyBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CopyBackupRequest request =
* CopyBackupRequest.newBuilder()
@@ -1950,8 +2109,11 @@ public final OperationFuture copyBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CopyBackupRequest request =
* CopyBackupRequest.newBuilder()
@@ -1989,8 +2151,11 @@ public final OperationFuture copyBackupAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* CopyBackupRequest request =
* CopyBackupRequest.newBuilder()
@@ -2017,8 +2182,11 @@ public final UnaryCallable copyBackupCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* BackupName name = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]");
* Backup response = databaseAdminClient.getBackup(name);
@@ -2042,8 +2210,11 @@ public final Backup getBackup(BackupName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String name = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]").toString();
* Backup response = databaseAdminClient.getBackup(name);
@@ -2066,8 +2237,11 @@ public final Backup getBackup(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetBackupRequest request =
* GetBackupRequest.newBuilder()
@@ -2091,8 +2265,11 @@ public final Backup getBackup(GetBackupRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* GetBackupRequest request =
* GetBackupRequest.newBuilder()
@@ -2115,8 +2292,11 @@ public final UnaryCallable getBackupCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* Backup backup = Backup.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
@@ -2146,8 +2326,11 @@ public final Backup updateBackup(Backup backup, FieldMask updateMask) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* UpdateBackupRequest request =
* UpdateBackupRequest.newBuilder()
@@ -2172,8 +2355,11 @@ public final Backup updateBackup(UpdateBackupRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* UpdateBackupRequest request =
* UpdateBackupRequest.newBuilder()
@@ -2197,8 +2383,11 @@ public final UnaryCallable updateBackupCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* BackupName name = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]");
* databaseAdminClient.deleteBackup(name);
@@ -2222,8 +2411,11 @@ public final void deleteBackup(BackupName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String name = BackupName.of("[PROJECT]", "[INSTANCE]", "[BACKUP]").toString();
* databaseAdminClient.deleteBackup(name);
@@ -2246,8 +2438,11 @@ public final void deleteBackup(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DeleteBackupRequest request =
* DeleteBackupRequest.newBuilder()
@@ -2271,8 +2466,11 @@ public final void deleteBackup(DeleteBackupRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DeleteBackupRequest request =
* DeleteBackupRequest.newBuilder()
@@ -2296,8 +2494,11 @@ public final UnaryCallable deleteBackupCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* for (Backup element : databaseAdminClient.listBackups(parent).iterateAll()) {
@@ -2326,8 +2527,11 @@ public final ListBackupsPagedResponse listBackups(InstanceName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* for (Backup element : databaseAdminClient.listBackups(parent).iterateAll()) {
@@ -2353,8 +2557,11 @@ public final ListBackupsPagedResponse listBackups(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListBackupsRequest request =
* ListBackupsRequest.newBuilder()
@@ -2384,8 +2591,11 @@ public final ListBackupsPagedResponse listBackups(ListBackupsRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListBackupsRequest request =
* ListBackupsRequest.newBuilder()
@@ -2415,8 +2625,11 @@ public final ListBackupsPagedResponse listBackups(ListBackupsRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListBackupsRequest request =
* ListBackupsRequest.newBuilder()
@@ -2464,8 +2677,11 @@ public final UnaryCallable listBackupsC
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* String databaseId = "databaseId1688905718";
@@ -2518,8 +2734,11 @@ public final OperationFuture restoreDatabaseA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* String databaseId = "databaseId1688905718";
@@ -2572,8 +2791,11 @@ public final OperationFuture restoreDatabaseA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* String databaseId = "databaseId1688905718";
@@ -2626,8 +2848,11 @@ public final OperationFuture restoreDatabaseA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* String databaseId = "databaseId1688905718";
@@ -2680,8 +2905,11 @@ public final OperationFuture restoreDatabaseA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* RestoreDatabaseRequest request =
* RestoreDatabaseRequest.newBuilder()
@@ -2721,8 +2949,11 @@ public final OperationFuture restoreDatabaseA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* RestoreDatabaseRequest request =
* RestoreDatabaseRequest.newBuilder()
@@ -2762,8 +2993,11 @@ public final OperationFuture restoreDatabaseA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* RestoreDatabaseRequest request =
* RestoreDatabaseRequest.newBuilder()
@@ -2794,8 +3028,11 @@ public final UnaryCallable restoreDatabaseCal
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* for (Operation element : databaseAdminClient.listDatabaseOperations(parent).iterateAll()) {
@@ -2828,8 +3065,11 @@ public final ListDatabaseOperationsPagedResponse listDatabaseOperations(Instance
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* for (Operation element : databaseAdminClient.listDatabaseOperations(parent).iterateAll()) {
@@ -2860,8 +3100,11 @@ public final ListDatabaseOperationsPagedResponse listDatabaseOperations(String p
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabaseOperationsRequest request =
* ListDatabaseOperationsRequest.newBuilder()
@@ -2896,8 +3139,11 @@ public final ListDatabaseOperationsPagedResponse listDatabaseOperations(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabaseOperationsRequest request =
* ListDatabaseOperationsRequest.newBuilder()
@@ -2932,8 +3178,11 @@ public final ListDatabaseOperationsPagedResponse listDatabaseOperations(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabaseOperationsRequest request =
* ListDatabaseOperationsRequest.newBuilder()
@@ -2977,8 +3226,11 @@ public final ListDatabaseOperationsPagedResponse listDatabaseOperations(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* InstanceName parent = InstanceName.of("[PROJECT]", "[INSTANCE]");
* for (Operation element : databaseAdminClient.listBackupOperations(parent).iterateAll()) {
@@ -3013,8 +3265,11 @@ public final ListBackupOperationsPagedResponse listBackupOperations(InstanceName
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* for (Operation element : databaseAdminClient.listBackupOperations(parent).iterateAll()) {
@@ -3047,8 +3302,11 @@ public final ListBackupOperationsPagedResponse listBackupOperations(String paren
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListBackupOperationsRequest request =
* ListBackupOperationsRequest.newBuilder()
@@ -3085,8 +3343,11 @@ public final ListBackupOperationsPagedResponse listBackupOperations(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListBackupOperationsRequest request =
* ListBackupOperationsRequest.newBuilder()
@@ -3123,8 +3384,11 @@ public final ListBackupOperationsPagedResponse listBackupOperations(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListBackupOperationsRequest request =
* ListBackupOperationsRequest.newBuilder()
@@ -3161,8 +3425,11 @@ public final ListBackupOperationsPagedResponse listBackupOperations(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName parent = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* for (DatabaseRole element : databaseAdminClient.listDatabaseRoles(parent).iterateAll()) {
@@ -3190,8 +3457,11 @@ public final ListDatabaseRolesPagedResponse listDatabaseRoles(DatabaseName paren
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* String parent = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]").toString();
* for (DatabaseRole element : databaseAdminClient.listDatabaseRoles(parent).iterateAll()) {
@@ -3217,8 +3487,11 @@ public final ListDatabaseRolesPagedResponse listDatabaseRoles(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabaseRolesRequest request =
* ListDatabaseRolesRequest.newBuilder()
@@ -3246,8 +3519,11 @@ public final ListDatabaseRolesPagedResponse listDatabaseRoles(ListDatabaseRolesR
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabaseRolesRequest request =
* ListDatabaseRolesRequest.newBuilder()
@@ -3276,8 +3552,11 @@ public final ListDatabaseRolesPagedResponse listDatabaseRoles(ListDatabaseRolesR
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* ListDatabaseRolesRequest request =
* ListDatabaseRolesRequest.newBuilder()
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/DatabaseAdminSettings.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/DatabaseAdminSettings.java
index 14cf1fc3d66..9a353025074 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/DatabaseAdminSettings.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/DatabaseAdminSettings.java
@@ -94,16 +94,16 @@
* For example, to set the total timeout of getDatabase to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* DatabaseAdminSettings.Builder databaseAdminSettingsBuilder = DatabaseAdminSettings.newBuilder();
* databaseAdminSettingsBuilder
* .getDatabaseSettings()
* .setRetrySettings(
- * databaseAdminSettingsBuilder
- * .getDatabaseSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * databaseAdminSettingsBuilder.getDatabaseSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* DatabaseAdminSettings databaseAdminSettings = databaseAdminSettingsBuilder.build();
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/package-info.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/package-info.java
index 45d50389b51..f89d6b56ed0 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/package-info.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/package-info.java
@@ -30,8 +30,11 @@
* Sample for DatabaseAdminClient:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (DatabaseAdminClient databaseAdminClient = DatabaseAdminClient.create()) {
* DatabaseName name = DatabaseName.of("[PROJECT]", "[INSTANCE]", "[DATABASE]");
* Database response = databaseAdminClient.getDatabase(name);
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/DatabaseAdminStubSettings.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/DatabaseAdminStubSettings.java
index b574d242e80..9c209ed0fef 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/DatabaseAdminStubSettings.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/DatabaseAdminStubSettings.java
@@ -115,17 +115,17 @@
* For example, to set the total timeout of getDatabase to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* DatabaseAdminStubSettings.Builder databaseAdminSettingsBuilder =
* DatabaseAdminStubSettings.newBuilder();
* databaseAdminSettingsBuilder
* .getDatabaseSettings()
* .setRetrySettings(
- * databaseAdminSettingsBuilder
- * .getDatabaseSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * databaseAdminSettingsBuilder.getDatabaseSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* DatabaseAdminStubSettings databaseAdminSettings = databaseAdminSettingsBuilder.build();
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/HttpJsonDatabaseAdminStub.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/HttpJsonDatabaseAdminStub.java
index 14861fc2cae..8f649502f18 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/HttpJsonDatabaseAdminStub.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/stub/HttpJsonDatabaseAdminStub.java
@@ -165,7 +165,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearParent().build()))
+ .toBody("*", request.toBuilder().clearParent().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -237,7 +237,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearDatabase().build()))
+ .toBody("*", request.toBuilder().clearDatabase().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -344,7 +344,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -382,7 +382,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -422,7 +422,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -460,7 +460,8 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
})
.setRequestBodyExtractor(
request ->
- ProtoRestSerializer.create().toBody("backup", request.getBackup()))
+ ProtoRestSerializer.create()
+ .toBody("backup", request.getBackup(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -499,7 +500,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearParent().build()))
+ .toBody("*", request.toBuilder().clearParent().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -571,7 +572,8 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
})
.setRequestBodyExtractor(
request ->
- ProtoRestSerializer.create().toBody("backup", request.getBackup()))
+ ProtoRestSerializer.create()
+ .toBody("backup", request.getBackup(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -676,7 +678,7 @@ public class HttpJsonDatabaseAdminStub extends DatabaseAdminStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearParent().build()))
+ .toBody("*", request.toBuilder().clearParent().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminClient.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminClient.java
index e6f016b3db5..13a271f7dc4 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminClient.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminClient.java
@@ -40,8 +40,11 @@
import com.google.longrunning.Operation;
import com.google.protobuf.Empty;
import com.google.protobuf.FieldMask;
+import com.google.spanner.admin.instance.v1.CreateInstanceConfigMetadata;
+import com.google.spanner.admin.instance.v1.CreateInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.CreateInstanceMetadata;
import com.google.spanner.admin.instance.v1.CreateInstanceRequest;
+import com.google.spanner.admin.instance.v1.DeleteInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.DeleteInstanceRequest;
import com.google.spanner.admin.instance.v1.GetInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.GetInstanceRequest;
@@ -49,11 +52,15 @@
import com.google.spanner.admin.instance.v1.InstanceConfig;
import com.google.spanner.admin.instance.v1.InstanceConfigName;
import com.google.spanner.admin.instance.v1.InstanceName;
+import com.google.spanner.admin.instance.v1.ListInstanceConfigOperationsRequest;
+import com.google.spanner.admin.instance.v1.ListInstanceConfigOperationsResponse;
import com.google.spanner.admin.instance.v1.ListInstanceConfigsRequest;
import com.google.spanner.admin.instance.v1.ListInstanceConfigsResponse;
import com.google.spanner.admin.instance.v1.ListInstancesRequest;
import com.google.spanner.admin.instance.v1.ListInstancesResponse;
import com.google.spanner.admin.instance.v1.ProjectName;
+import com.google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata;
+import com.google.spanner.admin.instance.v1.UpdateInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.UpdateInstanceMetadata;
import com.google.spanner.admin.instance.v1.UpdateInstanceRequest;
import java.io.IOException;
@@ -85,8 +92,11 @@
* calls that map to API methods. Sample code to get started:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* InstanceConfigName name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]");
* InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
@@ -122,8 +132,11 @@
* To customize credentials:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* InstanceAdminSettings instanceAdminSettings =
* InstanceAdminSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -134,8 +147,11 @@
* To customize the endpoint:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* InstanceAdminSettings instanceAdminSettings =
* InstanceAdminSettings.newBuilder().setEndpoint(myEndpoint).build();
* InstanceAdminClient instanceAdminClient = InstanceAdminClient.create(instanceAdminSettings);
@@ -145,8 +161,11 @@
* the wire:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* InstanceAdminSettings instanceAdminSettings =
* InstanceAdminSettings.newBuilder()
* .setTransportChannelProvider(
@@ -239,8 +258,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ProjectName parent = ProjectName.of("[PROJECT]");
* for (InstanceConfig element : instanceAdminClient.listInstanceConfigs(parent).iterateAll()) {
@@ -268,8 +290,11 @@ public final ListInstanceConfigsPagedResponse listInstanceConfigs(ProjectName pa
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String parent = ProjectName.of("[PROJECT]").toString();
* for (InstanceConfig element : instanceAdminClient.listInstanceConfigs(parent).iterateAll()) {
@@ -295,8 +320,11 @@ public final ListInstanceConfigsPagedResponse listInstanceConfigs(String parent)
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ListInstanceConfigsRequest request =
* ListInstanceConfigsRequest.newBuilder()
@@ -325,8 +353,11 @@ public final ListInstanceConfigsPagedResponse listInstanceConfigs(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ListInstanceConfigsRequest request =
* ListInstanceConfigsRequest.newBuilder()
@@ -355,8 +386,11 @@ public final ListInstanceConfigsPagedResponse listInstanceConfigs(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ListInstanceConfigsRequest request =
* ListInstanceConfigsRequest.newBuilder()
@@ -392,8 +426,11 @@ public final ListInstanceConfigsPagedResponse listInstanceConfigs(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* InstanceConfigName name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]");
* InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
@@ -419,8 +456,11 @@ public final InstanceConfig getInstanceConfig(InstanceConfigName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString();
* InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
@@ -443,8 +483,11 @@ public final InstanceConfig getInstanceConfig(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* GetInstanceConfigRequest request =
* GetInstanceConfigRequest.newBuilder()
@@ -468,8 +511,11 @@ public final InstanceConfig getInstanceConfig(GetInstanceConfigRequest request)
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* GetInstanceConfigRequest request =
* GetInstanceConfigRequest.newBuilder()
@@ -486,6 +532,989 @@ public final UnaryCallable getInstance
return stub.getInstanceConfigCallable();
}
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates an instance config and begins preparing it to be used. The returned [long-running
+ * operation][google.longrunning.Operation] can be used to track the progress of preparing the new
+ * instance config. The instance config name is assigned by the caller. If the named instance
+ * config already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`.
+ *
+ * Immediately after the request returns:
+ *
+ *
* The instance config is readable via the API, with all requested attributes. The
+ * instance config's [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+ * field is set to true. Its state is `CREATING`.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation renders the instance config immediately unreadable via the
+ * API. * Except for deleting the creating resource, all other attempts to modify the instance
+ * config are rejected.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Instances can be created using the instance configuration. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ * Its state becomes `READY`.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * creation of the instance config. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.create` permission on the resource
+ * [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * InstanceConfig instanceConfig = InstanceConfig.newBuilder().build();
+ * String instanceConfigId = "instanceConfigId1750947762";
+ * InstanceConfig response =
+ * instanceAdminClient
+ * .createInstanceConfigAsync(parent, instanceConfig, instanceConfigId)
+ * .get();
+ * }
+ * }
+ *
+ * @param parent Required. The name of the project in which to create the instance config. Values
+ * are of the form `projects/<project>`.
+ * @param instanceConfig Required. The InstanceConfig proto of the configuration to create.
+ * instance_config.name must be `<parent>/instanceConfigs/<instance_config_id>`.
+ * instance_config.base_config must be a Google managed configuration name, e.g.
+ * <parent>/instanceConfigs/us-east1, <parent>/instanceConfigs/nam3.
+ * @param instanceConfigId Required. The ID of the instance config to create. Valid identifiers
+ * are of the form `custom-[-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in
+ * length. The `custom-` prefix is required to avoid name conflicts with Google managed
+ * configurations.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture
+ createInstanceConfigAsync(
+ ProjectName parent, InstanceConfig instanceConfig, String instanceConfigId) {
+ CreateInstanceConfigRequest request =
+ CreateInstanceConfigRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .setInstanceConfig(instanceConfig)
+ .setInstanceConfigId(instanceConfigId)
+ .build();
+ return createInstanceConfigAsync(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates an instance config and begins preparing it to be used. The returned [long-running
+ * operation][google.longrunning.Operation] can be used to track the progress of preparing the new
+ * instance config. The instance config name is assigned by the caller. If the named instance
+ * config already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`.
+ *
+ * Immediately after the request returns:
+ *
+ *
* The instance config is readable via the API, with all requested attributes. The
+ * instance config's [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+ * field is set to true. Its state is `CREATING`.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation renders the instance config immediately unreadable via the
+ * API. * Except for deleting the creating resource, all other attempts to modify the instance
+ * config are rejected.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Instances can be created using the instance configuration. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ * Its state becomes `READY`.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * creation of the instance config. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.create` permission on the resource
+ * [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * String parent = ProjectName.of("[PROJECT]").toString();
+ * InstanceConfig instanceConfig = InstanceConfig.newBuilder().build();
+ * String instanceConfigId = "instanceConfigId1750947762";
+ * InstanceConfig response =
+ * instanceAdminClient
+ * .createInstanceConfigAsync(parent, instanceConfig, instanceConfigId)
+ * .get();
+ * }
+ * }
+ *
+ * @param parent Required. The name of the project in which to create the instance config. Values
+ * are of the form `projects/<project>`.
+ * @param instanceConfig Required. The InstanceConfig proto of the configuration to create.
+ * instance_config.name must be `<parent>/instanceConfigs/<instance_config_id>`.
+ * instance_config.base_config must be a Google managed configuration name, e.g.
+ * <parent>/instanceConfigs/us-east1, <parent>/instanceConfigs/nam3.
+ * @param instanceConfigId Required. The ID of the instance config to create. Valid identifiers
+ * are of the form `custom-[-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in
+ * length. The `custom-` prefix is required to avoid name conflicts with Google managed
+ * configurations.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture
+ createInstanceConfigAsync(
+ String parent, InstanceConfig instanceConfig, String instanceConfigId) {
+ CreateInstanceConfigRequest request =
+ CreateInstanceConfigRequest.newBuilder()
+ .setParent(parent)
+ .setInstanceConfig(instanceConfig)
+ .setInstanceConfigId(instanceConfigId)
+ .build();
+ return createInstanceConfigAsync(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates an instance config and begins preparing it to be used. The returned [long-running
+ * operation][google.longrunning.Operation] can be used to track the progress of preparing the new
+ * instance config. The instance config name is assigned by the caller. If the named instance
+ * config already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`.
+ *
+ * Immediately after the request returns:
+ *
+ *
* The instance config is readable via the API, with all requested attributes. The
+ * instance config's [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+ * field is set to true. Its state is `CREATING`.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation renders the instance config immediately unreadable via the
+ * API. * Except for deleting the creating resource, all other attempts to modify the instance
+ * config are rejected.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Instances can be created using the instance configuration. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ * Its state becomes `READY`.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * creation of the instance config. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.create` permission on the resource
+ * [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * CreateInstanceConfigRequest request =
+ * CreateInstanceConfigRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setInstanceConfigId("instanceConfigId1750947762")
+ * .setInstanceConfig(InstanceConfig.newBuilder().build())
+ * .setValidateOnly(true)
+ * .build();
+ * InstanceConfig response = instanceAdminClient.createInstanceConfigAsync(request).get();
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture
+ createInstanceConfigAsync(CreateInstanceConfigRequest request) {
+ return createInstanceConfigOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates an instance config and begins preparing it to be used. The returned [long-running
+ * operation][google.longrunning.Operation] can be used to track the progress of preparing the new
+ * instance config. The instance config name is assigned by the caller. If the named instance
+ * config already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`.
+ *
+ * Immediately after the request returns:
+ *
+ *
* The instance config is readable via the API, with all requested attributes. The
+ * instance config's [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+ * field is set to true. Its state is `CREATING`.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation renders the instance config immediately unreadable via the
+ * API. * Except for deleting the creating resource, all other attempts to modify the instance
+ * config are rejected.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Instances can be created using the instance configuration. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ * Its state becomes `READY`.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * creation of the instance config. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.create` permission on the resource
+ * [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * CreateInstanceConfigRequest request =
+ * CreateInstanceConfigRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setInstanceConfigId("instanceConfigId1750947762")
+ * .setInstanceConfig(InstanceConfig.newBuilder().build())
+ * .setValidateOnly(true)
+ * .build();
+ * OperationFuture future =
+ * instanceAdminClient.createInstanceConfigOperationCallable().futureCall(request);
+ * // Do something.
+ * InstanceConfig response = future.get();
+ * }
+ * }
+ */
+ public final OperationCallable<
+ CreateInstanceConfigRequest, InstanceConfig, CreateInstanceConfigMetadata>
+ createInstanceConfigOperationCallable() {
+ return stub.createInstanceConfigOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Creates an instance config and begins preparing it to be used. The returned [long-running
+ * operation][google.longrunning.Operation] can be used to track the progress of preparing the new
+ * instance config. The instance config name is assigned by the caller. If the named instance
+ * config already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`.
+ *
+ * Immediately after the request returns:
+ *
+ *
* The instance config is readable via the API, with all requested attributes. The
+ * instance config's [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+ * field is set to true. Its state is `CREATING`.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation renders the instance config immediately unreadable via the
+ * API. * Except for deleting the creating resource, all other attempts to modify the instance
+ * config are rejected.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Instances can be created using the instance configuration. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ * Its state becomes `READY`.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * creation of the instance config. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.create` permission on the resource
+ * [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * CreateInstanceConfigRequest request =
+ * CreateInstanceConfigRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setInstanceConfigId("instanceConfigId1750947762")
+ * .setInstanceConfig(InstanceConfig.newBuilder().build())
+ * .setValidateOnly(true)
+ * .build();
+ * ApiFuture future =
+ * instanceAdminClient.createInstanceConfigCallable().futureCall(request);
+ * // Do something.
+ * Operation response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallable
+ createInstanceConfigCallable() {
+ return stub.createInstanceConfigCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates an instance config. The returned [long-running operation][google.longrunning.Operation]
+ * can be used to track the progress of updating the instance. If the named instance config does
+ * not exist, returns `NOT_FOUND`.
+ *
+ * Only user managed configurations can be updated.
+ *
+ *
Immediately after the request returns:
+ *
+ *
* The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field is set to
+ * true.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation sets its metadata's
+ * [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time]. The
+ * operation is guaranteed to succeed at undoing all changes, after which point it terminates with
+ * a `CANCELLED` status. * All other attempts to modify the instance config are rejected.
+ * * Reading the instance config via the API continues to give the pre-request values.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Creating instances using the instance configuration uses the new values. * The
+ * instance config's new values are readable via the API. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * the instance config modification. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.update` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * InstanceConfig instanceConfig = InstanceConfig.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * InstanceConfig response =
+ * instanceAdminClient.updateInstanceConfigAsync(instanceConfig, updateMask).get();
+ * }
+ * }
+ *
+ * @param instanceConfig Required. The user instance config to update, which must always include
+ * the instance config name. Otherwise, only fields mentioned in
+ * [update_mask][google.spanner.admin.instance.v1.UpdateInstanceConfigRequest.update_mask]
+ * need be included. To prevent conflicts of concurrent updates,
+ * [etag][google.spanner.admin.instance.v1.InstanceConfig.reconciling] can be used.
+ * @param updateMask Required. A mask specifying which fields in
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig] should be updated. The
+ * field mask must always be specified; this prevents any future fields in
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig] from being erased
+ * accidentally by clients that do not know about them. Only display_name and labels can be
+ * updated.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture
+ updateInstanceConfigAsync(InstanceConfig instanceConfig, FieldMask updateMask) {
+ UpdateInstanceConfigRequest request =
+ UpdateInstanceConfigRequest.newBuilder()
+ .setInstanceConfig(instanceConfig)
+ .setUpdateMask(updateMask)
+ .build();
+ return updateInstanceConfigAsync(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates an instance config. The returned [long-running operation][google.longrunning.Operation]
+ * can be used to track the progress of updating the instance. If the named instance config does
+ * not exist, returns `NOT_FOUND`.
+ *
+ * Only user managed configurations can be updated.
+ *
+ *
Immediately after the request returns:
+ *
+ *
* The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field is set to
+ * true.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation sets its metadata's
+ * [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time]. The
+ * operation is guaranteed to succeed at undoing all changes, after which point it terminates with
+ * a `CANCELLED` status. * All other attempts to modify the instance config are rejected.
+ * * Reading the instance config via the API continues to give the pre-request values.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Creating instances using the instance configuration uses the new values. * The
+ * instance config's new values are readable via the API. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * the instance config modification. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.update` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * UpdateInstanceConfigRequest request =
+ * UpdateInstanceConfigRequest.newBuilder()
+ * .setInstanceConfig(InstanceConfig.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .setValidateOnly(true)
+ * .build();
+ * InstanceConfig response = instanceAdminClient.updateInstanceConfigAsync(request).get();
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final OperationFuture
+ updateInstanceConfigAsync(UpdateInstanceConfigRequest request) {
+ return updateInstanceConfigOperationCallable().futureCall(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates an instance config. The returned [long-running operation][google.longrunning.Operation]
+ * can be used to track the progress of updating the instance. If the named instance config does
+ * not exist, returns `NOT_FOUND`.
+ *
+ * Only user managed configurations can be updated.
+ *
+ *
Immediately after the request returns:
+ *
+ *
* The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field is set to
+ * true.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation sets its metadata's
+ * [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time]. The
+ * operation is guaranteed to succeed at undoing all changes, after which point it terminates with
+ * a `CANCELLED` status. * All other attempts to modify the instance config are rejected.
+ * * Reading the instance config via the API continues to give the pre-request values.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Creating instances using the instance configuration uses the new values. * The
+ * instance config's new values are readable via the API. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * the instance config modification. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.update` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * UpdateInstanceConfigRequest request =
+ * UpdateInstanceConfigRequest.newBuilder()
+ * .setInstanceConfig(InstanceConfig.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .setValidateOnly(true)
+ * .build();
+ * OperationFuture future =
+ * instanceAdminClient.updateInstanceConfigOperationCallable().futureCall(request);
+ * // Do something.
+ * InstanceConfig response = future.get();
+ * }
+ * }
+ */
+ public final OperationCallable<
+ UpdateInstanceConfigRequest, InstanceConfig, UpdateInstanceConfigMetadata>
+ updateInstanceConfigOperationCallable() {
+ return stub.updateInstanceConfigOperationCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Updates an instance config. The returned [long-running operation][google.longrunning.Operation]
+ * can be used to track the progress of updating the instance. If the named instance config does
+ * not exist, returns `NOT_FOUND`.
+ *
+ * Only user managed configurations can be updated.
+ *
+ *
Immediately after the request returns:
+ *
+ *
* The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field is set to
+ * true.
+ *
+ *
While the operation is pending:
+ *
+ *
* Cancelling the operation sets its metadata's
+ * [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time]. The
+ * operation is guaranteed to succeed at undoing all changes, after which point it terminates with
+ * a `CANCELLED` status. * All other attempts to modify the instance config are rejected.
+ * * Reading the instance config via the API continues to give the pre-request values.
+ *
+ *
Upon completion of the returned operation:
+ *
+ *
* Creating instances using the instance configuration uses the new values. * The
+ * instance config's new values are readable via the API. * The instance config's
+ * [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling] field becomes false.
+ *
+ *
The returned [long-running operation][google.longrunning.Operation] will have a name of the
+ * format `<instance_config_name>/operations/<operation_id>` and can be used to track
+ * the instance config modification. The [metadata][google.longrunning.Operation.metadata] field
+ * type is
+ * [UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].
+ * The [response][google.longrunning.Operation.response] field type is
+ * [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if successful.
+ *
+ *
Authorization requires `spanner.instanceConfigs.update` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * UpdateInstanceConfigRequest request =
+ * UpdateInstanceConfigRequest.newBuilder()
+ * .setInstanceConfig(InstanceConfig.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .setValidateOnly(true)
+ * .build();
+ * ApiFuture future =
+ * instanceAdminClient.updateInstanceConfigCallable().futureCall(request);
+ * // Do something.
+ * Operation response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallable
+ updateInstanceConfigCallable() {
+ return stub.updateInstanceConfigCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the instance config. Deletion is only allowed when no instances are using the
+ * configuration. If any instances are using the config, returns `FAILED_PRECONDITION`.
+ *
+ * Only user managed configurations can be deleted.
+ *
+ *
Authorization requires `spanner.instanceConfigs.delete` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * InstanceConfigName name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]");
+ * instanceAdminClient.deleteInstanceConfig(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the instance configuration to be deleted. Values are of the
+ * form `projects/<project>/instanceConfigs/<instance_config>`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteInstanceConfig(InstanceConfigName name) {
+ DeleteInstanceConfigRequest request =
+ DeleteInstanceConfigRequest.newBuilder()
+ .setName(name == null ? null : name.toString())
+ .build();
+ deleteInstanceConfig(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the instance config. Deletion is only allowed when no instances are using the
+ * configuration. If any instances are using the config, returns `FAILED_PRECONDITION`.
+ *
+ * Only user managed configurations can be deleted.
+ *
+ *
Authorization requires `spanner.instanceConfigs.delete` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * String name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString();
+ * instanceAdminClient.deleteInstanceConfig(name);
+ * }
+ * }
+ *
+ * @param name Required. The name of the instance configuration to be deleted. Values are of the
+ * form `projects/<project>/instanceConfigs/<instance_config>`
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteInstanceConfig(String name) {
+ DeleteInstanceConfigRequest request =
+ DeleteInstanceConfigRequest.newBuilder().setName(name).build();
+ deleteInstanceConfig(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the instance config. Deletion is only allowed when no instances are using the
+ * configuration. If any instances are using the config, returns `FAILED_PRECONDITION`.
+ *
+ * Only user managed configurations can be deleted.
+ *
+ *
Authorization requires `spanner.instanceConfigs.delete` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * DeleteInstanceConfigRequest request =
+ * DeleteInstanceConfigRequest.newBuilder()
+ * .setName(InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString())
+ * .setEtag("etag3123477")
+ * .setValidateOnly(true)
+ * .build();
+ * instanceAdminClient.deleteInstanceConfig(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final void deleteInstanceConfig(DeleteInstanceConfigRequest request) {
+ deleteInstanceConfigCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Deletes the instance config. Deletion is only allowed when no instances are using the
+ * configuration. If any instances are using the config, returns `FAILED_PRECONDITION`.
+ *
+ * Only user managed configurations can be deleted.
+ *
+ *
Authorization requires `spanner.instanceConfigs.delete` permission on the resource
+ * [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+ *
+ *
Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * DeleteInstanceConfigRequest request =
+ * DeleteInstanceConfigRequest.newBuilder()
+ * .setName(InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString())
+ * .setEtag("etag3123477")
+ * .setValidateOnly(true)
+ * .build();
+ * ApiFuture future =
+ * instanceAdminClient.deleteInstanceConfigCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
+ */
+ public final UnaryCallable deleteInstanceConfigCallable() {
+ return stub.deleteInstanceConfigCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists the user-managed instance config [long-running operations][google.longrunning.Operation]
+ * in the given project. An instance config operation has a name of the form
+ * `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
+ * The long-running operation [metadata][google.longrunning.Operation.metadata] field type
+ * `metadata.type_url` describes the type of the metadata. Operations returned include those that
+ * have completed/failed/canceled within the last 7 days, and pending operations. Operations
+ * returned are ordered by `operation.metadata.value.start_time` in descending order starting from
+ * the most recently started operation.
+ *
+ * Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * for (Operation element :
+ * instanceAdminClient.listInstanceConfigOperations(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The project of the instance config operations. Values are of the form
+ * `projects/<project>`.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListInstanceConfigOperationsPagedResponse listInstanceConfigOperations(
+ ProjectName parent) {
+ ListInstanceConfigOperationsRequest request =
+ ListInstanceConfigOperationsRequest.newBuilder()
+ .setParent(parent == null ? null : parent.toString())
+ .build();
+ return listInstanceConfigOperations(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists the user-managed instance config [long-running operations][google.longrunning.Operation]
+ * in the given project. An instance config operation has a name of the form
+ * `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
+ * The long-running operation [metadata][google.longrunning.Operation.metadata] field type
+ * `metadata.type_url` describes the type of the metadata. Operations returned include those that
+ * have completed/failed/canceled within the last 7 days, and pending operations. Operations
+ * returned are ordered by `operation.metadata.value.start_time` in descending order starting from
+ * the most recently started operation.
+ *
+ * Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * String parent = ProjectName.of("[PROJECT]").toString();
+ * for (Operation element :
+ * instanceAdminClient.listInstanceConfigOperations(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param parent Required. The project of the instance config operations. Values are of the form
+ * `projects/<project>`.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListInstanceConfigOperationsPagedResponse listInstanceConfigOperations(
+ String parent) {
+ ListInstanceConfigOperationsRequest request =
+ ListInstanceConfigOperationsRequest.newBuilder().setParent(parent).build();
+ return listInstanceConfigOperations(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists the user-managed instance config [long-running operations][google.longrunning.Operation]
+ * in the given project. An instance config operation has a name of the form
+ * `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
+ * The long-running operation [metadata][google.longrunning.Operation.metadata] field type
+ * `metadata.type_url` describes the type of the metadata. Operations returned include those that
+ * have completed/failed/canceled within the last 7 days, and pending operations. Operations
+ * returned are ordered by `operation.metadata.value.start_time` in descending order starting from
+ * the most recently started operation.
+ *
+ * Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * ListInstanceConfigOperationsRequest request =
+ * ListInstanceConfigOperationsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setFilter("filter-1274492040")
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Operation element :
+ * instanceAdminClient.listInstanceConfigOperations(request).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final ListInstanceConfigOperationsPagedResponse listInstanceConfigOperations(
+ ListInstanceConfigOperationsRequest request) {
+ return listInstanceConfigOperationsPagedCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists the user-managed instance config [long-running operations][google.longrunning.Operation]
+ * in the given project. An instance config operation has a name of the form
+ * `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
+ * The long-running operation [metadata][google.longrunning.Operation.metadata] field type
+ * `metadata.type_url` describes the type of the metadata. Operations returned include those that
+ * have completed/failed/canceled within the last 7 days, and pending operations. Operations
+ * returned are ordered by `operation.metadata.value.start_time` in descending order starting from
+ * the most recently started operation.
+ *
+ * Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * ListInstanceConfigOperationsRequest request =
+ * ListInstanceConfigOperationsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setFilter("filter-1274492040")
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * instanceAdminClient.listInstanceConfigOperationsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (Operation element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallable<
+ ListInstanceConfigOperationsRequest, ListInstanceConfigOperationsPagedResponse>
+ listInstanceConfigOperationsPagedCallable() {
+ return stub.listInstanceConfigOperationsPagedCallable();
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * Lists the user-managed instance config [long-running operations][google.longrunning.Operation]
+ * in the given project. An instance config operation has a name of the form
+ * `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
+ * The long-running operation [metadata][google.longrunning.Operation.metadata] field type
+ * `metadata.type_url` describes the type of the metadata. Operations returned include those that
+ * have completed/failed/canceled within the last 7 days, and pending operations. Operations
+ * returned are ordered by `operation.metadata.value.start_time` in descending order starting from
+ * the most recently started operation.
+ *
+ * Sample code:
+ *
+ *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
+ * ListInstanceConfigOperationsRequest request =
+ * ListInstanceConfigOperationsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setFilter("filter-1274492040")
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * while (true) {
+ * ListInstanceConfigOperationsResponse response =
+ * instanceAdminClient.listInstanceConfigOperationsCallable().call(request);
+ * for (Operation element : response.getOperationsList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
+ */
+ public final UnaryCallable<
+ ListInstanceConfigOperationsRequest, ListInstanceConfigOperationsResponse>
+ listInstanceConfigOperationsCallable() {
+ return stub.listInstanceConfigOperationsCallable();
+ }
+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists all instances in the given project.
@@ -493,8 +1522,11 @@ public final UnaryCallable getInstance
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ProjectName parent = ProjectName.of("[PROJECT]");
* for (Instance element : instanceAdminClient.listInstances(parent).iterateAll()) {
@@ -522,8 +1554,11 @@ public final ListInstancesPagedResponse listInstances(ProjectName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String parent = ProjectName.of("[PROJECT]").toString();
* for (Instance element : instanceAdminClient.listInstances(parent).iterateAll()) {
@@ -548,8 +1583,11 @@ public final ListInstancesPagedResponse listInstances(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ListInstancesRequest request =
* ListInstancesRequest.newBuilder()
@@ -578,8 +1616,11 @@ public final ListInstancesPagedResponse listInstances(ListInstancesRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ListInstancesRequest request =
* ListInstancesRequest.newBuilder()
@@ -609,8 +1650,11 @@ public final ListInstancesPagedResponse listInstances(ListInstancesRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ListInstancesRequest request =
* ListInstancesRequest.newBuilder()
@@ -645,8 +1689,11 @@ public final UnaryCallable listInst
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* InstanceName name = InstanceName.of("[PROJECT]", "[INSTANCE]");
* Instance response = instanceAdminClient.getInstance(name);
@@ -670,8 +1717,11 @@ public final Instance getInstance(InstanceName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String name = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* Instance response = instanceAdminClient.getInstance(name);
@@ -694,8 +1744,11 @@ public final Instance getInstance(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* GetInstanceRequest request =
* GetInstanceRequest.newBuilder()
@@ -720,8 +1773,11 @@ public final Instance getInstance(GetInstanceRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* GetInstanceRequest request =
* GetInstanceRequest.newBuilder()
@@ -773,8 +1829,11 @@ public final UnaryCallable getInstanceCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ProjectName parent = ProjectName.of("[PROJECT]");
* String instanceId = "instanceId902024336";
@@ -838,8 +1897,11 @@ public final OperationFuture createInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String parent = ProjectName.of("[PROJECT]").toString();
* String instanceId = "instanceId902024336";
@@ -903,8 +1965,11 @@ public final OperationFuture createInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* CreateInstanceRequest request =
* CreateInstanceRequest.newBuilder()
@@ -959,8 +2024,11 @@ public final OperationFuture createInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* CreateInstanceRequest request =
* CreateInstanceRequest.newBuilder()
@@ -1015,8 +2083,11 @@ public final OperationFuture createInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* CreateInstanceRequest request =
* CreateInstanceRequest.newBuilder()
@@ -1074,8 +2145,11 @@ public final UnaryCallable createInstanceCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* Instance instance = Instance.newBuilder().build();
* FieldMask fieldMask = FieldMask.newBuilder().build();
@@ -1140,8 +2214,11 @@ public final OperationFuture updateInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* UpdateInstanceRequest request =
* UpdateInstanceRequest.newBuilder()
@@ -1199,8 +2276,11 @@ public final OperationFuture updateInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* UpdateInstanceRequest request =
* UpdateInstanceRequest.newBuilder()
@@ -1258,8 +2338,11 @@ public final OperationFuture updateInstanceAsy
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* UpdateInstanceRequest request =
* UpdateInstanceRequest.newBuilder()
@@ -1293,8 +2376,11 @@ public final UnaryCallable updateInstanceCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* InstanceName name = InstanceName.of("[PROJECT]", "[INSTANCE]");
* instanceAdminClient.deleteInstance(name);
@@ -1327,8 +2413,11 @@ public final void deleteInstance(InstanceName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String name = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
* instanceAdminClient.deleteInstance(name);
@@ -1360,8 +2449,11 @@ public final void deleteInstance(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* DeleteInstanceRequest request =
* DeleteInstanceRequest.newBuilder()
@@ -1394,8 +2486,11 @@ public final void deleteInstance(DeleteInstanceRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* DeleteInstanceRequest request =
* DeleteInstanceRequest.newBuilder()
@@ -1421,8 +2516,11 @@ public final UnaryCallable deleteInstanceCallable(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ResourceName resource = InstanceName.of("[PROJECT]", "[INSTANCE]");
* Policy policy = Policy.newBuilder().build();
@@ -1456,8 +2554,11 @@ public final Policy setIamPolicy(ResourceName resource, Policy policy) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String resource = ProjectName.of("[PROJECT]").toString();
* Policy policy = Policy.newBuilder().build();
@@ -1488,8 +2589,11 @@ public final Policy setIamPolicy(String resource, Policy policy) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1518,8 +2622,11 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1548,8 +2655,11 @@ public final UnaryCallable setIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ResourceName resource = InstanceName.of("[PROJECT]", "[INSTANCE]");
* Policy response = instanceAdminClient.getIamPolicy(resource);
@@ -1579,8 +2689,11 @@ public final Policy getIamPolicy(ResourceName resource) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String resource = ProjectName.of("[PROJECT]").toString();
* Policy response = instanceAdminClient.getIamPolicy(resource);
@@ -1607,8 +2720,11 @@ public final Policy getIamPolicy(String resource) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1637,8 +2753,11 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1666,8 +2785,11 @@ public final UnaryCallable getIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* ResourceName resource = InstanceName.of("[PROJECT]", "[INSTANCE]");
* List permissions = new ArrayList<>();
@@ -1704,8 +2826,11 @@ public final TestIamPermissionsResponse testIamPermissions(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* String resource = ProjectName.of("[PROJECT]").toString();
* List permissions = new ArrayList<>();
@@ -1742,8 +2867,11 @@ public final TestIamPermissionsResponse testIamPermissions(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
@@ -1772,8 +2900,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
@@ -1906,6 +3037,103 @@ protected ListInstanceConfigsFixedSizeCollection createCollection(
}
}
+ public static class ListInstanceConfigOperationsPagedResponse
+ extends AbstractPagedListResponse<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation,
+ ListInstanceConfigOperationsPage,
+ ListInstanceConfigOperationsFixedSizeCollection> {
+
+ public static ApiFuture createAsync(
+ PageContext<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation>
+ context,
+ ApiFuture futureResponse) {
+ ApiFuture futurePage =
+ ListInstanceConfigOperationsPage.createEmptyPage()
+ .createPageAsync(context, futureResponse);
+ return ApiFutures.transform(
+ futurePage,
+ input -> new ListInstanceConfigOperationsPagedResponse(input),
+ MoreExecutors.directExecutor());
+ }
+
+ private ListInstanceConfigOperationsPagedResponse(ListInstanceConfigOperationsPage page) {
+ super(page, ListInstanceConfigOperationsFixedSizeCollection.createEmptyCollection());
+ }
+ }
+
+ public static class ListInstanceConfigOperationsPage
+ extends AbstractPage<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation,
+ ListInstanceConfigOperationsPage> {
+
+ private ListInstanceConfigOperationsPage(
+ PageContext<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation>
+ context,
+ ListInstanceConfigOperationsResponse response) {
+ super(context, response);
+ }
+
+ private static ListInstanceConfigOperationsPage createEmptyPage() {
+ return new ListInstanceConfigOperationsPage(null, null);
+ }
+
+ @Override
+ protected ListInstanceConfigOperationsPage createPage(
+ PageContext<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation>
+ context,
+ ListInstanceConfigOperationsResponse response) {
+ return new ListInstanceConfigOperationsPage(context, response);
+ }
+
+ @Override
+ public ApiFuture createPageAsync(
+ PageContext<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation>
+ context,
+ ApiFuture futureResponse) {
+ return super.createPageAsync(context, futureResponse);
+ }
+ }
+
+ public static class ListInstanceConfigOperationsFixedSizeCollection
+ extends AbstractFixedSizeCollection<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ Operation,
+ ListInstanceConfigOperationsPage,
+ ListInstanceConfigOperationsFixedSizeCollection> {
+
+ private ListInstanceConfigOperationsFixedSizeCollection(
+ List pages, int collectionSize) {
+ super(pages, collectionSize);
+ }
+
+ private static ListInstanceConfigOperationsFixedSizeCollection createEmptyCollection() {
+ return new ListInstanceConfigOperationsFixedSizeCollection(null, 0);
+ }
+
+ @Override
+ protected ListInstanceConfigOperationsFixedSizeCollection createCollection(
+ List pages, int collectionSize) {
+ return new ListInstanceConfigOperationsFixedSizeCollection(pages, collectionSize);
+ }
+ }
+
public static class ListInstancesPagedResponse
extends AbstractPagedListResponse<
ListInstancesRequest,
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminSettings.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminSettings.java
index 36339665f01..bed7960d4f0 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminSettings.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminSettings.java
@@ -16,6 +16,7 @@
package com.google.cloud.spanner.admin.instance.v1;
+import static com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient.ListInstanceConfigOperationsPagedResponse;
import static com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient.ListInstanceConfigsPagedResponse;
import static com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient.ListInstancesPagedResponse;
@@ -40,17 +41,24 @@
import com.google.iam.v1.TestIamPermissionsResponse;
import com.google.longrunning.Operation;
import com.google.protobuf.Empty;
+import com.google.spanner.admin.instance.v1.CreateInstanceConfigMetadata;
+import com.google.spanner.admin.instance.v1.CreateInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.CreateInstanceMetadata;
import com.google.spanner.admin.instance.v1.CreateInstanceRequest;
+import com.google.spanner.admin.instance.v1.DeleteInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.DeleteInstanceRequest;
import com.google.spanner.admin.instance.v1.GetInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.GetInstanceRequest;
import com.google.spanner.admin.instance.v1.Instance;
import com.google.spanner.admin.instance.v1.InstanceConfig;
+import com.google.spanner.admin.instance.v1.ListInstanceConfigOperationsRequest;
+import com.google.spanner.admin.instance.v1.ListInstanceConfigOperationsResponse;
import com.google.spanner.admin.instance.v1.ListInstanceConfigsRequest;
import com.google.spanner.admin.instance.v1.ListInstanceConfigsResponse;
import com.google.spanner.admin.instance.v1.ListInstancesRequest;
import com.google.spanner.admin.instance.v1.ListInstancesResponse;
+import com.google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata;
+import com.google.spanner.admin.instance.v1.UpdateInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.UpdateInstanceMetadata;
import com.google.spanner.admin.instance.v1.UpdateInstanceRequest;
import java.io.IOException;
@@ -75,16 +83,16 @@
* For example, to set the total timeout of getInstanceConfig to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* InstanceAdminSettings.Builder instanceAdminSettingsBuilder = InstanceAdminSettings.newBuilder();
* instanceAdminSettingsBuilder
* .getInstanceConfigSettings()
* .setRetrySettings(
- * instanceAdminSettingsBuilder
- * .getInstanceConfigSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * instanceAdminSettingsBuilder.getInstanceConfigSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* InstanceAdminSettings instanceAdminSettings = instanceAdminSettingsBuilder.build();
@@ -105,6 +113,44 @@ public UnaryCallSettings getInstanceCo
return ((InstanceAdminStubSettings) getStubSettings()).getInstanceConfigSettings();
}
+ /** Returns the object with the settings used for calls to createInstanceConfig. */
+ public UnaryCallSettings createInstanceConfigSettings() {
+ return ((InstanceAdminStubSettings) getStubSettings()).createInstanceConfigSettings();
+ }
+
+ /** Returns the object with the settings used for calls to createInstanceConfig. */
+ public OperationCallSettings<
+ CreateInstanceConfigRequest, InstanceConfig, CreateInstanceConfigMetadata>
+ createInstanceConfigOperationSettings() {
+ return ((InstanceAdminStubSettings) getStubSettings()).createInstanceConfigOperationSettings();
+ }
+
+ /** Returns the object with the settings used for calls to updateInstanceConfig. */
+ public UnaryCallSettings updateInstanceConfigSettings() {
+ return ((InstanceAdminStubSettings) getStubSettings()).updateInstanceConfigSettings();
+ }
+
+ /** Returns the object with the settings used for calls to updateInstanceConfig. */
+ public OperationCallSettings<
+ UpdateInstanceConfigRequest, InstanceConfig, UpdateInstanceConfigMetadata>
+ updateInstanceConfigOperationSettings() {
+ return ((InstanceAdminStubSettings) getStubSettings()).updateInstanceConfigOperationSettings();
+ }
+
+ /** Returns the object with the settings used for calls to deleteInstanceConfig. */
+ public UnaryCallSettings deleteInstanceConfigSettings() {
+ return ((InstanceAdminStubSettings) getStubSettings()).deleteInstanceConfigSettings();
+ }
+
+ /** Returns the object with the settings used for calls to listInstanceConfigOperations. */
+ public PagedCallSettings<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ ListInstanceConfigOperationsPagedResponse>
+ listInstanceConfigOperationsSettings() {
+ return ((InstanceAdminStubSettings) getStubSettings()).listInstanceConfigOperationsSettings();
+ }
+
/** Returns the object with the settings used for calls to listInstances. */
public PagedCallSettings
listInstancesSettings() {
@@ -289,6 +335,47 @@ public Builder applyToAllUnaryMethods(
return getStubSettingsBuilder().getInstanceConfigSettings();
}
+ /** Returns the builder for the settings used for calls to createInstanceConfig. */
+ public UnaryCallSettings.Builder
+ createInstanceConfigSettings() {
+ return getStubSettingsBuilder().createInstanceConfigSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to createInstanceConfig. */
+ public OperationCallSettings.Builder<
+ CreateInstanceConfigRequest, InstanceConfig, CreateInstanceConfigMetadata>
+ createInstanceConfigOperationSettings() {
+ return getStubSettingsBuilder().createInstanceConfigOperationSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to updateInstanceConfig. */
+ public UnaryCallSettings.Builder
+ updateInstanceConfigSettings() {
+ return getStubSettingsBuilder().updateInstanceConfigSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to updateInstanceConfig. */
+ public OperationCallSettings.Builder<
+ UpdateInstanceConfigRequest, InstanceConfig, UpdateInstanceConfigMetadata>
+ updateInstanceConfigOperationSettings() {
+ return getStubSettingsBuilder().updateInstanceConfigOperationSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to deleteInstanceConfig. */
+ public UnaryCallSettings.Builder
+ deleteInstanceConfigSettings() {
+ return getStubSettingsBuilder().deleteInstanceConfigSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to listInstanceConfigOperations. */
+ public PagedCallSettings.Builder<
+ ListInstanceConfigOperationsRequest,
+ ListInstanceConfigOperationsResponse,
+ ListInstanceConfigOperationsPagedResponse>
+ listInstanceConfigOperationsSettings() {
+ return getStubSettingsBuilder().listInstanceConfigOperationsSettings();
+ }
+
/** Returns the builder for the settings used for calls to listInstances. */
public PagedCallSettings.Builder<
ListInstancesRequest, ListInstancesResponse, ListInstancesPagedResponse>
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/gapic_metadata.json b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/gapic_metadata.json
index fd237fc2182..2296749c13a 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/gapic_metadata.json
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/gapic_metadata.json
@@ -13,9 +13,15 @@
"CreateInstance": {
"methods": ["createInstanceAsync", "createInstanceAsync", "createInstanceAsync", "createInstanceOperationCallable", "createInstanceCallable"]
},
+ "CreateInstanceConfig": {
+ "methods": ["createInstanceConfigAsync", "createInstanceConfigAsync", "createInstanceConfigAsync", "createInstanceConfigOperationCallable", "createInstanceConfigCallable"]
+ },
"DeleteInstance": {
"methods": ["deleteInstance", "deleteInstance", "deleteInstance", "deleteInstanceCallable"]
},
+ "DeleteInstanceConfig": {
+ "methods": ["deleteInstanceConfig", "deleteInstanceConfig", "deleteInstanceConfig", "deleteInstanceConfigCallable"]
+ },
"GetIamPolicy": {
"methods": ["getIamPolicy", "getIamPolicy", "getIamPolicy", "getIamPolicyCallable"]
},
@@ -25,6 +31,9 @@
"GetInstanceConfig": {
"methods": ["getInstanceConfig", "getInstanceConfig", "getInstanceConfig", "getInstanceConfigCallable"]
},
+ "ListInstanceConfigOperations": {
+ "methods": ["listInstanceConfigOperations", "listInstanceConfigOperations", "listInstanceConfigOperations", "listInstanceConfigOperationsPagedCallable", "listInstanceConfigOperationsCallable"]
+ },
"ListInstanceConfigs": {
"methods": ["listInstanceConfigs", "listInstanceConfigs", "listInstanceConfigs", "listInstanceConfigsPagedCallable", "listInstanceConfigsCallable"]
},
@@ -39,6 +48,9 @@
},
"UpdateInstance": {
"methods": ["updateInstanceAsync", "updateInstanceAsync", "updateInstanceOperationCallable", "updateInstanceCallable"]
+ },
+ "UpdateInstanceConfig": {
+ "methods": ["updateInstanceConfigAsync", "updateInstanceConfigAsync", "updateInstanceConfigOperationCallable", "updateInstanceConfigCallable"]
}
}
}
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/package-info.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/package-info.java
index 385739e5c80..98f6e781e94 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/package-info.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/package-info.java
@@ -40,8 +40,11 @@
* Sample for InstanceAdminClient:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
* InstanceConfigName name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]");
* InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
diff --git a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/stub/GrpcInstanceAdminStub.java b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/stub/GrpcInstanceAdminStub.java
index 20cd1496cfb..aef9f8725c7 100644
--- a/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/stub/GrpcInstanceAdminStub.java
+++ b/google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/stub/GrpcInstanceAdminStub.java
@@ -16,6 +16,7 @@
package com.google.cloud.spanner.admin.instance.v1.stub;
+import static com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient.ListInstanceConfigOperationsPagedResponse;
import static com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient.ListInstanceConfigsPagedResponse;
import static com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient.ListInstancesPagedResponse;
@@ -35,17 +36,24 @@
import com.google.longrunning.Operation;
import com.google.longrunning.stub.GrpcOperationsStub;
import com.google.protobuf.Empty;
+import com.google.spanner.admin.instance.v1.CreateInstanceConfigMetadata;
+import com.google.spanner.admin.instance.v1.CreateInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.CreateInstanceMetadata;
import com.google.spanner.admin.instance.v1.CreateInstanceRequest;
+import com.google.spanner.admin.instance.v1.DeleteInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.DeleteInstanceRequest;
import com.google.spanner.admin.instance.v1.GetInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.GetInstanceRequest;
import com.google.spanner.admin.instance.v1.Instance;
import com.google.spanner.admin.instance.v1.InstanceConfig;
+import com.google.spanner.admin.instance.v1.ListInstanceConfigOperationsRequest;
+import com.google.spanner.admin.instance.v1.ListInstanceConfigOperationsResponse;
import com.google.spanner.admin.instance.v1.ListInstanceConfigsRequest;
import com.google.spanner.admin.instance.v1.ListInstanceConfigsResponse;
import com.google.spanner.admin.instance.v1.ListInstancesRequest;
import com.google.spanner.admin.instance.v1.ListInstancesResponse;
+import com.google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata;
+import com.google.spanner.admin.instance.v1.UpdateInstanceConfigRequest;
import com.google.spanner.admin.instance.v1.UpdateInstanceMetadata;
import com.google.spanner.admin.instance.v1.UpdateInstanceRequest;
import io.grpc.MethodDescriptor;
@@ -84,6 +92,54 @@ public class GrpcInstanceAdminStub extends InstanceAdminStub {
.setResponseMarshaller(ProtoUtils.marshaller(InstanceConfig.getDefaultInstance()))
.build();
+ private static final MethodDescriptor
+ createInstanceConfigMethodDescriptor =
+ MethodDescriptor.