​

ves-io-schema-known_label-CustomAPI-Get

Published April 5, 2023 | Last modified May 28, 2026

Examples of performing known_label CustomAPI Get

Usecase:

Get known_label

Request:

Request using vesctl:

vesctl request rpc known_label.CustomAPI.Get -i request.yaml --uri /public/namespaces/shared/known_labels --http-method GET

where file request.yaml has following contents:

key: acmecorp/storetype
namespace: shared
query: QUERY_EXACT_LABEL
value: superstore

vesctl yaml response:

label:
- description: acmecorp site type is superstore
  key: acmecorp/storetype
  value: superstore

Request using curl:

curl -X 'GET' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build1414723615_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/config/namespaces/shared/known_labels?key=acmecorp%2Fstoretype&namespace=shared&query=QUERY_EXACT_LABEL&value=superstore'

curl response:

HTTP/1.1 200 OK
Content-Length: 152
Content-Type: application/json
Date: Mon, 13 Apr 2026 01:59:47 GMT
Vary: Accept-Encoding


{
  "label": [
    {
      "key": "acmecorp/storetype",
      "value": "superstore",
      "description": "acmecorp site type is superstore"
    }
  ]
}

Usecase:

Get known_label

Request:

Request using vesctl:

vesctl request rpc known_label.CustomAPI.Get -i request.yaml --uri /public/namespaces/shared/known_labels --http-method GET

where file request.yaml has following contents:

namespace: shared

vesctl yaml response:

label:
- description: acmecorp site type is superstore
  key: acmecorp/storetype
  value: superstore
- description: acmecorp site type is neighborhood store
  key: acmecorp/storetype
  value: neighborhood
- description: acmecorp site type is warehouse
  key: acmecorp/storetype
  value: warehouse
- description: acmecorp application deployment type is test setup
  key: acmecorp/deployment
  value: test
- description: acmecorp application deployment type is production
  key: acmecorp/deployment
  value: production

Request using curl:

curl -X 'GET' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build1414723615_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/config/namespaces/shared/known_labels?key=&namespace=shared&query=QUERY_ALL_LABELS&value='

curl response:

HTTP/1.1 200 OK
Content-Length: 724
Content-Type: application/json
Date: Mon, 13 Apr 2026 01:59:47 GMT
Vary: Accept-Encoding


{
  "label": [
    {
      "key": "acmecorp/storetype",
      "value": "superstore",
      "description": "acmecorp site type is superstore"
    },
    {
      "key": "acmecorp/storetype",
      "value": "neighborhood",
      "description": "acmecorp site type is neighborhood store"
    },
    {
      "key": "acmecorp/storetype",
      "value": "warehouse",
      "description": "acmecorp site type is warehouse"
    },
    {
      "key": "acmecorp/deployment",
      "value": "test",
      "description": "acmecorp application deployment type is test setup"
    },
    {
      "key": "acmecorp/deployment",
      "value": "production",
      "description": "acmecorp application deployment type is production"
    }
  ]
}
On this page: