google-apis-kmsinventory_v1 0.12.0 → 0.13.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: 66ca3972c63131a8794561d75b800a4d45f5477101f3bfd0922dc2d5cea26fd9
4
- data.tar.gz: 649fcdd695725b0e8821f003581b18d986d46f619eb6533542b480ad97c72cc4
3
+ metadata.gz: 6f4eb4c76da90532f8d029c97f44c836e95143b1ebb67226a68039af435a8802
4
+ data.tar.gz: 193b54596aca4a2687f567c5f67b84cc20f668df5f42ccfcec41eb062b174d66
5
5
  SHA512:
6
- metadata.gz: daf26e648b09f601bb29f9eaf23c844949b7380b61a3f798ae575c8ed4a15efb1da0819dbc1b18dad3c47e547197148b0725360272110096312f0d2c0936a992
7
- data.tar.gz: 7fa5282f3a2dc627c5b26db314360d68f7d6352c18e07dd4dfd7265507e89ec65e2aa1e6df84dc76b64eb7a00906974585275be9b8a8c438bc684ec3cf9bdf23
6
+ metadata.gz: 7d99e79a4af46b7dc614b8b2b37eaa0908d9af8060b88d305fd8d0cdf5ad6bc5e21ce834f016159db62654b0819c5df1da272a5860f0848e7872d96c78b065a2
7
+ data.tar.gz: 6b3af2eaea05397c3e558b5e4235d57bf69212917ec7ae242afccf03a3026a24bb4cb8f3071be5299f3a75c84688c3e416f6f3e1e1757ad9deaee92a54239019
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-kmsinventory_v1
2
2
 
3
+ ### v0.13.0 (2026-02-08)
4
+
5
+ * Regenerated from discovery document revision 20260201
6
+
3
7
  ### v0.12.0 (2025-12-14)
4
8
 
5
9
  * Regenerated from discovery document revision 20251207
@@ -133,7 +133,7 @@ module Google
133
133
  end
134
134
 
135
135
  # Aggregate information about the resources protected by a Cloud KMS key in the
136
- # same Cloud organization as the key.
136
+ # same Cloud organization/project as the key.
137
137
  class GoogleCloudKmsInventoryV1ProtectedResourcesSummary
138
138
  include Google::Apis::Core::Hashable
139
139
 
@@ -171,6 +171,13 @@ module Google
171
171
  # @return [Hash<String,Fixnum>]
172
172
  attr_accessor :resource_types
173
173
 
174
+ # Warning messages for the state of response ProtectedResourcesSummary For
175
+ # example, if the organization service account is not configured,
176
+ # INSUFFICIENT_PERMISSIONS_PARTIAL_DATA warning will be returned.
177
+ # Corresponds to the JSON property `warnings`
178
+ # @return [Array<Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1Warning>]
179
+ attr_accessor :warnings
180
+
174
181
  def initialize(**args)
175
182
  update!(**args)
176
183
  end
@@ -183,6 +190,7 @@ module Google
183
190
  @project_count = args[:project_count] if args.key?(:project_count)
184
191
  @resource_count = args[:resource_count] if args.key?(:resource_count)
185
192
  @resource_types = args[:resource_types] if args.key?(:resource_types)
193
+ @warnings = args[:warnings] if args.key?(:warnings)
186
194
  end
187
195
  end
188
196
 
@@ -212,6 +220,32 @@ module Google
212
220
  end
213
221
  end
214
222
 
223
+ # Warning message specifying various states of response data that might indicate
224
+ # incomplete or partial results.
225
+ class GoogleCloudKmsInventoryV1Warning
226
+ include Google::Apis::Core::Hashable
227
+
228
+ # The literal message providing context and details about the warnings.
229
+ # Corresponds to the JSON property `displayMessage`
230
+ # @return [String]
231
+ attr_accessor :display_message
232
+
233
+ # The specific warning code for the displayed message.
234
+ # Corresponds to the JSON property `warningCode`
235
+ # @return [String]
236
+ attr_accessor :warning_code
237
+
238
+ def initialize(**args)
239
+ update!(**args)
240
+ end
241
+
242
+ # Update properties of this object
243
+ def update!(**args)
244
+ @display_message = args[:display_message] if args.key?(:display_message)
245
+ @warning_code = args[:warning_code] if args.key?(:warning_code)
246
+ end
247
+ end
248
+
215
249
  # A CryptoKey represents a logical key that can be used for cryptographic
