google-apis-cloudkms_v1 0.58.0 → 0.60.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: 2ac78661e30da92e2ec843fee9cae7346e3ced775e81c9d02b12a586332ffd00
4
- data.tar.gz: d3e0c2dc81ecb83669638b53b37bfdaa9135414dd7f708b409f9b70186e912c0
3
+ metadata.gz: d88d548a35598e1bf54991b3b8e45cb5d1effcce6a484206865a11a551f807e7
4
+ data.tar.gz: 6246c1512a05f2f1b3e22436feb6889081201ec56f91399761578cbe0471d0c4
5
5
  SHA512:
6
- metadata.gz: df16dafdca1a8192eb28d08346f2d01bd8347548b4eb49154b1e08c020e3988d73bfbb2b6f672d518600d59482e4b915405313f457c83c61a0b635a184fc817d
7
- data.tar.gz: 7145226bb0ab11934f3cb862a33d2fadbe51c964f7247e431550a56295815b44f087df725a0adc7ae0e5893adf8b3d1a4de92f3e294a685e6e6d1019fa781b8b
6
+ metadata.gz: 454b02cadccf26341ae6656b0e7798fded48889c79b441e4c4f3b63c9c48cef4fa7ec44293c512c07f86cecdbc30088c73f27a7cc5d2a8f4551c48746cbbc7f7
7
+ data.tar.gz: 0b191bc027580a98a880255c86cfcb27113a6a5fd24f0eb5b76918ed8df044aea19793248ba6a62b9ce4b614906ef08be5b75ede127105c3d01e7f124dda1c38
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Release history for google-apis-cloudkms_v1
2
2
 
3
+ ### v0.60.0 (2025-08-10)
4
+
5
+ * Regenerated from discovery document revision 20250731
6
+
7
+ ### v0.59.0 (2025-05-25)
8
+
9
+ * Regenerated from discovery document revision 20250516
10
+ * Regenerated using generator version 0.18.0
11
+
3
12
  ### v0.58.0 (2025-05-18)
4
13
 
5
14
  * Regenerated from discovery document revision 20250501
@@ -323,6 +323,14 @@ module Google
323
323
  class AutokeyConfig
324
324
  include Google::Apis::Core::Hashable
325
325
 
326
+ # Optional. A checksum computed by the server based on the value of other fields.
327
+ # This may be sent on update requests to ensure that the client has an up-to-
328
+ # date value before proceeding. The request will be rejected with an ABORTED
329
+ # error on a mismatched etag.
330
+ # Corresponds to the JSON property `etag`
331
+ # @return [String]
332
+ attr_accessor :etag
333
+
326
334
  # Optional. Name of the key project, e.g. `projects/`PROJECT_ID`` or `projects/`
327
335
  # PROJECT_NUMBER``, where Cloud KMS Autokey will provision a new CryptoKey when
328
336
  # a KeyHandle is created. On UpdateAutokeyConfig, the caller will require `
@@ -352,6 +360,7 @@ module Google
352
360
 
353
361
  # Update properties of this object
354
362
  def update!(**args)
363
+ @etag = args[:etag] if args.key?(:etag)
355
364
  @key_project = args[:key_project] if args.key?(:key_project)
356
365
  @name = args[:name] if args.key?(:name)
357
366
  @state = args[:state] if args.key?(:state)
@@ -877,6 +886,107 @@ module Google
877
886
  end
878
887
  end
879
888
 
