Method: projects.configs.variables.create

Creates a variable within the given configuration. You cannot create a variable with a name that is a prefix of an existing variable name, or a name that has an existing variable name as a prefix.

To learn more about creating a variable, read the Setting and Getting Data documentation.

HTTP request

POST https://runtimeconfig.googleapis.com/v1beta1/{parent=projects/*/configs/*}/variables

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The path to the RutimeConfig resource that this variable should belong to. The configuration must exist beforehand; the path must be in the format:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

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

  • runtimeconfig.variables.create

Query parameters

Parameters
requestId

string

An optional but recommended unique requestId. If the server receives two create() requests with the same requestId, then the second request will be ignored and the first resource created and stored in the backend is returned. Empty requestId fields are ignored.

It is responsibility of the client to ensure uniqueness of the requestId strings.

requestId strings are limited to 64 characters.

Request body

The request body contains an instance of Variable.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.

Try it!