@google-cloud/firestore-api 0.1.0
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.
- package/README.md +111 -0
- package/build/protos/google/firestore/admin/v1/backup.proto +112 -0
- package/build/protos/google/firestore/admin/v1/database.proto +403 -0
- package/build/protos/google/firestore/admin/v1/field.proto +154 -0
- package/build/protos/google/firestore/admin/v1/firestore_admin.proto +1229 -0
- package/build/protos/google/firestore/admin/v1/index.proto +378 -0
- package/build/protos/google/firestore/admin/v1/location.proto +30 -0
- package/build/protos/google/firestore/admin/v1/operation.proto +330 -0
- package/build/protos/google/firestore/admin/v1/realtime_updates.proto +40 -0
- package/build/protos/google/firestore/admin/v1/schedule.proto +95 -0
- package/build/protos/google/firestore/admin/v1/snapshot.proto +53 -0
- package/build/protos/google/firestore/admin/v1/user_creds.proto +86 -0
- package/build/protos/google/firestore/v1/aggregation_result.proto +43 -0
- package/build/protos/google/firestore/v1/bloom_filter.proto +73 -0
- package/build/protos/google/firestore/v1/common.proto +111 -0
- package/build/protos/google/firestore/v1/document.proto +247 -0
- package/build/protos/google/firestore/v1/explain_stats.proto +41 -0
- package/build/protos/google/firestore/v1/firestore.proto +1237 -0
- package/build/protos/google/firestore/v1/pipeline.proto +43 -0
- package/build/protos/google/firestore/v1/query.proto +600 -0
- package/build/protos/google/firestore/v1/query_profile.proto +92 -0
- package/build/protos/google/firestore/v1/write.proto +286 -0
- package/build/protos/google/firestore/v1beta1/common.proto +82 -0
- package/build/protos/google/firestore/v1beta1/document.proto +149 -0
- package/build/protos/google/firestore/v1beta1/firestore.proto +900 -0
- package/build/protos/google/firestore/v1beta1/query.proto +300 -0
- package/build/protos/google/firestore/v1beta1/undeliverable_first_gen_event.proto +75 -0
- package/build/protos/google/firestore/v1beta1/write.proto +258 -0
- package/build/protos/protos.d.ts +35648 -0
- package/build/protos/protos.js +1 -0
- package/build/protos/protos.json +1 -0
- package/build/src/index.d.ts +13 -0
- package/build/src/index.js +30 -0
- package/build/src/index.js.map +1 -0
- package/build/src/v1/firestore_admin_client.d.ts +1925 -0
- package/build/src/v1/firestore_admin_client.js +2734 -0
- package/build/src/v1/firestore_admin_client.js.map +1 -0
- package/build/src/v1/firestore_admin_client_config.json +172 -0
- package/build/src/v1/firestore_admin_proto_list.json +13 -0
- package/build/src/v1/firestore_client.d.ts +1204 -0
- package/build/src/v1/firestore_client.js +1605 -0
- package/build/src/v1/firestore_client.js.map +1 -0
- package/build/src/v1/firestore_client_config.json +135 -0
- package/build/src/v1/firestore_proto_list.json +12 -0
- package/build/src/v1/gapic_metadata.json +351 -0
- package/build/src/v1/index.d.ts +2 -0
- package/build/src/v1/index.js +25 -0
- package/build/src/v1/index.js.map +1 -0
- package/build/src/v1beta1/firestore_client.d.ts +930 -0
- package/build/src/v1beta1/firestore_client.js +1310 -0
- package/build/src/v1beta1/firestore_client.js.map +1 -0
- package/build/src/v1beta1/firestore_client_config.json +99 -0
- package/build/src/v1beta1/firestore_proto_list.json +8 -0
- package/build/src/v1beta1/gapic_metadata.json +165 -0
- package/build/src/v1beta1/index.d.ts +1 -0
- package/build/src/v1beta1/index.js +23 -0
- package/build/src/v1beta1/index.js.map +1 -0
- package/package.json +65 -0
|
@@ -0,0 +1,1925 @@
|
|
|
1
|
+
import type * as gax from 'google-gax';
|
|
2
|
+
import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation, PaginationCallback, LocationsClient, LocationProtos } from 'google-gax';
|
|
3
|
+
import { Transform } from 'stream';
|
|
4
|
+
import * as protos from '../../protos/protos';
|
|
5
|
+
/**
|
|
6
|
+
* The Cloud Firestore Admin API.
|
|
7
|
+
*
|
|
8
|
+
* This API provides several administrative services for Cloud Firestore.
|
|
9
|
+
*
|
|
10
|
+
* Project, Database, Namespace, Collection, Collection Group, and Document are
|
|
11
|
+
* used as defined in the Google Cloud Firestore API.
|
|
12
|
+
*
|
|
13
|
+
* Operation: An Operation represents work being performed in the background.
|
|
14
|
+
*
|
|
15
|
+
* The index service manages Cloud Firestore indexes.
|
|
16
|
+
*
|
|
17
|
+
* Index creation is performed asynchronously.
|
|
18
|
+
* An Operation resource is created for each such asynchronous operation.
|
|
19
|
+
* The state of the operation (including any errors encountered)
|
|
20
|
+
* may be queried via the Operation resource.
|
|
21
|
+
*
|
|
22
|
+
* The Operations collection provides a record of actions performed for the
|
|
23
|
+
* specified Project (including any Operations in progress). Operations are not
|
|
24
|
+
* created directly but through calls on other collections or resources.
|
|
25
|
+
*
|
|
26
|
+
* An Operation that is done may be deleted so that it is no longer listed as
|
|
27
|
+
* part of the Operation collection. Operations are garbage collected after
|
|
28
|
+
* 30 days. By default, ListOperations will only return in progress and failed
|
|
29
|
+
* operations. To list completed operation, issue a ListOperations request with
|
|
30
|
+
* the filter `done: true`.
|
|
31
|
+
*
|
|
32
|
+
* Operations are created by service `FirestoreAdmin`, but are accessed via
|
|
33
|
+
* service `google.longrunning.Operations`.
|
|
34
|
+
* @class
|
|
35
|
+
* @memberof v1
|
|
36
|
+
*/
|
|
37
|
+
export declare class FirestoreAdminClient {
|
|
38
|
+
private _terminated;
|
|
39
|
+
private _opts;
|
|
40
|
+
private _providedCustomServicePath;
|
|
41
|
+
private _gaxModule;
|
|
42
|
+
private _gaxGrpc;
|
|
43
|
+
private _protos;
|
|
44
|
+
private _defaults;
|
|
45
|
+
private _universeDomain;
|
|
46
|
+
private _servicePath;
|
|
47
|
+
private _log;
|
|
48
|
+
auth: gax.GoogleAuth;
|
|
49
|
+
descriptors: Descriptors;
|
|
50
|
+
warn: (code: string, message: string, warnType?: string) => void;
|
|
51
|
+
innerApiCalls: {
|
|
52
|
+
[name: string]: Function;
|
|
53
|
+
};
|
|
54
|
+
locationsClient: LocationsClient;
|
|
55
|
+
pathTemplates: {
|
|
56
|
+
[name: string]: gax.PathTemplate;
|
|
57
|
+
};
|
|
58
|
+
operationsClient: gax.OperationsClient;
|
|
59
|
+
firestoreAdminStub?: Promise<{
|
|
60
|
+
[name: string]: Function;
|
|
61
|
+
}>;
|
|
62
|
+
/**
|
|
63
|
+
* Construct an instance of FirestoreAdminClient.
|
|
64
|
+
*
|
|
65
|
+
* @param {object} [options] - The configuration object.
|
|
66
|
+
* The options accepted by the constructor are described in detail
|
|
67
|
+
* in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
|
|
68
|
+
* The common options are:
|
|
69
|
+
* @param {object} [options.credentials] - Credentials object.
|
|
70
|
+
* @param {string} [options.credentials.client_email]
|
|
71
|
+
* @param {string} [options.credentials.private_key]
|
|
72
|
+
* @param {string} [options.email] - Account email address. Required when
|
|
73
|
+
* using a .pem or .p12 keyFilename.
|
|
74
|
+
* @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
|
|
75
|
+
* .p12 key downloaded from the Google Developers Console. If you provide
|
|
76
|
+
* a path to a JSON file, the projectId option below is not necessary.
|
|
77
|
+
* NOTE: .pem and .p12 require you to specify options.email as well.
|
|
78
|
+
* @param {number} [options.port] - The port on which to connect to
|
|
79
|
+
* the remote host.
|
|
80
|
+
* @param {string} [options.projectId] - The project ID from the Google
|
|
81
|
+
* Developer's Console, e.g. 'grape-spaceship-123'. We will also check
|
|
82
|
+
* the environment variable GCLOUD_PROJECT for your project ID. If your
|
|
83
|
+
* app is running in an environment which supports
|
|
84
|
+
* {@link https://cloud.google.com/docs/authentication/application-default-credentials Application Default Credentials},
|
|
85
|
+
* your project ID will be detected automatically.
|
|
86
|
+
* @param {string} [options.apiEndpoint] - The domain name of the
|
|
87
|
+
* API remote host.
|
|
88
|
+
* @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
|
|
89
|
+
* Follows the structure of {@link gapicConfig}.
|
|
90
|
+
* @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
|
|
91
|
+
* For more information, please check the
|
|
92
|
+
* {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
|
|
93
|
+
* @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
|
|
94
|
+
* need to avoid loading the default gRPC version and want to use the fallback
|
|
95
|
+
* HTTP implementation. Load only fallback version and pass it to the constructor:
|
|
96
|
+
* ```
|
|
97
|
+
* const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
|
|
98
|
+
* const client = new FirestoreAdminClient({fallback: true}, gax);
|
|
99
|
+
* ```
|
|
100
|
+
*/
|
|
101
|
+
constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
|
|
102
|
+
/**
|
|
103
|
+
* Initialize the client.
|
|
104
|
+
* Performs asynchronous operations (such as authentication) and prepares the client.
|
|
105
|
+
* This function will be called automatically when any class method is called for the
|
|
106
|
+
* first time, but if you need to initialize it before calling an actual method,
|
|
107
|
+
* feel free to call initialize() directly.
|
|
108
|
+
*
|
|
109
|
+
* You can await on this method if you want to make sure the client is initialized.
|
|
110
|
+
*
|
|
111
|
+
* @returns {Promise} A promise that resolves to an authenticated service stub.
|
|
112
|
+
*/
|
|
113
|
+
initialize(): Promise<{
|
|
114
|
+
[name: string]: Function;
|
|
115
|
+
}>;
|
|
116
|
+
/**
|
|
117
|
+
* The DNS address for this API service.
|
|
118
|
+
* @deprecated Use the apiEndpoint method of the client instance.
|
|
119
|
+
* @returns {string} The DNS address for this service.
|
|
120
|
+
*/
|
|
121
|
+
static get servicePath(): string;
|
|
122
|
+
/**
|
|
123
|
+
* The DNS address for this API service - same as servicePath.
|
|
124
|
+
* @deprecated Use the apiEndpoint method of the client instance.
|
|
125
|
+
* @returns {string} The DNS address for this service.
|
|
126
|
+
*/
|
|
127
|
+
static get apiEndpoint(): string;
|
|
128
|
+
/**
|
|
129
|
+
* The DNS address for this API service.
|
|
130
|
+
* @returns {string} The DNS address for this service.
|
|
131
|
+
*/
|
|
132
|
+
get apiEndpoint(): string;
|
|
133
|
+
get universeDomain(): string;
|
|
134
|
+
/**
|
|
135
|
+
* The port for this API service.
|
|
136
|
+
* @returns {number} The default port for this service.
|
|
137
|
+
*/
|
|
138
|
+
static get port(): number;
|
|
139
|
+
/**
|
|
140
|
+
* The scopes needed to make gRPC calls for every method defined
|
|
141
|
+
* in this service.
|
|
142
|
+
* @returns {string[]} List of default scopes.
|
|
143
|
+
*/
|
|
144
|
+
static get scopes(): string[];
|
|
145
|
+
getProjectId(): Promise<string>;
|
|
146
|
+
getProjectId(callback: Callback<string, undefined, undefined>): void;
|
|
147
|
+
/**
|
|
148
|
+
* Gets a composite index.
|
|
149
|
+
*
|
|
150
|
+
* @param {Object} request
|
|
151
|
+
* The request object that will be sent.
|
|
152
|
+
* @param {string} request.name
|
|
153
|
+
* Required. A name of the form
|
|
154
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
|
|
155
|
+
* @param {object} [options]
|
|
156
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
157
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
158
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.Index|Index}.
|
|
159
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
160
|
+
* for more details and examples.
|
|
161
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.get_index.js</caption>
|
|
162
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_GetIndex_async
|
|
163
|
+
*/
|
|
164
|
+
getIndex(request?: protos.google.firestore.admin.v1.IGetIndexRequest, options?: CallOptions): Promise<[
|
|
165
|
+
protos.google.firestore.admin.v1.IIndex,
|
|
166
|
+
protos.google.firestore.admin.v1.IGetIndexRequest | undefined,
|
|
167
|
+
{} | undefined
|
|
168
|
+
]>;
|
|
169
|
+
getIndex(request: protos.google.firestore.admin.v1.IGetIndexRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IIndex, protos.google.firestore.admin.v1.IGetIndexRequest | null | undefined, {} | null | undefined>): void;
|
|
170
|
+
getIndex(request: protos.google.firestore.admin.v1.IGetIndexRequest, callback: Callback<protos.google.firestore.admin.v1.IIndex, protos.google.firestore.admin.v1.IGetIndexRequest | null | undefined, {} | null | undefined>): void;
|
|
171
|
+
/**
|
|
172
|
+
* Deletes a composite index.
|
|
173
|
+
*
|
|
174
|
+
* @param {Object} request
|
|
175
|
+
* The request object that will be sent.
|
|
176
|
+
* @param {string} request.name
|
|
177
|
+
* Required. A name of the form
|
|
178
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
|
|
179
|
+
* @param {object} [options]
|
|
180
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
181
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
182
|
+
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
|
|
183
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
184
|
+
* for more details and examples.
|
|
185
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.delete_index.js</caption>
|
|
186
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DeleteIndex_async
|
|
187
|
+
*/
|
|
188
|
+
deleteIndex(request?: protos.google.firestore.admin.v1.IDeleteIndexRequest, options?: CallOptions): Promise<[
|
|
189
|
+
protos.google.protobuf.IEmpty,
|
|
190
|
+
protos.google.firestore.admin.v1.IDeleteIndexRequest | undefined,
|
|
191
|
+
{} | undefined
|
|
192
|
+
]>;
|
|
193
|
+
deleteIndex(request: protos.google.firestore.admin.v1.IDeleteIndexRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteIndexRequest | null | undefined, {} | null | undefined>): void;
|
|
194
|
+
deleteIndex(request: protos.google.firestore.admin.v1.IDeleteIndexRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteIndexRequest | null | undefined, {} | null | undefined>): void;
|
|
195
|
+
/**
|
|
196
|
+
* Gets the metadata and configuration for a Field.
|
|
197
|
+
*
|
|
198
|
+
* @param {Object} request
|
|
199
|
+
* The request object that will be sent.
|
|
200
|
+
* @param {string} request.name
|
|
201
|
+
* Required. A name of the form
|
|
202
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}`
|
|
203
|
+
* @param {object} [options]
|
|
204
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
205
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
206
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.Field|Field}.
|
|
207
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
208
|
+
* for more details and examples.
|
|
209
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.get_field.js</caption>
|
|
210
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_GetField_async
|
|
211
|
+
*/
|
|
212
|
+
getField(request?: protos.google.firestore.admin.v1.IGetFieldRequest, options?: CallOptions): Promise<[
|
|
213
|
+
protos.google.firestore.admin.v1.IField,
|
|
214
|
+
protos.google.firestore.admin.v1.IGetFieldRequest | undefined,
|
|
215
|
+
{} | undefined
|
|
216
|
+
]>;
|
|
217
|
+
getField(request: protos.google.firestore.admin.v1.IGetFieldRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IField, protos.google.firestore.admin.v1.IGetFieldRequest | null | undefined, {} | null | undefined>): void;
|
|
218
|
+
getField(request: protos.google.firestore.admin.v1.IGetFieldRequest, callback: Callback<protos.google.firestore.admin.v1.IField, protos.google.firestore.admin.v1.IGetFieldRequest | null | undefined, {} | null | undefined>): void;
|
|
219
|
+
/**
|
|
220
|
+
* Gets information about a database.
|
|
221
|
+
*
|
|
222
|
+
* @param {Object} request
|
|
223
|
+
* The request object that will be sent.
|
|
224
|
+
* @param {string} request.name
|
|
225
|
+
* Required. A name of the form
|
|
226
|
+
* `projects/{project_id}/databases/{database_id}`
|
|
227
|
+
* @param {object} [options]
|
|
228
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
229
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
230
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.Database|Database}.
|
|
231
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
232
|
+
* for more details and examples.
|
|
233
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.get_database.js</caption>
|
|
234
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_GetDatabase_async
|
|
235
|
+
*/
|
|
236
|
+
getDatabase(request?: protos.google.firestore.admin.v1.IGetDatabaseRequest, options?: CallOptions): Promise<[
|
|
237
|
+
protos.google.firestore.admin.v1.IDatabase,
|
|
238
|
+
protos.google.firestore.admin.v1.IGetDatabaseRequest | undefined,
|
|
239
|
+
{} | undefined
|
|
240
|
+
]>;
|
|
241
|
+
getDatabase(request: protos.google.firestore.admin.v1.IGetDatabaseRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IGetDatabaseRequest | null | undefined, {} | null | undefined>): void;
|
|
242
|
+
getDatabase(request: protos.google.firestore.admin.v1.IGetDatabaseRequest, callback: Callback<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IGetDatabaseRequest | null | undefined, {} | null | undefined>): void;
|
|
243
|
+
/**
|
|
244
|
+
* List all the databases in the project.
|
|
245
|
+
*
|
|
246
|
+
* @param {Object} request
|
|
247
|
+
* The request object that will be sent.
|
|
248
|
+
* @param {string} request.parent
|
|
249
|
+
* Required. A parent name of the form
|
|
250
|
+
* `projects/{project_id}`
|
|
251
|
+
* @param {boolean} request.showDeleted
|
|
252
|
+
* If true, also returns deleted resources.
|
|
253
|
+
* @param {object} [options]
|
|
254
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
255
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
256
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.ListDatabasesResponse|ListDatabasesResponse}.
|
|
257
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
258
|
+
* for more details and examples.
|
|
259
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.list_databases.js</caption>
|
|
260
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ListDatabases_async
|
|
261
|
+
*/
|
|
262
|
+
listDatabases(request?: protos.google.firestore.admin.v1.IListDatabasesRequest, options?: CallOptions): Promise<[
|
|
263
|
+
protos.google.firestore.admin.v1.IListDatabasesResponse,
|
|
264
|
+
protos.google.firestore.admin.v1.IListDatabasesRequest | undefined,
|
|
265
|
+
{} | undefined
|
|
266
|
+
]>;
|
|
267
|
+
listDatabases(request: protos.google.firestore.admin.v1.IListDatabasesRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IListDatabasesResponse, protos.google.firestore.admin.v1.IListDatabasesRequest | null | undefined, {} | null | undefined>): void;
|
|
268
|
+
listDatabases(request: protos.google.firestore.admin.v1.IListDatabasesRequest, callback: Callback<protos.google.firestore.admin.v1.IListDatabasesResponse, protos.google.firestore.admin.v1.IListDatabasesRequest | null | undefined, {} | null | undefined>): void;
|
|
269
|
+
/**
|
|
270
|
+
* Create a user creds.
|
|
271
|
+
*
|
|
272
|
+
* @param {Object} request
|
|
273
|
+
* The request object that will be sent.
|
|
274
|
+
* @param {string} request.parent
|
|
275
|
+
* Required. A parent name of the form
|
|
276
|
+
* `projects/{project_id}/databases/{database_id}`
|
|
277
|
+
* @param {google.firestore.admin.v1.UserCreds} request.userCreds
|
|
278
|
+
* Required. The user creds to create.
|
|
279
|
+
* @param {string} request.userCredsId
|
|
280
|
+
* Required. The ID to use for the user creds, which will become the final
|
|
281
|
+
* component of the user creds's resource name.
|
|
282
|
+
*
|
|
283
|
+
* This value should be 4-63 characters. Valid characters are /{@link protos.0-9|a-z}-/
|
|
284
|
+
* with first character a letter and the last a letter or a number. Must not
|
|
285
|
+
* be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
|
|
286
|
+
* @param {object} [options]
|
|
287
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
288
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
289
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.UserCreds|UserCreds}.
|
|
290
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
291
|
+
* for more details and examples.
|
|
292
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.create_user_creds.js</caption>
|
|
293
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CreateUserCreds_async
|
|
294
|
+
*/
|
|
295
|
+
createUserCreds(request?: protos.google.firestore.admin.v1.ICreateUserCredsRequest, options?: CallOptions): Promise<[
|
|
296
|
+
protos.google.firestore.admin.v1.IUserCreds,
|
|
297
|
+
protos.google.firestore.admin.v1.ICreateUserCredsRequest | undefined,
|
|
298
|
+
{} | undefined
|
|
299
|
+
]>;
|
|
300
|
+
createUserCreds(request: protos.google.firestore.admin.v1.ICreateUserCredsRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.ICreateUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
301
|
+
createUserCreds(request: protos.google.firestore.admin.v1.ICreateUserCredsRequest, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.ICreateUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
302
|
+
/**
|
|
303
|
+
* Gets a user creds resource. Note that the returned resource does not
|
|
304
|
+
* contain the secret value itself.
|
|
305
|
+
*
|
|
306
|
+
* @param {Object} request
|
|
307
|
+
* The request object that will be sent.
|
|
308
|
+
* @param {string} request.name
|
|
309
|
+
* Required. A name of the form
|
|
310
|
+
* `projects/{project_id}/databases/{database_id}/userCreds/{user_creds_id}`
|
|
311
|
+
* @param {object} [options]
|
|
312
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
313
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
314
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.UserCreds|UserCreds}.
|
|
315
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
316
|
+
* for more details and examples.
|
|
317
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.get_user_creds.js</caption>
|
|
318
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_GetUserCreds_async
|
|
319
|
+
*/
|
|
320
|
+
getUserCreds(request?: protos.google.firestore.admin.v1.IGetUserCredsRequest, options?: CallOptions): Promise<[
|
|
321
|
+
protos.google.firestore.admin.v1.IUserCreds,
|
|
322
|
+
protos.google.firestore.admin.v1.IGetUserCredsRequest | undefined,
|
|
323
|
+
{} | undefined
|
|
324
|
+
]>;
|
|
325
|
+
getUserCreds(request: protos.google.firestore.admin.v1.IGetUserCredsRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IGetUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
326
|
+
getUserCreds(request: protos.google.firestore.admin.v1.IGetUserCredsRequest, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IGetUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
327
|
+
/**
|
|
328
|
+
* List all user creds in the database. Note that the returned resource
|
|
329
|
+
* does not contain the secret value itself.
|
|
330
|
+
*
|
|
331
|
+
* @param {Object} request
|
|
332
|
+
* The request object that will be sent.
|
|
333
|
+
* @param {string} request.parent
|
|
334
|
+
* Required. A parent database name of the form
|
|
335
|
+
* `projects/{project_id}/databases/{database_id}`
|
|
336
|
+
* @param {object} [options]
|
|
337
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
338
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
339
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.ListUserCredsResponse|ListUserCredsResponse}.
|
|
340
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
341
|
+
* for more details and examples.
|
|
342
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.list_user_creds.js</caption>
|
|
343
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ListUserCreds_async
|
|
344
|
+
*/
|
|
345
|
+
listUserCreds(request?: protos.google.firestore.admin.v1.IListUserCredsRequest, options?: CallOptions): Promise<[
|
|
346
|
+
protos.google.firestore.admin.v1.IListUserCredsResponse,
|
|
347
|
+
protos.google.firestore.admin.v1.IListUserCredsRequest | undefined,
|
|
348
|
+
{} | undefined
|
|
349
|
+
]>;
|
|
350
|
+
listUserCreds(request: protos.google.firestore.admin.v1.IListUserCredsRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IListUserCredsResponse, protos.google.firestore.admin.v1.IListUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
351
|
+
listUserCreds(request: protos.google.firestore.admin.v1.IListUserCredsRequest, callback: Callback<protos.google.firestore.admin.v1.IListUserCredsResponse, protos.google.firestore.admin.v1.IListUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
352
|
+
/**
|
|
353
|
+
* Enables a user creds. No-op if the user creds are already enabled.
|
|
354
|
+
*
|
|
355
|
+
* @param {Object} request
|
|
356
|
+
* The request object that will be sent.
|
|
357
|
+
* @param {string} request.name
|
|
358
|
+
* Required. A name of the form
|
|
359
|
+
* `projects/{project_id}/databases/{database_id}/userCreds/{user_creds_id}`
|
|
360
|
+
* @param {object} [options]
|
|
361
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
362
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
363
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.UserCreds|UserCreds}.
|
|
364
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
365
|
+
* for more details and examples.
|
|
366
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.enable_user_creds.js</caption>
|
|
367
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_EnableUserCreds_async
|
|
368
|
+
*/
|
|
369
|
+
enableUserCreds(request?: protos.google.firestore.admin.v1.IEnableUserCredsRequest, options?: CallOptions): Promise<[
|
|
370
|
+
protos.google.firestore.admin.v1.IUserCreds,
|
|
371
|
+
protos.google.firestore.admin.v1.IEnableUserCredsRequest | undefined,
|
|
372
|
+
{} | undefined
|
|
373
|
+
]>;
|
|
374
|
+
enableUserCreds(request: protos.google.firestore.admin.v1.IEnableUserCredsRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IEnableUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
375
|
+
enableUserCreds(request: protos.google.firestore.admin.v1.IEnableUserCredsRequest, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IEnableUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
376
|
+
/**
|
|
377
|
+
* Disables a user creds. No-op if the user creds are already disabled.
|
|
378
|
+
*
|
|
379
|
+
* @param {Object} request
|
|
380
|
+
* The request object that will be sent.
|
|
381
|
+
* @param {string} request.name
|
|
382
|
+
* Required. A name of the form
|
|
383
|
+
* `projects/{project_id}/databases/{database_id}/userCreds/{user_creds_id}`
|
|
384
|
+
* @param {object} [options]
|
|
385
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
386
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
387
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.UserCreds|UserCreds}.
|
|
388
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
389
|
+
* for more details and examples.
|
|
390
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.disable_user_creds.js</caption>
|
|
391
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DisableUserCreds_async
|
|
392
|
+
*/
|
|
393
|
+
disableUserCreds(request?: protos.google.firestore.admin.v1.IDisableUserCredsRequest, options?: CallOptions): Promise<[
|
|
394
|
+
protos.google.firestore.admin.v1.IUserCreds,
|
|
395
|
+
protos.google.firestore.admin.v1.IDisableUserCredsRequest | undefined,
|
|
396
|
+
{} | undefined
|
|
397
|
+
]>;
|
|
398
|
+
disableUserCreds(request: protos.google.firestore.admin.v1.IDisableUserCredsRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IDisableUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
399
|
+
disableUserCreds(request: protos.google.firestore.admin.v1.IDisableUserCredsRequest, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IDisableUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
400
|
+
/**
|
|
401
|
+
* Resets the password of a user creds.
|
|
402
|
+
*
|
|
403
|
+
* @param {Object} request
|
|
404
|
+
* The request object that will be sent.
|
|
405
|
+
* @param {string} request.name
|
|
406
|
+
* Required. A name of the form
|
|
407
|
+
* `projects/{project_id}/databases/{database_id}/userCreds/{user_creds_id}`
|
|
408
|
+
* @param {object} [options]
|
|
409
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
410
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
411
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.UserCreds|UserCreds}.
|
|
412
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
413
|
+
* for more details and examples.
|
|
414
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.reset_user_password.js</caption>
|
|
415
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ResetUserPassword_async
|
|
416
|
+
*/
|
|
417
|
+
resetUserPassword(request?: protos.google.firestore.admin.v1.IResetUserPasswordRequest, options?: CallOptions): Promise<[
|
|
418
|
+
protos.google.firestore.admin.v1.IUserCreds,
|
|
419
|
+
protos.google.firestore.admin.v1.IResetUserPasswordRequest | undefined,
|
|
420
|
+
{} | undefined
|
|
421
|
+
]>;
|
|
422
|
+
resetUserPassword(request: protos.google.firestore.admin.v1.IResetUserPasswordRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IResetUserPasswordRequest | null | undefined, {} | null | undefined>): void;
|
|
423
|
+
resetUserPassword(request: protos.google.firestore.admin.v1.IResetUserPasswordRequest, callback: Callback<protos.google.firestore.admin.v1.IUserCreds, protos.google.firestore.admin.v1.IResetUserPasswordRequest | null | undefined, {} | null | undefined>): void;
|
|
424
|
+
/**
|
|
425
|
+
* Deletes a user creds.
|
|
426
|
+
*
|
|
427
|
+
* @param {Object} request
|
|
428
|
+
* The request object that will be sent.
|
|
429
|
+
* @param {string} request.name
|
|
430
|
+
* Required. A name of the form
|
|
431
|
+
* `projects/{project_id}/databases/{database_id}/userCreds/{user_creds_id}`
|
|
432
|
+
* @param {object} [options]
|
|
433
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
434
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
435
|
+
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
|
|
436
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
437
|
+
* for more details and examples.
|
|
438
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.delete_user_creds.js</caption>
|
|
439
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DeleteUserCreds_async
|
|
440
|
+
*/
|
|
441
|
+
deleteUserCreds(request?: protos.google.firestore.admin.v1.IDeleteUserCredsRequest, options?: CallOptions): Promise<[
|
|
442
|
+
protos.google.protobuf.IEmpty,
|
|
443
|
+
protos.google.firestore.admin.v1.IDeleteUserCredsRequest | undefined,
|
|
444
|
+
{} | undefined
|
|
445
|
+
]>;
|
|
446
|
+
deleteUserCreds(request: protos.google.firestore.admin.v1.IDeleteUserCredsRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
447
|
+
deleteUserCreds(request: protos.google.firestore.admin.v1.IDeleteUserCredsRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteUserCredsRequest | null | undefined, {} | null | undefined>): void;
|
|
448
|
+
/**
|
|
449
|
+
* Gets information about a backup.
|
|
450
|
+
*
|
|
451
|
+
* @param {Object} request
|
|
452
|
+
* The request object that will be sent.
|
|
453
|
+
* @param {string} request.name
|
|
454
|
+
* Required. Name of the backup to fetch.
|
|
455
|
+
*
|
|
456
|
+
* Format is `projects/{project}/locations/{location}/backups/{backup}`.
|
|
457
|
+
* @param {object} [options]
|
|
458
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
459
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
460
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.Backup|Backup}.
|
|
461
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
462
|
+
* for more details and examples.
|
|
463
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.get_backup.js</caption>
|
|
464
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_GetBackup_async
|
|
465
|
+
*/
|
|
466
|
+
getBackup(request?: protos.google.firestore.admin.v1.IGetBackupRequest, options?: CallOptions): Promise<[
|
|
467
|
+
protos.google.firestore.admin.v1.IBackup,
|
|
468
|
+
protos.google.firestore.admin.v1.IGetBackupRequest | undefined,
|
|
469
|
+
{} | undefined
|
|
470
|
+
]>;
|
|
471
|
+
getBackup(request: protos.google.firestore.admin.v1.IGetBackupRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IBackup, protos.google.firestore.admin.v1.IGetBackupRequest | null | undefined, {} | null | undefined>): void;
|
|
472
|
+
getBackup(request: protos.google.firestore.admin.v1.IGetBackupRequest, callback: Callback<protos.google.firestore.admin.v1.IBackup, protos.google.firestore.admin.v1.IGetBackupRequest | null | undefined, {} | null | undefined>): void;
|
|
473
|
+
/**
|
|
474
|
+
* Lists all the backups.
|
|
475
|
+
*
|
|
476
|
+
* @param {Object} request
|
|
477
|
+
* The request object that will be sent.
|
|
478
|
+
* @param {string} request.parent
|
|
479
|
+
* Required. The location to list backups from.
|
|
480
|
+
*
|
|
481
|
+
* Format is `projects/{project}/locations/{location}`.
|
|
482
|
+
* Use `{location} = '-'` to list backups from all locations for the given
|
|
483
|
+
* project. This allows listing backups from a single location or from all
|
|
484
|
+
* locations.
|
|
485
|
+
* @param {string} request.filter
|
|
486
|
+
* An expression that filters the list of returned backups.
|
|
487
|
+
*
|
|
488
|
+
* A filter expression consists of a field name, a comparison operator, and a
|
|
489
|
+
* value for filtering.
|
|
490
|
+
* The value must be a string, a number, or a boolean. The comparison operator
|
|
491
|
+
* must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
|
|
492
|
+
* Colon `:` is the contains operator. Filter rules are not case sensitive.
|
|
493
|
+
*
|
|
494
|
+
* The following fields in the {@link protos.google.firestore.admin.v1.Backup|Backup} are
|
|
495
|
+
* eligible for filtering:
|
|
496
|
+
*
|
|
497
|
+
* * `database_uid` (supports `=` only)
|
|
498
|
+
* @param {object} [options]
|
|
499
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
500
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
501
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.ListBackupsResponse|ListBackupsResponse}.
|
|
502
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
503
|
+
* for more details and examples.
|
|
504
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.list_backups.js</caption>
|
|
505
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ListBackups_async
|
|
506
|
+
*/
|
|
507
|
+
listBackups(request?: protos.google.firestore.admin.v1.IListBackupsRequest, options?: CallOptions): Promise<[
|
|
508
|
+
protos.google.firestore.admin.v1.IListBackupsResponse,
|
|
509
|
+
protos.google.firestore.admin.v1.IListBackupsRequest | undefined,
|
|
510
|
+
{} | undefined
|
|
511
|
+
]>;
|
|
512
|
+
listBackups(request: protos.google.firestore.admin.v1.IListBackupsRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IListBackupsResponse, protos.google.firestore.admin.v1.IListBackupsRequest | null | undefined, {} | null | undefined>): void;
|
|
513
|
+
listBackups(request: protos.google.firestore.admin.v1.IListBackupsRequest, callback: Callback<protos.google.firestore.admin.v1.IListBackupsResponse, protos.google.firestore.admin.v1.IListBackupsRequest | null | undefined, {} | null | undefined>): void;
|
|
514
|
+
/**
|
|
515
|
+
* Deletes a backup.
|
|
516
|
+
*
|
|
517
|
+
* @param {Object} request
|
|
518
|
+
* The request object that will be sent.
|
|
519
|
+
* @param {string} request.name
|
|
520
|
+
* Required. Name of the backup to delete.
|
|
521
|
+
*
|
|
522
|
+
* format is `projects/{project}/locations/{location}/backups/{backup}`.
|
|
523
|
+
* @param {object} [options]
|
|
524
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
525
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
526
|
+
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
|
|
527
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
528
|
+
* for more details and examples.
|
|
529
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.delete_backup.js</caption>
|
|
530
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DeleteBackup_async
|
|
531
|
+
*/
|
|
532
|
+
deleteBackup(request?: protos.google.firestore.admin.v1.IDeleteBackupRequest, options?: CallOptions): Promise<[
|
|
533
|
+
protos.google.protobuf.IEmpty,
|
|
534
|
+
protos.google.firestore.admin.v1.IDeleteBackupRequest | undefined,
|
|
535
|
+
{} | undefined
|
|
536
|
+
]>;
|
|
537
|
+
deleteBackup(request: protos.google.firestore.admin.v1.IDeleteBackupRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteBackupRequest | null | undefined, {} | null | undefined>): void;
|
|
538
|
+
deleteBackup(request: protos.google.firestore.admin.v1.IDeleteBackupRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteBackupRequest | null | undefined, {} | null | undefined>): void;
|
|
539
|
+
/**
|
|
540
|
+
* Creates a backup schedule on a database.
|
|
541
|
+
* At most two backup schedules can be configured on a database, one daily
|
|
542
|
+
* backup schedule and one weekly backup schedule.
|
|
543
|
+
*
|
|
544
|
+
* @param {Object} request
|
|
545
|
+
* The request object that will be sent.
|
|
546
|
+
* @param {string} request.parent
|
|
547
|
+
* Required. The parent database.
|
|
548
|
+
*
|
|
549
|
+
* Format `projects/{project}/databases/{database}`
|
|
550
|
+
* @param {google.firestore.admin.v1.BackupSchedule} request.backupSchedule
|
|
551
|
+
* Required. The backup schedule to create.
|
|
552
|
+
* @param {object} [options]
|
|
553
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
554
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
555
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.BackupSchedule|BackupSchedule}.
|
|
556
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
557
|
+
* for more details and examples.
|
|
558
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.create_backup_schedule.js</caption>
|
|
559
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CreateBackupSchedule_async
|
|
560
|
+
*/
|
|
561
|
+
createBackupSchedule(request?: protos.google.firestore.admin.v1.ICreateBackupScheduleRequest, options?: CallOptions): Promise<[
|
|
562
|
+
protos.google.firestore.admin.v1.IBackupSchedule,
|
|
563
|
+
protos.google.firestore.admin.v1.ICreateBackupScheduleRequest | undefined,
|
|
564
|
+
{} | undefined
|
|
565
|
+
]>;
|
|
566
|
+
createBackupSchedule(request: protos.google.firestore.admin.v1.ICreateBackupScheduleRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IBackupSchedule, protos.google.firestore.admin.v1.ICreateBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
567
|
+
createBackupSchedule(request: protos.google.firestore.admin.v1.ICreateBackupScheduleRequest, callback: Callback<protos.google.firestore.admin.v1.IBackupSchedule, protos.google.firestore.admin.v1.ICreateBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
568
|
+
/**
|
|
569
|
+
* Gets information about a backup schedule.
|
|
570
|
+
*
|
|
571
|
+
* @param {Object} request
|
|
572
|
+
* The request object that will be sent.
|
|
573
|
+
* @param {string} request.name
|
|
574
|
+
* Required. The name of the backup schedule.
|
|
575
|
+
*
|
|
576
|
+
* Format
|
|
577
|
+
* `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
|
|
578
|
+
* @param {object} [options]
|
|
579
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
580
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
581
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.BackupSchedule|BackupSchedule}.
|
|
582
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
583
|
+
* for more details and examples.
|
|
584
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.get_backup_schedule.js</caption>
|
|
585
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_GetBackupSchedule_async
|
|
586
|
+
*/
|
|
587
|
+
getBackupSchedule(request?: protos.google.firestore.admin.v1.IGetBackupScheduleRequest, options?: CallOptions): Promise<[
|
|
588
|
+
protos.google.firestore.admin.v1.IBackupSchedule,
|
|
589
|
+
protos.google.firestore.admin.v1.IGetBackupScheduleRequest | undefined,
|
|
590
|
+
{} | undefined
|
|
591
|
+
]>;
|
|
592
|
+
getBackupSchedule(request: protos.google.firestore.admin.v1.IGetBackupScheduleRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IBackupSchedule, protos.google.firestore.admin.v1.IGetBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
593
|
+
getBackupSchedule(request: protos.google.firestore.admin.v1.IGetBackupScheduleRequest, callback: Callback<protos.google.firestore.admin.v1.IBackupSchedule, protos.google.firestore.admin.v1.IGetBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
594
|
+
/**
|
|
595
|
+
* List backup schedules.
|
|
596
|
+
*
|
|
597
|
+
* @param {Object} request
|
|
598
|
+
* The request object that will be sent.
|
|
599
|
+
* @param {string} request.parent
|
|
600
|
+
* Required. The parent database.
|
|
601
|
+
*
|
|
602
|
+
* Format is `projects/{project}/databases/{database}`.
|
|
603
|
+
* @param {object} [options]
|
|
604
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
605
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
606
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.ListBackupSchedulesResponse|ListBackupSchedulesResponse}.
|
|
607
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
608
|
+
* for more details and examples.
|
|
609
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.list_backup_schedules.js</caption>
|
|
610
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ListBackupSchedules_async
|
|
611
|
+
*/
|
|
612
|
+
listBackupSchedules(request?: protos.google.firestore.admin.v1.IListBackupSchedulesRequest, options?: CallOptions): Promise<[
|
|
613
|
+
protos.google.firestore.admin.v1.IListBackupSchedulesResponse,
|
|
614
|
+
protos.google.firestore.admin.v1.IListBackupSchedulesRequest | undefined,
|
|
615
|
+
{} | undefined
|
|
616
|
+
]>;
|
|
617
|
+
listBackupSchedules(request: protos.google.firestore.admin.v1.IListBackupSchedulesRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IListBackupSchedulesResponse, protos.google.firestore.admin.v1.IListBackupSchedulesRequest | null | undefined, {} | null | undefined>): void;
|
|
618
|
+
listBackupSchedules(request: protos.google.firestore.admin.v1.IListBackupSchedulesRequest, callback: Callback<protos.google.firestore.admin.v1.IListBackupSchedulesResponse, protos.google.firestore.admin.v1.IListBackupSchedulesRequest | null | undefined, {} | null | undefined>): void;
|
|
619
|
+
/**
|
|
620
|
+
* Updates a backup schedule.
|
|
621
|
+
*
|
|
622
|
+
* @param {Object} request
|
|
623
|
+
* The request object that will be sent.
|
|
624
|
+
* @param {google.firestore.admin.v1.BackupSchedule} request.backupSchedule
|
|
625
|
+
* Required. The backup schedule to update.
|
|
626
|
+
* @param {google.protobuf.FieldMask} request.updateMask
|
|
627
|
+
* The list of fields to be updated.
|
|
628
|
+
* @param {object} [options]
|
|
629
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
630
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
631
|
+
* The first element of the array is an object representing {@link protos.google.firestore.admin.v1.BackupSchedule|BackupSchedule}.
|
|
632
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
633
|
+
* for more details and examples.
|
|
634
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.update_backup_schedule.js</caption>
|
|
635
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_UpdateBackupSchedule_async
|
|
636
|
+
*/
|
|
637
|
+
updateBackupSchedule(request?: protos.google.firestore.admin.v1.IUpdateBackupScheduleRequest, options?: CallOptions): Promise<[
|
|
638
|
+
protos.google.firestore.admin.v1.IBackupSchedule,
|
|
639
|
+
protos.google.firestore.admin.v1.IUpdateBackupScheduleRequest | undefined,
|
|
640
|
+
{} | undefined
|
|
641
|
+
]>;
|
|
642
|
+
updateBackupSchedule(request: protos.google.firestore.admin.v1.IUpdateBackupScheduleRequest, options: CallOptions, callback: Callback<protos.google.firestore.admin.v1.IBackupSchedule, protos.google.firestore.admin.v1.IUpdateBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
643
|
+
updateBackupSchedule(request: protos.google.firestore.admin.v1.IUpdateBackupScheduleRequest, callback: Callback<protos.google.firestore.admin.v1.IBackupSchedule, protos.google.firestore.admin.v1.IUpdateBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
644
|
+
/**
|
|
645
|
+
* Deletes a backup schedule.
|
|
646
|
+
*
|
|
647
|
+
* @param {Object} request
|
|
648
|
+
* The request object that will be sent.
|
|
649
|
+
* @param {string} request.name
|
|
650
|
+
* Required. The name of the backup schedule.
|
|
651
|
+
*
|
|
652
|
+
* Format
|
|
653
|
+
* `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
|
|
654
|
+
* @param {object} [options]
|
|
655
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
656
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
657
|
+
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
|
|
658
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
659
|
+
* for more details and examples.
|
|
660
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.delete_backup_schedule.js</caption>
|
|
661
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DeleteBackupSchedule_async
|
|
662
|
+
*/
|
|
663
|
+
deleteBackupSchedule(request?: protos.google.firestore.admin.v1.IDeleteBackupScheduleRequest, options?: CallOptions): Promise<[
|
|
664
|
+
protos.google.protobuf.IEmpty,
|
|
665
|
+
protos.google.firestore.admin.v1.IDeleteBackupScheduleRequest | undefined,
|
|
666
|
+
{} | undefined
|
|
667
|
+
]>;
|
|
668
|
+
deleteBackupSchedule(request: protos.google.firestore.admin.v1.IDeleteBackupScheduleRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
669
|
+
deleteBackupSchedule(request: protos.google.firestore.admin.v1.IDeleteBackupScheduleRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IDeleteBackupScheduleRequest | null | undefined, {} | null | undefined>): void;
|
|
670
|
+
/**
|
|
671
|
+
* Creates a composite index. This returns a
|
|
672
|
+
* {@link protos.google.longrunning.Operation|google.longrunning.Operation} which may be
|
|
673
|
+
* used to track the status of the creation. The metadata for the operation
|
|
674
|
+
* will be the type
|
|
675
|
+
* {@link protos.google.firestore.admin.v1.IndexOperationMetadata|IndexOperationMetadata}.
|
|
676
|
+
*
|
|
677
|
+
* @param {Object} request
|
|
678
|
+
* The request object that will be sent.
|
|
679
|
+
* @param {string} request.parent
|
|
680
|
+
* Required. A parent name of the form
|
|
681
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
682
|
+
* @param {google.firestore.admin.v1.Index} request.index
|
|
683
|
+
* Required. The composite index to create.
|
|
684
|
+
* @param {object} [options]
|
|
685
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
686
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
687
|
+
* The first element of the array is an object representing
|
|
688
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
689
|
+
* you can `await` for.
|
|
690
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
691
|
+
* for more details and examples.
|
|
692
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.create_index.js</caption>
|
|
693
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CreateIndex_async
|
|
694
|
+
*/
|
|
695
|
+
createIndex(request?: protos.google.firestore.admin.v1.ICreateIndexRequest, options?: CallOptions): Promise<[
|
|
696
|
+
LROperation<protos.google.firestore.admin.v1.IIndex, protos.google.firestore.admin.v1.IIndexOperationMetadata>,
|
|
697
|
+
protos.google.longrunning.IOperation | undefined,
|
|
698
|
+
{} | undefined
|
|
699
|
+
]>;
|
|
700
|
+
createIndex(request: protos.google.firestore.admin.v1.ICreateIndexRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IIndex, protos.google.firestore.admin.v1.IIndexOperationMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
701
|
+
createIndex(request: protos.google.firestore.admin.v1.ICreateIndexRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IIndex, protos.google.firestore.admin.v1.IIndexOperationMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
702
|
+
/**
|
|
703
|
+
* Check the status of the long running operation returned by `createIndex()`.
|
|
704
|
+
* @param {String} name
|
|
705
|
+
* The operation name that will be passed.
|
|
706
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
707
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
708
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
709
|
+
* for more details and examples.
|
|
710
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.create_index.js</caption>
|
|
711
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CreateIndex_async
|
|
712
|
+
*/
|
|
713
|
+
checkCreateIndexProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Index, protos.google.firestore.admin.v1.IndexOperationMetadata>>;
|
|
714
|
+
/**
|
|
715
|
+
* Updates a field configuration. Currently, field updates apply only to
|
|
716
|
+
* single field index configuration. However, calls to
|
|
717
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.UpdateField|FirestoreAdmin.UpdateField}
|
|
718
|
+
* should provide a field mask to avoid changing any configuration that the
|
|
719
|
+
* caller isn't aware of. The field mask should be specified as: `{ paths:
|
|
720
|
+
* "index_config" }`.
|
|
721
|
+
*
|
|
722
|
+
* This call returns a
|
|
723
|
+
* {@link protos.google.longrunning.Operation|google.longrunning.Operation} which may be
|
|
724
|
+
* used to track the status of the field update. The metadata for the
|
|
725
|
+
* operation will be the type
|
|
726
|
+
* {@link protos.google.firestore.admin.v1.FieldOperationMetadata|FieldOperationMetadata}.
|
|
727
|
+
*
|
|
728
|
+
* To configure the default field settings for the database, use
|
|
729
|
+
* the special `Field` with resource name:
|
|
730
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`.
|
|
731
|
+
*
|
|
732
|
+
* @param {Object} request
|
|
733
|
+
* The request object that will be sent.
|
|
734
|
+
* @param {google.firestore.admin.v1.Field} request.field
|
|
735
|
+
* Required. The field to be updated.
|
|
736
|
+
* @param {google.protobuf.FieldMask} request.updateMask
|
|
737
|
+
* A mask, relative to the field. If specified, only configuration specified
|
|
738
|
+
* by this field_mask will be updated in the field.
|
|
739
|
+
* @param {object} [options]
|
|
740
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
741
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
742
|
+
* The first element of the array is an object representing
|
|
743
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
744
|
+
* you can `await` for.
|
|
745
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
746
|
+
* for more details and examples.
|
|
747
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.update_field.js</caption>
|
|
748
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_UpdateField_async
|
|
749
|
+
*/
|
|
750
|
+
updateField(request?: protos.google.firestore.admin.v1.IUpdateFieldRequest, options?: CallOptions): Promise<[
|
|
751
|
+
LROperation<protos.google.firestore.admin.v1.IField, protos.google.firestore.admin.v1.IFieldOperationMetadata>,
|
|
752
|
+
protos.google.longrunning.IOperation | undefined,
|
|
753
|
+
{} | undefined
|
|
754
|
+
]>;
|
|
755
|
+
updateField(request: protos.google.firestore.admin.v1.IUpdateFieldRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IField, protos.google.firestore.admin.v1.IFieldOperationMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
756
|
+
updateField(request: protos.google.firestore.admin.v1.IUpdateFieldRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IField, protos.google.firestore.admin.v1.IFieldOperationMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
757
|
+
/**
|
|
758
|
+
* Check the status of the long running operation returned by `updateField()`.
|
|
759
|
+
* @param {String} name
|
|
760
|
+
* The operation name that will be passed.
|
|
761
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
762
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
763
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
764
|
+
* for more details and examples.
|
|
765
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.update_field.js</caption>
|
|
766
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_UpdateField_async
|
|
767
|
+
*/
|
|
768
|
+
checkUpdateFieldProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Field, protos.google.firestore.admin.v1.FieldOperationMetadata>>;
|
|
769
|
+
/**
|
|
770
|
+
* Exports a copy of all or a subset of documents from Google Cloud Firestore
|
|
771
|
+
* to another storage system, such as Google Cloud Storage. Recent updates to
|
|
772
|
+
* documents may not be reflected in the export. The export occurs in the
|
|
773
|
+
* background and its progress can be monitored and managed via the
|
|
774
|
+
* Operation resource that is created. The output of an export may only be
|
|
775
|
+
* used once the associated operation is done. If an export operation is
|
|
776
|
+
* cancelled before completion it may leave partial data behind in Google
|
|
777
|
+
* Cloud Storage.
|
|
778
|
+
*
|
|
779
|
+
* For more details on export behavior and output format, refer to:
|
|
780
|
+
* https://cloud.google.com/firestore/docs/manage-data/export-import
|
|
781
|
+
*
|
|
782
|
+
* @param {Object} request
|
|
783
|
+
* The request object that will be sent.
|
|
784
|
+
* @param {string} request.name
|
|
785
|
+
* Required. Database to export. Should be of the form:
|
|
786
|
+
* `projects/{project_id}/databases/{database_id}`.
|
|
787
|
+
* @param {string[]} request.collectionIds
|
|
788
|
+
* IDs of the collection groups to export. Unspecified means all
|
|
789
|
+
* collection groups. Each collection group in this list must be unique.
|
|
790
|
+
* @param {string} request.outputUriPrefix
|
|
791
|
+
* The output URI. Currently only supports Google Cloud Storage URIs of the
|
|
792
|
+
* form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name
|
|
793
|
+
* of the Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional
|
|
794
|
+
* Google Cloud Storage namespace path. When
|
|
795
|
+
* choosing a name, be sure to consider Google Cloud Storage naming
|
|
796
|
+
* guidelines: https://cloud.google.com/storage/docs/naming.
|
|
797
|
+
* If the URI is a bucket (without a namespace path), a prefix will be
|
|
798
|
+
* generated based on the start time.
|
|
799
|
+
* @param {string[]} request.namespaceIds
|
|
800
|
+
* An empty list represents all namespaces. This is the preferred
|
|
801
|
+
* usage for databases that don't use namespaces.
|
|
802
|
+
*
|
|
803
|
+
* An empty string element represents the default namespace. This should be
|
|
804
|
+
* used if the database has data in non-default namespaces, but doesn't want
|
|
805
|
+
* to include them. Each namespace in this list must be unique.
|
|
806
|
+
* @param {google.protobuf.Timestamp} request.snapshotTime
|
|
807
|
+
* The timestamp that corresponds to the version of the database to be
|
|
808
|
+
* exported. The timestamp must be in the past, rounded to the minute and not
|
|
809
|
+
* older than
|
|
810
|
+
* {@link protos.google.firestore.admin.v1.Database.earliest_version_time|earliestVersionTime}.
|
|
811
|
+
* If specified, then the exported documents will represent a consistent view
|
|
812
|
+
* of the database at the provided time. Otherwise, there are no guarantees
|
|
813
|
+
* about the consistency of the exported documents.
|
|
814
|
+
* @param {object} [options]
|
|
815
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
816
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
817
|
+
* The first element of the array is an object representing
|
|
818
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
819
|
+
* you can `await` for.
|
|
820
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
821
|
+
* for more details and examples.
|
|
822
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.export_documents.js</caption>
|
|
823
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ExportDocuments_async
|
|
824
|
+
*/
|
|
825
|
+
exportDocuments(request?: protos.google.firestore.admin.v1.IExportDocumentsRequest, options?: CallOptions): Promise<[
|
|
826
|
+
LROperation<protos.google.firestore.admin.v1.IExportDocumentsResponse, protos.google.firestore.admin.v1.IExportDocumentsMetadata>,
|
|
827
|
+
protos.google.longrunning.IOperation | undefined,
|
|
828
|
+
{} | undefined
|
|
829
|
+
]>;
|
|
830
|
+
exportDocuments(request: protos.google.firestore.admin.v1.IExportDocumentsRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IExportDocumentsResponse, protos.google.firestore.admin.v1.IExportDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
831
|
+
exportDocuments(request: protos.google.firestore.admin.v1.IExportDocumentsRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IExportDocumentsResponse, protos.google.firestore.admin.v1.IExportDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
832
|
+
/**
|
|
833
|
+
* Check the status of the long running operation returned by `exportDocuments()`.
|
|
834
|
+
* @param {String} name
|
|
835
|
+
* The operation name that will be passed.
|
|
836
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
837
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
838
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
839
|
+
* for more details and examples.
|
|
840
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.export_documents.js</caption>
|
|
841
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ExportDocuments_async
|
|
842
|
+
*/
|
|
843
|
+
checkExportDocumentsProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.ExportDocumentsResponse, protos.google.firestore.admin.v1.ExportDocumentsMetadata>>;
|
|
844
|
+
/**
|
|
845
|
+
* Imports documents into Google Cloud Firestore. Existing documents with the
|
|
846
|
+
* same name are overwritten. The import occurs in the background and its
|
|
847
|
+
* progress can be monitored and managed via the Operation resource that is
|
|
848
|
+
* created. If an ImportDocuments operation is cancelled, it is possible
|
|
849
|
+
* that a subset of the data has already been imported to Cloud Firestore.
|
|
850
|
+
*
|
|
851
|
+
* @param {Object} request
|
|
852
|
+
* The request object that will be sent.
|
|
853
|
+
* @param {string} request.name
|
|
854
|
+
* Required. Database to import into. Should be of the form:
|
|
855
|
+
* `projects/{project_id}/databases/{database_id}`.
|
|
856
|
+
* @param {string[]} request.collectionIds
|
|
857
|
+
* IDs of the collection groups to import. Unspecified means all collection
|
|
858
|
+
* groups that were included in the export. Each collection group in this list
|
|
859
|
+
* must be unique.
|
|
860
|
+
* @param {string} request.inputUriPrefix
|
|
861
|
+
* Location of the exported files.
|
|
862
|
+
* This must match the output_uri_prefix of an ExportDocumentsResponse from
|
|
863
|
+
* an export that has completed successfully.
|
|
864
|
+
* See:
|
|
865
|
+
* {@link protos.google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix|google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix}.
|
|
866
|
+
* @param {string[]} request.namespaceIds
|
|
867
|
+
* An empty list represents all namespaces. This is the preferred
|
|
868
|
+
* usage for databases that don't use namespaces.
|
|
869
|
+
*
|
|
870
|
+
* An empty string element represents the default namespace. This should be
|
|
871
|
+
* used if the database has data in non-default namespaces, but doesn't want
|
|
872
|
+
* to include them. Each namespace in this list must be unique.
|
|
873
|
+
* @param {object} [options]
|
|
874
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
875
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
876
|
+
* The first element of the array is an object representing
|
|
877
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
878
|
+
* you can `await` for.
|
|
879
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
880
|
+
* for more details and examples.
|
|
881
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.import_documents.js</caption>
|
|
882
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ImportDocuments_async
|
|
883
|
+
*/
|
|
884
|
+
importDocuments(request?: protos.google.firestore.admin.v1.IImportDocumentsRequest, options?: CallOptions): Promise<[
|
|
885
|
+
LROperation<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IImportDocumentsMetadata>,
|
|
886
|
+
protos.google.longrunning.IOperation | undefined,
|
|
887
|
+
{} | undefined
|
|
888
|
+
]>;
|
|
889
|
+
importDocuments(request: protos.google.firestore.admin.v1.IImportDocumentsRequest, options: CallOptions, callback: Callback<LROperation<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IImportDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
890
|
+
importDocuments(request: protos.google.firestore.admin.v1.IImportDocumentsRequest, callback: Callback<LROperation<protos.google.protobuf.IEmpty, protos.google.firestore.admin.v1.IImportDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
891
|
+
/**
|
|
892
|
+
* Check the status of the long running operation returned by `importDocuments()`.
|
|
893
|
+
* @param {String} name
|
|
894
|
+
* The operation name that will be passed.
|
|
895
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
896
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
897
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
898
|
+
* for more details and examples.
|
|
899
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.import_documents.js</caption>
|
|
900
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ImportDocuments_async
|
|
901
|
+
*/
|
|
902
|
+
checkImportDocumentsProgress(name: string): Promise<LROperation<protos.google.protobuf.Empty, protos.google.firestore.admin.v1.ImportDocumentsMetadata>>;
|
|
903
|
+
/**
|
|
904
|
+
* Bulk deletes a subset of documents from Google Cloud Firestore.
|
|
905
|
+
* Documents created or updated after the underlying system starts to process
|
|
906
|
+
* the request will not be deleted. The bulk delete occurs in the background
|
|
907
|
+
* and its progress can be monitored and managed via the Operation resource
|
|
908
|
+
* that is created.
|
|
909
|
+
*
|
|
910
|
+
* For more details on bulk delete behavior, refer to:
|
|
911
|
+
* https://cloud.google.com/firestore/docs/manage-data/bulk-delete
|
|
912
|
+
*
|
|
913
|
+
* @param {Object} request
|
|
914
|
+
* The request object that will be sent.
|
|
915
|
+
* @param {string} request.name
|
|
916
|
+
* Required. Database to operate. Should be of the form:
|
|
917
|
+
* `projects/{project_id}/databases/{database_id}`.
|
|
918
|
+
* @param {string[]} [request.collectionIds]
|
|
919
|
+
* Optional. IDs of the collection groups to delete. Unspecified means all
|
|
920
|
+
* collection groups.
|
|
921
|
+
*
|
|
922
|
+
* Each collection group in this list must be unique.
|
|
923
|
+
* @param {string[]} [request.namespaceIds]
|
|
924
|
+
* Optional. Namespaces to delete.
|
|
925
|
+
*
|
|
926
|
+
* An empty list means all namespaces. This is the recommended
|
|
927
|
+
* usage for databases that don't use namespaces.
|
|
928
|
+
*
|
|
929
|
+
* An empty string element represents the default namespace. This should be
|
|
930
|
+
* used if the database has data in non-default namespaces, but doesn't want
|
|
931
|
+
* to delete from them.
|
|
932
|
+
*
|
|
933
|
+
* Each namespace in this list must be unique.
|
|
934
|
+
* @param {object} [options]
|
|
935
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
936
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
937
|
+
* The first element of the array is an object representing
|
|
938
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
939
|
+
* you can `await` for.
|
|
940
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
941
|
+
* for more details and examples.
|
|
942
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.bulk_delete_documents.js</caption>
|
|
943
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_BulkDeleteDocuments_async
|
|
944
|
+
*/
|
|
945
|
+
bulkDeleteDocuments(request?: protos.google.firestore.admin.v1.IBulkDeleteDocumentsRequest, options?: CallOptions): Promise<[
|
|
946
|
+
LROperation<protos.google.firestore.admin.v1.IBulkDeleteDocumentsResponse, protos.google.firestore.admin.v1.IBulkDeleteDocumentsMetadata>,
|
|
947
|
+
protos.google.longrunning.IOperation | undefined,
|
|
948
|
+
{} | undefined
|
|
949
|
+
]>;
|
|
950
|
+
bulkDeleteDocuments(request: protos.google.firestore.admin.v1.IBulkDeleteDocumentsRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IBulkDeleteDocumentsResponse, protos.google.firestore.admin.v1.IBulkDeleteDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
951
|
+
bulkDeleteDocuments(request: protos.google.firestore.admin.v1.IBulkDeleteDocumentsRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IBulkDeleteDocumentsResponse, protos.google.firestore.admin.v1.IBulkDeleteDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
952
|
+
/**
|
|
953
|
+
* Check the status of the long running operation returned by `bulkDeleteDocuments()`.
|
|
954
|
+
* @param {String} name
|
|
955
|
+
* The operation name that will be passed.
|
|
956
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
957
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
958
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
959
|
+
* for more details and examples.
|
|
960
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.bulk_delete_documents.js</caption>
|
|
961
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_BulkDeleteDocuments_async
|
|
962
|
+
*/
|
|
963
|
+
checkBulkDeleteDocumentsProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.BulkDeleteDocumentsResponse, protos.google.firestore.admin.v1.BulkDeleteDocumentsMetadata>>;
|
|
964
|
+
/**
|
|
965
|
+
* Create a database.
|
|
966
|
+
*
|
|
967
|
+
* @param {Object} request
|
|
968
|
+
* The request object that will be sent.
|
|
969
|
+
* @param {string} request.parent
|
|
970
|
+
* Required. A parent name of the form
|
|
971
|
+
* `projects/{project_id}`
|
|
972
|
+
* @param {google.firestore.admin.v1.Database} request.database
|
|
973
|
+
* Required. The Database to create.
|
|
974
|
+
* @param {string} request.databaseId
|
|
975
|
+
* Required. The ID to use for the database, which will become the final
|
|
976
|
+
* component of the database's resource name.
|
|
977
|
+
*
|
|
978
|
+
* This value should be 4-63 characters. Valid characters are /{@link protos.0-9|a-z}-/
|
|
979
|
+
* with first character a letter and the last a letter or a number. Must not
|
|
980
|
+
* be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
|
|
981
|
+
*
|
|
982
|
+
* "(default)" database ID is also valid if the database is Standard edition.
|
|
983
|
+
* @param {object} [options]
|
|
984
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
985
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
986
|
+
* The first element of the array is an object representing
|
|
987
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
988
|
+
* you can `await` for.
|
|
989
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
990
|
+
* for more details and examples.
|
|
991
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.create_database.js</caption>
|
|
992
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CreateDatabase_async
|
|
993
|
+
*/
|
|
994
|
+
createDatabase(request?: protos.google.firestore.admin.v1.ICreateDatabaseRequest, options?: CallOptions): Promise<[
|
|
995
|
+
LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.ICreateDatabaseMetadata>,
|
|
996
|
+
protos.google.longrunning.IOperation | undefined,
|
|
997
|
+
{} | undefined
|
|
998
|
+
]>;
|
|
999
|
+
createDatabase(request: protos.google.firestore.admin.v1.ICreateDatabaseRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.ICreateDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1000
|
+
createDatabase(request: protos.google.firestore.admin.v1.ICreateDatabaseRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.ICreateDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1001
|
+
/**
|
|
1002
|
+
* Check the status of the long running operation returned by `createDatabase()`.
|
|
1003
|
+
* @param {String} name
|
|
1004
|
+
* The operation name that will be passed.
|
|
1005
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
1006
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
1007
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1008
|
+
* for more details and examples.
|
|
1009
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.create_database.js</caption>
|
|
1010
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CreateDatabase_async
|
|
1011
|
+
*/
|
|
1012
|
+
checkCreateDatabaseProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Database, protos.google.firestore.admin.v1.CreateDatabaseMetadata>>;
|
|
1013
|
+
/**
|
|
1014
|
+
* Updates a database.
|
|
1015
|
+
*
|
|
1016
|
+
* @param {Object} request
|
|
1017
|
+
* The request object that will be sent.
|
|
1018
|
+
* @param {google.firestore.admin.v1.Database} request.database
|
|
1019
|
+
* Required. The database to update.
|
|
1020
|
+
* @param {google.protobuf.FieldMask} request.updateMask
|
|
1021
|
+
* The list of fields to be updated.
|
|
1022
|
+
* @param {object} [options]
|
|
1023
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1024
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1025
|
+
* The first element of the array is an object representing
|
|
1026
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
1027
|
+
* you can `await` for.
|
|
1028
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1029
|
+
* for more details and examples.
|
|
1030
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.update_database.js</caption>
|
|
1031
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_UpdateDatabase_async
|
|
1032
|
+
*/
|
|
1033
|
+
updateDatabase(request?: protos.google.firestore.admin.v1.IUpdateDatabaseRequest, options?: CallOptions): Promise<[
|
|
1034
|
+
LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IUpdateDatabaseMetadata>,
|
|
1035
|
+
protos.google.longrunning.IOperation | undefined,
|
|
1036
|
+
{} | undefined
|
|
1037
|
+
]>;
|
|
1038
|
+
updateDatabase(request: protos.google.firestore.admin.v1.IUpdateDatabaseRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IUpdateDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1039
|
+
updateDatabase(request: protos.google.firestore.admin.v1.IUpdateDatabaseRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IUpdateDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1040
|
+
/**
|
|
1041
|
+
* Check the status of the long running operation returned by `updateDatabase()`.
|
|
1042
|
+
* @param {String} name
|
|
1043
|
+
* The operation name that will be passed.
|
|
1044
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
1045
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
1046
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1047
|
+
* for more details and examples.
|
|
1048
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.update_database.js</caption>
|
|
1049
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_UpdateDatabase_async
|
|
1050
|
+
*/
|
|
1051
|
+
checkUpdateDatabaseProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Database, protos.google.firestore.admin.v1.UpdateDatabaseMetadata>>;
|
|
1052
|
+
/**
|
|
1053
|
+
* Deletes a database.
|
|
1054
|
+
*
|
|
1055
|
+
* @param {Object} request
|
|
1056
|
+
* The request object that will be sent.
|
|
1057
|
+
* @param {string} request.name
|
|
1058
|
+
* Required. A name of the form
|
|
1059
|
+
* `projects/{project_id}/databases/{database_id}`
|
|
1060
|
+
* @param {string} request.etag
|
|
1061
|
+
* The current etag of the Database.
|
|
1062
|
+
* If an etag is provided and does not match the current etag of the database,
|
|
1063
|
+
* deletion will be blocked and a FAILED_PRECONDITION error will be returned.
|
|
1064
|
+
* @param {object} [options]
|
|
1065
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1066
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1067
|
+
* The first element of the array is an object representing
|
|
1068
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
1069
|
+
* you can `await` for.
|
|
1070
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1071
|
+
* for more details and examples.
|
|
1072
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.delete_database.js</caption>
|
|
1073
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DeleteDatabase_async
|
|
1074
|
+
*/
|
|
1075
|
+
deleteDatabase(request?: protos.google.firestore.admin.v1.IDeleteDatabaseRequest, options?: CallOptions): Promise<[
|
|
1076
|
+
LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IDeleteDatabaseMetadata>,
|
|
1077
|
+
protos.google.longrunning.IOperation | undefined,
|
|
1078
|
+
{} | undefined
|
|
1079
|
+
]>;
|
|
1080
|
+
deleteDatabase(request: protos.google.firestore.admin.v1.IDeleteDatabaseRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IDeleteDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1081
|
+
deleteDatabase(request: protos.google.firestore.admin.v1.IDeleteDatabaseRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IDeleteDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1082
|
+
/**
|
|
1083
|
+
* Check the status of the long running operation returned by `deleteDatabase()`.
|
|
1084
|
+
* @param {String} name
|
|
1085
|
+
* The operation name that will be passed.
|
|
1086
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
1087
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
1088
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1089
|
+
* for more details and examples.
|
|
1090
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.delete_database.js</caption>
|
|
1091
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_DeleteDatabase_async
|
|
1092
|
+
*/
|
|
1093
|
+
checkDeleteDatabaseProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Database, protos.google.firestore.admin.v1.DeleteDatabaseMetadata>>;
|
|
1094
|
+
/**
|
|
1095
|
+
* Creates a new database by restoring from an existing backup.
|
|
1096
|
+
*
|
|
1097
|
+
* The new database must be in the same cloud region or multi-region location
|
|
1098
|
+
* as the existing backup. This behaves similar to
|
|
1099
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.CreateDatabase|FirestoreAdmin.CreateDatabase}
|
|
1100
|
+
* except instead of creating a new empty database, a new database is created
|
|
1101
|
+
* with the database type, index configuration, and documents from an existing
|
|
1102
|
+
* backup.
|
|
1103
|
+
*
|
|
1104
|
+
* The {@link protos.google.longrunning.Operation|long-running operation} can be used to
|
|
1105
|
+
* track the progress of the restore, with the Operation's
|
|
1106
|
+
* {@link protos.google.longrunning.Operation.metadata|metadata} field type being the
|
|
1107
|
+
* {@link protos.google.firestore.admin.v1.RestoreDatabaseMetadata|RestoreDatabaseMetadata}.
|
|
1108
|
+
* The {@link protos.google.longrunning.Operation.response|response} type is the
|
|
1109
|
+
* {@link protos.google.firestore.admin.v1.Database|Database} if the restore was
|
|
1110
|
+
* successful. The new database is not readable or writeable until the LRO has
|
|
1111
|
+
* completed.
|
|
1112
|
+
*
|
|
1113
|
+
* @param {Object} request
|
|
1114
|
+
* The request object that will be sent.
|
|
1115
|
+
* @param {string} request.parent
|
|
1116
|
+
* Required. The project to restore the database in. Format is
|
|
1117
|
+
* `projects/{project_id}`.
|
|
1118
|
+
* @param {string} request.databaseId
|
|
1119
|
+
* Required. The ID to use for the database, which will become the final
|
|
1120
|
+
* component of the database's resource name. This database ID must not be
|
|
1121
|
+
* associated with an existing database.
|
|
1122
|
+
*
|
|
1123
|
+
* This value should be 4-63 characters. Valid characters are /{@link protos.0-9|a-z}-/
|
|
1124
|
+
* with first character a letter and the last a letter or a number. Must not
|
|
1125
|
+
* be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
|
|
1126
|
+
*
|
|
1127
|
+
* "(default)" database ID is also valid if the database is Standard edition.
|
|
1128
|
+
* @param {string} request.backup
|
|
1129
|
+
* Required. Backup to restore from. Must be from the same project as the
|
|
1130
|
+
* parent.
|
|
1131
|
+
*
|
|
1132
|
+
* The restored database will be created in the same location as the source
|
|
1133
|
+
* backup.
|
|
1134
|
+
*
|
|
1135
|
+
* Format is: `projects/{project_id}/locations/{location}/backups/{backup}`
|
|
1136
|
+
* @param {google.firestore.admin.v1.Database.EncryptionConfig} [request.encryptionConfig]
|
|
1137
|
+
* Optional. Encryption configuration for the restored database.
|
|
1138
|
+
*
|
|
1139
|
+
* If this field is not specified, the restored database will use
|
|
1140
|
+
* the same encryption configuration as the backup, namely
|
|
1141
|
+
* {@link protos.google.firestore.admin.v1.Database.EncryptionConfig.use_source_encryption|use_source_encryption}.
|
|
1142
|
+
* @param {number[]} request.tags
|
|
1143
|
+
* Optional. Immutable. Tags to be bound to the restored database.
|
|
1144
|
+
*
|
|
1145
|
+
* The tags should be provided in the format of
|
|
1146
|
+
* `tagKeys/{tag_key_id} -> tagValues/{tag_value_id}`.
|
|
1147
|
+
* @param {object} [options]
|
|
1148
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1149
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1150
|
+
* The first element of the array is an object representing
|
|
1151
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
1152
|
+
* you can `await` for.
|
|
1153
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1154
|
+
* for more details and examples.
|
|
1155
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.restore_database.js</caption>
|
|
1156
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_RestoreDatabase_async
|
|
1157
|
+
*/
|
|
1158
|
+
restoreDatabase(request?: protos.google.firestore.admin.v1.IRestoreDatabaseRequest, options?: CallOptions): Promise<[
|
|
1159
|
+
LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IRestoreDatabaseMetadata>,
|
|
1160
|
+
protos.google.longrunning.IOperation | undefined,
|
|
1161
|
+
{} | undefined
|
|
1162
|
+
]>;
|
|
1163
|
+
restoreDatabase(request: protos.google.firestore.admin.v1.IRestoreDatabaseRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IRestoreDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1164
|
+
restoreDatabase(request: protos.google.firestore.admin.v1.IRestoreDatabaseRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.IRestoreDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1165
|
+
/**
|
|
1166
|
+
* Check the status of the long running operation returned by `restoreDatabase()`.
|
|
1167
|
+
* @param {String} name
|
|
1168
|
+
* The operation name that will be passed.
|
|
1169
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
1170
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
1171
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1172
|
+
* for more details and examples.
|
|
1173
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.restore_database.js</caption>
|
|
1174
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_RestoreDatabase_async
|
|
1175
|
+
*/
|
|
1176
|
+
checkRestoreDatabaseProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Database, protos.google.firestore.admin.v1.RestoreDatabaseMetadata>>;
|
|
1177
|
+
/**
|
|
1178
|
+
* Creates a new database by cloning an existing one.
|
|
1179
|
+
*
|
|
1180
|
+
* The new database must be in the same cloud region or multi-region location
|
|
1181
|
+
* as the existing database. This behaves similar to
|
|
1182
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.CreateDatabase|FirestoreAdmin.CreateDatabase}
|
|
1183
|
+
* except instead of creating a new empty database, a new database is created
|
|
1184
|
+
* with the database type, index configuration, and documents from an existing
|
|
1185
|
+
* database.
|
|
1186
|
+
*
|
|
1187
|
+
* The {@link protos.google.longrunning.Operation|long-running operation} can be used to
|
|
1188
|
+
* track the progress of the clone, with the Operation's
|
|
1189
|
+
* {@link protos.google.longrunning.Operation.metadata|metadata} field type being the
|
|
1190
|
+
* {@link protos.google.firestore.admin.v1.CloneDatabaseMetadata|CloneDatabaseMetadata}.
|
|
1191
|
+
* The {@link protos.google.longrunning.Operation.response|response} type is the
|
|
1192
|
+
* {@link protos.google.firestore.admin.v1.Database|Database} if the clone was
|
|
1193
|
+
* successful. The new database is not readable or writeable until the LRO has
|
|
1194
|
+
* completed.
|
|
1195
|
+
*
|
|
1196
|
+
* @param {Object} request
|
|
1197
|
+
* The request object that will be sent.
|
|
1198
|
+
* @param {string} request.parent
|
|
1199
|
+
* Required. The project to clone the database in. Format is
|
|
1200
|
+
* `projects/{project_id}`.
|
|
1201
|
+
* @param {string} request.databaseId
|
|
1202
|
+
* Required. The ID to use for the database, which will become the final
|
|
1203
|
+
* component of the database's resource name. This database ID must not be
|
|
1204
|
+
* associated with an existing database.
|
|
1205
|
+
*
|
|
1206
|
+
* This value should be 4-63 characters. Valid characters are /{@link protos.0-9|a-z}-/
|
|
1207
|
+
* with first character a letter and the last a letter or a number. Must not
|
|
1208
|
+
* be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
|
|
1209
|
+
*
|
|
1210
|
+
* "(default)" database ID is also valid if the database is Standard edition.
|
|
1211
|
+
* @param {google.firestore.admin.v1.PitrSnapshot} request.pitrSnapshot
|
|
1212
|
+
* Required. Specification of the PITR data to clone from. The source database
|
|
1213
|
+
* must exist.
|
|
1214
|
+
*
|
|
1215
|
+
* The cloned database will be created in the same location as the source
|
|
1216
|
+
* database.
|
|
1217
|
+
* @param {google.firestore.admin.v1.Database.EncryptionConfig} [request.encryptionConfig]
|
|
1218
|
+
* Optional. Encryption configuration for the cloned database.
|
|
1219
|
+
*
|
|
1220
|
+
* If this field is not specified, the cloned database will use
|
|
1221
|
+
* the same encryption configuration as the source database, namely
|
|
1222
|
+
* {@link protos.google.firestore.admin.v1.Database.EncryptionConfig.use_source_encryption|use_source_encryption}.
|
|
1223
|
+
* @param {number[]} request.tags
|
|
1224
|
+
* Optional. Immutable. Tags to be bound to the cloned database.
|
|
1225
|
+
*
|
|
1226
|
+
* The tags should be provided in the format of
|
|
1227
|
+
* `tagKeys/{tag_key_id} -> tagValues/{tag_value_id}`.
|
|
1228
|
+
* @param {object} [options]
|
|
1229
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1230
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1231
|
+
* The first element of the array is an object representing
|
|
1232
|
+
* a long running operation. Its `promise()` method returns a promise
|
|
1233
|
+
* you can `await` for.
|
|
1234
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1235
|
+
* for more details and examples.
|
|
1236
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.clone_database.js</caption>
|
|
1237
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CloneDatabase_async
|
|
1238
|
+
*/
|
|
1239
|
+
cloneDatabase(request?: protos.google.firestore.admin.v1.ICloneDatabaseRequest, options?: CallOptions): Promise<[
|
|
1240
|
+
LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.ICloneDatabaseMetadata>,
|
|
1241
|
+
protos.google.longrunning.IOperation | undefined,
|
|
1242
|
+
{} | undefined
|
|
1243
|
+
]>;
|
|
1244
|
+
cloneDatabase(request: protos.google.firestore.admin.v1.ICloneDatabaseRequest, options: CallOptions, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.ICloneDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1245
|
+
cloneDatabase(request: protos.google.firestore.admin.v1.ICloneDatabaseRequest, callback: Callback<LROperation<protos.google.firestore.admin.v1.IDatabase, protos.google.firestore.admin.v1.ICloneDatabaseMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
|
|
1246
|
+
/**
|
|
1247
|
+
* Check the status of the long running operation returned by `cloneDatabase()`.
|
|
1248
|
+
* @param {String} name
|
|
1249
|
+
* The operation name that will be passed.
|
|
1250
|
+
* @returns {Promise} - The promise which resolves to an object.
|
|
1251
|
+
* The decoded operation object has result and metadata field to get information from.
|
|
1252
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
|
1253
|
+
* for more details and examples.
|
|
1254
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.clone_database.js</caption>
|
|
1255
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_CloneDatabase_async
|
|
1256
|
+
*/
|
|
1257
|
+
checkCloneDatabaseProgress(name: string): Promise<LROperation<protos.google.firestore.admin.v1.Database, protos.google.firestore.admin.v1.CloneDatabaseMetadata>>;
|
|
1258
|
+
/**
|
|
1259
|
+
* Lists composite indexes.
|
|
1260
|
+
*
|
|
1261
|
+
* @param {Object} request
|
|
1262
|
+
* The request object that will be sent.
|
|
1263
|
+
* @param {string} request.parent
|
|
1264
|
+
* Required. A parent name of the form
|
|
1265
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
1266
|
+
* @param {string} request.filter
|
|
1267
|
+
* The filter to apply to list results.
|
|
1268
|
+
* @param {number} request.pageSize
|
|
1269
|
+
* The number of results to return.
|
|
1270
|
+
* @param {string} request.pageToken
|
|
1271
|
+
* A page token, returned from a previous call to
|
|
1272
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListIndexes|FirestoreAdmin.ListIndexes},
|
|
1273
|
+
* that may be used to get the next page of results.
|
|
1274
|
+
* @param {object} [options]
|
|
1275
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1276
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1277
|
+
* The first element of the array is Array of {@link protos.google.firestore.admin.v1.Index|Index}.
|
|
1278
|
+
* The client library will perform auto-pagination by default: it will call the API as many
|
|
1279
|
+
* times as needed and will merge results from all the pages into this array.
|
|
1280
|
+
* Note that it can affect your quota.
|
|
1281
|
+
* We recommend using `listIndexesAsync()`
|
|
1282
|
+
* method described below for async iteration which you can stop as needed.
|
|
1283
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1284
|
+
* for more details and examples.
|
|
1285
|
+
*/
|
|
1286
|
+
listIndexes(request?: protos.google.firestore.admin.v1.IListIndexesRequest, options?: CallOptions): Promise<[
|
|
1287
|
+
protos.google.firestore.admin.v1.IIndex[],
|
|
1288
|
+
protos.google.firestore.admin.v1.IListIndexesRequest | null,
|
|
1289
|
+
protos.google.firestore.admin.v1.IListIndexesResponse
|
|
1290
|
+
]>;
|
|
1291
|
+
listIndexes(request: protos.google.firestore.admin.v1.IListIndexesRequest, options: CallOptions, callback: PaginationCallback<protos.google.firestore.admin.v1.IListIndexesRequest, protos.google.firestore.admin.v1.IListIndexesResponse | null | undefined, protos.google.firestore.admin.v1.IIndex>): void;
|
|
1292
|
+
listIndexes(request: protos.google.firestore.admin.v1.IListIndexesRequest, callback: PaginationCallback<protos.google.firestore.admin.v1.IListIndexesRequest, protos.google.firestore.admin.v1.IListIndexesResponse | null | undefined, protos.google.firestore.admin.v1.IIndex>): void;
|
|
1293
|
+
/**
|
|
1294
|
+
* Equivalent to `listIndexes`, but returns a NodeJS Stream object.
|
|
1295
|
+
* @param {Object} request
|
|
1296
|
+
* The request object that will be sent.
|
|
1297
|
+
* @param {string} request.parent
|
|
1298
|
+
* Required. A parent name of the form
|
|
1299
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
1300
|
+
* @param {string} request.filter
|
|
1301
|
+
* The filter to apply to list results.
|
|
1302
|
+
* @param {number} request.pageSize
|
|
1303
|
+
* The number of results to return.
|
|
1304
|
+
* @param {string} request.pageToken
|
|
1305
|
+
* A page token, returned from a previous call to
|
|
1306
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListIndexes|FirestoreAdmin.ListIndexes},
|
|
1307
|
+
* that may be used to get the next page of results.
|
|
1308
|
+
* @param {object} [options]
|
|
1309
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1310
|
+
* @returns {Stream}
|
|
1311
|
+
* An object stream which emits an object representing {@link protos.google.firestore.admin.v1.Index|Index} on 'data' event.
|
|
1312
|
+
* The client library will perform auto-pagination by default: it will call the API as many
|
|
1313
|
+
* times as needed. Note that it can affect your quota.
|
|
1314
|
+
* We recommend using `listIndexesAsync()`
|
|
1315
|
+
* method described below for async iteration which you can stop as needed.
|
|
1316
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1317
|
+
* for more details and examples.
|
|
1318
|
+
*/
|
|
1319
|
+
listIndexesStream(request?: protos.google.firestore.admin.v1.IListIndexesRequest, options?: CallOptions): Transform;
|
|
1320
|
+
/**
|
|
1321
|
+
* Equivalent to `listIndexes`, but returns an iterable object.
|
|
1322
|
+
*
|
|
1323
|
+
* `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
|
|
1324
|
+
* @param {Object} request
|
|
1325
|
+
* The request object that will be sent.
|
|
1326
|
+
* @param {string} request.parent
|
|
1327
|
+
* Required. A parent name of the form
|
|
1328
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
1329
|
+
* @param {string} request.filter
|
|
1330
|
+
* The filter to apply to list results.
|
|
1331
|
+
* @param {number} request.pageSize
|
|
1332
|
+
* The number of results to return.
|
|
1333
|
+
* @param {string} request.pageToken
|
|
1334
|
+
* A page token, returned from a previous call to
|
|
1335
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListIndexes|FirestoreAdmin.ListIndexes},
|
|
1336
|
+
* that may be used to get the next page of results.
|
|
1337
|
+
* @param {object} [options]
|
|
1338
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1339
|
+
* @returns {Object}
|
|
1340
|
+
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
|
|
1341
|
+
* When you iterate the returned iterable, each element will be an object representing
|
|
1342
|
+
* {@link protos.google.firestore.admin.v1.Index|Index}. The API will be called under the hood as needed, once per the page,
|
|
1343
|
+
* so you can stop the iteration when you don't need more results.
|
|
1344
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1345
|
+
* for more details and examples.
|
|
1346
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.list_indexes.js</caption>
|
|
1347
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ListIndexes_async
|
|
1348
|
+
*/
|
|
1349
|
+
listIndexesAsync(request?: protos.google.firestore.admin.v1.IListIndexesRequest, options?: CallOptions): AsyncIterable<protos.google.firestore.admin.v1.IIndex>;
|
|
1350
|
+
/**
|
|
1351
|
+
* Lists the field configuration and metadata for this database.
|
|
1352
|
+
*
|
|
1353
|
+
* Currently,
|
|
1354
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1355
|
+
* only supports listing fields that have been explicitly overridden. To issue
|
|
1356
|
+
* this query, call
|
|
1357
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1358
|
+
* with the filter set to `indexConfig.usesAncestorConfig:false` or
|
|
1359
|
+
* `ttlConfig:*`.
|
|
1360
|
+
*
|
|
1361
|
+
* @param {Object} request
|
|
1362
|
+
* The request object that will be sent.
|
|
1363
|
+
* @param {string} request.parent
|
|
1364
|
+
* Required. A parent name of the form
|
|
1365
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
1366
|
+
* @param {string} request.filter
|
|
1367
|
+
* The filter to apply to list results. Currently,
|
|
1368
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1369
|
+
* only supports listing fields that have been explicitly overridden. To issue
|
|
1370
|
+
* this query, call
|
|
1371
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1372
|
+
* with a filter that includes `indexConfig.usesAncestorConfig:false` or
|
|
1373
|
+
* `ttlConfig:*`.
|
|
1374
|
+
* @param {number} request.pageSize
|
|
1375
|
+
* The number of results to return.
|
|
1376
|
+
* @param {string} request.pageToken
|
|
1377
|
+
* A page token, returned from a previous call to
|
|
1378
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields},
|
|
1379
|
+
* that may be used to get the next page of results.
|
|
1380
|
+
* @param {object} [options]
|
|
1381
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1382
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1383
|
+
* The first element of the array is Array of {@link protos.google.firestore.admin.v1.Field|Field}.
|
|
1384
|
+
* The client library will perform auto-pagination by default: it will call the API as many
|
|
1385
|
+
* times as needed and will merge results from all the pages into this array.
|
|
1386
|
+
* Note that it can affect your quota.
|
|
1387
|
+
* We recommend using `listFieldsAsync()`
|
|
1388
|
+
* method described below for async iteration which you can stop as needed.
|
|
1389
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1390
|
+
* for more details and examples.
|
|
1391
|
+
*/
|
|
1392
|
+
listFields(request?: protos.google.firestore.admin.v1.IListFieldsRequest, options?: CallOptions): Promise<[
|
|
1393
|
+
protos.google.firestore.admin.v1.IField[],
|
|
1394
|
+
protos.google.firestore.admin.v1.IListFieldsRequest | null,
|
|
1395
|
+
protos.google.firestore.admin.v1.IListFieldsResponse
|
|
1396
|
+
]>;
|
|
1397
|
+
listFields(request: protos.google.firestore.admin.v1.IListFieldsRequest, options: CallOptions, callback: PaginationCallback<protos.google.firestore.admin.v1.IListFieldsRequest, protos.google.firestore.admin.v1.IListFieldsResponse | null | undefined, protos.google.firestore.admin.v1.IField>): void;
|
|
1398
|
+
listFields(request: protos.google.firestore.admin.v1.IListFieldsRequest, callback: PaginationCallback<protos.google.firestore.admin.v1.IListFieldsRequest, protos.google.firestore.admin.v1.IListFieldsResponse | null | undefined, protos.google.firestore.admin.v1.IField>): void;
|
|
1399
|
+
/**
|
|
1400
|
+
* Equivalent to `listFields`, but returns a NodeJS Stream object.
|
|
1401
|
+
* @param {Object} request
|
|
1402
|
+
* The request object that will be sent.
|
|
1403
|
+
* @param {string} request.parent
|
|
1404
|
+
* Required. A parent name of the form
|
|
1405
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
1406
|
+
* @param {string} request.filter
|
|
1407
|
+
* The filter to apply to list results. Currently,
|
|
1408
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1409
|
+
* only supports listing fields that have been explicitly overridden. To issue
|
|
1410
|
+
* this query, call
|
|
1411
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1412
|
+
* with a filter that includes `indexConfig.usesAncestorConfig:false` or
|
|
1413
|
+
* `ttlConfig:*`.
|
|
1414
|
+
* @param {number} request.pageSize
|
|
1415
|
+
* The number of results to return.
|
|
1416
|
+
* @param {string} request.pageToken
|
|
1417
|
+
* A page token, returned from a previous call to
|
|
1418
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields},
|
|
1419
|
+
* that may be used to get the next page of results.
|
|
1420
|
+
* @param {object} [options]
|
|
1421
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1422
|
+
* @returns {Stream}
|
|
1423
|
+
* An object stream which emits an object representing {@link protos.google.firestore.admin.v1.Field|Field} on 'data' event.
|
|
1424
|
+
* The client library will perform auto-pagination by default: it will call the API as many
|
|
1425
|
+
* times as needed. Note that it can affect your quota.
|
|
1426
|
+
* We recommend using `listFieldsAsync()`
|
|
1427
|
+
* method described below for async iteration which you can stop as needed.
|
|
1428
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1429
|
+
* for more details and examples.
|
|
1430
|
+
*/
|
|
1431
|
+
listFieldsStream(request?: protos.google.firestore.admin.v1.IListFieldsRequest, options?: CallOptions): Transform;
|
|
1432
|
+
/**
|
|
1433
|
+
* Equivalent to `listFields`, but returns an iterable object.
|
|
1434
|
+
*
|
|
1435
|
+
* `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
|
|
1436
|
+
* @param {Object} request
|
|
1437
|
+
* The request object that will be sent.
|
|
1438
|
+
* @param {string} request.parent
|
|
1439
|
+
* Required. A parent name of the form
|
|
1440
|
+
* `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
|
|
1441
|
+
* @param {string} request.filter
|
|
1442
|
+
* The filter to apply to list results. Currently,
|
|
1443
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1444
|
+
* only supports listing fields that have been explicitly overridden. To issue
|
|
1445
|
+
* this query, call
|
|
1446
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields}
|
|
1447
|
+
* with a filter that includes `indexConfig.usesAncestorConfig:false` or
|
|
1448
|
+
* `ttlConfig:*`.
|
|
1449
|
+
* @param {number} request.pageSize
|
|
1450
|
+
* The number of results to return.
|
|
1451
|
+
* @param {string} request.pageToken
|
|
1452
|
+
* A page token, returned from a previous call to
|
|
1453
|
+
* {@link protos.google.firestore.admin.v1.FirestoreAdmin.ListFields|FirestoreAdmin.ListFields},
|
|
1454
|
+
* that may be used to get the next page of results.
|
|
1455
|
+
* @param {object} [options]
|
|
1456
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1457
|
+
* @returns {Object}
|
|
1458
|
+
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
|
|
1459
|
+
* When you iterate the returned iterable, each element will be an object representing
|
|
1460
|
+
* {@link protos.google.firestore.admin.v1.Field|Field}. The API will be called under the hood as needed, once per the page,
|
|
1461
|
+
* so you can stop the iteration when you don't need more results.
|
|
1462
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1463
|
+
* for more details and examples.
|
|
1464
|
+
* @example <caption>include:samples/generated/v1/firestore_admin.list_fields.js</caption>
|
|
1465
|
+
* region_tag:firestore_v1_generated_FirestoreAdmin_ListFields_async
|
|
1466
|
+
*/
|
|
1467
|
+
listFieldsAsync(request?: protos.google.firestore.admin.v1.IListFieldsRequest, options?: CallOptions): AsyncIterable<protos.google.firestore.admin.v1.IField>;
|
|
1468
|
+
/**
|
|
1469
|
+
* Gets information about a location.
|
|
1470
|
+
*
|
|
1471
|
+
* @param {Object} request
|
|
1472
|
+
* The request object that will be sent.
|
|
1473
|
+
* @param {string} request.name
|
|
1474
|
+
* Resource name for the location.
|
|
1475
|
+
* @param {object} [options]
|
|
1476
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
|
|
1477
|
+
* @returns {Promise} - The promise which resolves to an array.
|
|
1478
|
+
* The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
|
|
1479
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
|
1480
|
+
* for more details and examples.
|
|
1481
|
+
* @example
|
|
1482
|
+
* ```
|
|
1483
|
+
* const [response] = await client.getLocation(request);
|
|
1484
|
+
* ```
|
|
1485
|
+
*/
|
|
1486
|
+
getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
|
|
1487
|
+
/**
|
|
1488
|
+
* Lists information about the supported locations for this service. Returns an iterable object.
|
|
1489
|
+
*
|
|
1490
|
+
* `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
|
|
1491
|
+
* @param {Object} request
|
|
1492
|
+
* The request object that will be sent.
|
|
1493
|
+
* @param {string} request.name
|
|
1494
|
+
* The resource that owns the locations collection, if applicable.
|
|
1495
|
+
* @param {string} request.filter
|
|
1496
|
+
* The standard list filter.
|
|
1497
|
+
* @param {number} request.pageSize
|
|
1498
|
+
* The standard list page size.
|
|
1499
|
+
* @param {string} request.pageToken
|
|
1500
|
+
* The standard list page token.
|
|
1501
|
+
* @param {object} [options]
|
|
1502
|
+
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
|
1503
|
+
* @returns {Object}
|
|
1504
|
+
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
|
|
1505
|
+
* When you iterate the returned iterable, each element will be an object representing
|
|
1506
|
+
* {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
|
|
1507
|
+
* so you can stop the iteration when you don't need more results.
|
|
1508
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
|
1509
|
+
* for more details and examples.
|
|
1510
|
+
* @example
|
|
1511
|
+
* ```
|
|
1512
|
+
* const iterable = client.listLocationsAsync(request);
|
|
1513
|
+
* for await (const response of iterable) {
|
|
1514
|
+
* // process response
|
|
1515
|
+
* }
|
|
1516
|
+
* ```
|
|
1517
|
+
*/
|
|
1518
|
+
listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
|
|
1519
|
+
/**
|
|
1520
|
+
* Gets the latest state of a long-running operation. Clients can use this
|
|
1521
|
+
* method to poll the operation result at intervals as recommended by the API
|
|
1522
|
+
* service.
|
|
1523
|
+
*
|
|
1524
|
+
* @param {Object} request - The request object that will be sent.
|
|
1525
|
+
* @param {string} request.name - The name of the operation resource.
|
|
1526
|
+
* @param {Object=} options
|
|
1527
|
+
* Optional parameters. You can override the default settings for this call,
|
|
1528
|
+
* e.g, timeout, retries, paginations, etc. See {@link
|
|
1529
|
+
* https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
|
|
1530
|
+
* for the details.
|
|
1531
|
+
* @param {function(?Error, ?Object)=} callback
|
|
1532
|
+
* The function which will be called with the result of the API call.
|
|
1533
|
+
*
|
|
1534
|
+
* The second parameter to the callback is an object representing
|
|
1535
|
+
* {@link google.longrunning.Operation | google.longrunning.Operation}.
|
|
1536
|
+
* @return {Promise} - The promise which resolves to an array.
|
|
1537
|
+
* The first element of the array is an object representing
|
|
1538
|
+
* {@link google.longrunning.Operation | google.longrunning.Operation}.
|
|
1539
|
+
* The promise has a method named "cancel" which cancels the ongoing API call.
|
|
1540
|
+
*
|
|
1541
|
+
* @example
|
|
1542
|
+
* ```
|
|
1543
|
+
* const client = longrunning.operationsClient();
|
|
1544
|
+
* const name = '';
|
|
1545
|
+
* const [response] = await client.getOperation({name});
|
|
1546
|
+
* // doThingsWith(response)
|
|
1547
|
+
* ```
|
|
1548
|
+
*/
|
|
1549
|
+
getOperation(request: protos.google.longrunning.GetOperationRequest, optionsOrCallback?: gax.CallOptions | Callback<protos.google.longrunning.Operation, protos.google.longrunning.GetOperationRequest, {} | null | undefined>, callback?: Callback<protos.google.longrunning.Operation, protos.google.longrunning.GetOperationRequest, {} | null | undefined>): Promise<[protos.google.longrunning.Operation]>;
|
|
1550
|
+
/**
|
|
1551
|
+
* Lists operations that match the specified filter in the request. If the
|
|
1552
|
+
* server doesn't support this method, it returns `UNIMPLEMENTED`. Returns an iterable object.
|
|
1553
|
+
*
|
|
1554
|
+
* For-await-of syntax is used with the iterable to recursively get response element on-demand.
|
|
1555
|
+
*
|
|
1556
|
+
* @param {Object} request - The request object that will be sent.
|
|
1557
|
+
* @param {string} request.name - The name of the operation collection.
|
|
1558
|
+
* @param {string} request.filter - The standard list filter.
|
|
1559
|
+
* @param {number=} request.pageSize -
|
|
1560
|
+
* The maximum number of resources contained in the underlying API
|
|
1561
|
+
* response. If page streaming is performed per-resource, this
|
|
1562
|
+
* parameter does not affect the return value. If page streaming is
|
|
1563
|
+
* performed per-page, this determines the maximum number of
|
|
1564
|
+
* resources in a page.
|
|
1565
|
+
* @param {Object=} options
|
|
1566
|
+
* Optional parameters. You can override the default settings for this call,
|
|
1567
|
+
* e.g, timeout, retries, paginations, etc. See {@link
|
|
1568
|
+
* https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions} for the
|
|
1569
|
+
* details.
|
|
1570
|
+
* @returns {Object}
|
|
1571
|
+
* An iterable Object that conforms to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | iteration protocols}.
|
|
1572
|
+
*
|
|
1573
|
+
* @example
|
|
1574
|
+
* ```
|
|
1575
|
+
* const client = longrunning.operationsClient();
|
|
1576
|
+
* for await (const response of client.listOperationsAsync(request));
|
|
1577
|
+
* // doThingsWith(response)
|
|
1578
|
+
* ```
|
|
1579
|
+
*/
|
|
1580
|
+
listOperationsAsync(request: protos.google.longrunning.ListOperationsRequest, options?: gax.CallOptions): AsyncIterable<protos.google.longrunning.IOperation>;
|
|
1581
|
+
/**
|
|
1582
|
+
* Starts asynchronous cancellation on a long-running operation. The server
|
|
1583
|
+
* makes a best effort to cancel the operation, but success is not
|
|
1584
|
+
* guaranteed. If the server doesn't support this method, it returns
|
|
1585
|
+
* `google.rpc.Code.UNIMPLEMENTED`. Clients can use
|
|
1586
|
+
* {@link Operations.GetOperation} or
|
|
1587
|
+
* other methods to check whether the cancellation succeeded or whether the
|
|
1588
|
+
* operation completed despite cancellation. On successful cancellation,
|
|
1589
|
+
* the operation is not deleted; instead, it becomes an operation with
|
|
1590
|
+
* an {@link Operation.error} value with a {@link google.rpc.Status.code} of
|
|
1591
|
+
* 1, corresponding to `Code.CANCELLED`.
|
|
1592
|
+
*
|
|
1593
|
+
* @param {Object} request - The request object that will be sent.
|
|
1594
|
+
* @param {string} request.name - The name of the operation resource to be cancelled.
|
|
1595
|
+
* @param {Object=} options
|
|
1596
|
+
* Optional parameters. You can override the default settings for this call,
|
|
1597
|
+
* e.g, timeout, retries, paginations, etc. See {@link
|
|
1598
|
+
* https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions} for the
|
|
1599
|
+
* details.
|
|
1600
|
+
* @param {function(?Error)=} callback
|
|
1601
|
+
* The function which will be called with the result of the API call.
|
|
1602
|
+
* @return {Promise} - The promise which resolves when API call finishes.
|
|
1603
|
+
* The promise has a method named "cancel" which cancels the ongoing API
|
|
1604
|
+
* call.
|
|
1605
|
+
*
|
|
1606
|
+
* @example
|
|
1607
|
+
* ```
|
|
1608
|
+
* const client = longrunning.operationsClient();
|
|
1609
|
+
* await client.cancelOperation({name: ''});
|
|
1610
|
+
* ```
|
|
1611
|
+
*/
|
|
1612
|
+
cancelOperation(request: protos.google.longrunning.CancelOperationRequest, optionsOrCallback?: gax.CallOptions | Callback<protos.google.longrunning.CancelOperationRequest, protos.google.protobuf.Empty, {} | undefined | null>, callback?: Callback<protos.google.longrunning.CancelOperationRequest, protos.google.protobuf.Empty, {} | undefined | null>): Promise<protos.google.protobuf.Empty>;
|
|
1613
|
+
/**
|
|
1614
|
+
* Deletes a long-running operation. This method indicates that the client is
|
|
1615
|
+
* no longer interested in the operation result. It does not cancel the
|
|
1616
|
+
* operation. If the server doesn't support this method, it returns
|
|
1617
|
+
* `google.rpc.Code.UNIMPLEMENTED`.
|
|
1618
|
+
*
|
|
1619
|
+
* @param {Object} request - The request object that will be sent.
|
|
1620
|
+
* @param {string} request.name - The name of the operation resource to be deleted.
|
|
1621
|
+
* @param {Object=} options
|
|
1622
|
+
* Optional parameters. You can override the default settings for this call,
|
|
1623
|
+
* e.g, timeout, retries, paginations, etc. See {@link
|
|
1624
|
+
* https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
|
|
1625
|
+
* for the details.
|
|
1626
|
+
* @param {function(?Error)=} callback
|
|
1627
|
+
* The function which will be called with the result of the API call.
|
|
1628
|
+
* @return {Promise} - The promise which resolves when API call finishes.
|
|
1629
|
+
* The promise has a method named "cancel" which cancels the ongoing API
|
|
1630
|
+
* call.
|
|
1631
|
+
*
|
|
1632
|
+
* @example
|
|
1633
|
+
* ```
|
|
1634
|
+
* const client = longrunning.operationsClient();
|
|
1635
|
+
* await client.deleteOperation({name: ''});
|
|
1636
|
+
* ```
|
|
1637
|
+
*/
|
|
1638
|
+
deleteOperation(request: protos.google.longrunning.DeleteOperationRequest, optionsOrCallback?: gax.CallOptions | Callback<protos.google.protobuf.Empty, protos.google.longrunning.DeleteOperationRequest, {} | null | undefined>, callback?: Callback<protos.google.protobuf.Empty, protos.google.longrunning.DeleteOperationRequest, {} | null | undefined>): Promise<protos.google.protobuf.Empty>;
|
|
1639
|
+
/**
|
|
1640
|
+
* Return a fully-qualified backup resource name string.
|
|
1641
|
+
*
|
|
1642
|
+
* @param {string} project
|
|
1643
|
+
* @param {string} location
|
|
1644
|
+
* @param {string} backup
|
|
1645
|
+
* @returns {string} Resource name string.
|
|
1646
|
+
*/
|
|
1647
|
+
backupPath(project: string, location: string, backup: string): string;
|
|
1648
|
+
/**
|
|
1649
|
+
* Parse the project from Backup resource.
|
|
1650
|
+
*
|
|
1651
|
+
* @param {string} backupName
|
|
1652
|
+
* A fully-qualified path representing Backup resource.
|
|
1653
|
+
* @returns {string} A string representing the project.
|
|
1654
|
+
*/
|
|
1655
|
+
matchProjectFromBackupName(backupName: string): string | number;
|
|
1656
|
+
/**
|
|
1657
|
+
* Parse the location from Backup resource.
|
|
1658
|
+
*
|
|
1659
|
+
* @param {string} backupName
|
|
1660
|
+
* A fully-qualified path representing Backup resource.
|
|
1661
|
+
* @returns {string} A string representing the location.
|
|
1662
|
+
*/
|
|
1663
|
+
matchLocationFromBackupName(backupName: string): string | number;
|
|
1664
|
+
/**
|
|
1665
|
+
* Parse the backup from Backup resource.
|
|
1666
|
+
*
|
|
1667
|
+
* @param {string} backupName
|
|
1668
|
+
* A fully-qualified path representing Backup resource.
|
|
1669
|
+
* @returns {string} A string representing the backup.
|
|
1670
|
+
*/
|
|
1671
|
+
matchBackupFromBackupName(backupName: string): string | number;
|
|
1672
|
+
/**
|
|
1673
|
+
* Return a fully-qualified backupSchedule resource name string.
|
|
1674
|
+
*
|
|
1675
|
+
* @param {string} project
|
|
1676
|
+
* @param {string} database
|
|
1677
|
+
* @param {string} backup_schedule
|
|
1678
|
+
* @returns {string} Resource name string.
|
|
1679
|
+
*/
|
|
1680
|
+
backupSchedulePath(project: string, database: string, backupSchedule: string): string;
|
|
1681
|
+
/**
|
|
1682
|
+
* Parse the project from BackupSchedule resource.
|
|
1683
|
+
*
|
|
1684
|
+
* @param {string} backupScheduleName
|
|
1685
|
+
* A fully-qualified path representing BackupSchedule resource.
|
|
1686
|
+
* @returns {string} A string representing the project.
|
|
1687
|
+
*/
|
|
1688
|
+
matchProjectFromBackupScheduleName(backupScheduleName: string): string | number;
|
|
1689
|
+
/**
|
|
1690
|
+
* Parse the database from BackupSchedule resource.
|
|
1691
|
+
*
|
|
1692
|
+
* @param {string} backupScheduleName
|
|
1693
|
+
* A fully-qualified path representing BackupSchedule resource.
|
|
1694
|
+
* @returns {string} A string representing the database.
|
|
1695
|
+
*/
|
|
1696
|
+
matchDatabaseFromBackupScheduleName(backupScheduleName: string): string | number;
|
|
1697
|
+
/**
|
|
1698
|
+
* Parse the backup_schedule from BackupSchedule resource.
|
|
1699
|
+
*
|
|
1700
|
+
* @param {string} backupScheduleName
|
|
1701
|
+
* A fully-qualified path representing BackupSchedule resource.
|
|
1702
|
+
* @returns {string} A string representing the backup_schedule.
|
|
1703
|
+
*/
|
|
1704
|
+
matchBackupScheduleFromBackupScheduleName(backupScheduleName: string): string | number;
|
|
1705
|
+
/**
|
|
1706
|
+
* Return a fully-qualified collectionGroup resource name string.
|
|
1707
|
+
*
|
|
1708
|
+
* @param {string} project
|
|
1709
|
+
* @param {string} database
|
|
1710
|
+
* @param {string} collection
|
|
1711
|
+
* @returns {string} Resource name string.
|
|
1712
|
+
*/
|
|
1713
|
+
collectionGroupPath(project: string, database: string, collection: string): string;
|
|
1714
|
+
/**
|
|
1715
|
+
* Parse the project from CollectionGroup resource.
|
|
1716
|
+
*
|
|
1717
|
+
* @param {string} collectionGroupName
|
|
1718
|
+
* A fully-qualified path representing CollectionGroup resource.
|
|
1719
|
+
* @returns {string} A string representing the project.
|
|
1720
|
+
*/
|
|
1721
|
+
matchProjectFromCollectionGroupName(collectionGroupName: string): string | number;
|
|
1722
|
+
/**
|
|
1723
|
+
* Parse the database from CollectionGroup resource.
|
|
1724
|
+
*
|
|
1725
|
+
* @param {string} collectionGroupName
|
|
1726
|
+
* A fully-qualified path representing CollectionGroup resource.
|
|
1727
|
+
* @returns {string} A string representing the database.
|
|
1728
|
+
*/
|
|
1729
|
+
matchDatabaseFromCollectionGroupName(collectionGroupName: string): string | number;
|
|
1730
|
+
/**
|
|
1731
|
+
* Parse the collection from CollectionGroup resource.
|
|
1732
|
+
*
|
|
1733
|
+
* @param {string} collectionGroupName
|
|
1734
|
+
* A fully-qualified path representing CollectionGroup resource.
|
|
1735
|
+
* @returns {string} A string representing the collection.
|
|
1736
|
+
*/
|
|
1737
|
+
matchCollectionFromCollectionGroupName(collectionGroupName: string): string | number;
|
|
1738
|
+
/**
|
|
1739
|
+
* Return a fully-qualified database resource name string.
|
|
1740
|
+
*
|
|
1741
|
+
* @param {string} project
|
|
1742
|
+
* @param {string} database
|
|
1743
|
+
* @returns {string} Resource name string.
|
|
1744
|
+
*/
|
|
1745
|
+
databasePath(project: string, database: string): string;
|
|
1746
|
+
/**
|
|
1747
|
+
* Parse the project from Database resource.
|
|
1748
|
+
*
|
|
1749
|
+
* @param {string} databaseName
|
|
1750
|
+
* A fully-qualified path representing Database resource.
|
|
1751
|
+
* @returns {string} A string representing the project.
|
|
1752
|
+
*/
|
|
1753
|
+
matchProjectFromDatabaseName(databaseName: string): string | number;
|
|
1754
|
+
/**
|
|
1755
|
+
* Parse the database from Database resource.
|
|
1756
|
+
*
|
|
1757
|
+
* @param {string} databaseName
|
|
1758
|
+
* A fully-qualified path representing Database resource.
|
|
1759
|
+
* @returns {string} A string representing the database.
|
|
1760
|
+
*/
|
|
1761
|
+
matchDatabaseFromDatabaseName(databaseName: string): string | number;
|
|
1762
|
+
/**
|
|
1763
|
+
* Return a fully-qualified field resource name string.
|
|
1764
|
+
*
|
|
1765
|
+
* @param {string} project
|
|
1766
|
+
* @param {string} database
|
|
1767
|
+
* @param {string} collection
|
|
1768
|
+
* @param {string} field
|
|
1769
|
+
* @returns {string} Resource name string.
|
|
1770
|
+
*/
|
|
1771
|
+
fieldPath(project: string, database: string, collection: string, field: string): string;
|
|
1772
|
+
/**
|
|
1773
|
+
* Parse the project from Field resource.
|
|
1774
|
+
*
|
|
1775
|
+
* @param {string} fieldName
|
|
1776
|
+
* A fully-qualified path representing Field resource.
|
|
1777
|
+
* @returns {string} A string representing the project.
|
|
1778
|
+
*/
|
|
1779
|
+
matchProjectFromFieldName(fieldName: string): string | number;
|
|
1780
|
+
/**
|
|
1781
|
+
* Parse the database from Field resource.
|
|
1782
|
+
*
|
|
1783
|
+
* @param {string} fieldName
|
|
1784
|
+
* A fully-qualified path representing Field resource.
|
|
1785
|
+
* @returns {string} A string representing the database.
|
|
1786
|
+
*/
|
|
1787
|
+
matchDatabaseFromFieldName(fieldName: string): string | number;
|
|
1788
|
+
/**
|
|
1789
|
+
* Parse the collection from Field resource.
|
|
1790
|
+
*
|
|
1791
|
+
* @param {string} fieldName
|
|
1792
|
+
* A fully-qualified path representing Field resource.
|
|
1793
|
+
* @returns {string} A string representing the collection.
|
|
1794
|
+
*/
|
|
1795
|
+
matchCollectionFromFieldName(fieldName: string): string | number;
|
|
1796
|
+
/**
|
|
1797
|
+
* Parse the field from Field resource.
|
|
1798
|
+
*
|
|
1799
|
+
* @param {string} fieldName
|
|
1800
|
+
* A fully-qualified path representing Field resource.
|
|
1801
|
+
* @returns {string} A string representing the field.
|
|
1802
|
+
*/
|
|
1803
|
+
matchFieldFromFieldName(fieldName: string): string | number;
|
|
1804
|
+
/**
|
|
1805
|
+
* Return a fully-qualified index resource name string.
|
|
1806
|
+
*
|
|
1807
|
+
* @param {string} project
|
|
1808
|
+
* @param {string} database
|
|
1809
|
+
* @param {string} collection
|
|
1810
|
+
* @param {string} index
|
|
1811
|
+
* @returns {string} Resource name string.
|
|
1812
|
+
*/
|
|
1813
|
+
indexPath(project: string, database: string, collection: string, index: string): string;
|
|
1814
|
+
/**
|
|
1815
|
+
* Parse the project from Index resource.
|
|
1816
|
+
*
|
|
1817
|
+
* @param {string} indexName
|
|
1818
|
+
* A fully-qualified path representing Index resource.
|
|
1819
|
+
* @returns {string} A string representing the project.
|
|
1820
|
+
*/
|
|
1821
|
+
matchProjectFromIndexName(indexName: string): string | number;
|
|
1822
|
+
/**
|
|
1823
|
+
* Parse the database from Index resource.
|
|
1824
|
+
*
|
|
1825
|
+
* @param {string} indexName
|
|
1826
|
+
* A fully-qualified path representing Index resource.
|
|
1827
|
+
* @returns {string} A string representing the database.
|
|
1828
|
+
*/
|
|
1829
|
+
matchDatabaseFromIndexName(indexName: string): string | number;
|
|
1830
|
+
/**
|
|
1831
|
+
* Parse the collection from Index resource.
|
|
1832
|
+
*
|
|
1833
|
+
* @param {string} indexName
|
|
1834
|
+
* A fully-qualified path representing Index resource.
|
|
1835
|
+
* @returns {string} A string representing the collection.
|
|
1836
|
+
*/
|
|
1837
|
+
matchCollectionFromIndexName(indexName: string): string | number;
|
|
1838
|
+
/**
|
|
1839
|
+
* Parse the index from Index resource.
|
|
1840
|
+
*
|
|
1841
|
+
* @param {string} indexName
|
|
1842
|
+
* A fully-qualified path representing Index resource.
|
|
1843
|
+
* @returns {string} A string representing the index.
|
|
1844
|
+
*/
|
|
1845
|
+
matchIndexFromIndexName(indexName: string): string | number;
|
|
1846
|
+
/**
|
|
1847
|
+
* Return a fully-qualified location resource name string.
|
|
1848
|
+
*
|
|
1849
|
+
* @param {string} project
|
|
1850
|
+
* @param {string} location
|
|
1851
|
+
* @returns {string} Resource name string.
|
|
1852
|
+
*/
|
|
1853
|
+
locationPath(project: string, location: string): string;
|
|
1854
|
+
/**
|
|
1855
|
+
* Parse the project from Location resource.
|
|
1856
|
+
*
|
|
1857
|
+
* @param {string} locationName
|
|
1858
|
+
* A fully-qualified path representing Location resource.
|
|
1859
|
+
* @returns {string} A string representing the project.
|
|
1860
|
+
*/
|
|
1861
|
+
matchProjectFromLocationName(locationName: string): string | number;
|
|
1862
|
+
/**
|
|
1863
|
+
* Parse the location from Location resource.
|
|
1864
|
+
*
|
|
1865
|
+
* @param {string} locationName
|
|
1866
|
+
* A fully-qualified path representing Location resource.
|
|
1867
|
+
* @returns {string} A string representing the location.
|
|
1868
|
+
*/
|
|
1869
|
+
matchLocationFromLocationName(locationName: string): string | number;
|
|
1870
|
+
/**
|
|
1871
|
+
* Return a fully-qualified project resource name string.
|
|
1872
|
+
*
|
|
1873
|
+
* @param {string} project
|
|
1874
|
+
* @returns {string} Resource name string.
|
|
1875
|
+
*/
|
|
1876
|
+
projectPath(project: string): string;
|
|
1877
|
+
/**
|
|
1878
|
+
* Parse the project from Project resource.
|
|
1879
|
+
*
|
|
1880
|
+
* @param {string} projectName
|
|
1881
|
+
* A fully-qualified path representing Project resource.
|
|
1882
|
+
* @returns {string} A string representing the project.
|
|
1883
|
+
*/
|
|
1884
|
+
matchProjectFromProjectName(projectName: string): string | number;
|
|
1885
|
+
/**
|
|
1886
|
+
* Return a fully-qualified userCreds resource name string.
|
|
1887
|
+
*
|
|
1888
|
+
* @param {string} project
|
|
1889
|
+
* @param {string} database
|
|
1890
|
+
* @param {string} user_creds
|
|
1891
|
+
* @returns {string} Resource name string.
|
|
1892
|
+
*/
|
|
1893
|
+
userCredsPath(project: string, database: string, userCreds: string): string;
|
|
1894
|
+
/**
|
|
1895
|
+
* Parse the project from UserCreds resource.
|
|
1896
|
+
*
|
|
1897
|
+
* @param {string} userCredsName
|
|
1898
|
+
* A fully-qualified path representing UserCreds resource.
|
|
1899
|
+
* @returns {string} A string representing the project.
|
|
1900
|
+
*/
|
|
1901
|
+
matchProjectFromUserCredsName(userCredsName: string): string | number;
|
|
1902
|
+
/**
|
|
1903
|
+
* Parse the database from UserCreds resource.
|
|
1904
|
+
*
|
|
1905
|
+
* @param {string} userCredsName
|
|
1906
|
+
* A fully-qualified path representing UserCreds resource.
|
|
1907
|
+
* @returns {string} A string representing the database.
|
|
1908
|
+
*/
|
|
1909
|
+
matchDatabaseFromUserCredsName(userCredsName: string): string | number;
|
|
1910
|
+
/**
|
|
1911
|
+
* Parse the user_creds from UserCreds resource.
|
|
1912
|
+
*
|
|
1913
|
+
* @param {string} userCredsName
|
|
1914
|
+
* A fully-qualified path representing UserCreds resource.
|
|
1915
|
+
* @returns {string} A string representing the user_creds.
|
|
1916
|
+
*/
|
|
1917
|
+
matchUserCredsFromUserCredsName(userCredsName: string): string | number;
|
|
1918
|
+
/**
|
|
1919
|
+
* Terminate the gRPC channel and close the client.
|
|
1920
|
+
*
|
|
1921
|
+
* The client will no longer be usable and all future behavior is undefined.
|
|
1922
|
+
* @returns {Promise} A promise that resolves when the client is closed.
|
|
1923
|
+
*/
|
|
1924
|
+
close(): Promise<void>;
|
|
1925
|
+
}
|