google-cloud-datastore-admin-v1 0.9.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/google/cloud/datastore/admin/v1/datastore_admin/client.rb +29 -41
- data/lib/google/cloud/datastore/admin/v1/datastore_admin/rest/client.rb +29 -41
- data/lib/google/cloud/datastore/admin/v1/datastore_admin/rest.rb +19 -33
- data/lib/google/cloud/datastore/admin/v1/datastore_admin.rb +19 -33
- data/lib/google/cloud/datastore/admin/v1/version.rb +1 -1
- data/lib/google/datastore/admin/v1/datastore_admin_services_pb.rb +24 -37
- data/proto_docs/google/datastore/admin/v1/datastore_admin.rb +10 -6
- data/proto_docs/google/datastore/admin/v1/index.rb +8 -2
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 75e9ce563b3ad1165e29b3f36ecf9e81d9fda38fcd07614472e020684188462b
|
4
|
+
data.tar.gz: 6372073237a4bb63100037e96647351ca35094d67cba95ef5a842795386cfa45
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 88e5849c7c18b12a02dc6b6631dd7e0bc3ad5169d4cae960c89a450c55a2f03afc970afa10f65beaeb1f1c14bd2e4dead7aa024c2cf614ba949ddc8dfa4b87a6
|
7
|
+
data.tar.gz: b41f20b4044ae18b6d7987b103c87e3c0522358fb29c96809389b82ed862d34d4cbda6b1031cda9dac9384b18fc2ccc1a6c2920e4c0bb8a0faa89d1ec8da6dba
|
@@ -30,14 +30,10 @@ module Google
|
|
30
30
|
#
|
31
31
|
# Google Cloud Datastore Admin API
|
32
32
|
#
|
33
|
-
#
|
34
33
|
# The Datastore Admin API provides several admin services for Cloud Datastore.
|
35
34
|
#
|
36
|
-
#
|
37
|
-
#
|
38
|
-
#
|
39
|
-
# Project, namespace, kind, and entity as defined in the Google Cloud Datastore
|
40
|
-
# API.
|
35
|
+
# Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
|
36
|
+
# Datastore API.
|
41
37
|
#
|
42
38
|
# Operation: An Operation represents work being performed in the background.
|
43
39
|
#
|
@@ -45,50 +41,40 @@ module Google
|
|
45
41
|
# specified as a combination of kinds and namespaces (either or both of which
|
46
42
|
# may be all).
|
47
43
|
#
|
48
|
-
#
|
49
|
-
# ## Services
|
50
|
-
#
|
51
|
-
# # Export/Import
|
44
|
+
# Export/Import Service:
|
52
45
|
#
|
53
|
-
# The Export/Import service provides the ability to copy all or a subset of
|
46
|
+
# - The Export/Import service provides the ability to copy all or a subset of
|
54
47
|
# entities to/from Google Cloud Storage.
|
55
|
-
#
|
56
|
-
# Exported data may be imported into Cloud Datastore for any Google Cloud
|
48
|
+
# - Exported data may be imported into Cloud Datastore for any Google Cloud
|
57
49
|
# Platform project. It is not restricted to the export source project. It is
|
58
50
|
# possible to export from one project and then import into another.
|
59
|
-
#
|
60
|
-
#
|
61
|
-
#
|
62
|
-
# Exports and imports are performed asynchronously. An Operation resource is
|
51
|
+
# - Exported data can also be loaded into Google BigQuery for analysis.
|
52
|
+
# - Exports and imports are performed asynchronously. An Operation resource is
|
63
53
|
# created for each export/import. The state (including any errors encountered)
|
64
54
|
# of the export/import may be queried via the Operation resource.
|
65
55
|
#
|
66
|
-
#
|
56
|
+
# Index Service:
|
67
57
|
#
|
68
|
-
# The index service manages Cloud Datastore composite indexes.
|
69
|
-
#
|
70
|
-
# Index creation and deletion are performed asynchronously.
|
58
|
+
# - The index service manages Cloud Datastore composite indexes.
|
59
|
+
# - Index creation and deletion are performed asynchronously.
|
71
60
|
# An Operation resource is created for each such asynchronous operation.
|
72
61
|
# The state of the operation (including any errors encountered)
|
73
62
|
# may be queried via the Operation resource.
|
74
63
|
#
|
75
|
-
#
|
64
|
+
# Operation Service:
|
76
65
|
#
|
77
|
-
# The Operations collection provides a record of actions performed for the
|
66
|
+
# - The Operations collection provides a record of actions performed for the
|
78
67
|
# specified project (including any operations in progress). Operations are not
|
79
68
|
# created directly but through calls on other collections or resources.
|
80
|
-
#
|
81
|
-
#
|
82
|
-
# asynchronous and the operation may continue to run for some time after the
|
69
|
+
# - An operation that is not yet done may be cancelled. The request to cancel
|
70
|
+
# is asynchronous and the operation may continue to run for some time after the
|
83
71
|
# request to cancel is made.
|
84
|
-
#
|
85
|
-
# An operation that is done may be deleted so that it is no longer listed as
|
72
|
+
# - An operation that is done may be deleted so that it is no longer listed as
|
86
73
|
# part of the Operation collection.
|
87
|
-
#
|
88
|
-
#
|
89
|
-
#
|
90
|
-
#
|
91
|
-
# but are accessed via service google.longrunning.Operations.
|
74
|
+
# - ListOperations returns all pending operations, but not completed
|
75
|
+
# operations.
|
76
|
+
# - Operations are created by service DatastoreAdmin, but are accessed via
|
77
|
+
# service google.longrunning.Operations.
|
92
78
|
#
|
93
79
|
class Client
|
94
80
|
# @private
|
@@ -279,8 +265,8 @@ module Google
|
|
279
265
|
#
|
280
266
|
# The resulting files will be nested deeper than the specified URL prefix.
|
281
267
|
# The final output URL will be provided in the
|
282
|
-
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
283
|
-
# value should be used for subsequent ImportEntities operations.
|
268
|
+
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
269
|
+
# field. That value should be used for subsequent ImportEntities operations.
|
284
270
|
#
|
285
271
|
# By nesting the data files deeper, the same Cloud Storage bucket can be used
|
286
272
|
# in multiple ExportEntities operations without conflict.
|
@@ -384,8 +370,9 @@ module Google
|
|
384
370
|
# @param labels [::Hash{::String => ::String}]
|
385
371
|
# Client-assigned labels.
|
386
372
|
# @param input_url [::String]
|
387
|
-
# Required. The full resource URL of the external storage location.
|
388
|
-
# Google Cloud Storage is supported. So input_url should be
|
373
|
+
# Required. The full resource URL of the external storage location.
|
374
|
+
# Currently, only Google Cloud Storage is supported. So input_url should be
|
375
|
+
# of the form:
|
389
376
|
# `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
|
390
377
|
# `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
|
391
378
|
# an optional Cloud Storage namespace path (this is not a Cloud Datastore
|
@@ -478,9 +465,9 @@ module Google
|
|
478
465
|
##
|
479
466
|
# Creates the specified index.
|
480
467
|
# A newly created index's initial state is `CREATING`. On completion of the
|
481
|
-
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
482
|
-
# If the index already exists, the call will return an
|
483
|
-
# status.
|
468
|
+
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
469
|
+
# state will be `READY`. If the index already exists, the call will return an
|
470
|
+
# `ALREADY_EXISTS` status.
|
484
471
|
#
|
485
472
|
# During index creation, the process could result in an error, in which
|
486
473
|
# case the index will move to the `ERROR` state. The process can be recovered
|
@@ -589,7 +576,8 @@ module Google
|
|
589
576
|
# An index can only be deleted if it is in a `READY` or `ERROR` state. On
|
590
577
|
# successful execution of the request, the index will be in a `DELETING`
|
591
578
|
# {::Google::Cloud::Datastore::Admin::V1::Index::State state}. And on completion of the
|
592
|
-
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
579
|
+
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
580
|
+
# index will be removed.
|
593
581
|
#
|
594
582
|
# During index deletion, the process could result in an error, in which
|
595
583
|
# case the index will move to the `ERROR` state. The process can be recovered
|
@@ -32,14 +32,10 @@ module Google
|
|
32
32
|
#
|
33
33
|
# Google Cloud Datastore Admin API
|
34
34
|
#
|
35
|
-
#
|
36
35
|
# The Datastore Admin API provides several admin services for Cloud Datastore.
|
37
36
|
#
|
38
|
-
#
|
39
|
-
#
|
40
|
-
#
|
41
|
-
# Project, namespace, kind, and entity as defined in the Google Cloud Datastore
|
42
|
-
# API.
|
37
|
+
# Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
|
38
|
+
# Datastore API.
|
43
39
|
#
|
44
40
|
# Operation: An Operation represents work being performed in the background.
|
45
41
|
#
|
@@ -47,50 +43,40 @@ module Google
|
|
47
43
|
# specified as a combination of kinds and namespaces (either or both of which
|
48
44
|
# may be all).
|
49
45
|
#
|
50
|
-
#
|
51
|
-
# ## Services
|
52
|
-
#
|
53
|
-
# # Export/Import
|
46
|
+
# Export/Import Service:
|
54
47
|
#
|
55
|
-
# The Export/Import service provides the ability to copy all or a subset of
|
48
|
+
# - The Export/Import service provides the ability to copy all or a subset of
|
56
49
|
# entities to/from Google Cloud Storage.
|
57
|
-
#
|
58
|
-
# Exported data may be imported into Cloud Datastore for any Google Cloud
|
50
|
+
# - Exported data may be imported into Cloud Datastore for any Google Cloud
|
59
51
|
# Platform project. It is not restricted to the export source project. It is
|
60
52
|
# possible to export from one project and then import into another.
|
61
|
-
#
|
62
|
-
#
|
63
|
-
#
|
64
|
-
# Exports and imports are performed asynchronously. An Operation resource is
|
53
|
+
# - Exported data can also be loaded into Google BigQuery for analysis.
|
54
|
+
# - Exports and imports are performed asynchronously. An Operation resource is
|
65
55
|
# created for each export/import. The state (including any errors encountered)
|
66
56
|
# of the export/import may be queried via the Operation resource.
|
67
57
|
#
|
68
|
-
#
|
58
|
+
# Index Service:
|
69
59
|
#
|
70
|
-
# The index service manages Cloud Datastore composite indexes.
|
71
|
-
#
|
72
|
-
# Index creation and deletion are performed asynchronously.
|
60
|
+
# - The index service manages Cloud Datastore composite indexes.
|
61
|
+
# - Index creation and deletion are performed asynchronously.
|
73
62
|
# An Operation resource is created for each such asynchronous operation.
|
74
63
|
# The state of the operation (including any errors encountered)
|
75
64
|
# may be queried via the Operation resource.
|
76
65
|
#
|
77
|
-
#
|
66
|
+
# Operation Service:
|
78
67
|
#
|
79
|
-
# The Operations collection provides a record of actions performed for the
|
68
|
+
# - The Operations collection provides a record of actions performed for the
|
80
69
|
# specified project (including any operations in progress). Operations are not
|
81
70
|
# created directly but through calls on other collections or resources.
|
82
|
-
#
|
83
|
-
#
|
84
|
-
# asynchronous and the operation may continue to run for some time after the
|
71
|
+
# - An operation that is not yet done may be cancelled. The request to cancel
|
72
|
+
# is asynchronous and the operation may continue to run for some time after the
|
85
73
|
# request to cancel is made.
|
86
|
-
#
|
87
|
-
# An operation that is done may be deleted so that it is no longer listed as
|
74
|
+
# - An operation that is done may be deleted so that it is no longer listed as
|
88
75
|
# part of the Operation collection.
|
89
|
-
#
|
90
|
-
#
|
91
|
-
#
|
92
|
-
#
|
93
|
-
# but are accessed via service google.longrunning.Operations.
|
76
|
+
# - ListOperations returns all pending operations, but not completed
|
77
|
+
# operations.
|
78
|
+
# - Operations are created by service DatastoreAdmin, but are accessed via
|
79
|
+
# service google.longrunning.Operations.
|
94
80
|
#
|
95
81
|
class Client
|
96
82
|
# @private
|
@@ -270,8 +256,8 @@ module Google
|
|
270
256
|
#
|
271
257
|
# The resulting files will be nested deeper than the specified URL prefix.
|
272
258
|
# The final output URL will be provided in the
|
273
|
-
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
274
|
-
# value should be used for subsequent ImportEntities operations.
|
259
|
+
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
260
|
+
# field. That value should be used for subsequent ImportEntities operations.
|
275
261
|
#
|
276
262
|
# By nesting the data files deeper, the same Cloud Storage bucket can be used
|
277
263
|
# in multiple ExportEntities operations without conflict.
|
@@ -345,8 +331,9 @@ module Google
|
|
345
331
|
# @param labels [::Hash{::String => ::String}]
|
346
332
|
# Client-assigned labels.
|
347
333
|
# @param input_url [::String]
|
348
|
-
# Required. The full resource URL of the external storage location.
|
349
|
-
# Google Cloud Storage is supported. So input_url should be
|
334
|
+
# Required. The full resource URL of the external storage location.
|
335
|
+
# Currently, only Google Cloud Storage is supported. So input_url should be
|
336
|
+
# of the form:
|
350
337
|
# `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
|
351
338
|
# `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
|
352
339
|
# an optional Cloud Storage namespace path (this is not a Cloud Datastore
|
@@ -409,9 +396,9 @@ module Google
|
|
409
396
|
##
|
410
397
|
# Creates the specified index.
|
411
398
|
# A newly created index's initial state is `CREATING`. On completion of the
|
412
|
-
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
413
|
-
# If the index already exists, the call will return an
|
414
|
-
# status.
|
399
|
+
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
400
|
+
# state will be `READY`. If the index already exists, the call will return an
|
401
|
+
# `ALREADY_EXISTS` status.
|
415
402
|
#
|
416
403
|
# During index creation, the process could result in an error, in which
|
417
404
|
# case the index will move to the `ERROR` state. The process can be recovered
|
@@ -490,7 +477,8 @@ module Google
|
|
490
477
|
# An index can only be deleted if it is in a `READY` or `ERROR` state. On
|
491
478
|
# successful execution of the request, the index will be in a `DELETING`
|
492
479
|
# {::Google::Cloud::Datastore::Admin::V1::Index::State state}. And on completion of the
|
493
|
-
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
480
|
+
# returned {::Google::Longrunning::Operation google.longrunning.Operation}, the
|
481
|
+
# index will be removed.
|
494
482
|
#
|
495
483
|
# During index deletion, the process could result in an error, in which
|
496
484
|
# case the index will move to the `ERROR` state. The process can be recovered
|
@@ -34,14 +34,10 @@ module Google
|
|
34
34
|
##
|
35
35
|
# Google Cloud Datastore Admin API
|
36
36
|
#
|
37
|
-
#
|
38
37
|
# The Datastore Admin API provides several admin services for Cloud Datastore.
|
39
38
|
#
|
40
|
-
#
|
41
|
-
#
|
42
|
-
#
|
43
|
-
# Project, namespace, kind, and entity as defined in the Google Cloud Datastore
|
44
|
-
# API.
|
39
|
+
# Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
|
40
|
+
# Datastore API.
|
45
41
|
#
|
46
42
|
# Operation: An Operation represents work being performed in the background.
|
47
43
|
#
|
@@ -49,50 +45,40 @@ module Google
|
|
49
45
|
# specified as a combination of kinds and namespaces (either or both of which
|
50
46
|
# may be all).
|
51
47
|
#
|
52
|
-
#
|
53
|
-
# ## Services
|
54
|
-
#
|
55
|
-
# # Export/Import
|
48
|
+
# Export/Import Service:
|
56
49
|
#
|
57
|
-
# The Export/Import service provides the ability to copy all or a subset of
|
50
|
+
# - The Export/Import service provides the ability to copy all or a subset of
|
58
51
|
# entities to/from Google Cloud Storage.
|
59
|
-
#
|
60
|
-
# Exported data may be imported into Cloud Datastore for any Google Cloud
|
52
|
+
# - Exported data may be imported into Cloud Datastore for any Google Cloud
|
61
53
|
# Platform project. It is not restricted to the export source project. It is
|
62
54
|
# possible to export from one project and then import into another.
|
63
|
-
#
|
64
|
-
#
|
65
|
-
#
|
66
|
-
# Exports and imports are performed asynchronously. An Operation resource is
|
55
|
+
# - Exported data can also be loaded into Google BigQuery for analysis.
|
56
|
+
# - Exports and imports are performed asynchronously. An Operation resource is
|
67
57
|
# created for each export/import. The state (including any errors encountered)
|
68
58
|
# of the export/import may be queried via the Operation resource.
|
69
59
|
#
|
70
|
-
#
|
60
|
+
# Index Service:
|
71
61
|
#
|
72
|
-
# The index service manages Cloud Datastore composite indexes.
|
73
|
-
#
|
74
|
-
# Index creation and deletion are performed asynchronously.
|
62
|
+
# - The index service manages Cloud Datastore composite indexes.
|
63
|
+
# - Index creation and deletion are performed asynchronously.
|
75
64
|
# An Operation resource is created for each such asynchronous operation.
|
76
65
|
# The state of the operation (including any errors encountered)
|
77
66
|
# may be queried via the Operation resource.
|
78
67
|
#
|
79
|
-
#
|
68
|
+
# Operation Service:
|
80
69
|
#
|
81
|
-
# The Operations collection provides a record of actions performed for the
|
70
|
+
# - The Operations collection provides a record of actions performed for the
|
82
71
|
# specified project (including any operations in progress). Operations are not
|
83
72
|
# created directly but through calls on other collections or resources.
|
84
|
-
#
|
85
|
-
#
|
86
|
-
# asynchronous and the operation may continue to run for some time after the
|
73
|
+
# - An operation that is not yet done may be cancelled. The request to cancel
|
74
|
+
# is asynchronous and the operation may continue to run for some time after the
|
87
75
|
# request to cancel is made.
|
88
|
-
#
|
89
|
-
# An operation that is done may be deleted so that it is no longer listed as
|
76
|
+
# - An operation that is done may be deleted so that it is no longer listed as
|
90
77
|
# part of the Operation collection.
|
91
|
-
#
|
92
|
-
#
|
93
|
-
#
|
94
|
-
#
|
95
|
-
# but are accessed via service google.longrunning.Operations.
|
78
|
+
# - ListOperations returns all pending operations, but not completed
|
79
|
+
# operations.
|
80
|
+
# - Operations are created by service DatastoreAdmin, but are accessed via
|
81
|
+
# service google.longrunning.Operations.
|
96
82
|
#
|
97
83
|
# To load this service and instantiate a REST client:
|
98
84
|
#
|
@@ -35,14 +35,10 @@ module Google
|
|
35
35
|
##
|
36
36
|
# Google Cloud Datastore Admin API
|
37
37
|
#
|
38
|
-
#
|
39
38
|
# The Datastore Admin API provides several admin services for Cloud Datastore.
|
40
39
|
#
|
41
|
-
#
|
42
|
-
#
|
43
|
-
#
|
44
|
-
# Project, namespace, kind, and entity as defined in the Google Cloud Datastore
|
45
|
-
# API.
|
40
|
+
# Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
|
41
|
+
# Datastore API.
|
46
42
|
#
|
47
43
|
# Operation: An Operation represents work being performed in the background.
|
48
44
|
#
|
@@ -50,50 +46,40 @@ module Google
|
|
50
46
|
# specified as a combination of kinds and namespaces (either or both of which
|
51
47
|
# may be all).
|
52
48
|
#
|
53
|
-
#
|
54
|
-
# ## Services
|
55
|
-
#
|
56
|
-
# # Export/Import
|
49
|
+
# Export/Import Service:
|
57
50
|
#
|
58
|
-
# The Export/Import service provides the ability to copy all or a subset of
|
51
|
+
# - The Export/Import service provides the ability to copy all or a subset of
|
59
52
|
# entities to/from Google Cloud Storage.
|
60
|
-
#
|
61
|
-
# Exported data may be imported into Cloud Datastore for any Google Cloud
|
53
|
+
# - Exported data may be imported into Cloud Datastore for any Google Cloud
|
62
54
|
# Platform project. It is not restricted to the export source project. It is
|
63
55
|
# possible to export from one project and then import into another.
|
64
|
-
#
|
65
|
-
#
|
66
|
-
#
|
67
|
-
# Exports and imports are performed asynchronously. An Operation resource is
|
56
|
+
# - Exported data can also be loaded into Google BigQuery for analysis.
|
57
|
+
# - Exports and imports are performed asynchronously. An Operation resource is
|
68
58
|
# created for each export/import. The state (including any errors encountered)
|
69
59
|
# of the export/import may be queried via the Operation resource.
|
70
60
|
#
|
71
|
-
#
|
61
|
+
# Index Service:
|
72
62
|
#
|
73
|
-
# The index service manages Cloud Datastore composite indexes.
|
74
|
-
#
|
75
|
-
# Index creation and deletion are performed asynchronously.
|
63
|
+
# - The index service manages Cloud Datastore composite indexes.
|
64
|
+
# - Index creation and deletion are performed asynchronously.
|
76
65
|
# An Operation resource is created for each such asynchronous operation.
|
77
66
|
# The state of the operation (including any errors encountered)
|
78
67
|
# may be queried via the Operation resource.
|
79
68
|
#
|
80
|
-
#
|
69
|
+
# Operation Service:
|
81
70
|
#
|
82
|
-
# The Operations collection provides a record of actions performed for the
|
71
|
+
# - The Operations collection provides a record of actions performed for the
|
83
72
|
# specified project (including any operations in progress). Operations are not
|
84
73
|
# created directly but through calls on other collections or resources.
|
85
|
-
#
|
86
|
-
#
|
87
|
-
# asynchronous and the operation may continue to run for some time after the
|
74
|
+
# - An operation that is not yet done may be cancelled. The request to cancel
|
75
|
+
# is asynchronous and the operation may continue to run for some time after the
|
88
76
|
# request to cancel is made.
|
89
|
-
#
|
90
|
-
# An operation that is done may be deleted so that it is no longer listed as
|
77
|
+
# - An operation that is done may be deleted so that it is no longer listed as
|
91
78
|
# part of the Operation collection.
|
92
|
-
#
|
93
|
-
#
|
94
|
-
#
|
95
|
-
#
|
96
|
-
# but are accessed via service google.longrunning.Operations.
|
79
|
+
# - ListOperations returns all pending operations, but not completed
|
80
|
+
# operations.
|
81
|
+
# - Operations are created by service DatastoreAdmin, but are accessed via
|
82
|
+
# service google.longrunning.Operations.
|
97
83
|
#
|
98
84
|
# @example Load this service and instantiate a gRPC client
|
99
85
|
#
|
@@ -27,14 +27,10 @@ module Google
|
|
27
27
|
module DatastoreAdmin
|
28
28
|
# Google Cloud Datastore Admin API
|
29
29
|
#
|
30
|
-
#
|
31
30
|
# The Datastore Admin API provides several admin services for Cloud Datastore.
|
32
31
|
#
|
33
|
-
#
|
34
|
-
#
|
35
|
-
#
|
36
|
-
# Project, namespace, kind, and entity as defined in the Google Cloud Datastore
|
37
|
-
# API.
|
32
|
+
# Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
|
33
|
+
# Datastore API.
|
38
34
|
#
|
39
35
|
# Operation: An Operation represents work being performed in the background.
|
40
36
|
#
|
@@ -42,50 +38,40 @@ module Google
|
|
42
38
|
# specified as a combination of kinds and namespaces (either or both of which
|
43
39
|
# may be all).
|
44
40
|
#
|
45
|
-
#
|
46
|
-
# ## Services
|
47
|
-
#
|
48
|
-
# # Export/Import
|
41
|
+
# Export/Import Service:
|
49
42
|
#
|
50
|
-
# The Export/Import service provides the ability to copy all or a subset of
|
43
|
+
# - The Export/Import service provides the ability to copy all or a subset of
|
51
44
|
# entities to/from Google Cloud Storage.
|
52
|
-
#
|
53
|
-
# Exported data may be imported into Cloud Datastore for any Google Cloud
|
45
|
+
# - Exported data may be imported into Cloud Datastore for any Google Cloud
|
54
46
|
# Platform project. It is not restricted to the export source project. It is
|
55
47
|
# possible to export from one project and then import into another.
|
56
|
-
#
|
57
|
-
#
|
58
|
-
#
|
59
|
-
# Exports and imports are performed asynchronously. An Operation resource is
|
48
|
+
# - Exported data can also be loaded into Google BigQuery for analysis.
|
49
|
+
# - Exports and imports are performed asynchronously. An Operation resource is
|
60
50
|
# created for each export/import. The state (including any errors encountered)
|
61
51
|
# of the export/import may be queried via the Operation resource.
|
62
52
|
#
|
63
|
-
#
|
53
|
+
# Index Service:
|
64
54
|
#
|
65
|
-
# The index service manages Cloud Datastore composite indexes.
|
66
|
-
#
|
67
|
-
# Index creation and deletion are performed asynchronously.
|
55
|
+
# - The index service manages Cloud Datastore composite indexes.
|
56
|
+
# - Index creation and deletion are performed asynchronously.
|
68
57
|
# An Operation resource is created for each such asynchronous operation.
|
69
58
|
# The state of the operation (including any errors encountered)
|
70
59
|
# may be queried via the Operation resource.
|
71
60
|
#
|
72
|
-
#
|
61
|
+
# Operation Service:
|
73
62
|
#
|
74
|
-
# The Operations collection provides a record of actions performed for the
|
63
|
+
# - The Operations collection provides a record of actions performed for the
|
75
64
|
# specified project (including any operations in progress). Operations are not
|
76
65
|
# created directly but through calls on other collections or resources.
|
77
|
-
#
|
78
|
-
#
|
79
|
-
# asynchronous and the operation may continue to run for some time after the
|
66
|
+
# - An operation that is not yet done may be cancelled. The request to cancel
|
67
|
+
# is asynchronous and the operation may continue to run for some time after the
|
80
68
|
# request to cancel is made.
|
81
|
-
#
|
82
|
-
# An operation that is done may be deleted so that it is no longer listed as
|
69
|
+
# - An operation that is done may be deleted so that it is no longer listed as
|
83
70
|
# part of the Operation collection.
|
84
|
-
#
|
85
|
-
#
|
86
|
-
#
|
87
|
-
#
|
88
|
-
# but are accessed via service google.longrunning.Operations.
|
71
|
+
# - ListOperations returns all pending operations, but not completed
|
72
|
+
# operations.
|
73
|
+
# - Operations are created by service DatastoreAdmin, but are accessed via
|
74
|
+
# service google.longrunning.Operations.
|
89
75
|
class Service
|
90
76
|
|
91
77
|
include ::GRPC::GenericService
|
@@ -111,9 +97,9 @@ module Google
|
|
111
97
|
rpc :ImportEntities, ::Google::Cloud::Datastore::Admin::V1::ImportEntitiesRequest, ::Google::Longrunning::Operation
|
112
98
|
# Creates the specified index.
|
113
99
|
# A newly created index's initial state is `CREATING`. On completion of the
|
114
|
-
# returned [google.longrunning.Operation][google.longrunning.Operation], the
|
115
|
-
# If the index already exists, the call will return an
|
116
|
-
# status.
|
100
|
+
# returned [google.longrunning.Operation][google.longrunning.Operation], the
|
101
|
+
# state will be `READY`. If the index already exists, the call will return an
|
102
|
+
# `ALREADY_EXISTS` status.
|
117
103
|
#
|
118
104
|
# During index creation, the process could result in an error, in which
|
119
105
|
# case the index will move to the `ERROR` state. The process can be recovered
|
@@ -128,7 +114,8 @@ module Google
|
|
128
114
|
# An index can only be deleted if it is in a `READY` or `ERROR` state. On
|
129
115
|
# successful execution of the request, the index will be in a `DELETING`
|
130
116
|
# [state][google.datastore.admin.v1.Index.State]. And on completion of the
|
131
|
-
# returned [google.longrunning.Operation][google.longrunning.Operation], the
|
117
|
+
# returned [google.longrunning.Operation][google.longrunning.Operation], the
|
118
|
+
# index will be removed.
|
132
119
|
#
|
133
120
|
# During index deletion, the process could result in an error, in which
|
134
121
|
# case the index will move to the `ERROR` state. The process can be recovered
|
@@ -123,8 +123,8 @@ module Google
|
|
123
123
|
#
|
124
124
|
# The resulting files will be nested deeper than the specified URL prefix.
|
125
125
|
# The final output URL will be provided in the
|
126
|
-
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
127
|
-
# value should be used for subsequent ImportEntities operations.
|
126
|
+
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
127
|
+
# field. That value should be used for subsequent ImportEntities operations.
|
128
128
|
#
|
129
129
|
# By nesting the data files deeper, the same Cloud Storage bucket can be used
|
130
130
|
# in multiple ExportEntities operations without conflict.
|
@@ -152,8 +152,9 @@ module Google
|
|
152
152
|
# Client-assigned labels.
|
153
153
|
# @!attribute [rw] input_url
|
154
154
|
# @return [::String]
|
155
|
-
# Required. The full resource URL of the external storage location.
|
156
|
-
# Google Cloud Storage is supported. So input_url should be
|
155
|
+
# Required. The full resource URL of the external storage location.
|
156
|
+
# Currently, only Google Cloud Storage is supported. So input_url should be
|
157
|
+
# of the form:
|
157
158
|
# `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
|
158
159
|
# `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
|
159
160
|
# an optional Cloud Storage namespace path (this is not a Cloud Datastore
|
@@ -239,7 +240,9 @@ module Google
|
|
239
240
|
# @!attribute [rw] input_url
|
240
241
|
# @return [::String]
|
241
242
|
# The location of the import metadata file. This will be the same value as
|
242
|
-
# the
|
243
|
+
# the
|
244
|
+
# {::Google::Cloud::Datastore::Admin::V1::ExportEntitiesResponse#output_url google.datastore.admin.v1.ExportEntitiesResponse.output_url}
|
245
|
+
# field.
|
243
246
|
class ImportEntitiesMetadata
|
244
247
|
include ::Google::Protobuf::MessageExts
|
245
248
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -308,7 +311,8 @@ module Google
|
|
308
311
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
309
312
|
end
|
310
313
|
|
311
|
-
# The request for
|
314
|
+
# The request for
|
315
|
+
# {::Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client#get_index google.datastore.admin.v1.DatastoreAdmin.GetIndex}.
|
312
316
|
# @!attribute [rw] project_id
|
313
317
|
# @return [::String]
|
314
318
|
# Project ID against which to make the request.
|
@@ -34,10 +34,15 @@ module Google
|
|
34
34
|
# Required. The entity kind to which this index applies.
|
35
35
|
# @!attribute [rw] ancestor
|
36
36
|
# @return [::Google::Cloud::Datastore::Admin::V1::Index::AncestorMode]
|
37
|
-
# Required. The index's ancestor mode. Must not be
|
37
|
+
# Required. The index's ancestor mode. Must not be
|
38
|
+
# ANCESTOR_MODE_UNSPECIFIED.
|
38
39
|
# @!attribute [rw] properties
|
39
40
|
# @return [::Array<::Google::Cloud::Datastore::Admin::V1::Index::IndexedProperty>]
|
40
41
|
# Required. An ordered sequence of property names and their index attributes.
|
42
|
+
#
|
43
|
+
# Requires:
|
44
|
+
#
|
45
|
+
# * A maximum of 100 properties.
|
41
46
|
# @!attribute [r] state
|
42
47
|
# @return [::Google::Cloud::Datastore::Admin::V1::Index::State]
|
43
48
|
# Output only. The state of the index.
|
@@ -51,7 +56,8 @@ module Google
|
|
51
56
|
# Required. The property name to index.
|
52
57
|
# @!attribute [rw] direction
|
53
58
|
# @return [::Google::Cloud::Datastore::Admin::V1::Index::Direction]
|
54
|
-
# Required. The indexed property's direction. Must not be
|
59
|
+
# Required. The indexed property's direction. Must not be
|
60
|
+
# DIRECTION_UNSPECIFIED.
|
55
61
|
class IndexedProperty
|
56
62
|
include ::Google::Protobuf::MessageExts
|
57
63
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-datastore-admin-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.9.
|
4
|
+
version: 0.9.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2023-
|
11
|
+
date: 2023-08-03 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|