lib/google/cloud/kms/v1/service_services_pb.rb in google-cloud-kms-1.0.2 vs lib/google/cloud/kms/v1/service_services_pb.rb in google-cloud-kms-1.1.0

- old
+ new

@@ -1,9 +1,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # Source: google/cloud/kms/v1/service.proto for package 'google.cloud.kms.v1' # Original file comments: -# Copyright 2018 Google LLC. +# Copyright 2019 Google LLC. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # @@ -49,113 +49,98 @@ rpc :ListKeyRings, ListKeyRingsRequest, ListKeyRingsResponse # Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey]. rpc :ListCryptoKeys, ListCryptoKeysRequest, ListCryptoKeysResponse # Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion]. rpc :ListCryptoKeyVersions, ListCryptoKeyVersionsRequest, ListCryptoKeyVersionsResponse + # Lists [ImportJobs][google.cloud.kms.v1.ImportJob]. + rpc :ListImportJobs, ListImportJobsRequest, ListImportJobsResponse # Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing]. rpc :GetKeyRing, GetKeyRingRequest, KeyRing - # Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as - # well as its [primary][google.cloud.kms.v1.CryptoKey.primary] - # [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. + # Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as well as its + # [primary][google.cloud.kms.v1.CryptoKey.primary] [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. rpc :GetCryptoKey, GetCryptoKeyRequest, CryptoKey - # Returns metadata for a given - # [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. + # Returns metadata for a given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. rpc :GetCryptoKeyVersion, GetCryptoKeyVersionRequest, CryptoKeyVersion - # Returns the public key for the given - # [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The + # Returns the public key for the given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The # [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - # [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] - # or + # [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] or # [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT]. rpc :GetPublicKey, GetPublicKeyRequest, PublicKey - # Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and - # Location. + # Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob]. + rpc :GetImportJob, GetImportJobRequest, ImportJob + # Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and Location. rpc :CreateKeyRing, CreateKeyRingRequest, KeyRing - # Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a - # [KeyRing][google.cloud.kms.v1.KeyRing]. + # Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a [KeyRing][google.cloud.kms.v1.KeyRing]. # # [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and # [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm] # are required. rpc :CreateCryptoKey, CreateCryptoKeyRequest, CryptoKey - # Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a - # [CryptoKey][google.cloud.kms.v1.CryptoKey]. + # Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a [CryptoKey][google.cloud.kms.v1.CryptoKey]. # # The server will assign the next sequential id. If unset, # [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to # [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED]. rpc :CreateCryptoKeyVersion, CreateCryptoKeyVersionRequest, CryptoKeyVersion + # Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the + # wrapped key material provided in the request. + # + # The version ID will be assigned the next sequential id within the + # [CryptoKey][google.cloud.kms.v1.CryptoKey]. + rpc :ImportCryptoKeyVersion, ImportCryptoKeyVersionRequest, CryptoKeyVersion + # Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a [KeyRing][google.cloud.kms.v1.KeyRing]. + # + # [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is required. + rpc :CreateImportJob, CreateImportJobRequest, ImportJob # Update a [CryptoKey][google.cloud.kms.v1.CryptoKey]. rpc :UpdateCryptoKey, UpdateCryptoKeyRequest, CryptoKey - # Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s - # metadata. + # Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s metadata. # # [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between - # [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] - # and - # [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] - # using this method. See - # [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] - # and - # [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - # to move between other states. + # [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] and + # [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] using this + # method. See [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] and [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] to + # move between other states. rpc :UpdateCryptoKeyVersion, UpdateCryptoKeyVersionRequest, CryptoKeyVersion - # Encrypts data, so that it can only be recovered by a call to - # [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The - # [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + # Encrypts data, so that it can only be recovered by a call to [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. + # The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be # [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. rpc :Encrypt, EncryptRequest, EncryptResponse - # Decrypts data that was protected by - # [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The - # [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - # [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. + # Decrypts data that was protected by [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + # must be [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. rpc :Decrypt, DecryptRequest, DecryptResponse - # Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] - # with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + # Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] # ASYMMETRIC_SIGN, producing a signature that can be verified with the public - # key retrieved from - # [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey]. + # key retrieved from [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey]. rpc :AsymmetricSign, AsymmetricSignRequest, AsymmetricSignResponse # Decrypts data that was encrypted with a public key retrieved from - # [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] - # corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] - # with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] - # ASYMMETRIC_DECRYPT. + # [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with + # [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] ASYMMETRIC_DECRYPT. rpc :AsymmetricDecrypt, AsymmetricDecryptRequest, AsymmetricDecryptResponse - # Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that - # will be used in - # [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. + # Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that will be used in [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. # # Returns an error if called on an asymmetric key. rpc :UpdateCryptoKeyPrimaryVersion, UpdateCryptoKeyPrimaryVersionRequest, CryptoKey - # Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for - # destruction. + # Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for destruction. # - # Upon calling this method, - # [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will - # be set to + # Upon calling this method, [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to # [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] - # and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will - # be set to a time 24 hours in the future, at which point the - # [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be changed to - # [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], - # and the key material will be irrevocably destroyed. + # and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will be set to a time 24 + # hours in the future, at which point the [state][google.cloud.kms.v1.CryptoKeyVersion.state] + # will be changed to + # [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], and the key + # material will be irrevocably destroyed. # - # Before the - # [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is - # reached, - # [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - # may be called to reverse the process. + # Before the [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is reached, + # [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] may be called to reverse the process. rpc :DestroyCryptoKeyVersion, DestroyCryptoKeyVersionRequest, CryptoKeyVersion # Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the # [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] # state. # - # Upon restoration of the CryptoKeyVersion, - # [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to - # [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED], - # and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will - # be cleared. + # Upon restoration of the CryptoKeyVersion, [state][google.cloud.kms.v1.CryptoKeyVersion.state] + # will be set to [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED], + # and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will be cleared. rpc :RestoreCryptoKeyVersion, RestoreCryptoKeyVersionRequest, CryptoKeyVersion end Stub = Service.rpc_stub_class end