889
+ # Request message for KeyManagementService.Decapsulate.
890
+ class DecapsulateRequest
891
+ include Google::Apis::Core::Hashable
892
+
893
+ # Required. The ciphertext produced from encapsulation with the named
894
+ # CryptoKeyVersion public key(s).
895
+ # Corresponds to the JSON property `ciphertext`
896
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
897
+ # @return [String]
898
+ attr_accessor :ciphertext
899
+
900
+ # Optional. A CRC32C checksum of the DecapsulateRequest.ciphertext. If specified,
901
+ # KeyManagementService will verify the integrity of the received
902
+ # DecapsulateRequest.ciphertext using this checksum. KeyManagementService will
903
+ # report an error if the checksum verification fails. If you receive a checksum
904
+ # error, your client should verify that CRC32C(DecapsulateRequest.ciphertext) is
905
+ # equal to DecapsulateRequest.ciphertext_crc32c, and if so, perform a limited
906
+ # number of retries. A persistent mismatch may indicate an issue in your
907
+ # computation of the CRC32C checksum. Note: This field is defined as int64 for
908
+ # reasons of compatibility across different languages. However, it is a non-
909
+ # negative integer, which will never exceed 2^32-1, and can be safely
910
+ # downconverted to uint32 in languages that support this type.
911
+ # Corresponds to the JSON property `ciphertextCrc32c`
912
+ # @return [Fixnum]
913
+ attr_accessor :ciphertext_crc32c
914
+
915
+ def initialize(**args)
916
+ update!(**args)
917
+ end
918
+
919
+ # Update properties of this object
920
+ def update!(**args)
921
+ @ciphertext = args[:ciphertext] if args.key?(:ciphertext)
922
+ @ciphertext_crc32c = args[:ciphertext_crc32c] if args.key?(:ciphertext_crc32c)
923
+ end
924
+ end
925
+
926
+ # Response message for KeyManagementService.Decapsulate.
927
+ class DecapsulateResponse
928
+ include Google::Apis::Core::Hashable
929
+
930
+ # The resource name of the CryptoKeyVersion used for decapsulation. Check this
931
+ # field to verify that the intended resource was used for decapsulation.
932
+ # Corresponds to the JSON property `name`
933
+ # @return [String]
934
+ attr_accessor :name
935
+
936
+ # The ProtectionLevel of the CryptoKeyVersion used in decapsulation.
937
+ # Corresponds to the JSON property `protectionLevel`
938
+ # @return [String]
939
+ attr_accessor :protection_level
940
+
941
+ # The decapsulated shared_secret originally encapsulated with the matching
942
+ # public key.
943
+ # Corresponds to the JSON property `sharedSecret`
944
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
945
+ # @return [String]
946
+ attr_accessor :shared_secret
947
+
948
+ # Integrity verification field. A CRC32C checksum of the returned
949
+ # DecapsulateResponse.shared_secret. An integrity check of DecapsulateResponse.
950
+ # shared_secret can be performed by computing the CRC32C checksum of
951
+ # DecapsulateResponse.shared_secret and comparing your results to this field.
952
+ # Discard the response in case of non-matching checksum values, and perform a
953
+ # limited number of retries. A persistent mismatch may indicate an issue in your
954
+ # computation of the CRC32C checksum. Note: receiving this response message
955
+ # indicates that KeyManagementService is able to successfully decrypt the
956
+ # ciphertext. Note: This field is defined as int64 for reasons of compatibility
957
+ # across different languages. However, it is a non-negative integer, which will
958
+ # never exceed 2^32-1, and can be safely downconverted to uint32 in languages
959
+ # that support this type.
960
+ # Corresponds to the JSON property `sharedSecretCrc32c`
961
+ # @return [Fixnum]
962
+ attr_accessor :shared_secret_crc32c
963
+
964
+ # Integrity verification field. A flag indicating whether DecapsulateRequest.
965
+ # ciphertext_crc32c was received by KeyManagementService and used for the
966
+ # integrity verification of the ciphertext. A false value of this field
967
+ # indicates either that DecapsulateRequest.ciphertext_crc32c was left unset or
968
+ # that it was not delivered to KeyManagementService. If you've set
969
+ # DecapsulateRequest.ciphertext_crc32c but this field is still false, discard
970
+ # the response and perform a limited number of retries.
971
+ # Corresponds to the JSON property `verifiedCiphertextCrc32c`
972
+ # @return [Boolean]
973
+ attr_accessor :verified_ciphertext_crc32c
974
+ alias_method :verified_ciphertext_crc32c?, :verified_ciphertext_crc32c
975
+
976
+ def initialize(**args)
977
+ update!(**args)
978
+ end
979
+
980
+ # Update properties of this object
981
+ def update!(**args)
982
+ @name = args[:name] if args.key?(:name)
983
+ @protection_level = args[:protection_level] if args.key?(:protection_level)
984
+ @shared_secret = args[:shared_secret] if args.key?(:shared_secret)
985
+ @shared_secret_crc32c = args[:shared_secret_crc32c] if args.key?(:shared_secret_crc32c)
986
+ @verified_ciphertext_crc32c = args[:verified_ciphertext_crc32c] if args.key?(:verified_ciphertext_crc32c)
987
+ end
988
+ end
989
+
880
990
  # Request message for KeyManagementService.Decrypt.
881
991
  class DecryptRequest
882
992
  include Google::Apis::Core::Hashable
@@ -1575,6 +1685,34 @@ module Google
1575
1685
  end
1576
1686
  end
1577
1687
 
