google-apis-cloudkms_v1 0.16.0 → 0.17.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: bc057de24245cd7eb971987a78baf5c5675d840e662c5dc1a260b07c69ecfdad
4
- data.tar.gz: '009ee70c362b987c4a82a2e1228558f4dd2defc49af4618d32d2e9a3c26376d4'
3
+ metadata.gz: 8ec60a3216d48fdd7643cfd06b15d7c77c684906787e8f2011de2eb640bd835c
4
+ data.tar.gz: e0fa9973ecbee473a9059cb5582805c2876278b4697663d1f5159c8d120377f4
5
5
  SHA512:
6
- metadata.gz: d20c9437983d3f997dec4d3d62317cce3611b9ccbdeaecc93a2da0e3ef035a9a1d793145340a83152ef101c0a0c2bf95a6f5bdfffe8d9d36a3f249dab299bc66
7
- data.tar.gz: e46b89d687f90234e58bb804d112f0a8646b11172fb0b82611f10f7d2ba6b35dad0f8ebc74a216ff1e7799ed5c5f632c030e6a359c754d09b9d4ce6020b8088d
6
+ metadata.gz: 2fa70620dc64d846fe35a03eccc03eb2babfde5f1917201292f541e4e5bcb41f1d3c2e841c158151c3aa562f6bba1bb016567169805e553ddafebfb3d0daf0ce
7
+ data.tar.gz: 8598f9d9d0412bbb04c9f8f5cb1fcf9a6faaa78ad659b7355943a09a340e4d1407051dd16459a30f927dc644f0a0468cf77b9f70be67d65dc97f00efd74d8f74
data/CHANGELOG.md CHANGED
@@ -1,5 +1,10 @@
1
1
  # Release history for google-apis-cloudkms_v1
2
2
 
3
+ ### v0.17.0 (2022-01-28)
4
+
5
+ * Regenerated from discovery document revision 20220122
6
+ * Regenerated using generator version 0.4.1
7
+
3
8
  ### v0.16.0 (2022-01-08)
4
9
 
5
10
  * Regenerated from discovery document revision 20220104
@@ -390,6 +390,82 @@ module Google
390
390
  end
391
391
  end
392
392
 
393
+ # A Certificate represents an X.509 certificate used to authenticate HTTPS
394
+ # connections to EKM replicas.
395
+ class Certificate
396
+ include Google::Apis::Core::Hashable
397
+
398
+ # Output only. The issuer distinguished name in RFC 2253 format. Only present if
399
+ # parsed is true.
400
+ # Corresponds to the JSON property `issuer`
401
+ # @return [String]
402
+ attr_accessor :issuer
403
+
404
+ # Output only. The certificate is not valid after this time. Only present if
405
+ # parsed is true.
406
+ # Corresponds to the JSON property `notAfterTime`
407
+ # @return [String]
408
+ attr_accessor :not_after_time
409
+
410
+ # Output only. The certificate is not valid before this time. Only present if
411
+ # parsed is true.
412
+ # Corresponds to the JSON property `notBeforeTime`
413
+ # @return [String]
414
+ attr_accessor :not_before_time
415
+
416
+ # Output only. True if the certificate was parsed successfully.
417
+ # Corresponds to the JSON property `parsed`
418
+ # @return [Boolean]
419
+ attr_accessor :parsed
420
+ alias_method :parsed?, :parsed
421
+
422
+ # Required. The raw certificate bytes in DER format.
423
+ # Corresponds to the JSON property `rawDer`
424
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
425
+ # @return [String]
426
+ attr_accessor :raw_der
427
+
428
+ # Output only. The certificate serial number as a hex string. Only present if
429
+ # parsed is true.
430
+ # Corresponds to the JSON property `serialNumber`
431
+ # @return [String]
432
+ attr_accessor :serial_number
433
+
434
+ # Output only. The SHA-256 certificate fingerprint as a hex string. Only present
435
+ # if parsed is true.
436
+ # Corresponds to the JSON property `sha256Fingerprint`
437
+ # @return [String]
438
+ attr_accessor :sha256_fingerprint
439
+
440
+ # Output only. The subject distinguished name in RFC 2253 format. Only present
441
+ # if parsed is true.
442
+ # Corresponds to the JSON property `subject`
443
+ # @return [String]
444
+ attr_accessor :subject
445
+
446
+ # Output only. The subject Alternative DNS names. Only present if parsed is true.
447
+ # Corresponds to the JSON property `subjectAlternativeDnsNames`
448
+ # @return [Array<String>]
449
+ attr_accessor :subject_alternative_dns_names
450
+
451
+ def initialize(**args)
452
+ update!(**args)
453
+ end
454
+
455
+ # Update properties of this object
456
+ def update!(**args)
457
+ @issuer = args[:issuer] if args.key?(:issuer)
458
+ @not_after_time = args[:not_after_time] if args.key?(:not_after_time)
459
+ @not_before_time = args[:not_before_time] if args.key?(:not_before_time)
460
+ @parsed = args[:parsed] if args.key?(:parsed)
461
+ @raw_der = args[:raw_der] if args.key?(:raw_der)
462
+ @serial_number = args[:serial_number] if args.key?(:serial_number)
463
+ @sha256_fingerprint = args[:sha256_fingerprint] if args.key?(:sha256_fingerprint)
464
+ @subject = args[:subject] if args.key?(:subject)
465
+ @subject_alternative_dns_names = args[:subject_alternative_dns_names] if args.key?(:subject_alternative_dns_names)
466
+ end
467
+ end
468
+
393
469
  # Certificate chains needed to verify the attestation. Certificates in chains
