Skip to content

Create

POST
/api/config/namespaces/{namespace}/known_label_key/create
curl --request POST \
--url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/config/namespaces/example/known_label_key/create \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "description": "example", "key": "example", "namespace": "example" }'

Create creates a new label key in shared namespace. Any other namespace requested will return error.

Examples of this operation.

namespace
required
string

Namespace Namespace in which to create label key.

Media typeapplication/json
Create Label Key Request

Create label Key request in shared namespace. Only shared namespace supported.

object
description
Description

Description for the label key.

string
>= 21 characters <= 1024 characters
key
Key

Key to be created.

string
>= 7 characters <= 1024 characters
namespace
Namespace

Namespace in which to create label key.

string
>= 6 characters <= 1024 characters
Examplegenerated
{
"description": "example",
"key": "example",
"namespace": "example"
}

A successful response.

Media typeapplication/json
Create Response

Create Label Response.

object
label_key
object
description
Description

Description of what this label key means.

string
>= 21 characters <= 1024 characters
key
Key

Label key

string
>= 7 characters <= 1024 characters
Examplegenerated
{
"label_key": {
"description": "example",
"key": "example"
}
}

Returned when operation is not authorized.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when there is no permission to access resource.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when resource is not found.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation on resource is conflicting with current value.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation has been rejected as it is happening too frequently.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server encountered an error in processing API.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when service is unavailable temporarily.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server timed out processing request.

Media typeapplication/json
string format: string
Examplegenerated
example