google-cloud-datastore-admin-v1 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6ff3f5bfe3626f8918be4dc4ba8050e74e492f095b307e25bebafb27c6e94ff
-  data.tar.gz: d4256e82209cacd23e9541250341a003de9b8decd19b4b7d021bd41c011b53e6
+  metadata.gz: 3625c8bbc579cb83a08da7a675c8193d06e8dc19524650f7371b9d8708f35f12
+  data.tar.gz: fdcbf5a5caa4cfb53d7d5eb09ef38cc89669dad416ddf485e8e0047eede1f3b6
 SHA512:
-  metadata.gz: f4871dc6b6ae3d3a4ea9086ab4c2cc471c6b27f285f25fe7c25b5be42a2dc0321559b93b62d4a87ad0c72f817b17d52e5334d85157588b00677776a74e805469
-  data.tar.gz: 6d5bc25cbb0900d54e28c318335cd3259af0d56a74a24869d6310447a19a681f8117d1eb50ab574d4df45180e9a5d99343b97d8395dfd16cf4283484119c04f3
+  metadata.gz: ced0fa3e2b18b60889b4105266559956b9b445f7ddfc1e1ffe24ecd83887cd66bd7ed23cd3bc39a6a78cc005f15dd9127622dd855ac95030ee9612a5064916fe
+  data.tar.gz: 7994125ffa47a36f100627f9bc143c8a696ee61852efaa5b899373c8b87217f74e065067c414456c461fd931e9a17aba25e1ff4b66de17d27ee3b5cd37484d4a

data/LICENSE.md

