projects

Changed on

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

post/v2/{+parent}/keys

Request

  • Base URL
    https://apikeys.googleapis.com
  • URL
    https://apikeys.googleapis.com/v2/{+parent}/keys
  • Auth
    • OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/apikeys
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/apikeys
    • or OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/cloud-platform
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform

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

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.

createTimestring google-datetime

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

deleteTimestring google-datetime

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

displayNamestring

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

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.

keyStringstring

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

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.

serviceAccountEmailstring

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

uidstring

Output only. Unique id in UUID4 format.

updateTimestring google-datetime

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

Response

Successful response

Changes

  • cc4cfbdc4f5eRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status

    • info

      the security scope https://www.googleapis.com/auth/apikeys was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/apikeys was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was removed from the endpoint's security scheme Oauth2c

  • 4e3ba81d89f9Revision changes
    • info

      the security scope https://www.googleapis.com/auth/apikeys was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/apikeys was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was removed from the endpoint's security scheme Oauth2c