216
250
  # operations. A CryptoKey is made up of zero or more versions, which represent
217
251
  # the actual key material used in cryptographic operations.
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module KmsinventoryV1
18
18
  # Version of the google-apis-kmsinventory_v1 gem
19
- GEM_VERSION = "0.12.0"
19
+ GEM_VERSION = "0.13.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 = "20251207"
25
+ REVISION = "20260201"
26
26
  end
27
27
  end
28
28
  end
@@ -46,6 +46,12 @@ module Google
46
46
  include Google::Apis::Core::JsonObjectSupport
47
47
  end
48
48
 
49
+ class GoogleCloudKmsInventoryV1Warning
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
49
55
  class GoogleCloudKmsV1CryptoKey
50
56
  class Representation < Google::Apis::Core::JsonRepresentation; end
51
57
 
@@ -122,6 +128,8 @@ module Google
122
128
  property :project_count, as: 'projectCount'
123
129
  property :resource_count, :numeric_string => true, as: 'resourceCount'
124
130
  hash :resource_types, as: 'resourceTypes'
131
+ collection :warnings, as: 'warnings', class: Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1Warning, decorator: Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1Warning::Representation
132
+
125
133
  end
126
134
  end
127
135
 
@@ -134,6 +142,14 @@ module Google
134
142
  end
135
143
  end
136
144
 
145
+ class GoogleCloudKmsInventoryV1Warning
146
+ # @private
147
+ class Representation < Google::Apis::Core::JsonRepresentation
148
+ property :display_message, as: 'displayMessage'
149
+ property :warning_code, as: 'warningCode'
150
+ end
151
+ end
152
+
137
153
  class GoogleCloudKmsV1CryptoKey
138
154
  # @private
139
155
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -52,9 +52,13 @@ module Google
52
52
  end
53
53
 
54
54
  # Returns metadata about the resources protected by the given Cloud KMS
55
- # CryptoKey in the given Cloud organization.
55
+ # CryptoKey in the given Cloud organization/project.
56
56
  # @param [String] scope
57
- # Required. Resource name of the organization. Example: organizations/123
57
+ # Required. A scope can be an organization or a project. Resources protected by
58
+ # the crypto key in provided scope will be returned. The allowed values are: *
59
+ # organizations/`ORGANIZATION_NUMBER` (e.g., "organizations/12345678") *
60
+ # projects/`PROJECT_ID` (e.g., "projects/foo-bar") * projects/`PROJECT_NUMBER` (
61
+ # e.g., "projects/12345678")
58
62
  # @param [String] crypto_key
59
63
  # Required. The resource name of the CryptoKey.
60
64
  # @param [Fixnum] page_size
@@ -150,11 +154,18 @@ module Google
150
154
  end
151
155
 
152
156
  # Returns aggregate information about the resources protected by the given Cloud
153
- # KMS CryptoKey. Only resources within the same Cloud organization as the key
154
- # will be returned. The project that holds the key must be part of an
155
- # organization in order for this call to succeed.
157
+ # KMS CryptoKey. By default, summary of resources within the same Cloud
158
+ # organization as the key will be returned, which requires the KMS organization
159
+ # service account to be configured(refer https://docs.cloud.google.com/kms/docs/
160
+ # view-key-usage#required-roles). If the KMS organization service account is not
161
+ # configured or key's project is not part of an organization, set fallback_scope
162
+ # to `FALLBACK_SCOPE_PROJECT` to retrieve a summary of protected resources
163
+ # within the key's project.
156
164
  # @param [String] name
157
165
  # Required. The resource name of the CryptoKey.
166
+ # @param [String] fallback_scope
167
+ # Optional. The scope to use if the kms organization service account is not
168
+ # configured.
158
169
  # @param [String] fields
159
170
  # Selector specifying which fields to include in a partial response.
160
171
  # @param [String] quota_user
@@ -172,11 +183,72 @@ module Google
172
183
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
173
184
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
174
185
  # @raise [Google::Apis::AuthorizationError] Authorization is required
175
- def get_project_location_key_ring_crypto_key_protected_resources_summary(name, fields: nil, quota_user: nil, options: nil, &block)
186
+ def get_project_location_key_ring_crypto_key_protected_resources_summary(name, fallback_scope: nil, fields: nil, quota_user: nil, options: nil, &block)
176
187
  command = make_simple_command(:get, 'v1/{+name}/protectedResourcesSummary', options)
