Method: keyRings.create

Full name: projects.locations.keyRings.create

Create a new KeyRing in a given Project and Location.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The resource name of the location associated with the KeyRings, in the format projects/*/locations/*.

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

  • cloudkms.keyRings.create

Query parameters

Parameters
keyRingId

string

Required. It must be unique within a location and match the regular expression [a-zA-Z0-9_-]{1,63}

Request body

The request body contains an instance of KeyRing.

Response body

If successful, the response body contains a newly created instance of KeyRing.

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.

Try it!

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

Send feedback about...

Cloud KMS Documentation