1688
+ # The configuration of a protection level for a project's Key Access
1689
+ # Justifications enrollment.
1690
+ class KeyAccessJustificationsEnrollmentConfig
1691
+ include Google::Apis::Core::Hashable
1692
+
1693
+ # Whether the project has KAJ logging enabled.
1694
+ # Corresponds to the JSON property `auditLogging`
1695
+ # @return [Boolean]
1696
+ attr_accessor :audit_logging
1697
+ alias_method :audit_logging?, :audit_logging
1698
+
1699
+ # Whether the project is enrolled in KAJ policy enforcement.
1700
+ # Corresponds to the JSON property `policyEnforcement`
1701
+ # @return [Boolean]
1702
+ attr_accessor :policy_enforcement
1703
+ alias_method :policy_enforcement?, :policy_enforcement
1704
+
1705
+ def initialize(**args)
1706
+ update!(**args)
1707
+ end
1708
+
1709
+ # Update properties of this object
1710
+ def update!(**args)
1711
+ @audit_logging = args[:audit_logging] if args.key?(:audit_logging)
1712
+ @policy_enforcement = args[:policy_enforcement] if args.key?(:policy_enforcement)
1713
+ end
1714
+ end
1715
+
1578
1716
  # A KeyAccessJustificationsPolicy specifies zero or more allowed AccessReason
1579
1717
  # values for encrypt, decrypt, and sign operations on a CryptoKey.
1580
1718
  class KeyAccessJustificationsPolicy
@@ -1597,6 +1735,33 @@ module Google
1597
1735
  end
1598
1736
  end
1599
1737
 
1738
+ # A singleton configuration for Key Access Justifications policies.
1739
+ class KeyAccessJustificationsPolicyConfig
1740
+ include Google::Apis::Core::Hashable
1741
+
1742
+ # A KeyAccessJustificationsPolicy specifies zero or more allowed AccessReason
1743
+ # values for encrypt, decrypt, and sign operations on a CryptoKey.
1744
+ # Corresponds to the JSON property `defaultKeyAccessJustificationPolicy`
1745
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicy]
1746
+ attr_accessor :default_key_access_justification_policy
1747
+
1748
+ # Identifier. The resource name for this KeyAccessJustificationsPolicyConfig in
1749
+ # the format of "`organizations|folders|projects`/*/kajPolicyConfig".
1750
+ # Corresponds to the JSON property `name`
1751
+ # @return [String]
1752
+ attr_accessor :name
1753
+
1754
+ def initialize(**args)
1755
+ update!(**args)
1756
+ end
1757
+
1758
+ # Update properties of this object
1759
+ def update!(**args)
1760
+ @default_key_access_justification_policy = args[:default_key_access_justification_policy] if args.key?(:default_key_access_justification_policy)
1761
+ @name = args[:name] if args.key?(:name)
1762
+ end
1763
+ end
1764
+
1600
1765
  # Resource-oriented representation of a request to Cloud KMS Autokey and the
1601
1766
  # resulting provisioning of a CryptoKey.
1602
1767
  class KeyHandle
@@ -2962,6 +3127,61 @@ module Google
2962
3127
  end
2963
3128
  end
2964
3129
 
3130
+ # Response message for KeyAccessJustificationsConfig.
3131
+ # ShowEffectiveKeyAccessJustificationsEnrollmentConfig
3132
+ class ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse
3133
+ include Google::Apis::Core::Hashable
3134
+
3135
+ # The configuration of a protection level for a project's Key Access
3136
+ # Justifications enrollment.
3137
+ # Corresponds to the JSON property `externalConfig`
3138
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig]
3139
+ attr_accessor :external_config
3140
+
3141
+ # The configuration of a protection level for a project's Key Access
3142
+ # Justifications enrollment.
3143
+ # Corresponds to the JSON property `hardwareConfig`
3144
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig]
3145
+ attr_accessor :hardware_config
3146
+
3147
+ # The configuration of a protection level for a project's Key Access
3148
+ # Justifications enrollment.
3149
+ # Corresponds to the JSON property `softwareConfig`
3150
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig]
3151
+ attr_accessor :software_config
3152
+
3153
+ def initialize(**args)
3154
+ update!(**args)
3155
+ end
3156
+
3157
+ # Update properties of this object
3158
+ def update!(**args)
3159
+ @external_config = args[:external_config] if args.key?(:external_config)
3160
+ @hardware_config = args[:hardware_config] if args.key?(:hardware_config)
3161
+ @software_config = args[:software_config] if args.key?(:software_config)
3162
+ end
3163
+ end
3164
+
3165
+ # Response message for KeyAccessJustificationsConfig.
3166
+ # ShowEffectiveKeyAccessJustificationsPolicyConfig.
3167
+ class ShowEffectiveKeyAccessJustificationsPolicyConfigResponse
3168
+ include Google::Apis::Core::Hashable
3169
+
3170
+ # A singleton configuration for Key Access Justifications policies.
3171
+ # Corresponds to the JSON property `effectiveKajPolicy`
3172
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
3173
+ attr_accessor :effective_kaj_policy
3174
+
3175
+ def initialize(**args)
3176
+ update!(**args)
3177
+ end
3178
+
3179
+ # Update properties of this object
3180
+ def update!(**args)
3181
+ @effective_kaj_policy = args[:effective_kaj_policy] if args.key?(:effective_kaj_policy)
3182
+ end
3183
+ end
3184
+
2965
3185
  # The `Status` type defines a logical error model that is suitable for different
