google-apis-cloudkms_v1 0.69.0 → 0.70.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '0070906a6d91adcbdf80ccfff134c8e1c08ffd117a3cff733eaca7e087d99ef0'
4
- data.tar.gz: ca496e3029b13a86822ce19e2117eaf4d578436a7094748872a1b4484e87b48b
3
+ metadata.gz: '09b3c751f0d4ad8232809494860642806981bbb959acd47e4b0f9575f239e132'
4
+ data.tar.gz: 160a0d69e8f22174285e2907795ecb1b9033ab61960f614cdb8188388771d8dc
5
5
  SHA512:
6
- metadata.gz: 38c6a4cf830d245abb583951c943afbb77bad92e86cd67e8488a16b17acaf306ae800f822704a54d5c3a8ed23ed6f4fe55fe8c562d935a638e2e718a54a2ce46
7
- data.tar.gz: 3e2281920216d4b5483f8cbd9b987245df037af2a6d6426d051deb5f1120262b1732bfbdf405ddeac59e8a001e8bf232ee3525f53764385ac6bd03743afd8692
6
+ metadata.gz: f0dd22421c0fc50ada1f7088c5b9aafe3494d868b0553135a0ab74bfe71fcd8a5635686160a6ec429299f3019421d5e85d5935b424b69f26fabff8d55b189896
7
+ data.tar.gz: 3ce805d7db6da19d47378ecd85a31c53fa56445bd8b8d2db5ca49956990825bdebff53fc0e76081a3230c931bdefe5e85b3da6d98f9ce5e00ed5927156a9bcba
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-cloudkms_v1
2
2
 
3
+ ### v0.70.0 (2026-02-15)
4
+
5
+ * Regenerated from discovery document revision 20260206
6
+
3
7
  ### v0.69.0 (2026-02-08)
4
8
 
5
9
  * Regenerated from discovery document revision 20260123
@@ -410,7 +410,7 @@ module Google
410
410
  attr_accessor :key_project_resolution_mode
411
411
 
412
412
  # Identifier. Name of the AutokeyConfig resource, e.g. `folders/`FOLDER_NUMBER`/
413
- # autokeyConfig`
413
+ # autokeyConfig` or `projects/`PROJECT_NUMBER`/autokeyConfig`.
414
414
  # Corresponds to the JSON property `name`
415
415
  # @return [String]
416
416
  attr_accessor :name
@@ -2290,6 +2290,38 @@ module Google
2290
2290
  end
2291
2291
  end
2292
2292
 
2293
+ # Response message for KeyManagementService.ListRetiredResources.
2294
+ class ListRetiredResourcesResponse
2295
+ include Google::Apis::Core::Hashable
2296
+
2297
+ # A token to retrieve the next page of results. Pass this value in
2298
+ # ListRetiredResourcesRequest.page_token to retrieve the next page of results.
2299
+ # Corresponds to the JSON property `nextPageToken`
2300
+ # @return [String]
2301
+ attr_accessor :next_page_token
2302
+
2303
+ # The list of RetiredResources.
2304
+ # Corresponds to the JSON property `retiredResources`
2305
+ # @return [Array<Google::Apis::CloudkmsV1::RetiredResource>]
2306
+ attr_accessor :retired_resources
2307
+
2308
+ # The total number of RetiredResources that matched the query.
2309
+ # Corresponds to the JSON property `totalSize`
2310
+ # @return [Fixnum]
2311
+ attr_accessor :total_size
2312
+
2313
+ def initialize(**args)
2314
+ update!(**args)
2315
+ end
2316
+
2317
+ # Update properties of this object
2318
+ def update!(**args)
2319
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
2320
+ @retired_resources = args[:retired_resources] if args.key?(:retired_resources)
2321
+ @total_size = args[:total_size] if args.key?(:total_size)
2322
+ end
2323
+ end
2324
+
2293
2325
  # Response message for HsmManagement.ListSingleTenantHsmInstanceProposals.
2294
2326
  class ListSingleTenantHsmInstanceProposalsResponse
2295
2327
  include Google::Apis::Core::Hashable
@@ -3526,6 +3558,48 @@ module Google
3526
3558
  end
3527
3559
  end
3528
3560
 
