Method: projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.list

Lists CryptoKeyVersions.

HTTP request

GET https://cloudkms.googleapis.com/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
parent

string

Required. The resource name of the CryptoKey to list, in the format projects/*/locations/*/keyRings/*/cryptoKeys/*.

Authorization requires the following Google IAM permission on the specified resource parent:

  • cloudkms.cryptoKeyVersions.list

Query parameters

Parameters
pageSize

number

Optional limit on the number of CryptoKeyVersions to include in the response. Further CryptoKeyVersions can subsequently be obtained by including the ListCryptoKeyVersionsResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.

pageToken

string

Optional pagination token, returned earlier via ListCryptoKeyVersionsResponse.next_page_token.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for KeyManagementService.ListCryptoKeyVersions.

JSON representation
{
  "cryptoKeyVersions": [
    {
      object(CryptoKeyVersion)
    }
  ],
  "nextPageToken": string,
  "totalSize": number
}
Fields
cryptoKeyVersions[]

object(CryptoKeyVersion)

The list of CryptoKeyVersions.

nextPageToken

string

A token to retrieve next page of results. Pass this value in ListCryptoKeyVersionsRequest.page_token to retrieve the next page of results.

totalSize

number

The total number of CryptoKeyVersions that matched the query.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloudkms
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud KMS Documentation