kms_generate_random: Returns a random byte string that is cryptographically secure

Description Usage Arguments Details Request syntax Examples

View source: R/kms_operations.R

Description

Returns a random byte string that is cryptographically secure.

Usage

1
kms_generate_random(NumberOfBytes, CustomKeyStoreId)

Arguments

NumberOfBytes

The length of the byte string.

CustomKeyStoreId

Generates the random byte string in the AWS CloudHSM cluster that is associated with the specified custom key store. To find the ID of a custom key store, use the DescribeCustomKeyStores operation.

Details

By default, the random byte string is generated in AWS KMS. To generate the byte string in the AWS CloudHSM cluster that is associated with a custom key store, specify the custom key store ID.

For more information about entropy and random number generation, see the AWS Key Management Service Cryptographic Details whitepaper.

Request syntax

1
2
3
4
svc$generate_random(
  NumberOfBytes = 123,
  CustomKeyStoreId = "string"
)

Examples

1
2
3
4
# The following example uses AWS KMS to generate 32 bytes of random data.
svc$generate_random(
  NumberOfBytes = 32L
)

paws.security.identity documentation built on Jan. 14, 2020, 5:08 p.m.