3561
+ # A RetiredResource resource represents the record of a deleted CryptoKey. Its
3562
+ # purpose is to provide visibility into retained user data and to prevent reuse
3563
+ # of these names for new CryptoKeys.
3564
+ class RetiredResource
3565
+ include Google::Apis::Core::Hashable
3566
+
3567
+ # Output only. The time at which the original resource was deleted and this
3568
+ # RetiredResource record was created.
3569
+ # Corresponds to the JSON property `deleteTime`
3570
+ # @return [String]
3571
+ attr_accessor :delete_time
3572
+
3573
+ # Output only. Identifier. The resource name for this RetiredResource in the
3574
+ # format `projects/*/locations/*/retiredResources/*`.
3575
+ # Corresponds to the JSON property `name`
3576
+ # @return [String]
3577
+ attr_accessor :name
3578
+
3579
+ # Output only. The full resource name of the original CryptoKey that was deleted
3580
+ # in the format `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
3581
+ # Corresponds to the JSON property `originalResource`
3582
+ # @return [String]
3583
+ attr_accessor :original_resource
3584
+
3585
+ # Output only. The resource type of the original deleted resource.
3586
+ # Corresponds to the JSON property `resourceType`
3587
+ # @return [String]
3588
+ attr_accessor :resource_type
3589
+
3590
+ def initialize(**args)
3591
+ update!(**args)
3592
+ end
3593
+
3594
+ # Update properties of this object
3595
+ def update!(**args)
3596
+ @delete_time = args[:delete_time] if args.key?(:delete_time)
3597
+ @name = args[:name] if args.key?(:name)
3598
+ @original_resource = args[:original_resource] if args.key?(:original_resource)
3599
+ @resource_type = args[:resource_type] if args.key?(:resource_type)
3600
+ end
3601
+ end
3602
+
3529
3603
  # A ServiceResolver represents an EKM replica that can be reached within an
3530
3604
  # EkmConnection.
3531
3605
  class ServiceResolver
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module CloudkmsV1
18
18
  # Version of the google-apis-cloudkms_v1 gem
19
- GEM_VERSION = "0.69.0"
19
+ GEM_VERSION = "0.70.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20260123"
25
+ REVISION = "20260206"
26
26
  end
27
27
  end
28
28
  end
@@ -340,6 +340,12 @@ module Google
340
340
  include Google::Apis::Core::JsonObjectSupport
341
341
  end
342
342
 
343
+ class ListRetiredResourcesResponse
344
+ class Representation < Google::Apis::Core::JsonRepresentation; end
345
+
346
+ include Google::Apis::Core::JsonObjectSupport
347
+ end
348
+
343
349
  class ListSingleTenantHsmInstanceProposalsResponse
344
350
  class Representation < Google::Apis::Core::JsonRepresentation; end
345
351
 
@@ -484,6 +490,12 @@ module Google
484
490
  include Google::Apis::Core::JsonObjectSupport
485
491
  end
486
492
 
493
+ class RetiredResource
494
+ class Representation < Google::Apis::Core::JsonRepresentation; end
495
+
496
+ include Google::Apis::Core::JsonObjectSupport
497
+ end
498
+
487
499
  class ServiceResolver
488
500
  class Representation < Google::Apis::Core::JsonRepresentation; end
489
501
 
@@ -1075,6 +1087,16 @@ module Google
1075
1087
  end
1076
1088
  end
1077
1089
 
1090
+ class ListRetiredResourcesResponse
1091
+ # @private
1092
+ class Representation < Google::Apis::Core::JsonRepresentation
1093
+ property :next_page_token, as: 'nextPageToken'
1094
+ collection :retired_resources, as: 'retiredResources', class: Google::Apis::CloudkmsV1::RetiredResource, decorator: Google::Apis::CloudkmsV1::RetiredResource::Representation
1095
+
1096
+ property :total_size, :numeric_string => true, as: 'totalSize'
1097
+ end
1098
+ end
1099
+
1078
1100
  class ListSingleTenantHsmInstanceProposalsResponse
1079
1101
  # @private
1080
1102
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1323,6 +1345,16 @@ module Google
1323
1345
  end
1324
1346
  end
1325
1347
 
1348
+ class RetiredResource
1349
+ # @private
1350
+ class Representation < Google::Apis::Core::JsonRepresentation
1351
+ property :delete_time, as: 'deleteTime'
1352
+ property :name, as: 'name'
1353
+ property :original_resource, as: 'originalResource'
1354
+ property :resource_type, as: 'resourceType'
1355
+ end
1356
+ end
1357
+
1326
1358
  class ServiceResolver
1327
1359
  # @private
1328
1360
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -121,7 +121,7 @@ module Google
121
121
  # determine where to create the resulting CryptoKey.
122
122
  # @param [String] name
123
123
  # Identifier. Name of the AutokeyConfig resource, e.g. `folders/`FOLDER_NUMBER`/
124
- # autokeyConfig`
124
+ # autokeyConfig` or `projects/`PROJECT_NUMBER`/autokeyConfig`.
125
125
  # @param [Google::Apis::CloudkmsV1::AutokeyConfig] autokey_config_object
126
126
  # @param [String] update_mask
127
127
  # Required. Masks which fields of the AutokeyConfig to update, e.g. `keyProject`.
@@ -427,7 +427,7 @@ module Google
427
427
  # determine where to create the resulting CryptoKey.
428
428
  # @param [String] name