394
470
  # are PEM-encoded and are ordered based on https://tools.ietf.org/html/rfc5246#
395
471
  # section-7.4.2.
@@ -434,6 +510,16 @@ module Google
434
510
  # @return [String]
435
511
  attr_accessor :create_time
436
512
 
513
+ # Immutable. The resource name of the backend environment where the key material
514
+ # for all CryptoKeyVersions associated with this CryptoKey reside and where all
515
+ # related cryptographic operations are performed. Only applicable if
516
+ # CryptoKeyVersions have a ProtectionLevel of EXTERNAL_VPC, with the resource
517
+ # name in the format `projects/*/locations/*/ekmConnections/*`. Note, this list
518
+ # is non-exhaustive and may apply to additional ProtectionLevels in the future.
519
+ # Corresponds to the JSON property `cryptoKeyBackend`
520
+ # @return [String]
521
+ attr_accessor :crypto_key_backend
522
+
437
523
  # Immutable. The period of time that versions of this key spend in the
438
524
  # DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at
439
525
  # creation time, the default duration is 24 hours.
@@ -507,6 +593,7 @@ module Google
507
593
  # Update properties of this object
508
594
  def update!(**args)
509
595
  @create_time = args[:create_time] if args.key?(:create_time)
596
+ @crypto_key_backend = args[:crypto_key_backend] if args.key?(:crypto_key_backend)
510
597
  @destroy_scheduled_duration = args[:destroy_scheduled_duration] if args.key?(:destroy_scheduled_duration)
511
598
  @import_only = args[:import_only] if args.key?(:import_only)
512
599
  @labels = args[:labels] if args.key?(:labels)
@@ -559,7 +646,7 @@ module Google
559
646
 
560
647
  # ExternalProtectionLevelOptions stores a group of additional fields for
561
648
  # configuring a CryptoKeyVersion that are specific to the EXTERNAL protection
562
- # level.
649
+ # level and EXTERNAL_VPC protection levels.
563
650
  # Corresponds to the JSON property `externalProtectionLevelOptions`
564
651
  # @return [Google::Apis::CloudkmsV1::ExternalProtectionLevelOptions]
565
652
  attr_accessor :external_protection_level_options
@@ -823,6 +910,51 @@ module Google
823
910
  end
824
911
  end
825
912
 