2966
3186
  # programming environments, including REST APIs and RPC APIs. It is used by [
2967
3187
  # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
@@ -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.58.0"
19
+ GEM_VERSION = "0.60.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.17.0"
22
+ GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20250501"
25
+ REVISION = "20250731"
26
26
  end
27
27
  end
28
28
  end
@@ -106,6 +106,18 @@ module Google
106
106
  include Google::Apis::Core::JsonObjectSupport
107
107
  end
108
108
 
109
+ class DecapsulateRequest
110
+ class Representation < Google::Apis::Core::JsonRepresentation; end
111
+
112
+ include Google::Apis::Core::JsonObjectSupport
113
+ end
114
+
115
+ class DecapsulateResponse
116
+ class Representation < Google::Apis::Core::JsonRepresentation; end
117
+
118
+ include Google::Apis::Core::JsonObjectSupport
119
+ end
120
+
109
121
  class DecryptRequest
110
122
  class Representation < Google::Apis::Core::JsonRepresentation; end
111
123
 
@@ -190,12 +202,24 @@ module Google
190
202
  include Google::Apis::Core::JsonObjectSupport
191
203
  end
192
204
 
205
+ class KeyAccessJustificationsEnrollmentConfig
206
+ class Representation < Google::Apis::Core::JsonRepresentation; end
207
+
208
+ include Google::Apis::Core::JsonObjectSupport
209
+ end
210
+
193
211
  class KeyAccessJustificationsPolicy
194
212
  class Representation < Google::Apis::Core::JsonRepresentation; end
195
213
 
196
214
  include Google::Apis::Core::JsonObjectSupport
197
215
  end
198
216
 
217
+ class KeyAccessJustificationsPolicyConfig
218
+ class Representation < Google::Apis::Core::JsonRepresentation; end
219
+
220
+ include Google::Apis::Core::JsonObjectSupport
221
+ end
222
+
199
223
  class KeyHandle
200
224
  class Representation < Google::Apis::Core::JsonRepresentation; end
201
225
 
@@ -358,6 +382,18 @@ module Google
358
382
  include Google::Apis::Core::JsonObjectSupport
359
383
  end
360
384
 
385
+ class ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse
386
+ class Representation < Google::Apis::Core::JsonRepresentation; end
387
+
388
+ include Google::Apis::Core::JsonObjectSupport
389
+ end
390
+
391
+ class ShowEffectiveKeyAccessJustificationsPolicyConfigResponse
392
+ class Representation < Google::Apis::Core::JsonRepresentation; end
393
+
394
+ include Google::Apis::Core::JsonObjectSupport
395
+ end
396
+
361
397
  class Status
362
398
  class Representation < Google::Apis::Core::JsonRepresentation; end
363
399
 
@@ -455,6 +491,7 @@ module Google
455
491
  class AutokeyConfig
456
492
  # @private
457
493
  class Representation < Google::Apis::Core::JsonRepresentation
494
+ property :etag, as: 'etag'
458
495
  property :key_project, as: 'keyProject'
459
496
  property :name, as: 'name'
460
497
  property :state, as: 'state'
@@ -556,6 +593,25 @@ module Google
556
593
  end
557
594
  end
558
595
 
596
+ class DecapsulateRequest
597
+ # @private
598
+ class Representation < Google::Apis::Core::JsonRepresentation
599
+ property :ciphertext, :base64 => true, as: 'ciphertext'
600
+ property :ciphertext_crc32c, :numeric_string => true, as: 'ciphertextCrc32c'
601
+ end
602
+ end
603
+
604
+ class DecapsulateResponse
605
+ # @private
606
+ class Representation < Google::Apis::Core::JsonRepresentation
607
+ property :name, as: 'name'
608
+ property :protection_level, as: 'protectionLevel'
609
+ property :shared_secret, :base64 => true, as: 'sharedSecret'
610
+ property :shared_secret_crc32c, :numeric_string => true, as: 'sharedSecretCrc32c'
611
+ property :verified_ciphertext_crc32c, as: 'verifiedCiphertextCrc32c'
612
+ end
613
+ end
614
+
559
615
  class DecryptRequest
