Access key version

New-CloudAccessKeyVersion

Synopsis

Create an access key version.

Syntax

New-CloudAccessKeyVersion [-AccessKeyUID] <Int32> [-CloudAccessKeyID] <String> [-CloudSecretAccessKey] <String> [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Rotates an access key to a new version.

Note: You need to do this only if your cloud provider credentials have changed, for example, because they've expired or been compromised. Only two versions of an access key can exist and be active at the same time. If you have two access key versions, you have to run the Remove-CloudAccessKeyVersion operation before you can create another version.

Parameters

‑AccessKeyUID
Required

Your access key's ID.

‑AccountSwitchKey

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.

‑CloudAccessKeyID
Required

The ID that's combined with the -CloudSecretAccessKey to sign API requests. This is the access key ID (AWS) or access ID (GCS) you get from your cloud provider.

‑CloudSecretAccessKey
Required

A value that's combined with the -CloudAccessKeyID to sign API requests. This is the secret access key (AWS) or secret (GCS) you get from your cloud provider.

‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑Section

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

Related Links