913
+ # An EkmConnection represents an individual EKM connection. It can be used for
914
+ # creating CryptoKeys and CryptoKeyVersions with a ProtectionLevel of
915
+ # EXTERNAL_VPC, as well as performing cryptographic operations using keys
916
+ # created within the EkmConnection.
917
+ class EkmConnection
918
+ include Google::Apis::Core::Hashable
919
+
920
+ # Output only. The time at which the EkmConnection was created.
921
+ # Corresponds to the JSON property `createTime`
922
+ # @return [String]
923
+ attr_accessor :create_time
924
+
925
+ # This checksum is computed by the server based on the value of other fields,
926
+ # and may be sent on update requests to ensure the client has an up-to-date
927
+ # value before proceeding.
928
+ # Corresponds to the JSON property `etag`
929
+ # @return [String]
930
+ attr_accessor :etag
931
+
932
+ # Output only. The resource name for the EkmConnection in the format `projects/*/
933
+ # locations/*/ekmConnections/*`.
934
+ # Corresponds to the JSON property `name`
935
+ # @return [String]
936
+ attr_accessor :name
937
+
938
+ # A list of ServiceResolvers where the EKM can be reached. There should be one
939
+ # ServiceResolver per EKM replica. Currently, only a single ServiceResolver is
940
+ # supported.
941
+ # Corresponds to the JSON property `serviceResolvers`
942
+ # @return [Array<Google::Apis::CloudkmsV1::ServiceResolver>]
943
+ attr_accessor :service_resolvers
944
+
945
+ def initialize(**args)
946
+ update!(**args)
947
+ end
948
+
949
+ # Update properties of this object
950
+ def update!(**args)
951
+ @create_time = args[:create_time] if args.key?(:create_time)
952
+ @etag = args[:etag] if args.key?(:etag)
953
+ @name = args[:name] if args.key?(:name)
954
+ @service_resolvers = args[:service_resolvers] if args.key?(:service_resolvers)
955
+ end
956
+ end
957
+
826
958
  # Request message for KeyManagementService.Encrypt.
827
959
  class EncryptRequest
828
960
  include Google::Apis::Core::Hashable
@@ -1021,10 +1153,17 @@ module Google
1021
1153
 
1022
1154
  # ExternalProtectionLevelOptions stores a group of additional fields for
1023
1155
  # configuring a CryptoKeyVersion that are specific to the EXTERNAL protection
1024
- # level.
1156
+ # level and EXTERNAL_VPC protection levels.
1025
1157
  class ExternalProtectionLevelOptions
1026
1158
  include Google::Apis::Core::Hashable
1027
1159
 
1160
+ # The path to the external key material on the EKM when using EkmConnection e.g.,
1161
+ # "v0/my/key". Set this field instead of external_key_uri when using an
1162
+ # EkmConnection.
1163
+ # Corresponds to the JSON property `ekmConnectionKeyPath`
1164
+ # @return [String]
1165
+ attr_accessor :ekm_connection_key_path
1166
+
1028
1167
  # The URI for an external resource that this CryptoKeyVersion represents.
1029
1168
  # Corresponds to the JSON property `externalKeyUri`
1030
1169
  # @return [String]
@@ -1036,6 +1175,7 @@ module Google
1036
1175
 
1037
1176
  # Update properties of this object
1038
1177
  def update!(**args)
1178
+ @ekm_connection_key_path = args[:ekm_connection_key_path] if args.key?(:ekm_connection_key_path)
1039
1179
  @external_key_uri = args[:external_key_uri] if args.key?(:external_key_uri)
1040
1180
  end
1041
1181
  end
@@ -1381,6 +1521,38 @@ module Google
1381
1521
  end
1382
1522
  end
1383
1523
 
1524
+ # Response message for KeyManagementService.ListEkmConnections.
1525
+ class ListEkmConnectionsResponse
1526
+ include Google::Apis::Core::Hashable
1527
+
1528
+ # The list of EkmConnections.
1529
+ # Corresponds to the JSON property `ekmConnections`
1530
+ # @return [Array<Google::Apis::CloudkmsV1::EkmConnection>]
1531
+ attr_accessor :ekm_connections
1532
+
1533
+ # A token to retrieve next page of results. Pass this value in
1534
+ # ListEkmConnectionsRequest.page_token to retrieve the next page of results.
1535
+ # Corresponds to the JSON property `nextPageToken`
1536
+ # @return [String]
1537
+ attr_accessor :next_page_token
1538
+
1539
+ # The total number of EkmConnections that matched the query.
1540
+ # Corresponds to the JSON property `totalSize`
1541
+ # @return [Fixnum]
1542
+ attr_accessor :total_size
1543
+
1544
+ def initialize(**args)
1545
+ update!(**args)
1546
+ end
1547
+
1548
+ # Update properties of this object
1549
+ def update!(**args)
1550
+ @ekm_connections = args[:ekm_connections] if args.key?(:ekm_connections)
1551
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1552
+ @total_size = args[:total_size] if args.key?(:total_size)
1553
+ end
1554
+ end
1555
+
1384
1556
  # Response message for KeyManagementService.ListImportJobs.
