google-cloud-storage-control-v2 1.2.0 → 1.3.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.
@@ -290,7 +290,7 @@ module Google
290
290
 
291
291
  # Configuration for Custom Dual Regions. It should specify precisely two
292
292
  # eligible regions within the same Multiregion. More information on regions
293
- # may be found [https://cloud.google.com/storage/docs/locations][here].
293
+ # may be found [here](https://cloud.google.com/storage/docs/locations).
294
294
  # @!attribute [rw] data_locations
295
295
  # @return [::Array<::String>]
296
296
  # List of locations to use for data placement.
@@ -461,6 +461,241 @@ module Google
461
461
  include ::Google::Protobuf::MessageExts
462
462
  extend ::Google::Protobuf::MessageExts::ClassMethods
463
463
  end
464
+
465
+ # Message returned in the metadata field of the Operation resource for
466
+ # CreateAnywhereCache operations.
467
+ # @!attribute [rw] common_metadata
468
+ # @return [::Google::Cloud::Storage::Control::V2::CommonLongRunningOperationMetadata]
469
+ # Generic metadata for the long running operation.
470
+ # @!attribute [rw] anywhere_cache_id
471
+ # @return [::String]
472
+ # Anywhere Cache ID.
473
+ # @!attribute [rw] zone
474
+ # @return [::String]
475
+ # The zone in which the cache instance is running. For example,
476
+ # us-central1-a.
477
+ # @!attribute [rw] ttl
478
+ # @return [::Google::Protobuf::Duration]
479
+ # Anywhere Cache entry's TTL. A cache-level config that is applied to all new
480
+ # cache entries on admission. Default ttl value (24hrs) is applied if not
481
+ # specified in the create request.
482
+ # @!attribute [rw] admission_policy
483
+ # @return [::String]
484
+ # Anywhere Cache entry Admission Policy in kebab-case (e.g.,
485
+ # "admit-on-first-miss"). Default admission policy (admit-on-first-miss) is
486
+ # applied if not specified in the create request.
487
+ class CreateAnywhereCacheMetadata
488
+ include ::Google::Protobuf::MessageExts
489
+ extend ::Google::Protobuf::MessageExts::ClassMethods
490
+ end
491
+
492
+ # Message returned in the metadata field of the Operation resource for
493
+ # UpdateAnywhereCache operation.
494
+ # @!attribute [rw] common_metadata
495
+ # @return [::Google::Cloud::Storage::Control::V2::CommonLongRunningOperationMetadata]
496
+ # Generic metadata for the long running operation.
497
+ # @!attribute [rw] anywhere_cache_id
498
+ # @return [::String]
499
+ # Anywhere Cache ID.
500
+ # @!attribute [rw] zone
501
+ # @return [::String]
502
+ # The zone in which the cache instance is running. For example,
503
+ # us-central1-a.
504
+ # @!attribute [rw] ttl
505
+ # @return [::Google::Protobuf::Duration]
506
+ # Anywhere Cache entry's TTL between 1h and 7days. A cache-level config that
507
+ # is applied to all new cache entries on admission. If `ttl` is pending
508
+ # update, this field equals to the new value specified in the Update request.
509
+ # @!attribute [rw] admission_policy
510
+ # @return [::String]
511
+ # L4 Cache entry Admission Policy in kebab-case (e.g.,
512
+ # "admit-on-first-miss"). If `admission_policy` is pending
513
+ # update, this field equals to the new value specified in the Update request.
514
+ class UpdateAnywhereCacheMetadata
515
+ include ::Google::Protobuf::MessageExts
516
+ extend ::Google::Protobuf::MessageExts::ClassMethods
517
+ end
518
+
519
+ # An Anywhere Cache Instance.
520
+ # @!attribute [rw] name
521
+ # @return [::String]
522
+ # Immutable. The resource name of this AnywhereCache.
523
+ # Format:
524
+ # `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
525
+ # @!attribute [rw] zone
526
+ # @return [::String]
527
+ # Immutable. The zone in which the cache instance is running. For example,
528
+ # us-central1-a.
529
+ # @!attribute [rw] ttl
530
+ # @return [::Google::Protobuf::Duration]
531
+ # Cache entry TTL (ranges between 1h to 7d). This is a cache-level config
532
+ # that defines how long a cache entry can live. Default ttl value (24hrs)
533
+ # is applied if not specified in the create request. TTL must be in whole
534
+ # seconds.
535
+ # @!attribute [rw] admission_policy
536
+ # @return [::String]
537
+ # Cache admission policy. Valid policies includes:
538
+ # `admit-on-first-miss` and `admit-on-second-miss`. Defaults to
539
+ # `admit-on-first-miss`. Default value is applied if not specified in the
540
+ # create request.
541
+ # @!attribute [r] state
542
+ # @return [::String]
543
+ # Output only. Cache state including RUNNING, CREATING, DISABLED and PAUSED.
544
+ # @!attribute [r] create_time
545
+ # @return [::Google::Protobuf::Timestamp]
546
+ # Output only. Time when Anywhere cache instance is allocated.
547
+ # @!attribute [r] update_time
548
+ # @return [::Google::Protobuf::Timestamp]
549
+ # Output only. Time when Anywhere cache instance is last updated, including
550
+ # creation.
551
+ # @!attribute [r] pending_update
552
+ # @return [::Boolean]
553
+ # Output only. True if there is an active update operation against this cache
554
+ # instance. Subsequential update requests will be rejected if this field is
555
+ # true. Output only.
556
+ class AnywhereCache
557
+ include ::Google::Protobuf::MessageExts
558
+ extend ::Google::Protobuf::MessageExts::ClassMethods
559
+ end
560
+
561
+ # Request message for CreateAnywhereCache.
562
+ # @!attribute [rw] parent
563
+ # @return [::String]
564
+ # Required. The bucket to which this cache belongs.
565
+ # Format: `projects/{project}/buckets/{bucket}`
566
+ # @!attribute [rw] anywhere_cache
567
+ # @return [::Google::Cloud::Storage::Control::V2::AnywhereCache]
568
+ # Required. Properties of the Anywhere Cache instance being created.
569
+ # The parent bucket name is specified in the `parent` field. Server uses the
570
+ # default value of `ttl` or `admission_policy` if not specified in
571
+ # request.
572
+ # @!attribute [rw] request_id
573
+ # @return [::String]
574
+ # Optional. A unique identifier for this request. UUID is the recommended
575
+ # format, but other formats are still accepted. This request is only
576
+ # idempotent if a `request_id` is provided.
577
+ class CreateAnywhereCacheRequest
578
+ include ::Google::Protobuf::MessageExts
579
+ extend ::Google::Protobuf::MessageExts::ClassMethods
580
+ end
581
+
582
+ # Request message for UpdateAnywhereCache.
583
+ # @!attribute [rw] anywhere_cache
584
+ # @return [::Google::Cloud::Storage::Control::V2::AnywhereCache]
585
+ # Required. The Anywhere Cache instance to be updated.
586
+ # @!attribute [rw] update_mask
587
+ # @return [::Google::Protobuf::FieldMask]
588
+ # Required. List of fields to be updated. Mutable fields of AnywhereCache
589
+ # include `ttl` and `admission_policy`.
590
+ #
591
+ # To specify ALL fields, specify a single field with the value `*`. Note: We
592
+ # recommend against doing this. If a new field is introduced at a later time,
593
+ # an older client updating with the `*` may accidentally reset the new
594
+ # field's value.
595
+ #
596
+ # Not specifying any fields is an error.
597
+ # @!attribute [rw] request_id
598
+ # @return [::String]
599
+ # Optional. A unique identifier for this request. UUID is the recommended
600
+ # format, but other formats are still accepted. This request is only
601
+ # idempotent if a `request_id` is provided.
602
+ class UpdateAnywhereCacheRequest
603
+ include ::Google::Protobuf::MessageExts
604
+ extend ::Google::Protobuf::MessageExts::ClassMethods
605
+ end
606
+
607
+ # Request message for DisableAnywhereCache.
608
+ # @!attribute [rw] name
609
+ # @return [::String]
610
+ # Required. The name field in the request should be:
611
+ # `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
612
+ # @!attribute [rw] request_id
613
+ # @return [::String]
614
+ # Optional. A unique identifier for this request. UUID is the recommended
615
+ # format, but other formats are still accepted. This request is only
616
+ # idempotent if a `request_id` is provided.
617
+ class DisableAnywhereCacheRequest
618
+ include ::Google::Protobuf::MessageExts
619
+ extend ::Google::Protobuf::MessageExts::ClassMethods
620
+ end
621
+
622
+ # Request message for PauseAnywhereCache.
623
+ # @!attribute [rw] name
624
+ # @return [::String]
625
+ # Required. The name field in the request should be:
626
+ # `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
627
+ # @!attribute [rw] request_id
628
+ # @return [::String]
629
+ # Optional. A unique identifier for this request. UUID is the recommended
630
+ # format, but other formats are still accepted. This request is only
631
+ # idempotent if a `request_id` is provided.
632
+ class PauseAnywhereCacheRequest
633
+ include ::Google::Protobuf::MessageExts
634
+ extend ::Google::Protobuf::MessageExts::ClassMethods
635
+ end
636
+
637
+ # Request message for ResumeAnywhereCache.
638
+ # @!attribute [rw] name
639
+ # @return [::String]
640
+ # Required. The name field in the request should be:
641
+ # `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
642
+ # @!attribute [rw] request_id
643
+ # @return [::String]
644
+ # Optional. A unique identifier for this request. UUID is the recommended
645
+ # format, but other formats are still accepted. This request is only
646
+ # idempotent if a `request_id` is provided.
647
+ class ResumeAnywhereCacheRequest
648
+ include ::Google::Protobuf::MessageExts
649
+ extend ::Google::Protobuf::MessageExts::ClassMethods
650
+ end
651
+
652
+ # Request message for GetAnywhereCache.
653
+ # @!attribute [rw] name
654
+ # @return [::String]
655
+ # Required. The name field in the request should be:
656
+ # `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
657
+ # @!attribute [rw] request_id
658
+ # @return [::String]
659
+ # Optional. A unique identifier for this request. UUID is the recommended
660
+ # format, but other formats are still accepted.
661
+ class GetAnywhereCacheRequest
662
+ include ::Google::Protobuf::MessageExts
663
+ extend ::Google::Protobuf::MessageExts::ClassMethods
664
+ end
665
+
666
+ # Request message for ListAnywhereCaches.
667
+ # @!attribute [rw] parent
668
+ # @return [::String]
669
+ # Required. The bucket to which this cache belongs.
670
+ # @!attribute [rw] page_size
671
+ # @return [::Integer]
672
+ # Maximum number of caches to return in a single response.
673
+ # The service will use this parameter or 1,000 items, whichever is smaller.
674
+ # @!attribute [rw] page_token
675
+ # @return [::String]
676
+ # A previously-returned page token representing part of the larger set of
677
+ # results to view.
678
+ # @!attribute [rw] request_id
679
+ # @return [::String]
680
+ # Optional. A unique identifier for this request. UUID is the recommended
681
+ # format, but other formats are still accepted.
682
+ class ListAnywhereCachesRequest
683
+ include ::Google::Protobuf::MessageExts
684
+ extend ::Google::Protobuf::MessageExts::ClassMethods
685
+ end
686
+
687
+ # Response message for ListAnywhereCaches.
688
+ # @!attribute [rw] anywhere_caches
689
+ # @return [::Array<::Google::Cloud::Storage::Control::V2::AnywhereCache>]
690
+ # The list of items.
691
+ # @!attribute [rw] next_page_token
692
+ # @return [::String]
693
+ # A token, which can be sent as `page_token` to retrieve the next page.
694
+ # If this field is omitted, there are no subsequent pages.
695
+ class ListAnywhereCachesResponse
696
+ include ::Google::Protobuf::MessageExts
697
+ extend ::Google::Protobuf::MessageExts::ClassMethods
698
+ end
464
699
  end
