google-apis-cloudkms_v1 0.16.0 → 0.17.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: 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