1385
1557
  class ListImportJobsResponse
1386
1558
  include Google::Apis::Core::Hashable
@@ -1936,6 +2108,50 @@ module Google
1936
2108
  end
1937
2109
  end
1938
2110
 
2111
+ # A ServiceResolver represents an EKM replica that can be reached within an
2112
+ # EkmConnection.
2113
+ class ServiceResolver
2114
+ include Google::Apis::Core::Hashable
2115
+
2116
+ # Optional. The filter applied to the endpoints of the resolved service. If no
2117
+ # filter is specified, all endpoints will be considered. An endpoint will be
2118
+ # chosen arbitrarily from the filtered list for each request. For endpoint
2119
+ # filter syntax and examples, see https://cloud.google.com/service-directory/
2120
+ # docs/reference/rpc/google.cloud.servicedirectory.v1#resolveservicerequest.
2121
+ # Corresponds to the JSON property `endpointFilter`
2122
+ # @return [String]
2123
+ attr_accessor :endpoint_filter
2124
+
2125
+ # Required. The hostname of the EKM replica used at TLS and HTTP layers.
2126
+ # Corresponds to the JSON property `hostname`
2127
+ # @return [String]
2128
+ attr_accessor :hostname
2129
+
2130
+ # Required. A list of leaf server certificates used to authenticate HTTPS
2131
+ # connections to the EKM replica.
2132
+ # Corresponds to the JSON property `serverCertificates`
2133
+ # @return [Array<Google::Apis::CloudkmsV1::Certificate>]
2134
+ attr_accessor :server_certificates
2135
+
2136
+ # Required. The resource name of the Service Directory service pointing to an
2137
+ # EKM replica, in the format `projects/*/locations/*/namespaces/*/services/*`.
2138
+ # Corresponds to the JSON property `serviceDirectoryService`
2139
+ # @return [String]
2140
+ attr_accessor :service_directory_service
2141
+
2142
+ def initialize(**args)
2143
+ update!(**args)
2144
+ end
2145
+
2146
+ # Update properties of this object
2147
+ def update!(**args)
2148
+ @endpoint_filter = args[:endpoint_filter] if args.key?(:endpoint_filter)
2149
+ @hostname = args[:hostname] if args.key?(:hostname)
2150
+ @server_certificates = args[:server_certificates] if args.key?(:server_certificates)
2151
+ @service_directory_service = args[:service_directory_service] if args.key?(:service_directory_service)
2152
+ end
2153
+ end
2154
+
1939
2155
  # Request message for `SetIamPolicy` method.
1940
2156
  class SetIamPolicyRequest
1941
2157
  include Google::Apis::Core::Hashable
@@ -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.16.0"
19
+ GEM_VERSION = "0.17.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.4.0"
22
+ GENERATOR_VERSION = "0.4.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20220104"
25
+ REVISION = "20220122"
26
26
  end
27
27
  end
28
28
  end
@@ -64,6 +64,12 @@ module Google
64
64
  include Google::Apis::Core::JsonObjectSupport
65
65
  end
66
66
 
67
+ class Certificate
68
+ class Representation < Google::Apis::Core::JsonRepresentation; end
69
+
70
+ include Google::Apis::Core::JsonObjectSupport
71
+ end
72
+
67
73
  class CertificateChains
68
74
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
75
 
@@ -112,6 +118,12 @@ module Google
112
118
  include Google::Apis::Core::JsonObjectSupport
113
119
  end
114
120
 
121
+ class EkmConnection
122
+ class Representation < Google::Apis::Core::JsonRepresentation; end
123
+
124
+ include Google::Apis::Core::JsonObjectSupport
125
+ end
126
+
115
127
  class EncryptRequest
116
128
  class Representation < Google::Apis::Core::JsonRepresentation; end
117
129
 
@@ -184,6 +196,12 @@ module Google
184
196
  include Google::Apis::Core::JsonObjectSupport
185
197
  end
186
198
 
199
+ class ListEkmConnectionsResponse
200
+ class Representation < Google::Apis::Core::JsonRepresentation; end
201
+
202
+ include Google::Apis::Core::JsonObjectSupport
203
+ end
204
+
187
205
  class ListImportJobsResponse
188
206
  class Representation < Google::Apis::Core::JsonRepresentation; end
189
207
 
@@ -256,6 +274,12 @@ module Google
256
274
  include Google::Apis::Core::JsonObjectSupport
