@google-cloud/storage-control 0.4.0 → 0.6.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.
@@ -363,6 +363,393 @@ export declare class StorageControlClient {
363
363
  ]>;
364
364
  getManagedFolder(request: protos.google.storage.control.v2.IGetManagedFolderRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IManagedFolder, protos.google.storage.control.v2.IGetManagedFolderRequest | null | undefined, {} | null | undefined>): void;
365
365
  getManagedFolder(request: protos.google.storage.control.v2.IGetManagedFolderRequest, callback: Callback<protos.google.storage.control.v2.IManagedFolder, protos.google.storage.control.v2.IGetManagedFolderRequest | null | undefined, {} | null | undefined>): void;
366
+ /**
367
+ * Disables an Anywhere Cache instance. A disabled instance is read-only. The
368
+ * disablement could be revoked by calling ResumeAnywhereCache. The cache
369
+ * instance will be deleted automatically if it remains in the disabled state
370
+ * for at least one hour.
371
+ *
372
+ * @param {Object} request
373
+ * The request object that will be sent.
374
+ * @param {string} request.name
375
+ * Required. The name field in the request should be:
376
+ * `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
377
+ * @param {string} [request.requestId]
378
+ * Optional. A unique identifier for this request. UUID is the recommended
379
+ * format, but other formats are still accepted. This request is only
380
+ * idempotent if a `request_id` is provided.
381
+ * @param {object} [options]
382
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
383
+ * @returns {Promise} - The promise which resolves to an array.
384
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache}.
385
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
386
+ * for more details and examples.
387
+ * @example <caption>include:samples/generated/v2/storage_control.disable_anywhere_cache.js</caption>
388
+ * region_tag:storage_v2_generated_StorageControl_DisableAnywhereCache_async
389
+ */
390
+ disableAnywhereCache(request?: protos.google.storage.control.v2.IDisableAnywhereCacheRequest, options?: CallOptions): Promise<[
391
+ protos.google.storage.control.v2.IAnywhereCache,
392
+ protos.google.storage.control.v2.IDisableAnywhereCacheRequest | undefined,
393
+ {} | undefined
394
+ ]>;
395
+ disableAnywhereCache(request: protos.google.storage.control.v2.IDisableAnywhereCacheRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IDisableAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
396
+ disableAnywhereCache(request: protos.google.storage.control.v2.IDisableAnywhereCacheRequest, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IDisableAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
397
+ /**
398
+ * Pauses an Anywhere Cache instance.
399
+ *
400
+ * @param {Object} request
401
+ * The request object that will be sent.
402
+ * @param {string} request.name
403
+ * Required. The name field in the request should be:
404
+ * `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
405
+ * @param {string} [request.requestId]
406
+ * Optional. A unique identifier for this request. UUID is the recommended
407
+ * format, but other formats are still accepted. This request is only
408
+ * idempotent if a `request_id` is provided.
409
+ * @param {object} [options]
410
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
411
+ * @returns {Promise} - The promise which resolves to an array.
412
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache}.
413
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
414
+ * for more details and examples.
415
+ * @example <caption>include:samples/generated/v2/storage_control.pause_anywhere_cache.js</caption>
416
+ * region_tag:storage_v2_generated_StorageControl_PauseAnywhereCache_async
417
+ */
418
+ pauseAnywhereCache(request?: protos.google.storage.control.v2.IPauseAnywhereCacheRequest, options?: CallOptions): Promise<[
419
+ protos.google.storage.control.v2.IAnywhereCache,
420
+ protos.google.storage.control.v2.IPauseAnywhereCacheRequest | undefined,
421
+ {} | undefined
422
+ ]>;
423
+ pauseAnywhereCache(request: protos.google.storage.control.v2.IPauseAnywhereCacheRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IPauseAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
424
+ pauseAnywhereCache(request: protos.google.storage.control.v2.IPauseAnywhereCacheRequest, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IPauseAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
425
+ /**
426
+ * Resumes a disabled or paused Anywhere Cache instance.
427
+ *
428
+ * @param {Object} request
429
+ * The request object that will be sent.
430
+ * @param {string} request.name
431
+ * Required. The name field in the request should be:
432
+ * `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
433
+ * @param {string} [request.requestId]
434
+ * Optional. A unique identifier for this request. UUID is the recommended
435
+ * format, but other formats are still accepted. This request is only
436
+ * idempotent if a `request_id` is provided.
437
+ * @param {object} [options]
438
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
439
+ * @returns {Promise} - The promise which resolves to an array.
440
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache}.
441
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
442
+ * for more details and examples.
443
+ * @example <caption>include:samples/generated/v2/storage_control.resume_anywhere_cache.js</caption>
444
+ * region_tag:storage_v2_generated_StorageControl_ResumeAnywhereCache_async
445
+ */
446
+ resumeAnywhereCache(request?: protos.google.storage.control.v2.IResumeAnywhereCacheRequest, options?: CallOptions): Promise<[
447
+ protos.google.storage.control.v2.IAnywhereCache,
448
+ protos.google.storage.control.v2.IResumeAnywhereCacheRequest | undefined,
449
+ {} | undefined
450
+ ]>;
451
+ resumeAnywhereCache(request: protos.google.storage.control.v2.IResumeAnywhereCacheRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IResumeAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
452
+ resumeAnywhereCache(request: protos.google.storage.control.v2.IResumeAnywhereCacheRequest, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IResumeAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
453
+ /**
454
+ * Gets an Anywhere Cache instance.
455
+ *
456
+ * @param {Object} request
457
+ * The request object that will be sent.
458
+ * @param {string} request.name
459
+ * Required. The name field in the request should be:
460
+ * `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
461
+ * @param {string} [request.requestId]
462
+ * Optional. A unique identifier for this request. UUID is the recommended
463
+ * format, but other formats are still accepted.
464
+ * @param {object} [options]
465
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
466
+ * @returns {Promise} - The promise which resolves to an array.
467
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache}.
468
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
469
+ * for more details and examples.
470
+ * @example <caption>include:samples/generated/v2/storage_control.get_anywhere_cache.js</caption>
471
+ * region_tag:storage_v2_generated_StorageControl_GetAnywhereCache_async
472
+ */
473
+ getAnywhereCache(request?: protos.google.storage.control.v2.IGetAnywhereCacheRequest, options?: CallOptions): Promise<[
474
+ protos.google.storage.control.v2.IAnywhereCache,
475
+ protos.google.storage.control.v2.IGetAnywhereCacheRequest | undefined,
476
+ {} | undefined
477
+ ]>;
478
+ getAnywhereCache(request: protos.google.storage.control.v2.IGetAnywhereCacheRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IGetAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
479
+ getAnywhereCache(request: protos.google.storage.control.v2.IGetAnywhereCacheRequest, callback: Callback<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IGetAnywhereCacheRequest | null | undefined, {} | null | undefined>): void;
480
+ /**
481
+ * Returns the Project scoped singleton IntelligenceConfig resource.
482
+ *
483
+ * @param {Object} request
484
+ * The request object that will be sent.
485
+ * @param {string} request.name
486
+ * Required. The name of the `IntelligenceConfig` resource associated with
487
+ * your project.
488
+ *
489
+ * Format: `projects/{id}/locations/global/intelligenceConfig`
490
+ * @param {object} [options]
491
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
492
+ * @returns {Promise} - The promise which resolves to an array.
493
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.IntelligenceConfig|IntelligenceConfig}.
494
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
495
+ * for more details and examples.
496
+ * @example <caption>include:samples/generated/v2/storage_control.get_project_intelligence_config.js</caption>
497
+ * region_tag:storage_v2_generated_StorageControl_GetProjectIntelligenceConfig_async
498
+ */
499
+ getProjectIntelligenceConfig(request?: protos.google.storage.control.v2.IGetProjectIntelligenceConfigRequest, options?: CallOptions): Promise<[
500
+ protos.google.storage.control.v2.IIntelligenceConfig,
501
+ protos.google.storage.control.v2.IGetProjectIntelligenceConfigRequest | undefined,
502
+ {} | undefined
503
+ ]>;
504
+ getProjectIntelligenceConfig(request: protos.google.storage.control.v2.IGetProjectIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IGetProjectIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
505
+ getProjectIntelligenceConfig(request: protos.google.storage.control.v2.IGetProjectIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IGetProjectIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
506
+ /**
507
+ * Updates the Project scoped singleton IntelligenceConfig resource.
508
+ *
509
+ * @param {Object} request
510
+ * The request object that will be sent.
511
+ * @param {google.storage.control.v2.IntelligenceConfig} request.intelligenceConfig
512
+ * Required. The `IntelligenceConfig` resource to be updated.
513
+ * @param {google.protobuf.FieldMask} request.updateMask
514
+ * Required. The `update_mask` that specifies the fields within the
515
+ * `IntelligenceConfig` resource that should be modified by this update. Only
516
+ * the listed fields are updated.
517
+ * @param {string} [request.requestId]
518
+ * Optional. The ID that uniquely identifies the request, preventing duplicate
519
+ * processing.
520
+ * @param {object} [options]
521
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
522
+ * @returns {Promise} - The promise which resolves to an array.
523
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.IntelligenceConfig|IntelligenceConfig}.
524
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
525
+ * for more details and examples.
526
+ * @example <caption>include:samples/generated/v2/storage_control.update_project_intelligence_config.js</caption>
527
+ * region_tag:storage_v2_generated_StorageControl_UpdateProjectIntelligenceConfig_async
528
+ */
529
+ updateProjectIntelligenceConfig(request?: protos.google.storage.control.v2.IUpdateProjectIntelligenceConfigRequest, options?: CallOptions): Promise<[
530
+ protos.google.storage.control.v2.IIntelligenceConfig,
531
+ protos.google.storage.control.v2.IUpdateProjectIntelligenceConfigRequest | undefined,
532
+ {} | undefined
533
+ ]>;
534
+ updateProjectIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateProjectIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateProjectIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
535
+ updateProjectIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateProjectIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateProjectIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
536
+ /**
537
+ * Returns the Folder scoped singleton IntelligenceConfig resource.
538
+ *
539
+ * @param {Object} request
540
+ * The request object that will be sent.
541
+ * @param {string} request.name
542
+ * Required. The name of the `IntelligenceConfig` resource associated with
543
+ * your folder.
544
+ *
545
+ * Format: `folders/{id}/locations/global/intelligenceConfig`
546
+ * @param {object} [options]
547
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
548
+ * @returns {Promise} - The promise which resolves to an array.
549
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.IntelligenceConfig|IntelligenceConfig}.
550
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
551
+ * for more details and examples.
552
+ * @example <caption>include:samples/generated/v2/storage_control.get_folder_intelligence_config.js</caption>
553
+ * region_tag:storage_v2_generated_StorageControl_GetFolderIntelligenceConfig_async
554
+ */
555
+ getFolderIntelligenceConfig(request?: protos.google.storage.control.v2.IGetFolderIntelligenceConfigRequest, options?: CallOptions): Promise<[
556
+ protos.google.storage.control.v2.IIntelligenceConfig,
557
+ protos.google.storage.control.v2.IGetFolderIntelligenceConfigRequest | undefined,
558
+ {} | undefined
559
+ ]>;
560
+ getFolderIntelligenceConfig(request: protos.google.storage.control.v2.IGetFolderIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IGetFolderIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
561
+ getFolderIntelligenceConfig(request: protos.google.storage.control.v2.IGetFolderIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IGetFolderIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
562
+ /**
563
+ * Updates the Folder scoped singleton IntelligenceConfig resource.
564
+ *
565
+ * @param {Object} request
566
+ * The request object that will be sent.
567
+ * @param {google.storage.control.v2.IntelligenceConfig} request.intelligenceConfig
568
+ * Required. The `IntelligenceConfig` resource to be updated.
569
+ * @param {google.protobuf.FieldMask} request.updateMask
570
+ * Required. The `update_mask` that specifies the fields within the
571
+ * `IntelligenceConfig` resource that should be modified by this update. Only
572
+ * the listed fields are updated.
573
+ * @param {string} [request.requestId]
574
+ * Optional. The ID that uniquely identifies the request, preventing duplicate
575
+ * processing.
576
+ * @param {object} [options]
577
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
578
+ * @returns {Promise} - The promise which resolves to an array.
579
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.IntelligenceConfig|IntelligenceConfig}.
580
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
581
+ * for more details and examples.
582
+ * @example <caption>include:samples/generated/v2/storage_control.update_folder_intelligence_config.js</caption>
583
+ * region_tag:storage_v2_generated_StorageControl_UpdateFolderIntelligenceConfig_async
584
+ */
585
+ updateFolderIntelligenceConfig(request?: protos.google.storage.control.v2.IUpdateFolderIntelligenceConfigRequest, options?: CallOptions): Promise<[
586
+ protos.google.storage.control.v2.IIntelligenceConfig,
587
+ protos.google.storage.control.v2.IUpdateFolderIntelligenceConfigRequest | undefined,
588
+ {} | undefined
589
+ ]>;
590
+ updateFolderIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateFolderIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateFolderIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
591
+ updateFolderIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateFolderIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateFolderIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
592
+ /**
593
+ * Returns the Organization scoped singleton IntelligenceConfig resource.
594
+ *
595
+ * @param {Object} request
596
+ * The request object that will be sent.
597
+ * @param {string} request.name
598
+ * Required. The name of the `IntelligenceConfig` resource associated with
599
+ * your organization.
600
+ *
601
+ * Format: `organizations/{org_id}/locations/global/intelligenceConfig`
602
+ * @param {object} [options]
603
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
604
+ * @returns {Promise} - The promise which resolves to an array.
605
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.IntelligenceConfig|IntelligenceConfig}.
606
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
607
+ * for more details and examples.
608
+ * @example <caption>include:samples/generated/v2/storage_control.get_organization_intelligence_config.js</caption>
609
+ * region_tag:storage_v2_generated_StorageControl_GetOrganizationIntelligenceConfig_async
610
+ */
611
+ getOrganizationIntelligenceConfig(request?: protos.google.storage.control.v2.IGetOrganizationIntelligenceConfigRequest, options?: CallOptions): Promise<[
612
+ protos.google.storage.control.v2.IIntelligenceConfig,
613
+ protos.google.storage.control.v2.IGetOrganizationIntelligenceConfigRequest | undefined,
614
+ {} | undefined
615
+ ]>;
616
+ getOrganizationIntelligenceConfig(request: protos.google.storage.control.v2.IGetOrganizationIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IGetOrganizationIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
617
+ getOrganizationIntelligenceConfig(request: protos.google.storage.control.v2.IGetOrganizationIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IGetOrganizationIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
618
+ /**
619
+ * Updates the Organization scoped singleton IntelligenceConfig resource.
620
+ *
621
+ * @param {Object} request
622
+ * The request object that will be sent.
623
+ * @param {google.storage.control.v2.IntelligenceConfig} request.intelligenceConfig
624
+ * Required. The `IntelligenceConfig` resource to be updated.
625
+ * @param {google.protobuf.FieldMask} request.updateMask
626
+ * Required. The `update_mask` that specifies the fields within the
627
+ * `IntelligenceConfig` resource that should be modified by this update. Only
628
+ * the listed fields are updated.
629
+ * @param {string} [request.requestId]
630
+ * Optional. The ID that uniquely identifies the request, preventing duplicate
631
+ * processing.
632
+ * @param {object} [options]
633
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
634
+ * @returns {Promise} - The promise which resolves to an array.
635
+ * The first element of the array is an object representing {@link protos.google.storage.control.v2.IntelligenceConfig|IntelligenceConfig}.
636
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
637
+ * for more details and examples.
638
+ * @example <caption>include:samples/generated/v2/storage_control.update_organization_intelligence_config.js</caption>
639
+ * region_tag:storage_v2_generated_StorageControl_UpdateOrganizationIntelligenceConfig_async
640
+ */
641
+ updateOrganizationIntelligenceConfig(request?: protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest, options?: CallOptions): Promise<[
642
+ protos.google.storage.control.v2.IIntelligenceConfig,
643
+ protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest | undefined,
644
+ {} | undefined
645
+ ]>;
646
+ updateOrganizationIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
647
+ updateOrganizationIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
648
+ /**
649
+ * Gets the IAM policy for a specified bucket.
650
+ * The `resource` field in the request should be
651
+ * `projects/_/buckets/{bucket}` for a bucket, or
652
+ * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
653
+ * for a managed folder.
654
+ *
655
+ * @param {Object} request
656
+ * The request object that will be sent.
657
+ * @param {string} request.resource
658
+ * REQUIRED: The resource for which the policy is being requested.
659
+ * See the operation documentation for the appropriate value for this field.
660
+ * @param {google.iam.v1.GetPolicyOptions} request.options
661
+ * OPTIONAL: A `GetPolicyOptions` object for specifying options to
662
+ * `GetIamPolicy`.
663
+ * @param {object} [options]
664
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
665
+ * @returns {Promise} - The promise which resolves to an array.
666
+ * The first element of the array is an object representing {@link protos.google.iam.v1.Policy|Policy}.
667
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
668
+ * for more details and examples.
669
+ * @example <caption>include:samples/generated/v2/storage_control.get_iam_policy.js</caption>
670
+ * region_tag:storage_v2_generated_StorageControl_GetIamPolicy_async
671
+ */
672
+ getIamPolicy(request?: protos.google.iam.v1.IGetIamPolicyRequest, options?: CallOptions): Promise<[
673
+ protos.google.iam.v1.IPolicy,
674
+ protos.google.iam.v1.IGetIamPolicyRequest | undefined,
675
+ {} | undefined
676
+ ]>;
677
+ getIamPolicy(request: protos.google.iam.v1.IGetIamPolicyRequest, options: CallOptions, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.IGetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
678
+ getIamPolicy(request: protos.google.iam.v1.IGetIamPolicyRequest, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.IGetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
679
+ /**
680
+ * Updates an IAM policy for the specified bucket.
681
+ * The `resource` field in the request should be
682
+ * `projects/_/buckets/{bucket}` for a bucket, or
683
+ * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
684
+ * for a managed folder.
685
+ *
686
+ * @param {Object} request
687
+ * The request object that will be sent.
688
+ * @param {string} request.resource
689
+ * REQUIRED: The resource for which the policy is being specified.
690
+ * See the operation documentation for the appropriate value for this field.
691
+ * @param {google.iam.v1.Policy} request.policy
692
+ * REQUIRED: The complete policy to be applied to the `resource`. The size of
693
+ * the policy is limited to a few 10s of KB. An empty policy is a
694
+ * valid policy but certain Cloud Platform services (such as Projects)
695
+ * might reject them.
696
+ * @param {google.protobuf.FieldMask} request.updateMask
697
+ * OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
698
+ * the fields in the mask will be modified. If no mask is provided, the
699
+ * following default mask is used:
700
+ *
701
+ * `paths: "bindings, etag"`
702
+ * @param {object} [options]
703
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
704
+ * @returns {Promise} - The promise which resolves to an array.
705
+ * The first element of the array is an object representing {@link protos.google.iam.v1.Policy|Policy}.
706
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
707
+ * for more details and examples.
708
+ * @example <caption>include:samples/generated/v2/storage_control.set_iam_policy.js</caption>
709
+ * region_tag:storage_v2_generated_StorageControl_SetIamPolicy_async
710
+ */
711
+ setIamPolicy(request?: protos.google.iam.v1.ISetIamPolicyRequest, options?: CallOptions): Promise<[
712
+ protos.google.iam.v1.IPolicy,
713
+ protos.google.iam.v1.ISetIamPolicyRequest | undefined,
714
+ {} | undefined
715
+ ]>;
716
+ setIamPolicy(request: protos.google.iam.v1.ISetIamPolicyRequest, options: CallOptions, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.ISetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
717
+ setIamPolicy(request: protos.google.iam.v1.ISetIamPolicyRequest, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.ISetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
718
+ /**
719
+ * Tests a set of permissions on the given bucket, object, or managed folder
720
+ * to see which, if any, are held by the caller.
721
+ * The `resource` field in the request should be
722
+ * `projects/_/buckets/{bucket}` for a bucket,
723
+ * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
724
+ * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
725
+ * for a managed folder.
726
+ *
727
+ * @param {Object} request
728
+ * The request object that will be sent.
729
+ * @param {string} request.resource
730
+ * REQUIRED: The resource for which the policy detail is being requested.
731
+ * See the operation documentation for the appropriate value for this field.
732
+ * @param {string[]} request.permissions
733
+ * The set of permissions to check for the `resource`. Permissions with
734
+ * wildcards (such as '*' or 'storage.*') are not allowed. For more
735
+ * information see
736
+ * [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
737
+ * @param {object} [options]
738
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
739
+ * @returns {Promise} - The promise which resolves to an array.
740
+ * The first element of the array is an object representing {@link protos.google.iam.v1.TestIamPermissionsResponse|TestIamPermissionsResponse}.
741
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
742
+ * for more details and examples.
743
+ * @example <caption>include:samples/generated/v2/storage_control.test_iam_permissions.js</caption>
744
+ * region_tag:storage_v2_generated_StorageControl_TestIamPermissions_async
745
+ */
746
+ testIamPermissions(request?: protos.google.iam.v1.ITestIamPermissionsRequest, options?: CallOptions): Promise<[
747
+ protos.google.iam.v1.ITestIamPermissionsResponse,
748
+ protos.google.iam.v1.ITestIamPermissionsRequest | undefined,
749
+ {} | undefined
750
+ ]>;
751
+ testIamPermissions(request: protos.google.iam.v1.ITestIamPermissionsRequest, options: CallOptions, callback: Callback<protos.google.iam.v1.ITestIamPermissionsResponse, protos.google.iam.v1.ITestIamPermissionsRequest | null | undefined, {} | null | undefined>): void;
752
+ testIamPermissions(request: protos.google.iam.v1.ITestIamPermissionsRequest, callback: Callback<protos.google.iam.v1.ITestIamPermissionsResponse, protos.google.iam.v1.ITestIamPermissionsRequest | null | undefined, {} | null | undefined>): void;
366
753
  /**
367
754
  * Renames a source folder to a destination folder. This operation is only
368
755
  * applicable to a hierarchical namespace enabled bucket. During a rename, the
@@ -417,52 +804,151 @@ export declare class StorageControlClient {
417
804
  */
418
805
  checkRenameFolderProgress(name: string): Promise<LROperation<protos.google.storage.control.v2.Folder, protos.google.storage.control.v2.RenameFolderMetadata>>;
419
806
  /**
420
- * Retrieves a list of folders. This operation is only applicable to a
421
- * hierarchical namespace enabled bucket.
807
+ * Creates an Anywhere Cache instance.
422
808
  *
423
809
  * @param {Object} request
424
810
  * The request object that will be sent.
425
811
  * @param {string} request.parent
426
- * Required. Name of the bucket in which to look for folders. The bucket must
427
- * be a hierarchical namespace enabled bucket.
428
- * @param {number} [request.pageSize]
429
- * Optional. Maximum number of folders to return in a single response. The
430
- * service will use this parameter or 1,000 items, whichever is smaller.
431
- * @param {string} [request.pageToken]
432
- * Optional. A previously-returned page token representing part of the larger
433
- * set of results to view.
434
- * @param {string} [request.prefix]
435
- * Optional. Filter results to folders whose names begin with this prefix.
436
- * If set, the value must either be an empty string or end with a '/'.
437
- * @param {string} [request.delimiter]
438
- * Optional. If set, returns results in a directory-like mode. The results
439
- * will only include folders that either exactly match the above prefix, or
440
- * are one level below the prefix. The only supported value is '/'.
441
- * @param {string} [request.lexicographicStart]
442
- * Optional. Filter results to folders whose names are lexicographically equal
443
- * to or after lexicographic_start. If lexicographic_end is also set, the
444
- * folders listed have names between lexicographic_start (inclusive) and
445
- * lexicographic_end (exclusive).
446
- * @param {string} [request.lexicographicEnd]
447
- * Optional. Filter results to folders whose names are lexicographically
448
- * before lexicographic_end. If lexicographic_start is also set, the folders
449
- * listed have names between lexicographic_start (inclusive) and
450
- * lexicographic_end (exclusive).
812
+ * Required. The bucket to which this cache belongs.
813
+ * Format: `projects/{project}/buckets/{bucket}`
814
+ * @param {google.storage.control.v2.AnywhereCache} request.anywhereCache
815
+ * Required. Properties of the Anywhere Cache instance being created.
816
+ * The parent bucket name is specified in the `parent` field. Server uses the
817
+ * default value of `ttl` or `admission_policy` if not specified in
818
+ * request.
451
819
  * @param {string} [request.requestId]
452
820
  * Optional. A unique identifier for this request. UUID is the recommended
453
- * format, but other formats are still accepted.
821
+ * format, but other formats are still accepted. This request is only
822
+ * idempotent if a `request_id` is provided.
454
823
  * @param {object} [options]
455
824
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
456
825
  * @returns {Promise} - The promise which resolves to an array.
457
- * The first element of the array is Array of {@link protos.google.storage.control.v2.Folder|Folder}.
458
- * The client library will perform auto-pagination by default: it will call the API as many
459
- * times as needed and will merge results from all the pages into this array.
460
- * Note that it can affect your quota.
461
- * We recommend using `listFoldersAsync()`
462
- * method described below for async iteration which you can stop as needed.
463
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
826
+ * The first element of the array is an object representing
827
+ * a long running operation. Its `promise()` method returns a promise
828
+ * you can `await` for.
829
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
830
+ * for more details and examples.
831
+ * @example <caption>include:samples/generated/v2/storage_control.create_anywhere_cache.js</caption>
832
+ * region_tag:storage_v2_generated_StorageControl_CreateAnywhereCache_async
833
+ */
834
+ createAnywhereCache(request?: protos.google.storage.control.v2.ICreateAnywhereCacheRequest, options?: CallOptions): Promise<[
835
+ LROperation<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.ICreateAnywhereCacheMetadata>,
836
+ protos.google.longrunning.IOperation | undefined,
837
+ {} | undefined
838
+ ]>;
839
+ createAnywhereCache(request: protos.google.storage.control.v2.ICreateAnywhereCacheRequest, options: CallOptions, callback: Callback<LROperation<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.ICreateAnywhereCacheMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
840
+ createAnywhereCache(request: protos.google.storage.control.v2.ICreateAnywhereCacheRequest, callback: Callback<LROperation<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.ICreateAnywhereCacheMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
841
+ /**
842
+ * Check the status of the long running operation returned by `createAnywhereCache()`.
843
+ * @param {String} name
844
+ * The operation name that will be passed.
845
+ * @returns {Promise} - The promise which resolves to an object.
846
+ * The decoded operation object has result and metadata field to get information from.
847
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
848
+ * for more details and examples.
849
+ * @example <caption>include:samples/generated/v2/storage_control.create_anywhere_cache.js</caption>
850
+ * region_tag:storage_v2_generated_StorageControl_CreateAnywhereCache_async
851
+ */
852
+ checkCreateAnywhereCacheProgress(name: string): Promise<LROperation<protos.google.storage.control.v2.AnywhereCache, protos.google.storage.control.v2.CreateAnywhereCacheMetadata>>;
853
+ /**
854
+ * Updates an Anywhere Cache instance. Mutable fields include `ttl` and
855
+ * `admission_policy`.
856
+ *
857
+ * @param {Object} request
858
+ * The request object that will be sent.
859
+ * @param {google.storage.control.v2.AnywhereCache} request.anywhereCache
860
+ * Required. The Anywhere Cache instance to be updated.
861
+ * @param {google.protobuf.FieldMask} request.updateMask
862
+ * Required. List of fields to be updated. Mutable fields of AnywhereCache
863
+ * include `ttl` and `admission_policy`.
864
+ *
865
+ * To specify ALL fields, specify a single field with the value `*`. Note: We
866
+ * recommend against doing this. If a new field is introduced at a later time,
867
+ * an older client updating with the `*` may accidentally reset the new
868
+ * field's value.
869
+ *
870
+ * Not specifying any fields is an error.
871
+ * @param {string} [request.requestId]
872
+ * Optional. A unique identifier for this request. UUID is the recommended
873
+ * format, but other formats are still accepted. This request is only
874
+ * idempotent if a `request_id` is provided.
875
+ * @param {object} [options]
876
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
877
+ * @returns {Promise} - The promise which resolves to an array.
878
+ * The first element of the array is an object representing
879
+ * a long running operation. Its `promise()` method returns a promise
880
+ * you can `await` for.
881
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
464
882
  * for more details and examples.
883
+ * @example <caption>include:samples/generated/v2/storage_control.update_anywhere_cache.js</caption>
884
+ * region_tag:storage_v2_generated_StorageControl_UpdateAnywhereCache_async
465
885
  */
886
+ updateAnywhereCache(request?: protos.google.storage.control.v2.IUpdateAnywhereCacheRequest, options?: CallOptions): Promise<[
887
+ LROperation<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IUpdateAnywhereCacheMetadata>,
888
+ protos.google.longrunning.IOperation | undefined,
889
+ {} | undefined
890
+ ]>;
891
+ updateAnywhereCache(request: protos.google.storage.control.v2.IUpdateAnywhereCacheRequest, options: CallOptions, callback: Callback<LROperation<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IUpdateAnywhereCacheMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
892
+ updateAnywhereCache(request: protos.google.storage.control.v2.IUpdateAnywhereCacheRequest, callback: Callback<LROperation<protos.google.storage.control.v2.IAnywhereCache, protos.google.storage.control.v2.IUpdateAnywhereCacheMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
893
+ /**
894
+ * Check the status of the long running operation returned by `updateAnywhereCache()`.
895
+ * @param {String} name
896
+ * The operation name that will be passed.
897
+ * @returns {Promise} - The promise which resolves to an object.
898
+ * The decoded operation object has result and metadata field to get information from.
899
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
900
+ * for more details and examples.
901
+ * @example <caption>include:samples/generated/v2/storage_control.update_anywhere_cache.js</caption>
902
+ * region_tag:storage_v2_generated_StorageControl_UpdateAnywhereCache_async
903
+ */
904
+ checkUpdateAnywhereCacheProgress(name: string): Promise<LROperation<protos.google.storage.control.v2.AnywhereCache, protos.google.storage.control.v2.UpdateAnywhereCacheMetadata>>;
905
+ /**
906
+ * Retrieves a list of folders. This operation is only applicable to a
907
+ * hierarchical namespace enabled bucket.
908
+ *
909
+ * @param {Object} request
910
+ * The request object that will be sent.
911
+ * @param {string} request.parent
912
+ * Required. Name of the bucket in which to look for folders. The bucket must
913
+ * be a hierarchical namespace enabled bucket.
914
+ * @param {number} [request.pageSize]
915
+ * Optional. Maximum number of folders to return in a single response. The
916
+ * service will use this parameter or 1,000 items, whichever is smaller.
917
+ * @param {string} [request.pageToken]
918
+ * Optional. A previously-returned page token representing part of the larger
919
+ * set of results to view.
920
+ * @param {string} [request.prefix]
921
+ * Optional. Filter results to folders whose names begin with this prefix.
922
+ * If set, the value must either be an empty string or end with a '/'.
923
+ * @param {string} [request.delimiter]
924
+ * Optional. If set, returns results in a directory-like mode. The results
925
+ * will only include folders that either exactly match the above prefix, or
926
+ * are one level below the prefix. The only supported value is '/'.
927
+ * @param {string} [request.lexicographicStart]
928
+ * Optional. Filter results to folders whose names are lexicographically equal
929
+ * to or after lexicographic_start. If lexicographic_end is also set, the
930
+ * folders listed have names between lexicographic_start (inclusive) and
931
+ * lexicographic_end (exclusive).
932
+ * @param {string} [request.lexicographicEnd]
933
+ * Optional. Filter results to folders whose names are lexicographically
934
+ * before lexicographic_end. If lexicographic_start is also set, the folders
935
+ * listed have names between lexicographic_start (inclusive) and
936
+ * lexicographic_end (exclusive).
937
+ * @param {string} [request.requestId]
938
+ * Optional. A unique identifier for this request. UUID is the recommended
939
+ * format, but other formats are still accepted.
940
+ * @param {object} [options]
941
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
942
+ * @returns {Promise} - The promise which resolves to an array.
943
+ * The first element of the array is Array of {@link protos.google.storage.control.v2.Folder|Folder}.
944
+ * The client library will perform auto-pagination by default: it will call the API as many
945
+ * times as needed and will merge results from all the pages into this array.
946
+ * Note that it can affect your quota.
947
+ * We recommend using `listFoldersAsync()`
948
+ * method described below for async iteration which you can stop as needed.
949
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
950
+ * for more details and examples.
951
+ */
466
952
  listFolders(request?: protos.google.storage.control.v2.IListFoldersRequest, options?: CallOptions): Promise<[
467
953
  protos.google.storage.control.v2.IFolder[],
468
954
  protos.google.storage.control.v2.IListFoldersRequest | null,
@@ -564,36 +1050,36 @@ export declare class StorageControlClient {
564
1050
  */
565
1051
  listFoldersAsync(request?: protos.google.storage.control.v2.IListFoldersRequest, options?: CallOptions): AsyncIterable<protos.google.storage.control.v2.IFolder>;
566
1052
  /**
567
- * Retrieves a list of managed folders for a given bucket.
568
- *
569
- * @param {Object} request
570
- * The request object that will be sent.
571
- * @param {string} request.parent
572
- * Required. Name of the bucket this managed folder belongs to.
573
- * @param {number} [request.pageSize]
574
- * Optional. Maximum number of managed folders to return in a single response.
575
- * The service will use this parameter or 1,000 items, whichever is smaller.
576
- * @param {string} [request.pageToken]
577
- * Optional. A previously-returned page token representing part of the larger
578
- * set of results to view.
579
- * @param {string} [request.prefix]
580
- * Optional. Filter results to match managed folders with name starting with
581
- * this prefix.
582
- * @param {string} [request.requestId]
583
- * Optional. A unique identifier for this request. UUID is the recommended
584
- * format, but other formats are still accepted.
585
- * @param {object} [options]
586
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
587
- * @returns {Promise} - The promise which resolves to an array.
588
- * The first element of the array is Array of {@link protos.google.storage.control.v2.ManagedFolder|ManagedFolder}.
589
- * The client library will perform auto-pagination by default: it will call the API as many
590
- * times as needed and will merge results from all the pages into this array.
591
- * Note that it can affect your quota.
592
- * We recommend using `listManagedFoldersAsync()`
593
- * method described below for async iteration which you can stop as needed.
594
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
595
- * for more details and examples.
596
- */
1053
+ * Retrieves a list of managed folders for a given bucket.
1054
+ *
1055
+ * @param {Object} request
1056
+ * The request object that will be sent.
1057
+ * @param {string} request.parent
1058
+ * Required. Name of the bucket this managed folder belongs to.
1059
+ * @param {number} [request.pageSize]
1060
+ * Optional. Maximum number of managed folders to return in a single response.
1061
+ * The service will use this parameter or 1,000 items, whichever is smaller.
1062
+ * @param {string} [request.pageToken]
1063
+ * Optional. A previously-returned page token representing part of the larger
1064
+ * set of results to view.
1065
+ * @param {string} [request.prefix]
1066
+ * Optional. Filter results to match managed folders with name starting with
1067
+ * this prefix.
1068
+ * @param {string} [request.requestId]
1069
+ * Optional. A unique identifier for this request. UUID is the recommended
1070
+ * format, but other formats are still accepted.
1071
+ * @param {object} [options]
1072
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
1073
+ * @returns {Promise} - The promise which resolves to an array.
1074
+ * The first element of the array is Array of {@link protos.google.storage.control.v2.ManagedFolder|ManagedFolder}.
1075
+ * The client library will perform auto-pagination by default: it will call the API as many
1076
+ * times as needed and will merge results from all the pages into this array.
1077
+ * Note that it can affect your quota.
1078
+ * We recommend using `listManagedFoldersAsync()`
1079
+ * method described below for async iteration which you can stop as needed.
1080
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
1081
+ * for more details and examples.
1082
+ */
597
1083
  listManagedFolders(request?: protos.google.storage.control.v2.IListManagedFoldersRequest, options?: CallOptions): Promise<[
598
1084
  protos.google.storage.control.v2.IManagedFolder[],
599
1085
  protos.google.storage.control.v2.IListManagedFoldersRequest | null,
@@ -665,35 +1151,127 @@ export declare class StorageControlClient {
665
1151
  */
666
1152
  listManagedFoldersAsync(request?: protos.google.storage.control.v2.IListManagedFoldersRequest, options?: CallOptions): AsyncIterable<protos.google.storage.control.v2.IManagedFolder>;
667
1153
  /**
668
- * Gets the latest state of a long-running operation. Clients can use this
669
- * method to poll the operation result at intervals as recommended by the API
670
- * service.
671
- *
672
- * @param {Object} request - The request object that will be sent.
673
- * @param {string} request.name - The name of the operation resource.
674
- * @param {Object=} options
675
- * Optional parameters. You can override the default settings for this call,
676
- * e.g, timeout, retries, paginations, etc. See {@link
677
- * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
678
- * for the details.
679
- * @param {function(?Error, ?Object)=} callback
680
- * The function which will be called with the result of the API call.
681
- *
682
- * The second parameter to the callback is an object representing
683
- * {@link google.longrunning.Operation | google.longrunning.Operation}.
684
- * @return {Promise} - The promise which resolves to an array.
685
- * The first element of the array is an object representing
686
- * {@link google.longrunning.Operation | google.longrunning.Operation}.
687
- * The promise has a method named "cancel" which cancels the ongoing API call.
1154
+ * Lists Anywhere Cache instances for a given bucket.
1155
+ *
1156
+ * @param {Object} request
1157
+ * The request object that will be sent.
1158
+ * @param {string} request.parent
1159
+ * Required. The bucket to which this cache belongs.
1160
+ * @param {number} request.pageSize
1161
+ * Maximum number of caches to return in a single response.
1162
+ * The service will use this parameter or 1,000 items, whichever is smaller.
1163
+ * @param {string} request.pageToken
1164
+ * A previously-returned page token representing part of the larger set of
1165
+ * results to view.
1166
+ * @param {string} [request.requestId]
1167
+ * Optional. A unique identifier for this request. UUID is the recommended
1168
+ * format, but other formats are still accepted.
1169
+ * @param {object} [options]
1170
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
1171
+ * @returns {Promise} - The promise which resolves to an array.
1172
+ * The first element of the array is Array of {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache}.
1173
+ * The client library will perform auto-pagination by default: it will call the API as many
1174
+ * times as needed and will merge results from all the pages into this array.
1175
+ * Note that it can affect your quota.
1176
+ * We recommend using `listAnywhereCachesAsync()`
1177
+ * method described below for async iteration which you can stop as needed.
1178
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
1179
+ * for more details and examples.
1180
+ */
1181
+ listAnywhereCaches(request?: protos.google.storage.control.v2.IListAnywhereCachesRequest, options?: CallOptions): Promise<[
1182
+ protos.google.storage.control.v2.IAnywhereCache[],
1183
+ protos.google.storage.control.v2.IListAnywhereCachesRequest | null,
1184
+ protos.google.storage.control.v2.IListAnywhereCachesResponse
1185
+ ]>;
1186
+ listAnywhereCaches(request: protos.google.storage.control.v2.IListAnywhereCachesRequest, options: CallOptions, callback: PaginationCallback<protos.google.storage.control.v2.IListAnywhereCachesRequest, protos.google.storage.control.v2.IListAnywhereCachesResponse | null | undefined, protos.google.storage.control.v2.IAnywhereCache>): void;
1187
+ listAnywhereCaches(request: protos.google.storage.control.v2.IListAnywhereCachesRequest, callback: PaginationCallback<protos.google.storage.control.v2.IListAnywhereCachesRequest, protos.google.storage.control.v2.IListAnywhereCachesResponse | null | undefined, protos.google.storage.control.v2.IAnywhereCache>): void;
1188
+ /**
1189
+ * Equivalent to `listAnywhereCaches`, but returns a NodeJS Stream object.
1190
+ * @param {Object} request
1191
+ * The request object that will be sent.
1192
+ * @param {string} request.parent
1193
+ * Required. The bucket to which this cache belongs.
1194
+ * @param {number} request.pageSize
1195
+ * Maximum number of caches to return in a single response.
1196
+ * The service will use this parameter or 1,000 items, whichever is smaller.
1197
+ * @param {string} request.pageToken
1198
+ * A previously-returned page token representing part of the larger set of
1199
+ * results to view.
1200
+ * @param {string} [request.requestId]
1201
+ * Optional. A unique identifier for this request. UUID is the recommended
1202
+ * format, but other formats are still accepted.
1203
+ * @param {object} [options]
1204
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
1205
+ * @returns {Stream}
1206
+ * An object stream which emits an object representing {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache} on 'data' event.
1207
+ * The client library will perform auto-pagination by default: it will call the API as many
1208
+ * times as needed. Note that it can affect your quota.
1209
+ * We recommend using `listAnywhereCachesAsync()`
1210
+ * method described below for async iteration which you can stop as needed.
1211
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
1212
+ * for more details and examples.
1213
+ */
1214
+ listAnywhereCachesStream(request?: protos.google.storage.control.v2.IListAnywhereCachesRequest, options?: CallOptions): Transform;
1215
+ /**
1216
+ * Equivalent to `listAnywhereCaches`, but returns an iterable object.
688
1217
  *
689
- * @example
690
- * ```
691
- * const client = longrunning.operationsClient();
692
- * const name = '';
693
- * const [response] = await client.getOperation({name});
694
- * // doThingsWith(response)
695
- * ```
1218
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
1219
+ * @param {Object} request
1220
+ * The request object that will be sent.
1221
+ * @param {string} request.parent
1222
+ * Required. The bucket to which this cache belongs.
1223
+ * @param {number} request.pageSize
1224
+ * Maximum number of caches to return in a single response.
1225
+ * The service will use this parameter or 1,000 items, whichever is smaller.
1226
+ * @param {string} request.pageToken
1227
+ * A previously-returned page token representing part of the larger set of
1228
+ * results to view.
1229
+ * @param {string} [request.requestId]
1230
+ * Optional. A unique identifier for this request. UUID is the recommended
1231
+ * format, but other formats are still accepted.
1232
+ * @param {object} [options]
1233
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
1234
+ * @returns {Object}
1235
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
1236
+ * When you iterate the returned iterable, each element will be an object representing
1237
+ * {@link protos.google.storage.control.v2.AnywhereCache|AnywhereCache}. The API will be called under the hood as needed, once per the page,
1238
+ * so you can stop the iteration when you don't need more results.
1239
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
1240
+ * for more details and examples.
1241
+ * @example <caption>include:samples/generated/v2/storage_control.list_anywhere_caches.js</caption>
1242
+ * region_tag:storage_v2_generated_StorageControl_ListAnywhereCaches_async
696
1243
  */
1244
+ listAnywhereCachesAsync(request?: protos.google.storage.control.v2.IListAnywhereCachesRequest, options?: CallOptions): AsyncIterable<protos.google.storage.control.v2.IAnywhereCache>;
1245
+ /**
1246
+ * Gets the latest state of a long-running operation. Clients can use this
1247
+ * method to poll the operation result at intervals as recommended by the API
1248
+ * service.
1249
+ *
1250
+ * @param {Object} request - The request object that will be sent.
1251
+ * @param {string} request.name - The name of the operation resource.
1252
+ * @param {Object=} options
1253
+ * Optional parameters. You can override the default settings for this call,
1254
+ * e.g, timeout, retries, paginations, etc. See {@link
1255
+ * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
1256
+ * for the details.
1257
+ * @param {function(?Error, ?Object)=} callback
1258
+ * The function which will be called with the result of the API call.
1259
+ *
1260
+ * The second parameter to the callback is an object representing
1261
+ * {@link google.longrunning.Operation | google.longrunning.Operation}.
1262
+ * @return {Promise} - The promise which resolves to an array.
1263
+ * The first element of the array is an object representing
1264
+ * {@link google.longrunning.Operation | google.longrunning.Operation}.
1265
+ * The promise has a method named "cancel" which cancels the ongoing API call.
1266
+ *
1267
+ * @example
1268
+ * ```
1269
+ * const client = longrunning.operationsClient();
1270
+ * const name = '';
1271
+ * const [response] = await client.getOperation({name});
1272
+ * // doThingsWith(response)
1273
+ * ```
1274
+ */
697
1275
  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]>;
698
1276
  /**
699
1277
  * Lists operations that match the specified filter in the request. If the
@@ -784,6 +1362,39 @@ export declare class StorageControlClient {
784
1362
  * ```
785
1363
  */
786
1364
  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>;
1365
+ /**
1366
+ * Return a fully-qualified anywhereCache resource name string.
1367
+ *
1368
+ * @param {string} project
1369
+ * @param {string} bucket
1370
+ * @param {string} anywhere_cache
1371
+ * @returns {string} Resource name string.
1372
+ */
1373
+ anywhereCachePath(project: string, bucket: string, anywhereCache: string): string;
1374
+ /**
1375
+ * Parse the project from AnywhereCache resource.
1376
+ *
1377
+ * @param {string} anywhereCacheName
1378
+ * A fully-qualified path representing AnywhereCache resource.
1379
+ * @returns {string} A string representing the project.
1380
+ */
1381
+ matchProjectFromAnywhereCacheName(anywhereCacheName: string): string | number;
1382
+ /**
1383
+ * Parse the bucket from AnywhereCache resource.
1384
+ *
1385
+ * @param {string} anywhereCacheName
1386
+ * A fully-qualified path representing AnywhereCache resource.
1387
+ * @returns {string} A string representing the bucket.
1388
+ */
1389
+ matchBucketFromAnywhereCacheName(anywhereCacheName: string): string | number;
1390
+ /**
1391
+ * Parse the anywhere_cache from AnywhereCache resource.
1392
+ *
1393
+ * @param {string} anywhereCacheName
1394
+ * A fully-qualified path representing AnywhereCache resource.
1395
+ * @returns {string} A string representing the anywhere_cache.
1396
+ */
1397
+ matchAnywhereCacheFromAnywhereCacheName(anywhereCacheName: string): string | number;
787
1398
  /**
788
1399
  * Return a fully-qualified bucket resource name string.
789
1400
  *
@@ -841,6 +1452,30 @@ export declare class StorageControlClient {
841
1452
  * @returns {string} A string representing the folder.
842
1453
  */
843
1454
  matchFolderFromFolderName(folderName: string): string | number;
1455
+ /**
1456
+ * Return a fully-qualified folderLocationIntelligenceConfig resource name string.
1457
+ *
1458
+ * @param {string} folder
1459
+ * @param {string} location
1460
+ * @returns {string} Resource name string.
1461
+ */
1462
+ folderLocationIntelligenceConfigPath(folder: string, location: string): string;
1463
+ /**
1464
+ * Parse the folder from FolderLocationIntelligenceConfig resource.
1465
+ *
1466
+ * @param {string} folderLocationIntelligenceConfigName
1467
+ * A fully-qualified path representing folder_location_intelligenceConfig resource.
1468
+ * @returns {string} A string representing the folder.
1469
+ */
1470
+ matchFolderFromFolderLocationIntelligenceConfigName(folderLocationIntelligenceConfigName: string): string | number;
1471
+ /**
1472
+ * Parse the location from FolderLocationIntelligenceConfig resource.
1473
+ *
1474
+ * @param {string} folderLocationIntelligenceConfigName
1475
+ * A fully-qualified path representing folder_location_intelligenceConfig resource.
1476
+ * @returns {string} A string representing the location.
1477
+ */
1478
+ matchLocationFromFolderLocationIntelligenceConfigName(folderLocationIntelligenceConfigName: string): string | number;
844
1479
  /**
845
1480
  * Return a fully-qualified managedFolder resource name string.
846
1481
  *
@@ -874,6 +1509,30 @@ export declare class StorageControlClient {
874
1509
  * @returns {string} A string representing the managed_folder.
875
1510
  */
876
1511
  matchManagedFolderFromManagedFolderName(managedFolderName: string): string | number;
1512
+ /**
1513
+ * Return a fully-qualified orgLocationIntelligenceConfig resource name string.
1514
+ *
1515
+ * @param {string} org
1516
+ * @param {string} location
1517
+ * @returns {string} Resource name string.
1518
+ */
1519
+ orgLocationIntelligenceConfigPath(org: string, location: string): string;
1520
+ /**
1521
+ * Parse the org from OrgLocationIntelligenceConfig resource.
1522
+ *
1523
+ * @param {string} orgLocationIntelligenceConfigName
1524
+ * A fully-qualified path representing org_location_intelligenceConfig resource.
1525
+ * @returns {string} A string representing the org.
1526
+ */
1527
+ matchOrgFromOrgLocationIntelligenceConfigName(orgLocationIntelligenceConfigName: string): string | number;
1528
+ /**
1529
+ * Parse the location from OrgLocationIntelligenceConfig resource.
1530
+ *
1531
+ * @param {string} orgLocationIntelligenceConfigName
1532
+ * A fully-qualified path representing org_location_intelligenceConfig resource.
1533
+ * @returns {string} A string representing the location.
1534
+ */
1535
+ matchLocationFromOrgLocationIntelligenceConfigName(orgLocationIntelligenceConfigName: string): string | number;
877
1536
  /**
878
1537
  * Return a fully-qualified project resource name string.
879
1538
  *
@@ -889,6 +1548,30 @@ export declare class StorageControlClient {
889
1548
  * @returns {string} A string representing the project.
890
1549
  */
891
1550
  matchProjectFromProjectName(projectName: string): string | number;
1551
+ /**
1552
+ * Return a fully-qualified projectLocationIntelligenceConfig resource name string.
1553
+ *
1554
+ * @param {string} project
1555
+ * @param {string} location
1556
+ * @returns {string} Resource name string.
1557
+ */
1558
+ projectLocationIntelligenceConfigPath(project: string, location: string): string;
1559
+ /**
1560
+ * Parse the project from ProjectLocationIntelligenceConfig resource.
1561
+ *
1562
+ * @param {string} projectLocationIntelligenceConfigName
1563
+ * A fully-qualified path representing project_location_intelligenceConfig resource.
1564
+ * @returns {string} A string representing the project.
1565
+ */
1566
+ matchProjectFromProjectLocationIntelligenceConfigName(projectLocationIntelligenceConfigName: string): string | number;
1567
+ /**
1568
+ * Parse the location from ProjectLocationIntelligenceConfig resource.
1569
+ *
1570
+ * @param {string} projectLocationIntelligenceConfigName
1571
+ * A fully-qualified path representing project_location_intelligenceConfig resource.
1572
+ * @returns {string} A string representing the location.
1573
+ */
1574
+ matchLocationFromProjectLocationIntelligenceConfigName(projectLocationIntelligenceConfigName: string): string | number;
892
1575
  /**
893
1576
  * Return a fully-qualified storageLayout resource name string.
894
1577
  *