docs(samples): add auto-generated Node samples (#501)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 398604509

Source-Link: googleapis/googleapis@6ef16b9

Source-Link: googleapis/googleapis-gen@8314e1e
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiODMxNGUxZWFkM2U5MDZkYmYyMDEyY2VkOGQ5MmYyYmM4ZGQ0NWM5NSJ9

packages/google-cloud-kms/samples/generated/v1/key_management_service.asymmetric_decrypt.js

@@ -0,0 +1,75 @@
+// Copyright 2021 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+function main(name, ciphertext) {
+ // [START kms_v1_generated_KeyManagementService_AsymmetricDecrypt_async]
+ /**
+ * TODO(developer): Uncomment these variables before running the sample.
+ */
+ /**
+ * Required. The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use for
+ * decryption.
+ */
+ // const name = 'abc123'
+ /**
+ * Required. The data encrypted with the named [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s public
+ * key using OAEP.
+ */
+ // const ciphertext = 'Buffer.from('string')'
+ /**
+ * Optional. An optional CRC32C checksum of the [AsymmetricDecryptRequest.ciphertext][google.cloud.kms.v1.AsymmetricDecryptRequest.ciphertext].
+ * If specified, [KeyManagementService][google.cloud.kms.v1.KeyManagementService] will verify the integrity of the
+ * received [AsymmetricDecryptRequest.ciphertext][google.cloud.kms.v1.AsymmetricDecryptRequest.ciphertext] using this checksum.
+ * [KeyManagementService][google.cloud.kms.v1.KeyManagementService] will report an error if the checksum verification
+ * fails. If you receive a checksum error, your client should verify that
+ * CRC32C([AsymmetricDecryptRequest.ciphertext][google.cloud.kms.v1.AsymmetricDecryptRequest.ciphertext]) is equal to
+ * [AsymmetricDecryptRequest.ciphertext_crc32c][google.cloud.kms.v1.AsymmetricDecryptRequest.ciphertext_crc32c], and if so, perform a
+ * limited number of retries. A persistent mismatch may indicate an issue in
+ * your computation of the CRC32C checksum.
+ * Note: This field is defined as int64 for reasons of compatibility across
+ * different languages. However, it is a non-negative integer, which will
+ * never exceed 2^32-1, and can be safely downconverted to uint32 in languages
+ * that support this type.
+ */
+ // const ciphertextCrc32c = ''
+
+ // Imports the Kms library
+ const {KeyManagementServiceClient} = require('@google-cloud/kms').v1;
+
+ // Instantiates a client
+ const kmsClient = new KeyManagementServiceClient();
+
+ async function asymmetricDecrypt() {
+ // Construct request
+ const request = {
+ name,
+ ciphertext,
+ };
+
+ // Run request
+ const response = await kmsClient.asymmetricDecrypt(request);
+ console.log(response);
+ }
+
+ asymmetricDecrypt();
+ // [END kms_v1_generated_KeyManagementService_AsymmetricDecrypt_async]
+}
+
+process.on('unhandledRejection', err => {
+ console.error(err.message);
+ process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-kms/samples/generated/v1/key_management_service.asymmetric_sign.js

@@ -0,0 +1,75 @@
+// Copyright 2021 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+function main(name, digest) {
+ // [START kms_v1_generated_KeyManagementService_AsymmetricSign_async]
+ /**
+ * TODO(developer): Uncomment these variables before running the sample.
+ */
+ /**
+ * Required. The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use for signing.
+ */
+ // const name = 'abc123'
+ /**
+ * Required. The digest of the data to sign. The digest must be produced with
+ * the same digest algorithm as specified by the key version's
+ * [algorithm][google.cloud.kms.v1.CryptoKeyVersion.algorithm].
+ */
+ // const digest = ''
+ /**
+ * Optional. An optional CRC32C checksum of the [AsymmetricSignRequest.digest][google.cloud.kms.v1.AsymmetricSignRequest.digest]. If
+ * specified, [KeyManagementService][google.cloud.kms.v1.KeyManagementService] will verify the integrity of the
+ * received [AsymmetricSignRequest.digest][google.cloud.kms.v1.AsymmetricSignRequest.digest] using this checksum.
+ * [KeyManagementService][google.cloud.kms.v1.KeyManagementService] will report an error if the checksum verification
+ * fails. If you receive a checksum error, your client should verify that
+ * CRC32C([AsymmetricSignRequest.digest][google.cloud.kms.v1.AsymmetricSignRequest.digest]) is equal to
+ * [AsymmetricSignRequest.digest_crc32c][google.cloud.kms.v1.AsymmetricSignRequest.digest_crc32c], and if so, perform a limited
+ * number of retries. A persistent mismatch may indicate an issue in your
+ * computation of the CRC32C checksum.
+ * Note: This field is defined as int64 for reasons of compatibility across
+ * different languages. However, it is a non-negative integer, which will
+ * never exceed 2^32-1, and can be safely downconverted to uint32 in languages
+ * that support this type.
+ */
+ // const digestCrc32c = ''
+
+ // Imports the Kms library
+ const {KeyManagementServiceClient} = require('@google-cloud/kms').v1;
+
+ // Instantiates a client
+ const kmsClient = new KeyManagementServiceClient();
+
+ async function asymmetricSign() {
+ // Construct request
+ const request = {
+ name,
+ digest,
+ };
+
+ // Run request
+ const response = await kmsClient.asymmetricSign(request);
+ console.log(response);
+ }
+
+ asymmetricSign();
+ // [END kms_v1_generated_KeyManagementService_AsymmetricSign_async]
+}
+
+process.on('unhandledRejection', err => {
+ console.error(err.message);
+ process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-kms/samples/generated/v1/key_management_service.create_crypto_key.js

@@ -0,0 +1,72 @@
+// Copyright 2021 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+function main(parent, cryptoKeyId, cryptoKey) {
+ // [START kms_v1_generated_KeyManagementService_CreateCryptoKey_async]
+ /**
+ * TODO(developer): Uncomment these variables before running the sample.
+ */
+ /**
+ * Required. The [name][google.cloud.kms.v1.KeyRing.name] of the KeyRing associated with the
+ * [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+ */
+ // const parent = 'abc123'
+ /**
+ * Required. It must be unique within a KeyRing and match the regular
+ * expression `[a-zA-Z0-9_-]{1,63}`
+ */
+ // const cryptoKeyId = 'abc123'
+ /**
+ * Required. A [CryptoKey][google.cloud.kms.v1.CryptoKey] with initial field values.
+ */
+ // const cryptoKey = ''
+ /**
+ * If set to true, the request will create a [CryptoKey][google.cloud.kms.v1.CryptoKey] without any
+ * [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion]. You must manually call
+ * [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion] or
+ * [ImportCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion]
+ * before you can use this [CryptoKey][google.cloud.kms.v1.CryptoKey].
+ */
+ // const skipInitialVersionCreation = true
+
+ // Imports the Kms library
+ const {KeyManagementServiceClient} = require('@google-cloud/kms').v1;
+
+ // Instantiates a client
+ const kmsClient = new KeyManagementServiceClient();
+
+ async function createCryptoKey() {
+ // Construct request
+ const request = {
+ parent,
+ cryptoKeyId,
+ cryptoKey,
+ };
+
+ // Run request
+ const response = await kmsClient.createCryptoKey(request);
+ console.log(response);
+ }
+
+ createCryptoKey();
+ // [END kms_v1_generated_KeyManagementService_CreateCryptoKey_async]
+}
+
+process.on('unhandledRejection', err => {
+ console.error(err.message);
+ process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-kms/samples/generated/v1/key_management_service.create_crypto_key_version.js

@@ -0,0 +1,58 @@
+// Copyright 2021 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+function main(parent, cryptoKeyVersion) {
+ // [START kms_v1_generated_KeyManagementService_CreateCryptoKeyVersion_async]
+ /**
+ * TODO(developer): Uncomment these variables before running the sample.
+ */
+ /**
+ * Required. The [name][google.cloud.kms.v1.CryptoKey.name] of the [CryptoKey][google.cloud.kms.v1.CryptoKey] associated with
+ * the [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
+ */
+ // const parent = 'abc123'
+ /**
+ * Required. A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with initial field values.
+ */
+ // const cryptoKeyVersion = ''
+
+ // Imports the Kms library
+ const {KeyManagementServiceClient} = require('@google-cloud/kms').v1;
+
+ // Instantiates a client
+ const kmsClient = new KeyManagementServiceClient();
+
+ async function createCryptoKeyVersion() {
+ // Construct request
+ const request = {
+ parent,
+ cryptoKeyVersion,
+ };
+
+ // Run request
+ const response = await kmsClient.createCryptoKeyVersion(request);
+ console.log(response);
+ }
+
+ createCryptoKeyVersion();
+ // [END kms_v1_generated_KeyManagementService_CreateCryptoKeyVersion_async]
+}
+
+process.on('unhandledRejection', err => {
+ console.error(err.message);
+ process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-kms/samples/generated/v1/key_management_service.create_import_job.js

@@ -0,0 +1,64 @@
+// Copyright 2021 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+function main(parent, importJobId, importJob) {
+ // [START kms_v1_generated_KeyManagementService_CreateImportJob_async]
+ /**
+ * TODO(developer): Uncomment these variables before running the sample.
+ */
+ /**
+ * Required. The [name][google.cloud.kms.v1.KeyRing.name] of the [KeyRing][google.cloud.kms.v1.KeyRing] associated with the
+ * [ImportJobs][google.cloud.kms.v1.ImportJob].
+ */
+ // const parent = 'abc123'
+ /**
+ * Required. It must be unique within a KeyRing and match the regular
+ * expression `[a-zA-Z0-9_-]{1,63}`
+ */
+ // const importJobId = 'abc123'
+ /**
+ * Required. An [ImportJob][google.cloud.kms.v1.ImportJob] with initial field values.
+ */
+ // const importJob = ''
+
+ // Imports the Kms library
+ const {KeyManagementServiceClient} = require('@google-cloud/kms').v1;
+
+ // Instantiates a client
+ const kmsClient = new KeyManagementServiceClient();
+
+ async function createImportJob() {
+ // Construct request
+ const request = {
+ parent,
+ importJobId,
+ importJob,
+ };
+
+ // Run request
+ const response = await kmsClient.createImportJob(request);
+ console.log(response);
+ }
+
+ createImportJob();
+ // [END kms_v1_generated_KeyManagementService_CreateImportJob_async]
+}
+
+process.on('unhandledRejection', err => {
+ console.error(err.message);
+ process.exitCode = 1;
+});
+main(...process.argv.slice(2));