257
275
  end
258
276
 
277
+ class ServiceResolver
278
+ class Representation < Google::Apis::Core::JsonRepresentation; end
279
+
280
+ include Google::Apis::Core::JsonObjectSupport
281
+ end
282
+
259
283
  class SetIamPolicyRequest
260
284
  class Representation < Google::Apis::Core::JsonRepresentation; end
261
285
 
@@ -354,6 +378,21 @@ module Google
354
378
  end
355
379
  end
356
380
 
381
+ class Certificate
382
+ # @private
383
+ class Representation < Google::Apis::Core::JsonRepresentation
384
+ property :issuer, as: 'issuer'
385
+ property :not_after_time, as: 'notAfterTime'
386
+ property :not_before_time, as: 'notBeforeTime'
387
+ property :parsed, as: 'parsed'
388
+ property :raw_der, :base64 => true, as: 'rawDer'
389
+ property :serial_number, as: 'serialNumber'
390
+ property :sha256_fingerprint, as: 'sha256Fingerprint'
391
+ property :subject, as: 'subject'
392
+ collection :subject_alternative_dns_names, as: 'subjectAlternativeDnsNames'
393
+ end
394
+ end
395
+
357
396
  class CertificateChains
358
397
  # @private
359
398
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -367,6 +406,7 @@ module Google
367
406
  # @private
368
407
  class Representation < Google::Apis::Core::JsonRepresentation
369
408
  property :create_time, as: 'createTime'
409
+ property :crypto_key_backend, as: 'cryptoKeyBackend'
370
410
  property :destroy_scheduled_duration, as: 'destroyScheduledDuration'
371
411
  property :import_only, as: 'importOnly'
372
412
  hash :labels, as: 'labels'
@@ -446,6 +486,17 @@ module Google
446
486
  end
447
487
  end
448
488
 
489
+ class EkmConnection
490
+ # @private
491
+ class Representation < Google::Apis::Core::JsonRepresentation
492
+ property :create_time, as: 'createTime'
493
+ property :etag, as: 'etag'
494
+ property :name, as: 'name'
495
+ collection :service_resolvers, as: 'serviceResolvers', class: Google::Apis::CloudkmsV1::ServiceResolver, decorator: Google::Apis::CloudkmsV1::ServiceResolver::Representation
496
+
497
+ end
498
+ end
499
+
449
500
  class EncryptRequest
450
501
  # @private
451
502
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -481,6 +532,7 @@ module Google
481
532
  class ExternalProtectionLevelOptions
482
533
  # @private
483
534
  class Representation < Google::Apis::Core::JsonRepresentation
535
+ property :ekm_connection_key_path, as: 'ekmConnectionKeyPath'
484
536
  property :external_key_uri, as: 'externalKeyUri'
485
537
  end
486
538
  end
@@ -567,6 +619,16 @@ module Google
567
619
  end
568
620
  end
569
621
 
622
+ class ListEkmConnectionsResponse
623
+ # @private
624
+ class Representation < Google::Apis::Core::JsonRepresentation
625
+ collection :ekm_connections, as: 'ekmConnections', class: Google::Apis::CloudkmsV1::EkmConnection, decorator: Google::Apis::CloudkmsV1::EkmConnection::Representation
626
+
627
+ property :next_page_token, as: 'nextPageToken'
628
+ property :total_size, as: 'totalSize'
629
+ end
630
+ end
631
+
570
632
  class ListImportJobsResponse
571
633
  # @private
572
634
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -685,6 +747,17 @@ module Google
685
747
  end
686
748
  end
687
749
 
750
+ class ServiceResolver
751
+ # @private
752
+ class Representation < Google::Apis::Core::JsonRepresentation
753
+ property :endpoint_filter, as: 'endpointFilter'
754
+ property :hostname, as: 'hostname'
755
+ collection :server_certificates, as: 'serverCertificates', class: Google::Apis::CloudkmsV1::Certificate, decorator: Google::Apis::CloudkmsV1::Certificate::Representation
756
+
757
+ property :service_directory_service, as: 'serviceDirectoryService'
758
+ end
759
+ end
760
+
688
761
  class SetIamPolicyRequest
689
762
  # @private
690
763
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -158,6 +158,74 @@ module Google
158
158
  execute_or_queue_command(command, &block)
159
159
  end
160
160
 
161
+ # Creates a new EkmConnection in a given Project and Location.
162
+ # @param [String] parent
163
+ # Required. The resource name of the location associated with the EkmConnection,
164
+ # in the format `projects/*/locations/*`.
165
+ # @param [Google::Apis::CloudkmsV1::EkmConnection] ekm_connection_object
166
+ # @param [String] ekm_connection_id
167
+ # Required. It must be unique within a location and match the regular expression
168
+ # `[a-zA-Z0-9_-]`1,63``.
169
+ # @param [String] fields
170
+ # Selector specifying which fields to include in a partial response.
171
+ # @param [String] quota_user
172
+ # Available to use for quota purposes for server-side applications. Can be any
173
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
174
+ # @param [Google::Apis::RequestOptions] options
175
+ # Request-specific options
176
+ #
177
+ # @yield [result, err] Result & error if block supplied
178
+ # @yieldparam result [Google::Apis::CloudkmsV1::EkmConnection] parsed result object
179
+ # @yieldparam err [StandardError] error object if request failed
180
+ #
181
+ # @return [Google::Apis::CloudkmsV1::EkmConnection]
182
+ #
183
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
184
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
185
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
186
+ def create_project_location_ekm_connection(parent, ekm_connection_object = nil, ekm_connection_id: nil, fields: nil, quota_user: nil, options: nil, &block)
187
+ command = make_simple_command(:post, 'v1/{+parent}/ekmConnections', options)
188
+ command.request_representation = Google::Apis::CloudkmsV1::EkmConnection::Representation
189
+ command.request_object = ekm_connection_object
190
+ command.response_representation = Google::Apis::CloudkmsV1::EkmConnection::Representation
191
+ command.response_class = Google::Apis::CloudkmsV1::EkmConnection
192
+ command.params['parent'] = parent unless parent.nil?
193
+ command.query['ekmConnectionId'] = ekm_connection_id unless ekm_connection_id.nil?
194
+ command.query['fields'] = fields unless fields.nil?
195
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
196
+ execute_or_queue_command(command, &block)
197
+ end
198
+
199
+ # Returns metadata for a given EkmConnection.
200
+ # @param [String] name
201
+ # Required. The name of the EkmConnection to get.
202
+ # @param [String] fields
203
+ # Selector specifying which fields to include in a partial response.
204
+ # @param [String] quota_user
205
+ # Available to use for quota purposes for server-side applications. Can be any
206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
207
+ # @param [Google::Apis::RequestOptions] options
208
+ # Request-specific options
209
+ #
210
+ # @yield [result, err] Result & error if block supplied
211
+ # @yieldparam result [Google::Apis::CloudkmsV1::EkmConnection] parsed result object
212
+ # @yieldparam err [StandardError] error object if request failed
213
+ #
214
+ # @return [Google::Apis::CloudkmsV1::EkmConnection]
215
+ #
216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
219
+ def get_project_location_ekm_connection(name, fields: nil, quota_user: nil, options: nil, &block)
220
+ command = make_simple_command(:get, 'v1/{+name}', options)
221
+ command.response_representation = Google::Apis::CloudkmsV1::EkmConnection::Representation
222
+ command.response_class = Google::Apis::CloudkmsV1::EkmConnection
223
+ command.params['name'] = name unless name.nil?
224
+ command.query['fields'] = fields unless fields.nil?
225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
226
+ execute_or_queue_command(command, &block)
227
+ end
228
+
161
229
  # Gets the access control policy for a resource. Returns an empty policy if the
162
230
  # resource exists and does not have a policy set.
163
231
  # @param [String] resource
@@ -202,6 +270,95 @@ module Google
202
270
  execute_or_queue_command(command, &block)
203
271
  end
204
272
 