177
188
  command.response_representation = Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1ProtectedResourcesSummary::Representation
178
189
  command.response_class = Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1ProtectedResourcesSummary
179
190
  command.params['name'] = name unless name.nil?
191
+ command.query['fallbackScope'] = fallback_scope unless fallback_scope.nil?
192
+ command.query['fields'] = fields unless fields.nil?
193
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
194
+ execute_or_queue_command(command, &block)
195
+ end
196
+
197
+ # Returns metadata about the resources protected by the given Cloud KMS
198
+ # CryptoKey in the given Cloud organization/project.
199
+ # @param [String] scope
200
+ # Required. A scope can be an organization or a project. Resources protected by
201
+ # the crypto key in provided scope will be returned. The allowed values are: *
202
+ # organizations/`ORGANIZATION_NUMBER` (e.g., "organizations/12345678") *
203
+ # projects/`PROJECT_ID` (e.g., "projects/foo-bar") * projects/`PROJECT_NUMBER` (
204
+ # e.g., "projects/12345678")
205
+ # @param [String] crypto_key
206
+ # Required. The resource name of the CryptoKey.
207
+ # @param [Fixnum] page_size
208
+ # The maximum number of resources to return. The service may return fewer than
209
+ # this value. If unspecified, at most 500 resources will be returned. The
210
+ # maximum value is 500; values above 500 will be coerced to 500.
211
+ # @param [String] page_token
212
+ # A page token, received from a previous KeyTrackingService.
213
+ # SearchProtectedResources call. Provide this to retrieve the subsequent page.
214
+ # When paginating, all other parameters provided to KeyTrackingService.
215
+ # SearchProtectedResources must match the call that provided the page token.
216
+ # @param [Array<String>, String] resource_types
217
+ # Optional. A list of resource types that this request searches for. If empty,
218
+ # it will search all the [trackable resource types](https://cloud.google.com/kms/
219
+ # docs/view-key-usage#tracked-resource-types). Regular expressions are also
220
+ # supported. For example: * `compute.googleapis.com.*` snapshots resources whose
221
+ # type starts with `compute.googleapis.com`. * `.*Image` snapshots resources
222
+ # whose type ends with `Image`. * `.*Image.*` snapshots resources whose type
223
+ # contains `Image`. See [RE2](https://github.com/google/re2/wiki/Syntax) for all
224
+ # supported regular expression syntax. If the regular expression does not match
225
+ # any supported resource type, an INVALID_ARGUMENT error will be returned.
226
+ # @param [String] fields
227
+ # Selector specifying which fields to include in a partial response.
228
+ # @param [String] quota_user
229
+ # Available to use for quota purposes for server-side applications. Can be any
230
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
231
+ # @param [Google::Apis::RequestOptions] options
232
+ # Request-specific options
233
+ #
234
+ # @yield [result, err] Result & error if block supplied
235
+ # @yieldparam result [Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse] parsed result object
236
+ # @yieldparam err [StandardError] error object if request failed
237
+ #
238
+ # @return [Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse]
239
+ #
240
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
241
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
242
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
243
+ def search_project_protected_resources(scope, crypto_key: nil, page_size: nil, page_token: nil, resource_types: nil, fields: nil, quota_user: nil, options: nil, &block)
244
+ command = make_simple_command(:get, 'v1/{+scope}/protectedResources:search', options)
245
+ command.response_representation = Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse::Representation
246
+ command.response_class = Google::Apis::KmsinventoryV1::GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse
247
+ command.params['scope'] = scope unless scope.nil?
248
+ command.query['cryptoKey'] = crypto_key unless crypto_key.nil?
249
+ command.query['pageSize'] = page_size unless page_size.nil?
250
+ command.query['pageToken'] = page_token unless page_token.nil?
251
+ command.query['resourceTypes'] = resource_types unless resource_types.nil?
180
252
  command.query['fields'] = fields unless fields.nil?
181
253
  command.query['quotaUser'] = quota_user unless quota_user.nil?
182
254
  execute_or_queue_command(command, &block)
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-kmsinventory_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.12.0
4
+ version: 0.13.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-kmsinventory_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-kmsinventory_v1/v0.12.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-kmsinventory_v1/v0.13.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-kmsinventory_v1
62
62
  rdoc_options: []
63
63
  require_paths: