curl --request PATCH \
--url https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"filter": "<string>",
"name": "<string>",
"business_metric_token": "<string>",
"label_key": "<string>",
"label_values": [
"<string>"
],
"display_name": "<string>",
"label_transforms": [
{
"delimiter": "<string>",
"index": 123,
"template": "<string>"
}
],
"percentages": [
{
"value": "<string>",
"pct": 123
}
],
"date_ranges": [
{
"start_date": "<string>",
"end_date": "<string>"
}
]
}
'import requests
url = "https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}"
payload = {
"filter": "<string>",
"name": "<string>",
"business_metric_token": "<string>",
"label_key": "<string>",
"label_values": ["<string>"],
"display_name": "<string>",
"label_transforms": [
{
"delimiter": "<string>",
"index": 123,
"template": "<string>"
}
],
"percentages": [
{
"value": "<string>",
"pct": 123
}
],
"date_ranges": [
{
"start_date": "<string>",
"end_date": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
filter: '<string>',
name: '<string>',
business_metric_token: '<string>',
label_key: '<string>',
label_values: ['<string>'],
display_name: '<string>',
label_transforms: [{delimiter: '<string>', index: 123, template: '<string>'}],
percentages: [{value: '<string>', pct: 123}],
date_ranges: [{start_date: '<string>', end_date: '<string>'}]
})
};
fetch('https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'filter' => '<string>',
'name' => '<string>',
'business_metric_token' => '<string>',
'label_key' => '<string>',
'label_values' => [
'<string>'
],
'display_name' => '<string>',
'label_transforms' => [
[
'delimiter' => '<string>',
'index' => 123,
'template' => '<string>'
]
],
'percentages' => [
[
'value' => '<string>',
'pct' => 123
]
],
'date_ranges' => [
[
'start_date' => '<string>',
'end_date' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}"
payload := strings.NewReader("{\n \"filter\": \"<string>\",\n \"name\": \"<string>\",\n \"business_metric_token\": \"<string>\",\n \"label_key\": \"<string>\",\n \"label_values\": [\n \"<string>\"\n ],\n \"display_name\": \"<string>\",\n \"label_transforms\": [\n {\n \"delimiter\": \"<string>\",\n \"index\": 123,\n \"template\": \"<string>\"\n }\n ],\n \"percentages\": [\n {\n \"value\": \"<string>\",\n \"pct\": 123\n }\n ],\n \"date_ranges\": [\n {\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"filter\": \"<string>\",\n \"name\": \"<string>\",\n \"business_metric_token\": \"<string>\",\n \"label_key\": \"<string>\",\n \"label_values\": [\n \"<string>\"\n ],\n \"display_name\": \"<string>\",\n \"label_transforms\": [\n {\n \"delimiter\": \"<string>\",\n \"index\": 123,\n \"template\": \"<string>\"\n }\n ],\n \"percentages\": [\n {\n \"value\": \"<string>\",\n \"pct\": 123\n }\n ],\n \"date_ranges\": [\n {\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"filter\": \"<string>\",\n \"name\": \"<string>\",\n \"business_metric_token\": \"<string>\",\n \"label_key\": \"<string>\",\n \"label_values\": [\n \"<string>\"\n ],\n \"display_name\": \"<string>\",\n \"label_transforms\": [\n {\n \"delimiter\": \"<string>\",\n \"index\": 123,\n \"template\": \"<string>\"\n }\n ],\n \"percentages\": [\n {\n \"value\": \"<string>\",\n \"pct\": 123\n }\n ],\n \"date_ranges\": [\n {\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"token": "vtag_val_d104b11fc34ef7f3",
"filter": "costs.provider = 'aws'",
"name": "First",
"label_transforms": [],
"percentages": [],
"date_ranges": []
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}Update virtual tag config value
Update a VirtualTagConfigValue.
curl --request PATCH \
--url https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"filter": "<string>",
"name": "<string>",
"business_metric_token": "<string>",
"label_key": "<string>",
"label_values": [
"<string>"
],
"display_name": "<string>",
"label_transforms": [
{
"delimiter": "<string>",
"index": 123,
"template": "<string>"
}
],
"percentages": [
{
"value": "<string>",
"pct": 123
}
],
"date_ranges": [
{
"start_date": "<string>",
"end_date": "<string>"
}
]
}
'import requests
url = "https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}"
payload = {
"filter": "<string>",
"name": "<string>",
"business_metric_token": "<string>",
"label_key": "<string>",
"label_values": ["<string>"],
"display_name": "<string>",
"label_transforms": [
{
"delimiter": "<string>",
"index": 123,
"template": "<string>"
}
],
"percentages": [
{
"value": "<string>",
"pct": 123
}
],
"date_ranges": [
{
"start_date": "<string>",
"end_date": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
filter: '<string>',
name: '<string>',
business_metric_token: '<string>',
label_key: '<string>',
label_values: ['<string>'],
display_name: '<string>',
label_transforms: [{delimiter: '<string>', index: 123, template: '<string>'}],
percentages: [{value: '<string>', pct: 123}],
date_ranges: [{start_date: '<string>', end_date: '<string>'}]
})
};
fetch('https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'filter' => '<string>',
'name' => '<string>',
'business_metric_token' => '<string>',
'label_key' => '<string>',
'label_values' => [
'<string>'
],
'display_name' => '<string>',
'label_transforms' => [
[
'delimiter' => '<string>',
'index' => 123,
'template' => '<string>'
]
],
'percentages' => [
[
'value' => '<string>',
'pct' => 123
]
],
'date_ranges' => [
[
'start_date' => '<string>',
'end_date' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}"
payload := strings.NewReader("{\n \"filter\": \"<string>\",\n \"name\": \"<string>\",\n \"business_metric_token\": \"<string>\",\n \"label_key\": \"<string>\",\n \"label_values\": [\n \"<string>\"\n ],\n \"display_name\": \"<string>\",\n \"label_transforms\": [\n {\n \"delimiter\": \"<string>\",\n \"index\": 123,\n \"template\": \"<string>\"\n }\n ],\n \"percentages\": [\n {\n \"value\": \"<string>\",\n \"pct\": 123\n }\n ],\n \"date_ranges\": [\n {\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"filter\": \"<string>\",\n \"name\": \"<string>\",\n \"business_metric_token\": \"<string>\",\n \"label_key\": \"<string>\",\n \"label_values\": [\n \"<string>\"\n ],\n \"display_name\": \"<string>\",\n \"label_transforms\": [\n {\n \"delimiter\": \"<string>\",\n \"index\": 123,\n \"template\": \"<string>\"\n }\n ],\n \"percentages\": [\n {\n \"value\": \"<string>\",\n \"pct\": 123\n }\n ],\n \"date_ranges\": [\n {\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vantage.sh/v2/virtual_tag_configs/{virtual_tag_config_token}/values/{virtual_tag_config_value_token}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"filter\": \"<string>\",\n \"name\": \"<string>\",\n \"business_metric_token\": \"<string>\",\n \"label_key\": \"<string>\",\n \"label_values\": [\n \"<string>\"\n ],\n \"display_name\": \"<string>\",\n \"label_transforms\": [\n {\n \"delimiter\": \"<string>\",\n \"index\": 123,\n \"template\": \"<string>\"\n }\n ],\n \"percentages\": [\n {\n \"value\": \"<string>\",\n \"pct\": 123\n }\n ],\n \"date_ranges\": [\n {\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"token": "vtag_val_d104b11fc34ef7f3",
"filter": "costs.provider = 'aws'",
"name": "First",
"label_transforms": [],
"percentages": [],
"date_ranges": []
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}{
"errors": [
"<string>"
],
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"last": "<string>",
"prev": "<string>"
}
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
Update a VirtualTagConfigValue.
The filter query language to apply to the value. Additional documentation available at https://docs.vantage.sh/vql.
The name of the value.
The token of an associated business metric.
The business metric label key used for this virtual tag value.
Business metric label values. An empty array includes every value for the label key.
The display name for a cost metric or percentage allocation value.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Date ranges restricting when this value applies.
Show child attributes
Show child attributes
Response
VirtualTagConfigValue model
The token of the Value.
"vtag_val_1234"
The filter VQL for the Value.
"costs.provider = 'aws' AND costs.service = 'Amazon Simple Storage Service'"
Label transforms applied to business metric labels.
Show child attributes
Show child attributes
Labeled percentage allocations for matching costs.
Show child attributes
Show child attributes
Date ranges restricting when this value applies.
Show child attributes
Show child attributes
The name of the Value.
"Informatics"
The token of the associated BusinessMetric.
"bsnss_mtrc_abc123"
The business metric label key used for this virtual tag value.
Optional business metric label values. An empty array includes every value for the label key.
Show child attributes
Show child attributes
The display name for this allocation value.