560
616
  # @private
561
617
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -697,6 +753,14 @@ module Google
697
753
  end
698
754
  end
699
755
 
756
+ class KeyAccessJustificationsEnrollmentConfig
757
+ # @private
758
+ class Representation < Google::Apis::Core::JsonRepresentation
759
+ property :audit_logging, as: 'auditLogging'
760
+ property :policy_enforcement, as: 'policyEnforcement'
761
+ end
762
+ end
763
+
700
764
  class KeyAccessJustificationsPolicy
701
765
  # @private
702
766
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -704,6 +768,15 @@ module Google
704
768
  end
705
769
  end
706
770
 
771
+ class KeyAccessJustificationsPolicyConfig
772
+ # @private
773
+ class Representation < Google::Apis::Core::JsonRepresentation
774
+ property :default_key_access_justification_policy, as: 'defaultKeyAccessJustificationPolicy', class: Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicy, decorator: Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicy::Representation
775
+
776
+ property :name, as: 'name'
777
+ end
778
+ end
779
+
707
780
  class KeyHandle
708
781
  # @private
709
782
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -983,6 +1056,26 @@ module Google
983
1056
  end
984
1057
  end
985
1058
 
1059
+ class ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse
1060
+ # @private
1061
+ class Representation < Google::Apis::Core::JsonRepresentation
1062
+ property :external_config, as: 'externalConfig', class: Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig, decorator: Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig::Representation
1063
+
1064
+ property :hardware_config, as: 'hardwareConfig', class: Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig, decorator: Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig::Representation
1065
+
1066
+ property :software_config, as: 'softwareConfig', class: Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig, decorator: Google::Apis::CloudkmsV1::KeyAccessJustificationsEnrollmentConfig::Representation
1067
+
1068
+ end
1069
+ end
1070
+
1071
+ class ShowEffectiveKeyAccessJustificationsPolicyConfigResponse
1072
+ # @private
1073
+ class Representation < Google::Apis::Core::JsonRepresentation
1074
+ property :effective_kaj_policy, as: 'effectiveKajPolicy', class: Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig, decorator: Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
1075
+
1076
+ end
1077
+ end
1078
+
986
1079
  class Status
987
1080
  # @private
988
1081
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -83,6 +83,37 @@ module Google
83
83
  execute_or_queue_command(command, &block)
84
84
  end
85
85
 
86
+ # Gets the KeyAccessJustificationsPolicyConfig for a given organization/folder/
87
+ # projects.
88
+ # @param [String] name
89
+ # Required. The name of the KeyAccessJustificationsPolicyConfig to get.
90
+ # @param [String] fields
91
+ # Selector specifying which fields to include in a partial response.
92
+ # @param [String] quota_user
93
+ # Available to use for quota purposes for server-side applications. Can be any
94
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
95
+ # @param [Google::Apis::RequestOptions] options
96
+ # Request-specific options
97
+ #
98
+ # @yield [result, err] Result & error if block supplied
99
+ # @yieldparam result [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] parsed result object
100
+ # @yieldparam err [StandardError] error object if request failed
101
+ #
102
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
103
+ #
104
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
105
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
106
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
107
+ def get_folder_kaj_policy_config(name, fields: nil, quota_user: nil, options: nil, &block)
108
+ command = make_simple_command(:get, 'v1/{+name}', options)
109
+ command.response_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
110
+ command.response_class = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig
111
+ command.params['name'] = name unless name.nil?
112
+ command.query['fields'] = fields unless fields.nil?
113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
114
+ execute_or_queue_command(command, &block)
115
+ end
116
+
86
117
  # Updates the AutokeyConfig for a folder. The caller must have both `cloudkms.
87
118
  # autokeyConfigs.update` permission on the parent folder and `cloudkms.
88
119
  # cryptoKeys.setIamPolicy` permission on the provided key project. A KeyHandle
@@ -124,6 +155,144 @@ module Google
124
155
  execute_or_queue_command(command, &block)
125
156
  end
126
157
 