@@ -1,192 +1,190 @@
-Apache License
-==============
-
-* Version 2.0, January 2004
-* https://www.apache.org/licenses/
-
-### TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
- 1. **Definitions.**
-
-    "License" shall mean the terms and conditions for use, reproduction,
-    and distribution as defined by Sections 1 through 9 of this document.
-
-    "Licensor" shall mean the copyright owner or entity authorized by
-    the copyright owner that is granting the License.
-
-    "Legal Entity" shall mean the union of the acting entity and all
-    other entities that control, are controlled by, or are under common
-    control with that entity. For the purposes of this definition,
-    "control" means (i) the power, direct or indirect, to cause the
-    direction or management of such entity, whether by contract or
-    otherwise, or (ii) ownership of fifty percent (50%) or more of the
-    outstanding shares, or (iii) beneficial ownership of such entity.
-
-    "You" (or "Your") shall mean an individual or Legal Entity
-    exercising permissions granted by this License.
-
-    "Source" form shall mean the preferred form for making modifications,
-    including but not limited to software source code, documentation
-    source, and configuration files.
-
-    "Object" form shall mean any form resulting from mechanical
-    transformation or translation of a Source form, including but
-    not limited to compiled object code, generated documentation,
-    and conversions to other media types.
-
-    "Work" shall mean the work of authorship, whether in Source or
-    Object form, made available under the License, as indicated by a
-    copyright notice that is included in or attached to the work
-    (an example is provided in the Appendix below).
-
-    "Derivative Works" shall mean any work, whether in Source or Object
-    form, that is based on (or derived from) the Work and for which the
-    editorial revisions, annotations, elaborations, or other modifications
-    represent, as a whole, an original work of authorship. For the purposes
-    of this License, Derivative Works shall not include works that remain
-    separable from, or merely link (or bind by name) to the interfaces of,
-    the Work and Derivative Works thereof.
-
-    "Contribution" shall mean any work of authorship, including
-    the original version of the Work and any modifications or additions
-    to that Work or Derivative Works thereof, that is intentionally
-    submitted to Licensor for inclusion in the Work by the copyright owner
-    or by an individual or Legal Entity authorized to submit on behalf of
-    the copyright owner. For the purposes of this definition, "submitted"
-    means any form of electronic, verbal, or written communication sent
-    to the Licensor or its representatives, including but not limited to
-    communication on electronic mailing lists, source code control systems,
-    and issue tracking systems that are managed by, or on behalf of, the
-    Licensor for the purpose of discussing and improving the Work, but
-    excluding communication that is conspicuously marked or otherwise
-    designated in writing by the copyright owner as "Not a Contribution."
-
-    "Contributor" shall mean Licensor and any individual or Legal Entity
-    on behalf of whom a Contribution has been received by Licensor and
-    subsequently incorporated within the Work.
-
- 2. **Grant of Copyright License.** Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    copyright license to reproduce, prepare Derivative Works of,
-    publicly display, publicly perform, sublicense, and distribute the
-    Work and such Derivative Works in Source or Object form.
-
- 3. **Grant of Patent License.** Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    (except as stated in this section) patent license to make, have made,
-    use, offer to sell, sell, import, and otherwise transfer the Work,
-    where such license applies only to those patent claims licensable
-    by such Contributor that are necessarily infringed by their
-    Contribution(s) alone or by combination of their Contribution(s)
-    with the Work to which such Contribution(s) was submitted. If You
-    institute patent litigation against any entity (including a
-    cross-claim or counterclaim in a lawsuit) alleging that the Work
-    or a Contribution incorporated within the Work constitutes direct
-    or contributory patent infringement, then any patent licenses
-    granted to You under this License for that Work shall terminate
-    as of the date such litigation is filed.
-
- 4. **Redistribution.** You may reproduce and distribute copies of the
-    Work or Derivative Works thereof in any medium, with or without
-    modifications, and in Source or Object form, provided that You
-    meet the following conditions:
-
-     *  **(a)** You must give any other recipients of the Work or
-        Derivative Works a copy of this License; and
-
-     *  **(b)** You must cause any modified files to carry prominent notices
-        stating that You changed the files; and
-
-     *  **(c)** You must retain, in the Source form of any Derivative Works
-        that You distribute, all copyright, patent, trademark, and
-        attribution notices from the Source form of the Work,
-        excluding those notices that do not pertain to any part of
-        the Derivative Works; and
-
-     *  **(d)** If the Work includes a "NOTICE" text file as part of its
-        distribution, then any Derivative Works that You distribute must
-        include a readable copy of the attribution notices contained
-        within such NOTICE file, excluding those notices that do not
-        pertain to any part of the Derivative Works, in at least one
-        of the following places: within a NOTICE text file distributed
-        as part of the Derivative Works; within the Source form or
-        documentation, if provided along with the Derivative Works; or,
-        within a display generated by the Derivative Works, if and
-        wherever such third-party notices normally appear. The contents
-        of the NOTICE file are for informational purposes only and
-        do not modify the License. You may add Your own attribution
-        notices within Derivative Works that You distribute, alongside
-        or as an addendum to the NOTICE text from the Work, provided
-        that such additional attribution notices cannot be construed
-        as modifying the License.
-
-    You may add Your own copyright statement to Your modifications and
-    may provide additional or different license terms and conditions
-    for use, reproduction, or distribution of Your modifications, or
-    for any such Derivative Works as a whole, provided Your use,
-    reproduction, and distribution of the Work otherwise complies with
-    the conditions stated in this License.
-
- 5. **Submission of Contributions.** Unless You explicitly state otherwise,
-    any Contribution intentionally submitted for inclusion in the Work
-    by You to the Licensor shall be under the terms and conditions of
-    this License, without any additional terms or conditions.
-    Notwithstanding the above, nothing herein shall supersede or modify
-    the terms of any separate license agreement you may have executed
-    with Licensor regarding such Contributions.
-
- 6. **Trademarks.** This License does not grant permission to use the trade
-    names, trademarks, service marks, or product names of the Licensor,
-    except as required for reasonable and customary use in describing the
-    origin of the Work and reproducing the content of the NOTICE file.
-
- 7. **Disclaimer of Warranty.** Unless required by applicable law or
-    agreed to in writing, Licensor provides the Work (and each
-    Contributor provides its Contributions) on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied, including, without limitation, any warranties or conditions
-    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-    PARTICULAR PURPOSE. You are solely responsible for determining the
-    appropriateness of using or redistributing the Work and assume any
-    risks associated with Your exercise of permissions under this License.
-
- 8. **Limitation of Liability.** In no event and under no legal theory,
-    whether in tort (including negligence), contract, or otherwise,
-    unless required by applicable law (such as deliberate and grossly
-    negligent acts) or agreed to in writing, shall any Contributor be
-    liable to You for damages, including any direct, indirect, special,
-    incidental, or consequential damages of any character arising as a
-    result of this License or out of the use or inability to use the
-    Work (including but not limited to damages for loss of goodwill,
-    work stoppage, computer failure or malfunction, or any and all
-    other commercial damages or losses), even if such Contributor
-    has been advised of the possibility of such damages.
-
- 9. **Accepting Warranty or Additional Liability.** While redistributing
-    the Work or Derivative Works thereof, You may choose to offer,
-    and charge a fee for, acceptance of support, warranty, indemnity,
-    or other liability obligations and/or rights consistent with this
-    License. However, in accepting such obligations, You may act only
-    on Your own behalf and on Your sole responsibility, not on behalf
-    of any other Contributor, and only if You agree to indemnify,
-    defend, and hold each Contributor harmless for any liability
-    incurred by, or claims asserted against, such Contributor by reason
-    of your accepting any such warranty or additional liability.
-
-_END OF TERMS AND CONDITIONS_
-
-### APPENDIX: How to apply the Apache License to your work.
-
-To apply the Apache License to your work, attach the following
-boilerplate notice, with the fields enclosed by brackets "`[]`"
-replaced with your own identifying information. (Don't include
-the brackets!)  The text should be enclosed in the appropriate
-comment syntax for the file format. We also recommend that a
-file or class name and description of purpose be included on the
-same "printed page" as the copyright notice for easier
-identification within third-party archives.
+                                  Apache License
+                            Version 2.0, January 2004
+                         http://www.apache.org/licenses/
+
+    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+    1. Definitions.
+
+       "License" shall mean the terms and conditions for use, reproduction,
+       and distribution as defined by Sections 1 through 9 of this document.
+
+       "Licensor" shall mean the copyright owner or entity authorized by
+       the copyright owner that is granting the License.
+
+       "Legal Entity" shall mean the union of the acting entity and all
+       other entities that control, are controlled by, or are under common
+       control with that entity. For the purposes of this definition,
+       "control" means (i) the power, direct or indirect, to cause the
+       direction or management of such entity, whether by contract or
+       otherwise, or (ii) ownership of fifty percent (50%) or more of the
+       outstanding shares, or (iii) beneficial ownership of such entity.
+
+       "You" (or "Your") shall mean an individual or Legal Entity
+       exercising permissions granted by this License.
+
+       "Source" form shall mean the preferred form for making modifications,
+       including but not limited to software source code, documentation
+       source, and configuration files.
+
+       "Object" form shall mean any form resulting from mechanical
+       transformation or translation of a Source form, including but
+       not limited to compiled object code, generated documentation,
+       and conversions to other media types.
+
+       "Work" shall mean the work of authorship, whether in Source or
+       Object form, made available under the License, as indicated by a
+       copyright notice that is included in or attached to the work
+       (an example is provided in the Appendix below).
+
+       "Derivative Works" shall mean any work, whether in Source or Object
+       form, that is based on (or derived from) the Work and for which the
+       editorial revisions, annotations, elaborations, or other modifications
+       represent, as a whole, an original work of authorship. For the purposes
+       of this License, Derivative Works shall not include works that remain
+       separable from, or merely link (or bind by name) to the interfaces of,
+       the Work and Derivative Works thereof.
+
+       "Contribution" shall mean any work of authorship, including
+       the original version of the Work and any modifications or additions
+       to that Work or Derivative Works thereof, that is intentionally
+       submitted to Licensor for inclusion in the Work by the copyright owner
+       or by an individual or Legal Entity authorized to submit on behalf of
+       the copyright owner. For the purposes of this definition, "submitted"
+       means any form of electronic, verbal, or written communication sent
+       to the Licensor or its representatives, including but not limited to
+       communication on electronic mailing lists, source code control systems,
+       and issue tracking systems that are managed by, or on behalf of, the
+       Licensor for the purpose of discussing and improving the Work, but
+       excluding communication that is conspicuously marked or otherwise
+       designated in writing by the copyright owner as "Not a Contribution."
+
+       "Contributor" shall mean Licensor and any individual or Legal Entity
+       on behalf of whom a Contribution has been received by Licensor and
+       subsequently incorporated within the Work.
+
+    2. Grant of Copyright License. Subject to the terms and conditions of
+       this License, each Contributor hereby grants to You a perpetual,
+       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+       copyright license to reproduce, prepare Derivative Works of,
+       publicly display, publicly perform, sublicense, and distribute the
+       Work and such Derivative Works in Source or Object form.
+
+    3. Grant of Patent License. Subject to the terms and conditions of
+       this License, each Contributor hereby grants to You a perpetual,
+       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+       (except as stated in this section) patent license to make, have made,
+       use, offer to sell, sell, import, and otherwise transfer the Work,
+       where such license applies only to those patent claims licensable
+       by such Contributor that are necessarily infringed by their
+       Contribution(s) alone or by combination of their Contribution(s)
+       with the Work to which such Contribution(s) was submitted. If You
+       institute patent litigation against any entity (including a
+       cross-claim or counterclaim in a lawsuit) alleging that the Work
+       or a Contribution incorporated within the Work constitutes direct
+       or contributory patent infringement, then any patent licenses
+       granted to You under this License for that Work shall terminate
+       as of the date such litigation is filed.
+
+    4. Redistribution. You may reproduce and distribute copies of the
+       Work or Derivative Works thereof in any medium, with or without
+       modifications, and in Source or Object form, provided that You
+       meet the following conditions:
+
+       (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+       (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+       (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+       (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+       You may add Your own copyright statement to Your modifications and
+       may provide additional or different license terms and conditions
+       for use, reproduction, or distribution of Your modifications, or
+       for any such Derivative Works as a whole, provided Your use,
+       reproduction, and distribution of the Work otherwise complies with
+       the conditions stated in this License.
+
+    5. Submission of Contributions. Unless You explicitly state otherwise,
+       any Contribution intentionally submitted for inclusion in the Work
+       by You to the Licensor shall be under the terms and conditions of
+       this License, without any additional terms or conditions.
+       Notwithstanding the above, nothing herein shall supersede or modify
+       the terms of any separate license agreement you may have executed
+       with Licensor regarding such Contributions.
+
+    6. Trademarks. This License does not grant permission to use the trade
+       names, trademarks, service marks, or product names of the Licensor,
+       except as required for reasonable and customary use in describing the
+       origin of the Work and reproducing the content of the NOTICE file.
+
+    7. Disclaimer of Warranty. Unless required by applicable law or
+       agreed to in writing, Licensor provides the Work (and each
+       Contributor provides its Contributions) on an "AS IS" BASIS,
+       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+       implied, including, without limitation, any warranties or conditions
+       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+       PARTICULAR PURPOSE. You are solely responsible for determining the
+       appropriateness of using or redistributing the Work and assume any
+       risks associated with Your exercise of permissions under this License.
+
+    8. Limitation of Liability. In no event and under no legal theory,
+       whether in tort (including negligence), contract, or otherwise,
+       unless required by applicable law (such as deliberate and grossly
+       negligent acts) or agreed to in writing, shall any Contributor be
+       liable to You for damages, including any direct, indirect, special,
+       incidental, or consequential damages of any character arising as a
+       result of this License or out of the use or inability to use the
+       Work (including but not limited to damages for loss of goodwill,
+       work stoppage, computer failure or malfunction, or any and all
+       other commercial damages or losses), even if such Contributor
+       has been advised of the possibility of such damages.
+
+    9. Accepting Warranty or Additional Liability. While redistributing
+       the Work or Derivative Works thereof, You may choose to offer,
+       and charge a fee for, acceptance of support, warranty, indemnity,
+       or other liability obligations and/or rights consistent with this
+       License. However, in accepting such obligations, You may act only
+       on Your own behalf and on Your sole responsibility, not on behalf
+       of any other Contributor, and only if You agree to indemnify,
+       defend, and hold each Contributor harmless for any liability
+       incurred by, or claims asserted against, such Contributor by reason
+       of your accepting any such warranty or additional liability.
+
+    END OF TERMS AND CONDITIONS
+
+    APPENDIX: How to apply the Apache License to your work.
+
+       To apply the Apache License to your work, attach the following
+       boilerplate notice, with the fields enclosed by brackets "[]"
+       replaced with your own identifying information. (Don't include
+       the brackets!)  The text should be enclosed in the appropriate
+       comment syntax for the file format. We also recommend that a
+       file or class name and description of purpose be included on the
+       same "printed page" as the copyright notice for easier
+       identification within third-party archives.
 
     Copyright [yyyy] [name of copyright owner]
 
@@ -194,7 +192,7 @@ identification within third-party archives.
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
 
-        https://www.apache.org/licenses/LICENSE-2.0
+       http://www.apache.org/licenses/LICENSE-2.0
 
     Unless required by applicable law or agreed to in writing, software
     distributed under the License is distributed on an "AS IS" BASIS,

data/lib/google/cloud/datastore/admin/v1/datastore_admin/client.rb

@@ -128,6 +128,10 @@ module Google
 
                   default_config.rpcs.import_entities.timeout = 60.0
 
+                  default_config.rpcs.create_index.timeout = 60.0
+
+                  default_config.rpcs.delete_index.timeout = 60.0
+
                   default_config.rpcs.get_index.timeout = 60.0
                   default_config.rpcs.get_index.retry_policy = {
                     initial_delay: 0.1,
@@ -430,6 +434,168 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # 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.
+              #
+              # 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
+              # {::Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client#delete_index delete}, then
+              # re-creating the index with [create]
+              # [google.datastore.admin.v1.DatastoreAdmin.CreateIndex].
+              #
+              # Indexes with a single property cannot be created.
+              #
+              # @overload create_index(request, options = nil)
+              #   Pass arguments to `create_index` via a request object, either of type
+              #   {::Google::Cloud::Datastore::Admin::V1::CreateIndexRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::Datastore::Admin::V1::CreateIndexRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+              #
+              # @overload create_index(project_id: nil, index: nil)
+              #   Pass arguments to `create_index` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param project_id [::String]
+              #     Project ID against which to make the request.
+              #   @param index [::Google::Cloud::Datastore::Admin::V1::Index, ::Hash]
+              #     The index to create. The name and state fields are output only and will be
+              #     ignored. Single property indexes cannot be created or deleted.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Gapic::Operation]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Gapic::Operation]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              def create_index request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Datastore::Admin::V1::CreateIndexRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                metadata = @config.rpcs.create_index.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::Datastore::Admin::V1::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {
+                  "project_id" => request.project_id
+                }
+                request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                metadata[:"x-goog-request-params"] ||= request_params_header
+
+                options.apply_defaults timeout:      @config.rpcs.create_index.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.create_index.retry_policy
+                options.apply_defaults metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @datastore_admin_stub.call_rpc :create_index, request, options: options do |response, operation|
+                  response = ::Gapic::Operation.new response, @operations_client, options: options
+                  yield response, operation if block_given?
+                  return response
+                end
+              rescue ::GRPC::BadStatus => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Deletes an existing index.
+              # 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`
+              # {::Google::Cloud::Datastore::Admin::V1::Index::State state}. And on completion of the
+              # 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
+              # {::Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client#delete_index delete} again.
+              #
+              # @overload delete_index(request, options = nil)
+              #   Pass arguments to `delete_index` via a request object, either of type
+              #   {::Google::Cloud::Datastore::Admin::V1::DeleteIndexRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::Datastore::Admin::V1::DeleteIndexRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+              #
+              # @overload delete_index(project_id: nil, index_id: nil)
+              #   Pass arguments to `delete_index` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param project_id [::String]
+              #     Project ID against which to make the request.
+              #   @param index_id [::String]
+              #     The resource ID of the index to delete.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Gapic::Operation]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Gapic::Operation]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              def delete_index request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Datastore::Admin::V1::DeleteIndexRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                metadata = @config.rpcs.delete_index.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::Datastore::Admin::V1::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {
+                  "project_id" => request.project_id,
+                  "index_id"   => request.index_id
+                }
+                request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                metadata[:"x-goog-request-params"] ||= request_params_header
+
+                options.apply_defaults timeout:      @config.rpcs.delete_index.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.delete_index.retry_policy
+                options.apply_defaults metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @datastore_admin_stub.call_rpc :delete_index, request, options: options do |response, operation|
+                  response = ::Gapic::Operation.new response, @operations_client, options: options
+                  yield response, operation if block_given?
+                  return response
+                end
+              rescue ::GRPC::BadStatus => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Gets an index.
               #
@@ -721,6 +887,16 @@ module Google
                   #
                   attr_reader :import_entities
                   ##
+                  # RPC-specific configuration for `create_index`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :create_index
+                  ##
+                  # RPC-specific configuration for `delete_index`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :delete_index
+                  ##
                   # RPC-specific configuration for `get_index`
                   # @return [::Gapic::Config::Method]
                   #
@@ -737,6 +913,10 @@ module Google
                     @export_entities = ::Gapic::Config::Method.new export_entities_config
                     import_entities_config = parent_rpcs&.import_entities if parent_rpcs&.respond_to? :import_entities
                     @import_entities = ::Gapic::Config::Method.new import_entities_config
+                    create_index_config = parent_rpcs&.create_index if parent_rpcs&.respond_to? :create_index
+                    @create_index = ::Gapic::Config::Method.new create_index_config
+                    delete_index_config = parent_rpcs&.delete_index if parent_rpcs&.respond_to? :delete_index
+                    @delete_index = ::Gapic::Config::Method.new delete_index_config
                     get_index_config = parent_rpcs&.get_index if parent_rpcs&.respond_to? :get_index
                     @get_index = ::Gapic::Config::Method.new get_index_config
                     list_indexes_config = parent_rpcs&.list_indexes if parent_rpcs&.respond_to? :list_indexes

data/lib/google/cloud/datastore/admin/v1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Datastore
       module Admin
         module V1
-          VERSION = "0.2.0"
+          VERSION = "0.3.0"
         end
       end
     end

data/lib/google/datastore/admin/v1/datastore_admin_pb.rb

@@ -65,6 +65,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :kinds, :string, 1
       repeated :namespace_ids, :string, 2
     end
+    add_message "google.datastore.admin.v1.CreateIndexRequest" do
+      optional :project_id, :string, 1
+      optional :index, :message, 3, "google.datastore.admin.v1.Index"
+    end
+    add_message "google.datastore.admin.v1.DeleteIndexRequest" do
+      optional :project_id, :string, 1
+      optional :index_id, :string, 3
+    end
     add_message "google.datastore.admin.v1.GetIndexRequest" do
       optional :project_id, :string, 1
       optional :index_id, :string, 3
@@ -108,6 +116,8 @@ module Google
           ExportEntitiesMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.ExportEntitiesMetadata").msgclass
           ImportEntitiesMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.ImportEntitiesMetadata").msgclass
           EntityFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.EntityFilter").msgclass
+          CreateIndexRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.CreateIndexRequest").msgclass
+          DeleteIndexRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.DeleteIndexRequest").msgclass
           GetIndexRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.GetIndexRequest").msgclass
           ListIndexesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.ListIndexesRequest").msgclass
           ListIndexesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.ListIndexesResponse").msgclass

data/lib/google/datastore/admin/v1/datastore_admin_services_pb.rb

@@ -109,6 +109,32 @@ module Google
               # 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, ::Google::Cloud::Datastore::Admin::V1::ImportEntitiesRequest, ::Google::Longrunning::Operation
+              # 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.
+              #
+              # 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
+              # [delete][google.datastore.admin.v1.DatastoreAdmin.DeleteIndex], then
+              # re-creating the index with [create]
+              # [google.datastore.admin.v1.DatastoreAdmin.CreateIndex].
+              #
+              # Indexes with a single property cannot be created.
+              rpc :CreateIndex, ::Google::Cloud::Datastore::Admin::V1::CreateIndexRequest, ::Google::Longrunning::Operation
+              # Deletes an existing index.
+              # 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.
+              #
+              # 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
+              # [delete][google.datastore.admin.v1.DatastoreAdmin.DeleteIndex] again.
+              rpc :DeleteIndex, ::Google::Cloud::Datastore::Admin::V1::DeleteIndexRequest, ::Google::Longrunning::Operation
               # Gets an index.
               rpc :GetIndex, ::Google::Cloud::Datastore::Admin::V1::GetIndexRequest, ::Google::Cloud::Datastore::Admin::V1::Index
               # Lists the indexes that match the specified filters.  Datastore uses an

data/lib/google/datastore/admin/v1/migration_pb.rb

@@ -0,0 +1,44 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/datastore/admin/v1/migration.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/datastore/admin/v1/migration.proto", :syntax => :proto3) do
+    add_message "google.datastore.admin.v1.MigrationStateEvent" do
+      optional :state, :enum, 1, "google.datastore.admin.v1.MigrationState"
+    end
+    add_message "google.datastore.admin.v1.MigrationProgressEvent" do
+      optional :step, :enum, 1, "google.datastore.admin.v1.MigrationStep"
+    end
+    add_enum "google.datastore.admin.v1.MigrationState" do
+      value :MIGRATION_STATE_UNSPECIFIED, 0
+      value :RUNNING, 1
+      value :PAUSED, 2
+      value :COMPLETE, 3
+    end
+    add_enum "google.datastore.admin.v1.MigrationStep" do
+      value :MIGRATION_STEP_UNSPECIFIED, 0
+      value :START, 1
+      value :COPY_AND_VERIFY, 2
+      value :REDIRECT_EVENTUALLY_CONSISTENT_READS, 3
+      value :REDIRECT_STRONGLY_CONSISTENT_READS, 4
+      value :REDIRECT_WRITES, 5
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Datastore
+      module Admin
+        module V1
+          MigrationStateEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.MigrationStateEvent").msgclass
+          MigrationProgressEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.MigrationProgressEvent").msgclass
+          MigrationState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.MigrationState").enummodule
+          MigrationStep = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.admin.v1.MigrationStep").enummodule
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/datastore/admin/v1/datastore_admin.rb

@@ -281,6 +281,33 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # The request for
+          # {::Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client#create_index google.datastore.admin.v1.DatastoreAdmin.CreateIndex}.
+          # @!attribute [rw] project_id
+          #   @return [::String]
+          #     Project ID against which to make the request.
+          # @!attribute [rw] index
+          #   @return [::Google::Cloud::Datastore::Admin::V1::Index]
+          #     The index to create. The name and state fields are output only and will be
+          #     ignored. Single property indexes cannot be created or deleted.
+          class CreateIndexRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The request for
+          # {::Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client#delete_index google.datastore.admin.v1.DatastoreAdmin.DeleteIndex}.
+          # @!attribute [rw] project_id
+          #   @return [::String]
+          #     Project ID against which to make the request.
+          # @!attribute [rw] index_id
+          #   @return [::String]
+          #     The resource ID of the index to delete.
+          class DeleteIndexRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The request for {::Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client#get_index google.datastore.admin.v1.DatastoreAdmin.GetIndex}.
           # @!attribute [rw] project_id
           #   @return [::String]

data/proto_docs/google/datastore/admin/v1/index.rb

@@ -22,7 +22,7 @@ module Google
     module Datastore
       module Admin
         module V1
-          # A minimal index definition.
+          # Datastore composite index definition.
           # @!attribute [r] project_id
           #   @return [::String]
           #     Output only. Project ID.

data/proto_docs/google/datastore/admin/v1/migration.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Datastore
+      module Admin
+        module V1
+          # An event signifying a change in state of a [migration from Cloud Datastore to
+          # Cloud Firestore in Datastore
+          # mode](https://cloud.google.com/datastore/docs/upgrade-to-firestore).
+          # @!attribute [rw] state
+          #   @return [::Google::Cloud::Datastore::Admin::V1::MigrationState]
+          #     The new state of the migration.
+          class MigrationStateEvent
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # An event signifying the start of a new step in a [migration from Cloud
+          # Datastore to Cloud Firestore in Datastore
+          # mode](https://cloud.google.com/datastore/docs/upgrade-to-firestore).
+          # @!attribute [rw] step
+          #   @return [::Google::Cloud::Datastore::Admin::V1::MigrationStep]
+          #     The step that is starting.
+          #
+          #     An event with step set to `START` indicates that the migration
+          #     has been reverted back to the initial pre-migration state.
+          class MigrationProgressEvent
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # States for a migration.
+          module MigrationState
+            # Unspecified.
+            MIGRATION_STATE_UNSPECIFIED = 0
+
+            # The migration is running.
+            RUNNING = 1
+
+            # The migration is paused.
+            PAUSED = 2
+
+            # The migration is complete.
+            COMPLETE = 3
+          end
+
+          # Steps in a migration.
+          module MigrationStep
+            # Unspecified.
+            MIGRATION_STEP_UNSPECIFIED = 0
+
+            # Start of migration.
+            START = 1
+
+            # Data is copied to Cloud Firestore and then verified to match the data in
+            # Cloud Datastore.
+            COPY_AND_VERIFY = 2
+
+            # Eventually-consistent reads are redirected to Cloud Firestore.
+            REDIRECT_EVENTUALLY_CONSISTENT_READS = 3
+
+            # Strongly-consistent reads are redirected to Cloud Firestore.
+            REDIRECT_STRONGLY_CONSISTENT_READS = 4
+
+            # Writes are redirected to Cloud Firestore.
+            REDIRECT_WRITES = 5
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-datastore-admin-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-02 00:00:00.000000000 Z
+date: 2021-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -174,11 +174,13 @@ files:
 - lib/google/datastore/admin/v1/datastore_admin_pb.rb
 - lib/google/datastore/admin/v1/datastore_admin_services_pb.rb
 - lib/google/datastore/admin/v1/index_pb.rb
+- lib/google/datastore/admin/v1/migration_pb.rb
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/datastore/admin/v1/datastore_admin.rb
 - proto_docs/google/datastore/admin/v1/index.rb
+- proto_docs/google/datastore/admin/v1/migration.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb
 - proto_docs/google/protobuf/duration.rb
@@ -204,7 +206,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.6
+rubygems_version: 3.2.11
 signing_key: 
 specification_version: 4
 summary: API Client library for the Firestore in Datastore mode Admin V1 API