429
429
  # Identifier. Name of the AutokeyConfig resource, e.g. `folders/`FOLDER_NUMBER`/
430
- # autokeyConfig`
430
+ # autokeyConfig` or `projects/`PROJECT_NUMBER`/autokeyConfig`.
431
431
  # @param [Google::Apis::CloudkmsV1::AutokeyConfig] autokey_config_object
432
432
  # @param [String] update_mask
433
433
  # Required. Masks which fields of the AutokeyConfig to update, e.g. `keyProject`.
@@ -594,7 +594,11 @@ module Google
594
594
  execute_or_queue_command(command, &block)
595
595
  end
596
596
 
597
- # Lists information about the supported locations for this service.
597
+ # Lists information about the supported locations for this service. This method
598
+ # can be called in two ways: * **List all public locations:** Use the path `GET /
599
+ # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
600
+ # projects/`project_id`/locations`. This may include public locations as well as
601
+ # private or other locations specifically visible to the project.
598
602
  # @param [String] name
599
603
  # The resource that owns the locations collection, if applicable.
600
604
  # @param [Array<String>, String] extra_location_types
@@ -1548,6 +1552,39 @@ module Google
1548
1552
  execute_or_queue_command(command, &block)
1549
1553
  end
1550
1554
 
1555
+ # Permanently deletes the given CryptoKey. All child CryptoKeyVersions must have
1556
+ # been previously deleted using KeyManagementService.DeleteCryptoKeyVersion. The
1557
+ # specified crypto key will be immediately and permanently deleted upon calling
1558
+ # this method. This action cannot be undone.
1559
+ # @param [String] name
1560
+ # Required. The name of the CryptoKey to delete.
1561
+ # @param [String] fields
1562
+ # Selector specifying which fields to include in a partial response.
1563
+ # @param [String] quota_user
1564
+ # Available to use for quota purposes for server-side applications. Can be any
1565
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1566
+ # @param [Google::Apis::RequestOptions] options
1567
+ # Request-specific options
1568
+ #
1569
+ # @yield [result, err] Result & error if block supplied
1570
+ # @yieldparam result [Google::Apis::CloudkmsV1::Operation] parsed result object
1571
+ # @yieldparam err [StandardError] error object if request failed
1572
+ #
1573
+ # @return [Google::Apis::CloudkmsV1::Operation]
1574
+ #
1575
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1576
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1577
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1578
+ def delete_project_location_key_ring_crypto_key(name, fields: nil, quota_user: nil, options: nil, &block)
1579
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1580
+ command.response_representation = Google::Apis::CloudkmsV1::Operation::Representation
1581
+ command.response_class = Google::Apis::CloudkmsV1::Operation
1582
+ command.params['name'] = name unless name.nil?
1583
+ command.query['fields'] = fields unless fields.nil?
1584
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1585
+ execute_or_queue_command(command, &block)
1586
+ end
1587
+
1551
1588
  # Encrypts data, so that it can only be recovered by a call to Decrypt. The
1552
1589
  # CryptoKey.purpose must be ENCRYPT_DECRYPT.
1553
1590
  # @param [String] name
@@ -2000,6 +2037,40 @@ module Google
2000
2037
  execute_or_queue_command(command, &block)
2001
2038
  end
2002
2039
 
2040
+ # Permanently deletes the given CryptoKeyVersion. Only possible if the version
2041
+ # has not been previously imported and if its state is one of DESTROYED,
2042
+ # IMPORT_FAILED, or GENERATION_FAILED. Successfully imported CryptoKeyVersions
2043
+ # cannot be deleted at this time. The specified version will be immediately and
2044
+ # permanently deleted upon calling this method. This action cannot be undone.
2045
+ # @param [String] name
2046
+ # Required. The name of the CryptoKeyVersion to delete.
2047
+ # @param [String] fields
2048
+ # Selector specifying which fields to include in a partial response.
2049
+ # @param [String] quota_user
2050
+ # Available to use for quota purposes for server-side applications. Can be any
2051
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2052
+ # @param [Google::Apis::RequestOptions] options
2053
+ # Request-specific options
2054
+ #
2055
+ # @yield [result, err] Result & error if block supplied
2056
+ # @yieldparam result [Google::Apis::CloudkmsV1::Operation] parsed result object
2057
+ # @yieldparam err [StandardError] error object if request failed
2058
+ #
2059
+ # @return [Google::Apis::CloudkmsV1::Operation]
2060
+ #
2061
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2062
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2063
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2064
+ def delete_project_location_key_ring_crypto_key_crypto_key_version(name, fields: nil, quota_user: nil, options: nil, &block)
2065
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2066
+ command.response_representation = Google::Apis::CloudkmsV1::Operation::Representation
2067
+ command.response_class = Google::Apis::CloudkmsV1::Operation
2068
+ command.params['name'] = name unless name.nil?
2069
+ command.query['fields'] = fields unless fields.nil?
2070
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2071
+ execute_or_queue_command(command, &block)
2072
+ end
2073
+
2003
2074
  # Schedule a CryptoKeyVersion for destruction. Upon calling this method,