273
+ # Lists EkmConnections.
274
+ # @param [String] parent
275
+ # Required. The resource name of the location associated with the EkmConnections
276
+ # to list, in the format `projects/*/locations/*`.
277
+ # @param [String] filter
278
+ # Optional. Only include resources that match the filter in the response. For
279
+ # more information, see [Sorting and filtering list results](https://cloud.
280
+ # google.com/kms/docs/sorting-and-filtering).
281
+ # @param [String] order_by
282
+ # Optional. Specify how the results should be sorted. If not specified, the
283
+ # results will be sorted in the default order. For more information, see [
284
+ # Sorting and filtering list results](https://cloud.google.com/kms/docs/sorting-
285
+ # and-filtering).
286
+ # @param [Fixnum] page_size
287
+ # Optional. Optional limit on the number of EkmConnections to include in the
288
+ # response. Further EkmConnections can subsequently be obtained by including the
289
+ # ListEkmConnectionsResponse.next_page_token in a subsequent request. If
290
+ # unspecified, the server will pick an appropriate default.
291
+ # @param [String] page_token
292
+ # Optional. Optional pagination token, returned earlier via
293
+ # ListEkmConnectionsResponse.next_page_token.
294
+ # @param [String] fields
295
+ # Selector specifying which fields to include in a partial response.
296
+ # @param [String] quota_user
297
+ # Available to use for quota purposes for server-side applications. Can be any
298
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
299
+ # @param [Google::Apis::RequestOptions] options
300
+ # Request-specific options
301
+ #
302
+ # @yield [result, err] Result & error if block supplied
303
+ # @yieldparam result [Google::Apis::CloudkmsV1::ListEkmConnectionsResponse] parsed result object
304
+ # @yieldparam err [StandardError] error object if request failed
305
+ #
306
+ # @return [Google::Apis::CloudkmsV1::ListEkmConnectionsResponse]
307
+ #
308
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
309
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
310
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
311
+ def list_project_location_ekm_connections(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
312
+ command = make_simple_command(:get, 'v1/{+parent}/ekmConnections', options)
313
+ command.response_representation = Google::Apis::CloudkmsV1::ListEkmConnectionsResponse::Representation
314
+ command.response_class = Google::Apis::CloudkmsV1::ListEkmConnectionsResponse
315
+ command.params['parent'] = parent unless parent.nil?
316
+ command.query['filter'] = filter unless filter.nil?
317
+ command.query['orderBy'] = order_by unless order_by.nil?
318
+ command.query['pageSize'] = page_size unless page_size.nil?
319
+ command.query['pageToken'] = page_token unless page_token.nil?
320
+ command.query['fields'] = fields unless fields.nil?
321
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
322
+ execute_or_queue_command(command, &block)
323
+ end
324
+
325
+ # Updates an EkmConnection's metadata.
326
+ # @param [String] name
327
+ # Output only. The resource name for the EkmConnection in the format `projects/*/
328
+ # locations/*/ekmConnections/*`.
329
+ # @param [Google::Apis::CloudkmsV1::EkmConnection] ekm_connection_object
330
+ # @param [String] update_mask
331
+ # Required. List of fields to be updated in this request.
332
+ # @param [String] fields
333
+ # Selector specifying which fields to include in a partial response.
334
+ # @param [String] quota_user
335
+ # Available to use for quota purposes for server-side applications. Can be any
336
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
337
+ # @param [Google::Apis::RequestOptions] options
338
+ # Request-specific options
339
+ #
340
+ # @yield [result, err] Result & error if block supplied
341
+ # @yieldparam result [Google::Apis::CloudkmsV1::EkmConnection] parsed result object
342
+ # @yieldparam err [StandardError] error object if request failed
343
+ #
344
+ # @return [Google::Apis::CloudkmsV1::EkmConnection]
345
+ #
346
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
347
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
348
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
349
+ def patch_project_location_ekm_connection(name, ekm_connection_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
350
+ command = make_simple_command(:patch, 'v1/{+name}', options)
351
+ command.request_representation = Google::Apis::CloudkmsV1::EkmConnection::Representation
352
+ command.request_object = ekm_connection_object
353
+ command.response_representation = Google::Apis::CloudkmsV1::EkmConnection::Representation
354
+ command.response_class = Google::Apis::CloudkmsV1::EkmConnection
355
+ command.params['name'] = name unless name.nil?
356
+ command.query['updateMask'] = update_mask unless update_mask.nil?
357
+ command.query['fields'] = fields unless fields.nil?
358
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
359
+ execute_or_queue_command(command, &block)
360
+ end
361
+
205
362
  # Sets the access control policy on the specified resource. Replaces any
206
363
  # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
207
364
  # PERMISSION_DENIED` errors.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-cloudkms_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.16.0
4
+ version: 0.17.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-01-10 00:00:00.000000000 Z
11
+ date: 2022-01-31 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudkms_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.16.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.17.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudkms_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.3.4
78
+ rubygems_version: 3.3.5
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Cloud Key Management Service (KMS) API V1