465
700
  end
466
701
  end
metadata CHANGED
@@ -1,34 +1,28 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-storage-control-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 1.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-01-29 00:00:00.000000000 Z
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: gapic-common
14
14
  requirement: !ruby/object:Gem::Requirement
15
15
  requirements:
16
- - - ">="
17
- - !ruby/object:Gem::Version
18
- version: 0.25.0
19
- - - "<"
16
+ - - "~>"
20
17
  - !ruby/object:Gem::Version
21
- version: 2.a
18
+ version: '1.0'
22
19
  type: :runtime
23
20
  prerelease: false
24
21
  version_requirements: !ruby/object:Gem::Requirement
25
22
  requirements:
26
- - - ">="
27
- - !ruby/object:Gem::Version
28
- version: 0.25.0
29
- - - "<"
23
+ - - "~>"
30
24
  - !ruby/object:Gem::Version
31
- version: 2.a
25
+ version: '1.0'
32
26
  - !ruby/object:Gem::Dependency
33
27
  name: google-cloud-errors
34
28
  requirement: !ruby/object:Gem::Requirement
@@ -82,6 +76,7 @@ files:
82
76
  - proto_docs/google/protobuf/any.rb
83
77
  - proto_docs/google/protobuf/duration.rb
84
78
  - proto_docs/google/protobuf/empty.rb
79
+ - proto_docs/google/protobuf/field_mask.rb
85
80
  - proto_docs/google/protobuf/timestamp.rb
86
81
  - proto_docs/google/rpc/status.rb
87
82
  - proto_docs/google/storage/control/v2/storage_control.rb
@@ -96,14 +91,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
96
91
  requirements:
97
92
  - - ">="
98
93
  - !ruby/object:Gem::Version
99
- version: '3.0'
94
+ version: '3.1'
100
95
  required_rubygems_version: !ruby/object:Gem::Requirement
101
96
  requirements:
102
97
  - - ">="
103
98
  - !ruby/object:Gem::Version
104
99
  version: '0'
105
100
  requirements: []
106
- rubygems_version: 3.6.2
101
+ rubygems_version: 3.6.8
107
102
  specification_version: 4
108
103
  summary: The Storage Control API lets you perform metadata-specific, control plane,
109
104
  and long-running operations. The Storage Control API creates one space to perform