2004
2075
  # CryptoKeyVersion.state will be set to DESTROY_SCHEDULED, and destroy_time will
2005
2076
  # be set to the time destroy_scheduled_duration in the future. At that time, the
@@ -2682,6 +2753,79 @@ module Google
2682
2753
  execute_or_queue_command(command, &block)
2683
2754
  end
2684
2755
 
2756
+ # Retrieves a specific RetiredResource resource, which represents the record of
2757
+ # a deleted CryptoKey.
2758
+ # @param [String] name
2759
+ # Required. The name of the RetiredResource to get.
2760
+ # @param [String] fields
2761
+ # Selector specifying which fields to include in a partial response.
2762
+ # @param [String] quota_user
2763
+ # Available to use for quota purposes for server-side applications. Can be any
2764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2765
+ # @param [Google::Apis::RequestOptions] options
2766
+ # Request-specific options
2767
+ #
2768
+ # @yield [result, err] Result & error if block supplied
2769
+ # @yieldparam result [Google::Apis::CloudkmsV1::RetiredResource] parsed result object
2770
+ # @yieldparam err [StandardError] error object if request failed
2771
+ #
2772
+ # @return [Google::Apis::CloudkmsV1::RetiredResource]
2773
+ #
2774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2777
+ def get_project_location_retired_resource(name, fields: nil, quota_user: nil, options: nil, &block)
2778
+ command = make_simple_command(:get, 'v1/{+name}', options)
2779
+ command.response_representation = Google::Apis::CloudkmsV1::RetiredResource::Representation
2780
+ command.response_class = Google::Apis::CloudkmsV1::RetiredResource
2781
+ command.params['name'] = name unless name.nil?
2782
+ command.query['fields'] = fields unless fields.nil?
2783
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2784
+ execute_or_queue_command(command, &block)
2785
+ end
2786
+
2787
+ # Lists the RetiredResources which are the records of deleted CryptoKeys.
2788
+ # RetiredResources prevent the reuse of these resource names after deletion.
2789
+ # @param [String] parent
2790
+ # Required. The project-specific location holding the RetiredResources, in the
2791
+ # format `projects/*/locations/*`.
2792
+ # @param [Fixnum] page_size
2793
+ # Optional. Optional limit on the number of RetiredResources to be included in
2794
+ # the response. Further RetiredResources can subsequently be obtained by
2795
+ # including the ListRetiredResourcesResponse.next_page_token in a subsequent
2796
+ # request. If unspecified, the server will pick an appropriate default.
2797
+ # @param [String] page_token
2798
+ # Optional. Optional pagination token, returned earlier via
2799
+ # ListRetiredResourcesResponse.next_page_token.
2800
+ # @param [String] fields
2801
+ # Selector specifying which fields to include in a partial response.
2802
+ # @param [String] quota_user
2803
+ # Available to use for quota purposes for server-side applications. Can be any
2804
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2805
+ # @param [Google::Apis::RequestOptions] options
2806
+ # Request-specific options
2807
+ #
2808
+ # @yield [result, err] Result & error if block supplied
2809
+ # @yieldparam result [Google::Apis::CloudkmsV1::ListRetiredResourcesResponse] parsed result object
2810
+ # @yieldparam err [StandardError] error object if request failed
2811
+ #
2812
+ # @return [Google::Apis::CloudkmsV1::ListRetiredResourcesResponse]
2813
+ #
2814
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2815
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2816
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2817
+ def list_project_location_retired_resources(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2818
+ command = make_simple_command(:get, 'v1/{+parent}/retiredResources', options)
2819
+ command.response_representation = Google::Apis::CloudkmsV1::ListRetiredResourcesResponse::Representation
2820
+ command.response_class = Google::Apis::CloudkmsV1::ListRetiredResourcesResponse
2821
+ command.params['parent'] = parent unless parent.nil?
2822
+ command.query['pageSize'] = page_size unless page_size.nil?
2823
+ command.query['pageToken'] = page_token unless page_token.nil?
2824
+ command.query['fields'] = fields unless fields.nil?
2825
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2826
+ execute_or_queue_command(command, &block)
2827
+ end
2828
+
2685
2829
  # Creates a new SingleTenantHsmInstance in a given Project and Location. User
2686
2830
  # must create a RegisterTwoFactorAuthKeys proposal with this single-tenant HSM
2687
2831
  # instance to finish setup of the instance.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-cloudkms_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.69.0
4
+ version: 0.70.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudkms_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.69.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.70.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudkms_v1
62
62
  rdoc_options: []
63
63
  require_paths: