What the credential's workspace was charged per SKU for usage that started at or after
start_time and before end_time, over each window of the period: the sum of the charges to
its balance.
curl --request POST \
--url https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost \
--header 'Authorization: Bearer <token>' \
--header 'Connect-Protocol-Version: <connect-protocol-version>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"startTime": "2023-01-15T01:30:15.01Z",
"endTime": "2023-01-15T01:30:15.01Z",
"groupBy": [],
"filter": {
"skus": [
"<string>"
],
"subjects": [
"<string>"
],
"principals": [
"<string>"
],
"resources": [
"<string>"
]
}
}
'import requests
url = "https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost"
payload = {
"name": "<string>",
"startTime": "2023-01-15T01:30:15.01Z",
"endTime": "2023-01-15T01:30:15.01Z",
"groupBy": [],
"filter": {
"skus": ["<string>"],
"subjects": ["<string>"],
"principals": ["<string>"],
"resources": ["<string>"]
}
}
headers = {
"Connect-Protocol-Version": "<connect-protocol-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Connect-Protocol-Version': '<connect-protocol-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
startTime: '2023-01-15T01:30:15.01Z',
endTime: '2023-01-15T01:30:15.01Z',
groupBy: [],
filter: {
skus: ['<string>'],
subjects: ['<string>'],
principals: ['<string>'],
resources: ['<string>']
}
})
};
fetch('https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost', 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.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'startTime' => '2023-01-15T01:30:15.01Z',
'endTime' => '2023-01-15T01:30:15.01Z',
'groupBy' => [
],
'filter' => [
'skus' => [
'<string>'
],
'subjects' => [
'<string>'
],
'principals' => [
'<string>'
],
'resources' => [
'<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Connect-Protocol-Version: <connect-protocol-version>",
"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.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"startTime\": \"2023-01-15T01:30:15.01Z\",\n \"endTime\": \"2023-01-15T01:30:15.01Z\",\n \"groupBy\": [],\n \"filter\": {\n \"skus\": [\n \"<string>\"\n ],\n \"subjects\": [\n \"<string>\"\n ],\n \"principals\": [\n \"<string>\"\n ],\n \"resources\": [\n \"<string>\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Connect-Protocol-Version", "<connect-protocol-version>")
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.post("https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost")
.header("Connect-Protocol-Version", "<connect-protocol-version>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"startTime\": \"2023-01-15T01:30:15.01Z\",\n \"endTime\": \"2023-01-15T01:30:15.01Z\",\n \"groupBy\": [],\n \"filter\": {\n \"skus\": [\n \"<string>\"\n ],\n \"subjects\": [\n \"<string>\"\n ],\n \"principals\": [\n \"<string>\"\n ],\n \"resources\": [\n \"<string>\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Connect-Protocol-Version"] = '<connect-protocol-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"startTime\": \"2023-01-15T01:30:15.01Z\",\n \"endTime\": \"2023-01-15T01:30:15.01Z\",\n \"groupBy\": [],\n \"filter\": {\n \"skus\": [\n \"<string>\"\n ],\n \"subjects\": [\n \"<string>\"\n ],\n \"principals\": [\n \"<string>\"\n ],\n \"resources\": [\n \"<string>\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"costs": [
{
"sku": "<string>",
"quantity": "<string>",
"amount": "<string>",
"startTime": "2023-01-15T01:30:15.01Z",
"endTime": "2023-01-15T01:30:15.01Z",
"subject": "<string>",
"principal": "<string>",
"resource": "<string>"
}
]
}{
"code": "not_found",
"message": "<string>",
"details": [
{
"type": "<string>",
"value": "<string>",
"debug": {}
}
]
}Usage
What the credential's workspace was charged per SKU for usage that started at or after start_time and before end_time, over each window of the period: the sum of the charges to its balance.
cf. AWS Cost Explorer GetCostAndUsage; AIP-136.
POST
/
outerproduct.usage.v1alpha.UsageService
/
QueryCost
What the credential's workspace was charged per SKU for usage that started at or after
start_time and before end_time, over each window of the period: the sum of the charges to
its balance.
curl --request POST \
--url https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost \
--header 'Authorization: Bearer <token>' \
--header 'Connect-Protocol-Version: <connect-protocol-version>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"startTime": "2023-01-15T01:30:15.01Z",
"endTime": "2023-01-15T01:30:15.01Z",
"groupBy": [],
"filter": {
"skus": [
"<string>"
],
"subjects": [
"<string>"
],
"principals": [
"<string>"
],
"resources": [
"<string>"
]
}
}
'import requests
url = "https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost"
payload = {
"name": "<string>",
"startTime": "2023-01-15T01:30:15.01Z",
"endTime": "2023-01-15T01:30:15.01Z",
"groupBy": [],
"filter": {
"skus": ["<string>"],
"subjects": ["<string>"],
"principals": ["<string>"],
"resources": ["<string>"]
}
}
headers = {
"Connect-Protocol-Version": "<connect-protocol-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Connect-Protocol-Version': '<connect-protocol-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
startTime: '2023-01-15T01:30:15.01Z',
endTime: '2023-01-15T01:30:15.01Z',
groupBy: [],
filter: {
skus: ['<string>'],
subjects: ['<string>'],
principals: ['<string>'],
resources: ['<string>']
}
})
};
fetch('https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost', 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.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'startTime' => '2023-01-15T01:30:15.01Z',
'endTime' => '2023-01-15T01:30:15.01Z',
'groupBy' => [
],
'filter' => [
'skus' => [
'<string>'
],
'subjects' => [
'<string>'
],
'principals' => [
'<string>'
],
'resources' => [
'<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Connect-Protocol-Version: <connect-protocol-version>",
"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.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"startTime\": \"2023-01-15T01:30:15.01Z\",\n \"endTime\": \"2023-01-15T01:30:15.01Z\",\n \"groupBy\": [],\n \"filter\": {\n \"skus\": [\n \"<string>\"\n ],\n \"subjects\": [\n \"<string>\"\n ],\n \"principals\": [\n \"<string>\"\n ],\n \"resources\": [\n \"<string>\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Connect-Protocol-Version", "<connect-protocol-version>")
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.post("https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost")
.header("Connect-Protocol-Version", "<connect-protocol-version>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"startTime\": \"2023-01-15T01:30:15.01Z\",\n \"endTime\": \"2023-01-15T01:30:15.01Z\",\n \"groupBy\": [],\n \"filter\": {\n \"skus\": [\n \"<string>\"\n ],\n \"subjects\": [\n \"<string>\"\n ],\n \"principals\": [\n \"<string>\"\n ],\n \"resources\": [\n \"<string>\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.outerproduct.com/outerproduct.usage.v1alpha.UsageService/QueryCost")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Connect-Protocol-Version"] = '<connect-protocol-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"startTime\": \"2023-01-15T01:30:15.01Z\",\n \"endTime\": \"2023-01-15T01:30:15.01Z\",\n \"groupBy\": [],\n \"filter\": {\n \"skus\": [\n \"<string>\"\n ],\n \"subjects\": [\n \"<string>\"\n ],\n \"principals\": [\n \"<string>\"\n ],\n \"resources\": [\n \"<string>\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"costs": [
{
"sku": "<string>",
"quantity": "<string>",
"amount": "<string>",
"startTime": "2023-01-15T01:30:15.01Z",
"endTime": "2023-01-15T01:30:15.01Z",
"subject": "<string>",
"principal": "<string>",
"resource": "<string>"
}
]
}{
"code": "not_found",
"message": "<string>",
"details": [
{
"type": "<string>",
"value": "<string>",
"debug": {}
}
]
}Authorizations
A user session token or personal API key.
Headers
Define the version of the Connect protocol
Example:
1
Define the timeout, in ms
Example:
1000
Body
application/json
cf. AWS Cost Explorer GetCostAndUsage (TimePeriod, Granularity, GroupBy, Filter).
Charges for usage that started at or after start_time and before end_time, as in
QueryUsage.
Example:
"2023-01-15T01:30:15.01Z"
A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (Z); input may use an offset from UTC.
Example:
"2023-01-15T01:30:15.01Z"
The windows the period is cut into; unspecified sums the whole period as one.
Available options:
GRANULARITY_UNSPECIFIED, GRANULARITY_HOURLY, GRANULARITY_DAILY, GRANULARITY_MONTHLY What each window's charges are further summed by, besides their SKU.
A fact of usage it may be summed by, besides its SKU and window.
cf. AWS Cost Explorer GroupBy dimension keys; Cloud Billing's export columns.
Available options:
USAGE_DIMENSION_UNSPECIFIED, USAGE_DIMENSION_SUBJECT, USAGE_DIMENSION_PRINCIPAL, USAGE_DIMENSION_RESOURCE Only charges matching every set list. Charges recorded before they carried their subject, principal and resource match none of those lists, and group under empty values.
Show child attributes
Show child attributes
Response
Success
cf. AWS Cost Explorer GetCostAndUsage ResultsByTime.
One per window and SKU charged in it, by window, then SKU.
Show child attributes
Show child attributes