Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1381423.2 KB
projects

Creates a new API key. NOTE: Key is a global resource; hence the only supported value for location is global.

post/v2/{+parent}/keys

Path parameters

parentstring required

Required. The project in which the API key is created. The parent field must be in format of "projects//locations/global".

Query parameters

keyIdstring

User specified key id (optional). If specified, it will become the final component of the key resource name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the id must match the regular expression: [a-z]([a-z0-9-]{0,61}[a-z0-9])?. The id must NOT be a UUID-like string.

Request body

uidstring

Output only. Unique id in UUID4 format.

keyStringstring

Output only. An encrypted and signed value held by this key. This field can be accessed only through the GetKeyString method.

deleteTimestring google-datetime

Output only. A timestamp when this key was deleted. If the resource is not deleted, this must be empty.

serviceAccountEmailstring

Optional. The email address of the service account the key is bound to.

etagstring

A checksum computed by the server based on the current value of the Key resource. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. See https://google.aip.dev/154.

namestring

Identifier. The resource name of the key. The name has the form: projects//locations/global/keys/. For example: projects/123456867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2 NOTE: Key is a global resource; hence the only supported value for location is global.

annotationsobject

Annotations is an unstructured key-value map stored with a policy that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects.

displayNamestring

Human-readable display name of this key that you can modify. The maximum length is 63 characters.

createTimestring google-datetime

Output only. A timestamp identifying the time this key was originally created.

updateTimestring google-datetime

Output only. A timestamp identifying the time this key was last updated.

Response

Successful response