158
+ # Updates the KeyAccessJustificationsPolicyConfig for a given organization/
159
+ # folder/projects.
160
+ # @param [String] name
161
+ # Identifier. The resource name for this KeyAccessJustificationsPolicyConfig in
162
+ # the format of "`organizations|folders|projects`/*/kajPolicyConfig".
163
+ # @param [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] key_access_justifications_policy_config_object
164
+ # @param [String] update_mask
165
+ # Optional. The list of fields to update.
166
+ # @param [String] fields
167
+ # Selector specifying which fields to include in a partial response.
168
+ # @param [String] quota_user
169
+ # Available to use for quota purposes for server-side applications. Can be any
170
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
171
+ # @param [Google::Apis::RequestOptions] options
172
+ # Request-specific options
173
+ #
174
+ # @yield [result, err] Result & error if block supplied
175
+ # @yieldparam result [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] parsed result object
176
+ # @yieldparam err [StandardError] error object if request failed
177
+ #
178
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
179
+ #
180
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
181
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
182
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
183
+ def update_folder_kaj_policy_config(name, key_access_justifications_policy_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
184
+ command = make_simple_command(:patch, 'v1/{+name}', options)
185
+ command.request_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
186
+ command.request_object = key_access_justifications_policy_config_object
187
+ command.response_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
188
+ command.response_class = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig
189
+ command.params['name'] = name unless name.nil?
190
+ command.query['updateMask'] = update_mask unless update_mask.nil?
191
+ command.query['fields'] = fields unless fields.nil?
192
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
193
+ execute_or_queue_command(command, &block)
194
+ end
195
+
196
+ # Gets the KeyAccessJustificationsPolicyConfig for a given organization/folder/
197
+ # projects.
198
+ # @param [String] name
199
+ # Required. The name of the KeyAccessJustificationsPolicyConfig to get.
200
+ # @param [String] fields
201
+ # Selector specifying which fields to include in a partial response.
202
+ # @param [String] quota_user
203
+ # Available to use for quota purposes for server-side applications. Can be any
204
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
205
+ # @param [Google::Apis::RequestOptions] options
206
+ # Request-specific options
207
+ #
208
+ # @yield [result, err] Result & error if block supplied
209
+ # @yieldparam result [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] parsed result object
210
+ # @yieldparam err [StandardError] error object if request failed
211
+ #
212
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
213
+ #
214
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
215
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
216
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
217
+ def get_organization_kaj_policy_config(name, fields: nil, quota_user: nil, options: nil, &block)
218
+ command = make_simple_command(:get, 'v1/{+name}', options)
219
+ command.response_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
220
+ command.response_class = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig
221
+ command.params['name'] = name unless name.nil?
222
+ command.query['fields'] = fields unless fields.nil?
223
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
224
+ execute_or_queue_command(command, &block)
225
+ end
226
+
227
+ # Updates the KeyAccessJustificationsPolicyConfig for a given organization/
228
+ # folder/projects.
229
+ # @param [String] name
230
+ # Identifier. The resource name for this KeyAccessJustificationsPolicyConfig in
231
+ # the format of "`organizations|folders|projects`/*/kajPolicyConfig".
232
+ # @param [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] key_access_justifications_policy_config_object
233
+ # @param [String] update_mask
234
+ # Optional. The list of fields to update.
235
+ # @param [String] fields
236
+ # Selector specifying which fields to include in a partial response.
237
+ # @param [String] quota_user
238
+ # Available to use for quota purposes for server-side applications. Can be any
239
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
240
+ # @param [Google::Apis::RequestOptions] options
241
+ # Request-specific options
242
+ #
243
+ # @yield [result, err] Result & error if block supplied
244
+ # @yieldparam result [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] parsed result object
245
+ # @yieldparam err [StandardError] error object if request failed
246
+ #
247
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
248
+ #
249
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
250
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
251
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
252
+ def update_organization_kaj_policy_config(name, key_access_justifications_policy_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
253
+ command = make_simple_command(:patch, 'v1/{+name}', options)
254
+ command.request_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
255
+ command.request_object = key_access_justifications_policy_config_object
256
+ command.response_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
257
+ command.response_class = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig
258
+ command.params['name'] = name unless name.nil?
259
+ command.query['updateMask'] = update_mask unless update_mask.nil?
260
+ command.query['fields'] = fields unless fields.nil?
261
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
262
+ execute_or_queue_command(command, &block)
263
+ end
264
+
265
+ # Gets the KeyAccessJustificationsPolicyConfig for a given organization/folder/
266
+ # projects.
267
+ # @param [String] name
268
+ # Required. The name of the KeyAccessJustificationsPolicyConfig to get.
269
+ # @param [String] fields
270
+ # Selector specifying which fields to include in a partial response.
271
+ # @param [String] quota_user
272
+ # Available to use for quota purposes for server-side applications. Can be any
273
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
274
+ # @param [Google::Apis::RequestOptions] options
275
+ # Request-specific options
276
+ #
277
+ # @yield [result, err] Result & error if block supplied
278
+ # @yieldparam result [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] parsed result object
279
+ # @yieldparam err [StandardError] error object if request failed
280
+ #
281
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
282
+ #
283
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
284
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
285
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
286
+ def get_project_kaj_policy_config(name, fields: nil, quota_user: nil, options: nil, &block)
287
+ command = make_simple_command(:get, 'v1/{+name}', options)
288
+ command.response_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
289
+ command.response_class = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig
290
+ command.params['name'] = name unless name.nil?
291
+ command.query['fields'] = fields unless fields.nil?
292
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
293
+ execute_or_queue_command(command, &block)
294
+ end
295
+
127
296
  # Returns the effective Cloud KMS Autokey configuration for a given project.
128
297
  # @param [String] parent
129
298
  # Required. Name of the resource project to the show effective Cloud KMS Autokey
@@ -156,6 +325,108 @@ module Google
156
325
  execute_or_queue_command(command, &block)
157
326
  end
158
327
 
328
+ # Returns the KeyAccessJustificationsEnrollmentConfig of the resource closest to
329
+ # the given project in hierarchy.
330
+ # @param [String] project
331
+ # Required. The number or id of the project to get the effective
332
+ # KeyAccessJustificationsEnrollmentConfig for.
333
+ # @param [String] fields
334
+ # Selector specifying which fields to include in a partial response.
335
+ # @param [String] quota_user
336
+ # Available to use for quota purposes for server-side applications. Can be any
337
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
338
+ # @param [Google::Apis::RequestOptions] options
339
+ # Request-specific options
340
+ #
341
+ # @yield [result, err] Result & error if block supplied
342
+ # @yieldparam result [Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse] parsed result object
343
+ # @yieldparam err [StandardError] error object if request failed
344
+ #
345
+ # @return [Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse]
346
+ #
347
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
348
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
349
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
350
+ def show_project_effective_key_access_justifications_enrollment_config(project, fields: nil, quota_user: nil, options: nil, &block)
351
+ command = make_simple_command(:get, 'v1/{+project}:showEffectiveKeyAccessJustificationsEnrollmentConfig', options)
352
+ command.response_representation = Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse::Representation
353
+ command.response_class = Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsEnrollmentConfigResponse
354
+ command.params['project'] = project unless project.nil?
355
+ command.query['fields'] = fields unless fields.nil?
356
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
357
+ execute_or_queue_command(command, &block)
358
+ end
359
+
360
+ # Returns the KeyAccessJustificationsPolicyConfig of the resource closest to the
361
+ # given project in hierarchy.
362
+ # @param [String] project
363
+ # Required. The number or id of the project to get the effective
364
+ # KeyAccessJustificationsPolicyConfig. In the format of "projects/`|`"
365
+ # @param [String] fields
366
+ # Selector specifying which fields to include in a partial response.
367
+ # @param [String] quota_user
368
+ # Available to use for quota purposes for server-side applications. Can be any
369
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
370
+ # @param [Google::Apis::RequestOptions] options
371
+ # Request-specific options
372
+ #
373
+ # @yield [result, err] Result & error if block supplied
374
+ # @yieldparam result [Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsPolicyConfigResponse] parsed result object
375
+ # @yieldparam err [StandardError] error object if request failed
376
+ #
377
+ # @return [Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsPolicyConfigResponse]
378
+ #
379
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
380
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
381
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
382
+ def show_project_effective_key_access_justifications_policy_config(project, fields: nil, quota_user: nil, options: nil, &block)
383
+ command = make_simple_command(:get, 'v1/{+project}:showEffectiveKeyAccessJustificationsPolicyConfig', options)
384
+ command.response_representation = Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsPolicyConfigResponse::Representation
385
+ command.response_class = Google::Apis::CloudkmsV1::ShowEffectiveKeyAccessJustificationsPolicyConfigResponse
386
+ command.params['project'] = project unless project.nil?
387
+ command.query['fields'] = fields unless fields.nil?
388
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
389
+ execute_or_queue_command(command, &block)
390
+ end
391
+
392
+ # Updates the KeyAccessJustificationsPolicyConfig for a given organization/
393
+ # folder/projects.
394
+ # @param [String] name
395
+ # Identifier. The resource name for this KeyAccessJustificationsPolicyConfig in
396
+ # the format of "`organizations|folders|projects`/*/kajPolicyConfig".
397
+ # @param [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] key_access_justifications_policy_config_object
398
+ # @param [String] update_mask
399
+ # Optional. The list of fields to update.
400
+ # @param [String] fields
401
+ # Selector specifying which fields to include in a partial response.
402
+ # @param [String] quota_user
403
+ # Available to use for quota purposes for server-side applications. Can be any
404
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
405
+ # @param [Google::Apis::RequestOptions] options
406
+ # Request-specific options
407
+ #
408
+ # @yield [result, err] Result & error if block supplied
409
+ # @yieldparam result [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig] parsed result object
410
+ # @yieldparam err [StandardError] error object if request failed
411
+ #
412
+ # @return [Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig]
413
+ #
414
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
415
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
416
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
417
+ def update_project_kaj_policy_config(name, key_access_justifications_policy_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
418
+ command = make_simple_command(:patch, 'v1/{+name}', options)
419
+ command.request_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
420
+ command.request_object = key_access_justifications_policy_config_object
421
+ command.response_representation = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig::Representation
422
+ command.response_class = Google::Apis::CloudkmsV1::KeyAccessJustificationsPolicyConfig
423
+ command.params['name'] = name unless name.nil?
424
+ command.query['updateMask'] = update_mask unless update_mask.nil?
425
+ command.query['fields'] = fields unless fields.nil?
426
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
427
+ execute_or_queue_command(command, &block)
428
+ end
429
+
159
430
  # Generate random bytes using the Cloud KMS randomness source in the provided
160
431
  # location.
161
432
  # @param [String] location
@@ -1622,6 +1893,41 @@ module Google
1622
1893
  execute_or_queue_command(command, &block)
1623
1894
  end
1624
1895
 
1896
+ # Decapsulates data that was encapsulated with a public key retrieved from
1897
+ # GetPublicKey corresponding to a CryptoKeyVersion with CryptoKey.purpose
1898
+ # KEY_ENCAPSULATION.
1899
+ # @param [String] name
1900
+ # Required. The resource name of the CryptoKeyVersion to use for decapsulation.
1901
+ # @param [Google::Apis::CloudkmsV1::DecapsulateRequest] decapsulate_request_object
1902
+ # @param [String] fields
1903
+ # Selector specifying which fields to include in a partial response.
1904
+ # @param [String] quota_user
1905
+ # Available to use for quota purposes for server-side applications. Can be any
1906
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1907
+ # @param [Google::Apis::RequestOptions] options
1908
+ # Request-specific options
1909
+ #
1910
+ # @yield [result, err] Result & error if block supplied
1911
+ # @yieldparam result [Google::Apis::CloudkmsV1::DecapsulateResponse] parsed result object
1912
+ # @yieldparam err [StandardError] error object if request failed
1913
+ #
1914
+ # @return [Google::Apis::CloudkmsV1::DecapsulateResponse]
1915
+ #
1916
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1917
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1918
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1919
+ def decapsulate_crypto_key_version(name, decapsulate_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1920
+ command = make_simple_command(:post, 'v1/{+name}:decapsulate', options)
1921
+ command.request_representation = Google::Apis::CloudkmsV1::DecapsulateRequest::Representation
1922
+ command.request_object = decapsulate_request_object
1923
+ command.response_representation = Google::Apis::CloudkmsV1::DecapsulateResponse::Representation
1924
+ command.response_class = Google::Apis::CloudkmsV1::DecapsulateResponse
1925
+ command.params['name'] = name unless name.nil?
1926
+ command.query['fields'] = fields unless fields.nil?
1927
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1928
+ execute_or_queue_command(command, &block)
1929
+ end
1930
+
1625
1931
  # Schedule a CryptoKeyVersion for destruction. Upon calling this method,
1626
1932
  # CryptoKeyVersion.state will be set to DESTROY_SCHEDULED, and destroy_time will
1627
1933
  # be set to the time destroy_scheduled_duration in the future. At that time, the
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.58.0
4
+ version: 0.60.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.58.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.60.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:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
73
73
  - !ruby/object:Gem::Version
74
74
  version: '0'
75
75
  requirements: []
76
- rubygems_version: 3.6.8
76
+ rubygems_version: 3.6.9
77
77
  specification_version: 4
78
78
  summary: Simple REST client for Cloud Key Management Service (KMS) API V1
79
79
  test_files: []