diff --git a/README.md b/README.md index 1e91e0a91..e8439ed7d 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ If you are using Maven without the BOM, add this to your dependencies: If you are using Gradle 5.x or later, add this to your dependencies: ```Groovy -implementation platform('com.google.cloud:libraries-bom:26.19.0') +implementation platform('com.google.cloud:libraries-bom:26.20.0') implementation 'com.google.cloud:google-cloud-datastore' ``` diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java index 7d4752fb9..399e61e01 100644 --- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java +++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java @@ -58,56 +58,40 @@ * *
The Datastore Admin API provides several admin services for Cloud Datastore. * - *
----------------------------------------------------------------------------- ## Concepts - * - *
Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. + *
Concepts: Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. * *
Operation: An Operation represents work being performed in the background. * *
EntityFilter: Allows specifying a subset of entities in a project. This is specified as a * combination of kinds and namespaces (either or both of which may be all). * - *
----------------------------------------------------------------------------- ## Services - * - *
# Export/Import - * - *
The Export/Import service provides the ability to copy all or a subset of entities to/from - * Google Cloud Storage. - * - *
Exported data may be imported into Cloud Datastore for any Google Cloud Platform project. It - * is not restricted to the export source project. It is possible to export from one project and - * then import into another. - * - *
Exported data can also be loaded into Google BigQuery for analysis. + *
Export/Import Service: * - *
Exports and imports are performed asynchronously. An Operation resource is created for each - * export/import. The state (including any errors encountered) of the export/import may be queried - * via the Operation resource. + *
- The Export/Import service provides the ability to copy all or a subset of entities to/from + * Google Cloud Storage. - Exported data may be imported into Cloud Datastore for any Google Cloud + * Platform project. It is not restricted to the export source project. It is possible to export + * from one project and then import into another. - Exported data can also be loaded into Google + * BigQuery for analysis. - Exports and imports are performed asynchronously. An Operation resource + * is created for each export/import. The state (including any errors encountered) of the + * export/import may be queried via the Operation resource. * - *
# Index + *
Index Service: * - *
The index service manages Cloud Datastore composite indexes. + *
- The index service manages Cloud Datastore composite indexes. - Index creation and deletion + * are performed asynchronously. An Operation resource is created for each such asynchronous + * operation. The state of the operation (including any errors encountered) may be queried via the + * Operation resource. * - *
Index creation and deletion are performed asynchronously. An Operation resource is created for - * each such asynchronous operation. The state of the operation (including any errors encountered) - * may be queried via the Operation resource. + *
Operation Service: * - *
# Operation - * - *
The Operations collection provides a record of actions performed for the specified project + *
- The Operations collection provides a record of actions performed for the specified project * (including any operations in progress). Operations are not created directly but through calls on - * other collections or resources. - * - *
An operation that is not yet done may be cancelled. The request to cancel is asynchronous and - * the operation may continue to run for some time after the request to cancel is made. - * - *
An operation that is done may be deleted so that it is no longer listed as part of the - * Operation collection. - * - *
ListOperations returns all pending operations, but not completed operations. - * - *
Operations are created by service DatastoreAdmin, but are accessed via service - * google.longrunning.Operations. + * other collections or resources. - An operation that is not yet done may be cancelled. The request + * to cancel is asynchronous and the operation may continue to run for some time after the request + * to cancel is made. - An operation that is done may be deleted so that it is no longer listed as + * part of the Operation collection. - ListOperations returns all pending operations, but not + * completed operations. - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. * *
This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java index b6dd28a57..3079a193a 100644 --- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java +++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java @@ -25,56 +25,40 @@ * *
The Datastore Admin API provides several admin services for Cloud Datastore. * - *
----------------------------------------------------------------------------- ## Concepts - * - *
Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. + *
Concepts: Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. * *
Operation: An Operation represents work being performed in the background. * *
EntityFilter: Allows specifying a subset of entities in a project. This is specified as a * combination of kinds and namespaces (either or both of which may be all). * - *
----------------------------------------------------------------------------- ## Services - * - *
# Export/Import - * - *
The Export/Import service provides the ability to copy all or a subset of entities to/from - * Google Cloud Storage. - * - *
Exported data may be imported into Cloud Datastore for any Google Cloud Platform project. It - * is not restricted to the export source project. It is possible to export from one project and - * then import into another. - * - *
Exported data can also be loaded into Google BigQuery for analysis. + *
Export/Import Service: * - *
Exports and imports are performed asynchronously. An Operation resource is created for each - * export/import. The state (including any errors encountered) of the export/import may be queried - * via the Operation resource. + *
- The Export/Import service provides the ability to copy all or a subset of entities to/from + * Google Cloud Storage. - Exported data may be imported into Cloud Datastore for any Google Cloud + * Platform project. It is not restricted to the export source project. It is possible to export + * from one project and then import into another. - Exported data can also be loaded into Google + * BigQuery for analysis. - Exports and imports are performed asynchronously. An Operation resource + * is created for each export/import. The state (including any errors encountered) of the + * export/import may be queried via the Operation resource. * - *
# Index + *
Index Service: * - *
The index service manages Cloud Datastore composite indexes. + *
- The index service manages Cloud Datastore composite indexes. - Index creation and deletion + * are performed asynchronously. An Operation resource is created for each such asynchronous + * operation. The state of the operation (including any errors encountered) may be queried via the + * Operation resource. * - *
Index creation and deletion are performed asynchronously. An Operation resource is created for - * each such asynchronous operation. The state of the operation (including any errors encountered) - * may be queried via the Operation resource. + *
Operation Service: * - *
# Operation - * - *
The Operations collection provides a record of actions performed for the specified project + *
- The Operations collection provides a record of actions performed for the specified project * (including any operations in progress). Operations are not created directly but through calls on - * other collections or resources. - * - *
An operation that is not yet done may be cancelled. The request to cancel is asynchronous and - * the operation may continue to run for some time after the request to cancel is made. - * - *
An operation that is done may be deleted so that it is no longer listed as part of the - * Operation collection. - * - *
ListOperations returns all pending operations, but not completed operations. - * - *
Operations are created by service DatastoreAdmin, but are accessed via service - * google.longrunning.Operations. + * other collections or resources. - An operation that is not yet done may be cancelled. The request + * to cancel is asynchronous and the operation may continue to run for some time after the request + * to cancel is made. - An operation that is done may be deleted so that it is no longer listed as + * part of the Operation collection. - ListOperations returns all pending operations, but not + * completed operations. - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. * *
Sample for DatastoreAdminClient: * diff --git a/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java b/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java index 6fe5618d7..1b1f7803f 100644 --- a/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java +++ b/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java @@ -23,44 +23,41 @@ *
* Google Cloud Datastore Admin API * The Datastore Admin API provides several admin services for Cloud Datastore. - * ----------------------------------------------------------------------------- - * ## Concepts - * Project, namespace, kind, and entity as defined in the Google Cloud Datastore - * API. + * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud + * Datastore API. * Operation: An Operation represents work being performed in the background. * EntityFilter: Allows specifying a subset of entities in a project. This is * specified as a combination of kinds and namespaces (either or both of which * may be all). - * ----------------------------------------------------------------------------- - * ## Services - * # Export/Import - * The Export/Import service provides the ability to copy all or a subset of + * Export/Import Service: + * - The Export/Import service provides the ability to copy all or a subset of * entities to/from Google Cloud Storage. - * Exported data may be imported into Cloud Datastore for any Google Cloud + * - Exported data may be imported into Cloud Datastore for any Google Cloud * Platform project. It is not restricted to the export source project. It is * possible to export from one project and then import into another. - * Exported data can also be loaded into Google BigQuery for analysis. - * Exports and imports are performed asynchronously. An Operation resource is + * - Exported data can also be loaded into Google BigQuery for analysis. + * - Exports and imports are performed asynchronously. An Operation resource is * created for each export/import. The state (including any errors encountered) * of the export/import may be queried via the Operation resource. - * # Index - * The index service manages Cloud Datastore composite indexes. - * Index creation and deletion are performed asynchronously. + * Index Service: + * - The index service manages Cloud Datastore composite indexes. + * - Index creation and deletion are performed asynchronously. * An Operation resource is created for each such asynchronous operation. * The state of the operation (including any errors encountered) * may be queried via the Operation resource. - * # Operation - * The Operations collection provides a record of actions performed for the + * Operation Service: + * - The Operations collection provides a record of actions performed for the * specified project (including any operations in progress). Operations are not * created directly but through calls on other collections or resources. - * An operation that is not yet done may be cancelled. The request to cancel is - * asynchronous and the operation may continue to run for some time after the + * - An operation that is not yet done may be cancelled. The request to cancel + * is asynchronous and the operation may continue to run for some time after the * request to cancel is made. - * An operation that is done may be deleted so that it is no longer listed as + * - An operation that is done may be deleted so that it is no longer listed as * part of the Operation collection. - * ListOperations returns all pending operations, but not completed operations. - * Operations are created by service DatastoreAdmin, - * but are accessed via service google.longrunning.Operations. + * - ListOperations returns all pending operations, but not completed + * operations. + * - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. **/ @javax.annotation.Generated( @@ -381,44 +378,41 @@ public DatastoreAdminFutureStub newStub( *
* Google Cloud Datastore Admin API * The Datastore Admin API provides several admin services for Cloud Datastore. - * ----------------------------------------------------------------------------- - * ## Concepts - * Project, namespace, kind, and entity as defined in the Google Cloud Datastore - * API. + * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud + * Datastore API. * Operation: An Operation represents work being performed in the background. * EntityFilter: Allows specifying a subset of entities in a project. This is * specified as a combination of kinds and namespaces (either or both of which * may be all). - * ----------------------------------------------------------------------------- - * ## Services - * # Export/Import - * The Export/Import service provides the ability to copy all or a subset of + * Export/Import Service: + * - The Export/Import service provides the ability to copy all or a subset of * entities to/from Google Cloud Storage. - * Exported data may be imported into Cloud Datastore for any Google Cloud + * - Exported data may be imported into Cloud Datastore for any Google Cloud * Platform project. It is not restricted to the export source project. It is * possible to export from one project and then import into another. - * Exported data can also be loaded into Google BigQuery for analysis. - * Exports and imports are performed asynchronously. An Operation resource is + * - Exported data can also be loaded into Google BigQuery for analysis. + * - Exports and imports are performed asynchronously. An Operation resource is * created for each export/import. The state (including any errors encountered) * of the export/import may be queried via the Operation resource. - * # Index - * The index service manages Cloud Datastore composite indexes. - * Index creation and deletion are performed asynchronously. + * Index Service: + * - The index service manages Cloud Datastore composite indexes. + * - Index creation and deletion are performed asynchronously. * An Operation resource is created for each such asynchronous operation. * The state of the operation (including any errors encountered) * may be queried via the Operation resource. - * # Operation - * The Operations collection provides a record of actions performed for the + * Operation Service: + * - The Operations collection provides a record of actions performed for the * specified project (including any operations in progress). Operations are not * created directly but through calls on other collections or resources. - * An operation that is not yet done may be cancelled. The request to cancel is - * asynchronous and the operation may continue to run for some time after the + * - An operation that is not yet done may be cancelled. The request to cancel + * is asynchronous and the operation may continue to run for some time after the * request to cancel is made. - * An operation that is done may be deleted so that it is no longer listed as + * - An operation that is done may be deleted so that it is no longer listed as * part of the Operation collection. - * ListOperations returns all pending operations, but not completed operations. - * Operations are created by service DatastoreAdmin, - * but are accessed via service google.longrunning.Operations. + * - ListOperations returns all pending operations, but not completed + * operations. + * - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. **/ public interface AsyncService { @@ -468,9 +462,9 @@ default void importEntities( *
* Creates the specified index. * A newly created index's initial state is `CREATING`. On completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`. - * If the index already exists, the call will return an `ALREADY_EXISTS` - * status. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * state will be `READY`. If the index already exists, the call will return an + * `ALREADY_EXISTS` status. * During index creation, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, removing the index with @@ -495,7 +489,8 @@ default void createIndex( * An index can only be deleted if it is in a `READY` or `ERROR` state. On * successful execution of the request, the index will be in a `DELETING` * [state][google.datastore.admin.v1.Index.State]. And on completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the index will be removed. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * index will be removed. * During index deletion, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, followed by calling @@ -546,44 +541,41 @@ default void listIndexes( ** Google Cloud Datastore Admin API * The Datastore Admin API provides several admin services for Cloud Datastore. - * ----------------------------------------------------------------------------- - * ## Concepts - * Project, namespace, kind, and entity as defined in the Google Cloud Datastore - * API. + * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud + * Datastore API. * Operation: An Operation represents work being performed in the background. * EntityFilter: Allows specifying a subset of entities in a project. This is * specified as a combination of kinds and namespaces (either or both of which * may be all). - * ----------------------------------------------------------------------------- - * ## Services - * # Export/Import - * The Export/Import service provides the ability to copy all or a subset of + * Export/Import Service: + * - The Export/Import service provides the ability to copy all or a subset of * entities to/from Google Cloud Storage. - * Exported data may be imported into Cloud Datastore for any Google Cloud + * - Exported data may be imported into Cloud Datastore for any Google Cloud * Platform project. It is not restricted to the export source project. It is * possible to export from one project and then import into another. - * Exported data can also be loaded into Google BigQuery for analysis. - * Exports and imports are performed asynchronously. An Operation resource is + * - Exported data can also be loaded into Google BigQuery for analysis. + * - Exports and imports are performed asynchronously. An Operation resource is * created for each export/import. The state (including any errors encountered) * of the export/import may be queried via the Operation resource. - * # Index - * The index service manages Cloud Datastore composite indexes. - * Index creation and deletion are performed asynchronously. + * Index Service: + * - The index service manages Cloud Datastore composite indexes. + * - Index creation and deletion are performed asynchronously. * An Operation resource is created for each such asynchronous operation. * The state of the operation (including any errors encountered) * may be queried via the Operation resource. - * # Operation - * The Operations collection provides a record of actions performed for the + * Operation Service: + * - The Operations collection provides a record of actions performed for the * specified project (including any operations in progress). Operations are not * created directly but through calls on other collections or resources. - * An operation that is not yet done may be cancelled. The request to cancel is - * asynchronous and the operation may continue to run for some time after the + * - An operation that is not yet done may be cancelled. The request to cancel + * is asynchronous and the operation may continue to run for some time after the * request to cancel is made. - * An operation that is done may be deleted so that it is no longer listed as + * - An operation that is done may be deleted so that it is no longer listed as * part of the Operation collection. - * ListOperations returns all pending operations, but not completed operations. - * Operations are created by service DatastoreAdmin, - * but are accessed via service google.longrunning.Operations. + * - ListOperations returns all pending operations, but not completed + * operations. + * - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. **/ public abstract static class DatastoreAdminImplBase @@ -601,44 +593,41 @@ public final io.grpc.ServerServiceDefinition bindService() { ** Google Cloud Datastore Admin API * The Datastore Admin API provides several admin services for Cloud Datastore. - * ----------------------------------------------------------------------------- - * ## Concepts - * Project, namespace, kind, and entity as defined in the Google Cloud Datastore - * API. + * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud + * Datastore API. * Operation: An Operation represents work being performed in the background. * EntityFilter: Allows specifying a subset of entities in a project. This is * specified as a combination of kinds and namespaces (either or both of which * may be all). - * ----------------------------------------------------------------------------- - * ## Services - * # Export/Import - * The Export/Import service provides the ability to copy all or a subset of + * Export/Import Service: + * - The Export/Import service provides the ability to copy all or a subset of * entities to/from Google Cloud Storage. - * Exported data may be imported into Cloud Datastore for any Google Cloud + * - Exported data may be imported into Cloud Datastore for any Google Cloud * Platform project. It is not restricted to the export source project. It is * possible to export from one project and then import into another. - * Exported data can also be loaded into Google BigQuery for analysis. - * Exports and imports are performed asynchronously. An Operation resource is + * - Exported data can also be loaded into Google BigQuery for analysis. + * - Exports and imports are performed asynchronously. An Operation resource is * created for each export/import. The state (including any errors encountered) * of the export/import may be queried via the Operation resource. - * # Index - * The index service manages Cloud Datastore composite indexes. - * Index creation and deletion are performed asynchronously. + * Index Service: + * - The index service manages Cloud Datastore composite indexes. + * - Index creation and deletion are performed asynchronously. * An Operation resource is created for each such asynchronous operation. * The state of the operation (including any errors encountered) * may be queried via the Operation resource. - * # Operation - * The Operations collection provides a record of actions performed for the + * Operation Service: + * - The Operations collection provides a record of actions performed for the * specified project (including any operations in progress). Operations are not * created directly but through calls on other collections or resources. - * An operation that is not yet done may be cancelled. The request to cancel is - * asynchronous and the operation may continue to run for some time after the + * - An operation that is not yet done may be cancelled. The request to cancel + * is asynchronous and the operation may continue to run for some time after the * request to cancel is made. - * An operation that is done may be deleted so that it is no longer listed as + * - An operation that is done may be deleted so that it is no longer listed as * part of the Operation collection. - * ListOperations returns all pending operations, but not completed operations. - * Operations are created by service DatastoreAdmin, - * but are accessed via service google.longrunning.Operations. + * - ListOperations returns all pending operations, but not completed + * operations. + * - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. **/ public static final class DatastoreAdminStub @@ -701,9 +690,9 @@ public void importEntities( ** Creates the specified index. * A newly created index's initial state is `CREATING`. On completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`. - * If the index already exists, the call will return an `ALREADY_EXISTS` - * status. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * state will be `READY`. If the index already exists, the call will return an + * `ALREADY_EXISTS` status. * During index creation, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, removing the index with @@ -730,7 +719,8 @@ public void createIndex( * An index can only be deleted if it is in a `READY` or `ERROR` state. On * successful execution of the request, the index will be in a `DELETING` * [state][google.datastore.admin.v1.Index.State]. And on completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the index will be removed. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * index will be removed. * During index deletion, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, followed by calling @@ -786,44 +776,41 @@ public void listIndexes( ** Google Cloud Datastore Admin API * The Datastore Admin API provides several admin services for Cloud Datastore. - * ----------------------------------------------------------------------------- - * ## Concepts - * Project, namespace, kind, and entity as defined in the Google Cloud Datastore - * API. + * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud + * Datastore API. * Operation: An Operation represents work being performed in the background. * EntityFilter: Allows specifying a subset of entities in a project. This is * specified as a combination of kinds and namespaces (either or both of which * may be all). - * ----------------------------------------------------------------------------- - * ## Services - * # Export/Import - * The Export/Import service provides the ability to copy all or a subset of + * Export/Import Service: + * - The Export/Import service provides the ability to copy all or a subset of * entities to/from Google Cloud Storage. - * Exported data may be imported into Cloud Datastore for any Google Cloud + * - Exported data may be imported into Cloud Datastore for any Google Cloud * Platform project. It is not restricted to the export source project. It is * possible to export from one project and then import into another. - * Exported data can also be loaded into Google BigQuery for analysis. - * Exports and imports are performed asynchronously. An Operation resource is + * - Exported data can also be loaded into Google BigQuery for analysis. + * - Exports and imports are performed asynchronously. An Operation resource is * created for each export/import. The state (including any errors encountered) * of the export/import may be queried via the Operation resource. - * # Index - * The index service manages Cloud Datastore composite indexes. - * Index creation and deletion are performed asynchronously. + * Index Service: + * - The index service manages Cloud Datastore composite indexes. + * - Index creation and deletion are performed asynchronously. * An Operation resource is created for each such asynchronous operation. * The state of the operation (including any errors encountered) * may be queried via the Operation resource. - * # Operation - * The Operations collection provides a record of actions performed for the + * Operation Service: + * - The Operations collection provides a record of actions performed for the * specified project (including any operations in progress). Operations are not * created directly but through calls on other collections or resources. - * An operation that is not yet done may be cancelled. The request to cancel is - * asynchronous and the operation may continue to run for some time after the + * - An operation that is not yet done may be cancelled. The request to cancel + * is asynchronous and the operation may continue to run for some time after the * request to cancel is made. - * An operation that is done may be deleted so that it is no longer listed as + * - An operation that is done may be deleted so that it is no longer listed as * part of the Operation collection. - * ListOperations returns all pending operations, but not completed operations. - * Operations are created by service DatastoreAdmin, - * but are accessed via service google.longrunning.Operations. + * - ListOperations returns all pending operations, but not completed + * operations. + * - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. **/ public static final class DatastoreAdminBlockingStub @@ -881,9 +868,9 @@ public com.google.longrunning.Operation importEntities( ** Creates the specified index. * A newly created index's initial state is `CREATING`. On completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`. - * If the index already exists, the call will return an `ALREADY_EXISTS` - * status. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * state will be `READY`. If the index already exists, the call will return an + * `ALREADY_EXISTS` status. * During index creation, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, removing the index with @@ -907,7 +894,8 @@ public com.google.longrunning.Operation createIndex( * An index can only be deleted if it is in a `READY` or `ERROR` state. On * successful execution of the request, the index will be in a `DELETING` * [state][google.datastore.admin.v1.Index.State]. And on completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the index will be removed. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * index will be removed. * During index deletion, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, followed by calling @@ -955,44 +943,41 @@ public com.google.datastore.admin.v1.ListIndexesResponse listIndexes( ** Google Cloud Datastore Admin API * The Datastore Admin API provides several admin services for Cloud Datastore. - * ----------------------------------------------------------------------------- - * ## Concepts - * Project, namespace, kind, and entity as defined in the Google Cloud Datastore - * API. + * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud + * Datastore API. * Operation: An Operation represents work being performed in the background. * EntityFilter: Allows specifying a subset of entities in a project. This is * specified as a combination of kinds and namespaces (either or both of which * may be all). - * ----------------------------------------------------------------------------- - * ## Services - * # Export/Import - * The Export/Import service provides the ability to copy all or a subset of + * Export/Import Service: + * - The Export/Import service provides the ability to copy all or a subset of * entities to/from Google Cloud Storage. - * Exported data may be imported into Cloud Datastore for any Google Cloud + * - Exported data may be imported into Cloud Datastore for any Google Cloud * Platform project. It is not restricted to the export source project. It is * possible to export from one project and then import into another. - * Exported data can also be loaded into Google BigQuery for analysis. - * Exports and imports are performed asynchronously. An Operation resource is + * - Exported data can also be loaded into Google BigQuery for analysis. + * - Exports and imports are performed asynchronously. An Operation resource is * created for each export/import. The state (including any errors encountered) * of the export/import may be queried via the Operation resource. - * # Index - * The index service manages Cloud Datastore composite indexes. - * Index creation and deletion are performed asynchronously. + * Index Service: + * - The index service manages Cloud Datastore composite indexes. + * - Index creation and deletion are performed asynchronously. * An Operation resource is created for each such asynchronous operation. * The state of the operation (including any errors encountered) * may be queried via the Operation resource. - * # Operation - * The Operations collection provides a record of actions performed for the + * Operation Service: + * - The Operations collection provides a record of actions performed for the * specified project (including any operations in progress). Operations are not * created directly but through calls on other collections or resources. - * An operation that is not yet done may be cancelled. The request to cancel is - * asynchronous and the operation may continue to run for some time after the + * - An operation that is not yet done may be cancelled. The request to cancel + * is asynchronous and the operation may continue to run for some time after the * request to cancel is made. - * An operation that is done may be deleted so that it is no longer listed as + * - An operation that is done may be deleted so that it is no longer listed as * part of the Operation collection. - * ListOperations returns all pending operations, but not completed operations. - * Operations are created by service DatastoreAdmin, - * but are accessed via service google.longrunning.Operations. + * - ListOperations returns all pending operations, but not completed + * operations. + * - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. **/ public static final class DatastoreAdminFutureStub @@ -1050,9 +1035,9 @@ protected DatastoreAdminFutureStub build( ** Creates the specified index. * A newly created index's initial state is `CREATING`. On completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`. - * If the index already exists, the call will return an `ALREADY_EXISTS` - * status. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * state will be `READY`. If the index already exists, the call will return an + * `ALREADY_EXISTS` status. * During index creation, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, removing the index with @@ -1076,7 +1061,8 @@ protected DatastoreAdminFutureStub build( * An index can only be deleted if it is in a `READY` or `ERROR` state. On * successful execution of the request, the index will be in a `DELETING` * [state][google.datastore.admin.v1.Index.State]. And on completion of the - * returned [google.longrunning.Operation][google.longrunning.Operation], the index will be removed. + * returned [google.longrunning.Operation][google.longrunning.Operation], the + * index will be removed. * During index deletion, the process could result in an error, in which * case the index will move to the `ERROR` state. The process can be recovered * by fixing the data that caused the error, followed by calling diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java index 7e81988e7..57d21e691 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java @@ -299,8 +299,8 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -339,8 +339,8 @@ public java.lang.String getOutputUrlPrefix() { * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -1289,8 +1289,8 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -1328,8 +1328,8 @@ public java.lang.String getOutputUrlPrefix() { * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -1367,8 +1367,8 @@ public com.google.protobuf.ByteString getOutputUrlPrefixBytes() { * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -1405,8 +1405,8 @@ public Builder setOutputUrlPrefix(java.lang.String value) { * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -1439,8 +1439,8 @@ public Builder clearOutputUrlPrefix() { * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java index d652ea7a7..c542b562c 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java @@ -158,8 +158,8 @@ java.lang.String getLabelsOrDefault( * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. @@ -187,8 +187,8 @@ java.lang.String getLabelsOrDefault( * * The resulting files will be nested deeper than the specified URL prefix. * The final output URL will be provided in the - * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - * value should be used for subsequent ImportEntities operations. + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. That value should be used for subsequent ImportEntities operations. * * By nesting the data files deeper, the same Cloud Storage bucket can be used * in multiple ExportEntities operations without conflict. diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java index c7f1e40e8..84cd35a26 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java @@ -22,7 +22,8 @@ * * *- * The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. + * The request for + * [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. ** * Protobuf type {@code google.datastore.admin.v1.GetIndexRequest} @@ -337,7 +338,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * *- * The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. + * The request for + * [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. ** * Protobuf type {@code google.datastore.admin.v1.GetIndexRequest} diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java index 1b6d92aba..0d1a82b8f 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java @@ -271,7 +271,9 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -295,7 +297,9 @@ public java.lang.String getInputUrl() { * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -1526,7 +1530,9 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -1549,7 +1555,9 @@ public java.lang.String getInputUrl() { * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -1572,7 +1580,9 @@ public com.google.protobuf.ByteString getInputUrlBytes() { * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -1594,7 +1604,9 @@ public Builder setInputUrl(java.lang.String value) { * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -1612,7 +1624,9 @@ public Builder clearInputUrl() { * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java index 8dc5147ec..8dbf67421 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java @@ -168,7 +168,9 @@ public interface ImportEntitiesMetadataOrBuilder * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
@@ -181,7 +183,9 @@ public interface ImportEntitiesMetadataOrBuilder * ** The location of the import metadata file. This will be the same value as - * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + * the + * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + * field. ** *string input_url = 5;
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java index 9ca45ea1c..ee9b39b56 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java @@ -236,8 +236,9 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) { * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -271,8 +272,9 @@ public java.lang.String getInputUrl() { * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -1091,8 +1093,9 @@ public Builder putAllLabels(java.util.Mapva * * * - * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -1125,8 +1128,9 @@ public java.lang.String getInputUrl() { * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -1159,8 +1163,9 @@ public com.google.protobuf.ByteString getInputUrlBytes() { * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -1192,8 +1197,9 @@ public Builder setInputUrl(java.lang.String value) { * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -1221,8 +1227,9 @@ public Builder clearInputUrl() { * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java index 6a5004067..dcf83c997 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java @@ -110,8 +110,9 @@ java.lang.String getLabelsOrDefault( * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -134,8 +135,9 @@ java.lang.String getLabelsOrDefault( * * *- * Required. The full resource URL of the external storage location. Currently, only - * Google Cloud Storage is supported. So input_url should be of the form: + * Required. The full resource URL of the external storage location. + * Currently, only Google Cloud Storage is supported. So input_url should be + * of the form: * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is * an optional Cloud Storage namespace path (this is not a Cloud Datastore diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java index e03a585f4..57a41fc3e 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java @@ -647,7 +647,8 @@ public interface IndexedPropertyOrBuilder * * *- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -661,7 +662,8 @@ public interface IndexedPropertyOrBuilder * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -774,7 +776,8 @@ public com.google.protobuf.ByteString getNameBytes() { * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -791,7 +794,8 @@ public int getDirectionValue() { * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -1289,7 +1293,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) { * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -1306,7 +1311,8 @@ public int getDirectionValue() { * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -1326,7 +1332,8 @@ public Builder setDirectionValue(int value) { * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -1345,7 +1352,8 @@ public com.google.datastore.admin.v1.Index.Direction getDirection() { * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -1368,7 +1376,8 @@ public Builder setDirection(com.google.datastore.admin.v1.Index.Direction value) * * *
- * Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + * Required. The indexed property's direction. Must not be + * DIRECTION_UNSPECIFIED. ** *@@ -1607,7 +1616,8 @@ public com.google.protobuf.ByteString getKindBytes() { * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -1624,7 +1634,8 @@ public int getAncestorValue() { * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -1649,6 +1660,10 @@ public com.google.datastore.admin.v1.Index.AncestorMode getAncestor() { * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -1664,6 +1679,10 @@ public java.util.List
getPr * * * Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -1680,6 +1699,10 @@ public java.util.List
getPr * * * Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -1695,6 +1718,10 @@ public int getPropertiesCount() { * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -1710,6 +1737,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty getProperties(int ind * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2588,7 +2619,8 @@ public Builder setKindBytes(com.google.protobuf.ByteString value) { * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -2605,7 +2637,8 @@ public int getAncestorValue() { * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -2625,7 +2658,8 @@ public Builder setAncestorValue(int value) { * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -2646,7 +2680,8 @@ public com.google.datastore.admin.v1.Index.AncestorMode getAncestor() { * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -2669,7 +2704,8 @@ public Builder setAncestor(com.google.datastore.admin.v1.Index.AncestorMode valu * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -2708,6 +2744,10 @@ private void ensurePropertiesIsMutable() { * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2726,6 +2766,10 @@ public java.util.List
getPr * * * Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2744,6 +2788,10 @@ public int getPropertiesCount() { * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2762,6 +2810,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty getProperties(int ind * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2787,6 +2839,10 @@ public Builder setProperties( * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2809,6 +2865,10 @@ public Builder setProperties( * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2833,6 +2893,10 @@ public Builder addProperties(com.google.datastore.admin.v1.Index.IndexedProperty * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2858,6 +2922,10 @@ public Builder addProperties( * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2880,6 +2948,10 @@ public Builder addProperties( * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2902,6 +2974,10 @@ public Builder addProperties( * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2924,6 +3000,10 @@ public Builder addAllProperties( * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2945,6 +3025,10 @@ public Builder clearProperties() { * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2966,6 +3050,10 @@ public Builder removeProperties(int index) { * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -2981,6 +3069,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty.Builder getProperties * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -3000,6 +3092,10 @@ public com.google.datastore.admin.v1.Index.IndexedPropertyOrBuilder getPropertie * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -3019,6 +3115,10 @@ public com.google.datastore.admin.v1.Index.IndexedPropertyOrBuilder getPropertie * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -3034,6 +3134,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty.Builder addProperties * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -3051,6 +3155,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty.Builder addProperties * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java index 27e384765..6445c073d 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java @@ -102,7 +102,8 @@ public interface IndexOrBuilder * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -116,7 +117,8 @@ public interface IndexOrBuilder * * *
- * Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + * Required. The index's ancestor mode. Must not be + * ANCESTOR_MODE_UNSPECIFIED. ** *@@ -132,6 +134,10 @@ public interface IndexOrBuilder * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -144,6 +150,10 @@ public interface IndexOrBuilder * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -156,6 +166,10 @@ public interface IndexOrBuilder * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -168,6 +182,10 @@ public interface IndexOrBuilder * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *@@ -181,6 +199,10 @@ public interface IndexOrBuilder * *
* Required. An ordered sequence of property names and their index attributes. + * + * Requires: + * + * * A maximum of 100 properties. ** *diff --git a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto index 744d97df7..79ca3df68 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto +++ b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -34,14 +34,10 @@ option ruby_package = "Google::Cloud::Datastore::Admin::V1"; // Google Cloud Datastore Admin API // -// // The Datastore Admin API provides several admin services for Cloud Datastore. // -// ----------------------------------------------------------------------------- -// ## Concepts -// -// Project, namespace, kind, and entity as defined in the Google Cloud Datastore -// API. +// Concepts: Project, namespace, kind, and entity as defined in the Google Cloud +// Datastore API. // // Operation: An Operation represents work being performed in the background. // @@ -49,50 +45,40 @@ option ruby_package = "Google::Cloud::Datastore::Admin::V1"; // specified as a combination of kinds and namespaces (either or both of which // may be all). // -// ----------------------------------------------------------------------------- -// ## Services -// -// # Export/Import +// Export/Import Service: // -// The Export/Import service provides the ability to copy all or a subset of +// - The Export/Import service provides the ability to copy all or a subset of // entities to/from Google Cloud Storage. -// -// Exported data may be imported into Cloud Datastore for any Google Cloud +// - Exported data may be imported into Cloud Datastore for any Google Cloud // Platform project. It is not restricted to the export source project. It is // possible to export from one project and then import into another. -// -// Exported data can also be loaded into Google BigQuery for analysis. -// -// Exports and imports are performed asynchronously. An Operation resource is +// - Exported data can also be loaded into Google BigQuery for analysis. +// - Exports and imports are performed asynchronously. An Operation resource is // created for each export/import. The state (including any errors encountered) // of the export/import may be queried via the Operation resource. // -// # Index +// Index Service: // -// The index service manages Cloud Datastore composite indexes. -// -// Index creation and deletion are performed asynchronously. +// - The index service manages Cloud Datastore composite indexes. +// - Index creation and deletion are performed asynchronously. // An Operation resource is created for each such asynchronous operation. // The state of the operation (including any errors encountered) // may be queried via the Operation resource. // -// # Operation +// Operation Service: // -// The Operations collection provides a record of actions performed for the +// - The Operations collection provides a record of actions performed for the // specified project (including any operations in progress). Operations are not // created directly but through calls on other collections or resources. -// -// An operation that is not yet done may be cancelled. The request to cancel is -// asynchronous and the operation may continue to run for some time after the +// - An operation that is not yet done may be cancelled. The request to cancel +// is asynchronous and the operation may continue to run for some time after the // request to cancel is made. -// -// An operation that is done may be deleted so that it is no longer listed as +// - An operation that is done may be deleted so that it is no longer listed as // part of the Operation collection. -// -// ListOperations returns all pending operations, but not completed operations. -// -// Operations are created by service DatastoreAdmin, -// but are accessed via service google.longrunning.Operations. +// - ListOperations returns all pending operations, but not completed +// operations. +// - Operations are created by service DatastoreAdmin, but are accessed via +// service google.longrunning.Operations. service DatastoreAdmin { option (google.api.default_host) = "datastore.googleapis.com"; option (google.api.oauth_scopes) = @@ -107,12 +93,14 @@ service DatastoreAdmin { // used once the associated operation is done. If an export operation is // cancelled before completion it may leave partial data behind in Google // Cloud Storage. - rpc ExportEntities(ExportEntitiesRequest) returns (google.longrunning.Operation) { + rpc ExportEntities(ExportEntitiesRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/projects/{project_id}:export" body: "*" }; - option (google.api.method_signature) = "project_id,labels,entity_filter,output_url_prefix"; + option (google.api.method_signature) = + "project_id,labels,entity_filter,output_url_prefix"; option (google.longrunning.operation_info) = { response_type: "ExportEntitiesResponse" metadata_type: "ExportEntitiesMetadata" @@ -124,12 +112,14 @@ service DatastoreAdmin { // progress can be monitored and managed via the Operation resource that is // created. If an ImportEntities operation is cancelled, it is possible // that a subset of the data has already been imported to Cloud Datastore. - rpc ImportEntities(ImportEntitiesRequest) returns (google.longrunning.Operation) { + rpc ImportEntities(ImportEntitiesRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/projects/{project_id}:import" body: "*" }; - option (google.api.method_signature) = "project_id,labels,input_url,entity_filter"; + option (google.api.method_signature) = + "project_id,labels,input_url,entity_filter"; option (google.longrunning.operation_info) = { response_type: "google.protobuf.Empty" metadata_type: "ImportEntitiesMetadata" @@ -138,9 +128,9 @@ service DatastoreAdmin { // Creates the specified index. // A newly created index's initial state is `CREATING`. On completion of the - // returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`. - // If the index already exists, the call will return an `ALREADY_EXISTS` - // status. + // returned [google.longrunning.Operation][google.longrunning.Operation], the + // state will be `READY`. If the index already exists, the call will return an + // `ALREADY_EXISTS` status. // // During index creation, the process could result in an error, in which // case the index will move to the `ERROR` state. The process can be recovered @@ -165,7 +155,8 @@ service DatastoreAdmin { // An index can only be deleted if it is in a `READY` or `ERROR` state. On // successful execution of the request, the index will be in a `DELETING` // [state][google.datastore.admin.v1.Index.State]. And on completion of the - // returned [google.longrunning.Operation][google.longrunning.Operation], the index will be removed. + // returned [google.longrunning.Operation][google.longrunning.Operation], the + // index will be removed. // // During index deletion, the process could result in an error, in which // case the index will move to the `ERROR` state. The process can be recovered @@ -283,8 +274,8 @@ message ExportEntitiesRequest { // // The resulting files will be nested deeper than the specified URL prefix. // The final output URL will be provided in the - // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - // value should be used for subsequent ImportEntities operations. + // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + // field. That value should be used for subsequent ImportEntities operations. // // By nesting the data files deeper, the same Cloud Storage bucket can be used // in multiple ExportEntities operations without conflict. @@ -300,8 +291,9 @@ message ImportEntitiesRequest { // Client-assigned labels. map
labels = 2; - // Required. The full resource URL of the external storage location. Currently, only - // Google Cloud Storage is supported. So input_url should be of the form: + // Required. The full resource URL of the external storage location. + // Currently, only Google Cloud Storage is supported. So input_url should be + // of the form: // `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where // `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is // an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -369,7 +361,9 @@ message ImportEntitiesMetadata { EntityFilter entity_filter = 4; // The location of the import metadata file. This will be the same value as - // the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + // the + // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + // field. string input_url = 5; } @@ -427,7 +421,8 @@ message DeleteIndexRequest { string index_id = 3; } -// The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. +// The request for +// [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. message GetIndexRequest { // Project ID against which to make the request. string project_id = 1; diff --git a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto index 4eeffc7e4..60bb5af5f 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto +++ b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -60,7 +60,8 @@ message Index { // Required. The property name to index. string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + // Required. The indexed property's direction. Must not be + // DIRECTION_UNSPECIFIED. Direction direction = 2 [(google.api.field_behavior) = REQUIRED]; } @@ -104,11 +105,17 @@ message Index { // Required. The entity kind to which this index applies. string kind = 4 [(google.api.field_behavior) = REQUIRED]; - // Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + // Required. The index's ancestor mode. Must not be + // ANCESTOR_MODE_UNSPECIFIED. AncestorMode ancestor = 5 [(google.api.field_behavior) = REQUIRED]; // Required. An ordered sequence of property names and their index attributes. - repeated IndexedProperty properties = 6 [(google.api.field_behavior) = REQUIRED]; + // + // Requires: + // + // * A maximum of 100 properties. + repeated IndexedProperty properties = 6 + [(google.api.field_behavior) = REQUIRED]; // Output only. The state of the index. State state = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; diff --git a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto index f47cb70e1..e5f7477da 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto +++ b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License.