curl --request POST \
--url https://telemetry.{region}.basaltic.sh/v1/log-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
'import requests
url = "https://telemetry.{region}.basaltic.sh/v1/log-groups"
payload = {
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'app/prod/api',
description: 'Production API request logs',
retention_days: 30,
kms_key: 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
tags: {}
})
};
fetch('https://telemetry.{region}.basaltic.sh/v1/log-groups', 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://telemetry.{region}.basaltic.sh/v1/log-groups",
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' => 'app/prod/api',
'description' => 'Production API request logs',
'retention_days' => 30,
'kms_key' => 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
'tags' => [
]
]),
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://telemetry.{region}.basaltic.sh/v1/log-groups"
payload := strings.NewReader("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}")
req, _ := http.NewRequest("POST", 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.post("https://telemetry.{region}.basaltic.sh/v1/log-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://telemetry.{region}.basaltic.sh/v1/log-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}"
response = http.request(request)
puts response.read_body{
"log_group": {
"id": "4a7b2c8d-9e1f-4a2b-8c3d-5e6f7a8b9c0d",
"crn": "crn:telemetry:sa-saopaulo-1:my-account:log-group/app-prod-api",
"account_id": "9b2e4d11-6c3a-4f8e-bd47-1a2b3c4d5e6f",
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key_unavailable": true,
"kms_key_crn": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Resource with this name already exists",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Criar um grupo de log
Registre um novo grupo de log na organização do chamador. O nome é o identificador visível pelo cliente (1 a 512 caracteres de A-Za-z0-9_./#-) e é imutável. Requer telemetry:CreateLogGroup.
curl --request POST \
--url https://telemetry.{region}.basaltic.sh/v1/log-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
'import requests
url = "https://telemetry.{region}.basaltic.sh/v1/log-groups"
payload = {
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'app/prod/api',
description: 'Production API request logs',
retention_days: 30,
kms_key: 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
tags: {}
})
};
fetch('https://telemetry.{region}.basaltic.sh/v1/log-groups', 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://telemetry.{region}.basaltic.sh/v1/log-groups",
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' => 'app/prod/api',
'description' => 'Production API request logs',
'retention_days' => 30,
'kms_key' => 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
'tags' => [
]
]),
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://telemetry.{region}.basaltic.sh/v1/log-groups"
payload := strings.NewReader("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}")
req, _ := http.NewRequest("POST", 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.post("https://telemetry.{region}.basaltic.sh/v1/log-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://telemetry.{region}.basaltic.sh/v1/log-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}"
response = http.request(request)
puts response.read_body{
"log_group": {
"id": "4a7b2c8d-9e1f-4a2b-8c3d-5e6f7a8b9c0d",
"crn": "crn:telemetry:sa-saopaulo-1:my-account:log-group/app-prod-api",
"account_id": "9b2e4d11-6c3a-4f8e-bd47-1a2b3c4d5e6f",
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key_unavailable": true,
"kms_key_crn": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Resource with this name already exists",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}telemetry:CreateLogGroup. Consulte permissões de telemetria para obter a lista completa, o que cada uma abrange e um exemplo de política.Autorizações
Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.
Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.
Cabeçalhos
Chave opcional gerada pelo cliente que torna uma criação segura para reprodução. A reintentar uma solicitação com a mesma chave retorna o resultado original literalmente em vez de criar um recurso duplicado. A reutilização de uma chave com um corpo de solicitação diferente é rejeitada (422); uma solicitação cuja chave ainda está sendo processada retorna 409. Os registros são honrados por 24 horas. Use um UUID ou token exclusivo semelhante.
255Corpo
Os nomes de recursos não devem começar com o prefixo literal crn: ou ser UUIDs (formas canônicas, compactas, entre colchetes ou urn:uuid:, em qualquer caso).
"app/prod/api"
"Production API request logs"
1..3650, ou omita para nunca expirar
1 <= x <= 365030
UUID da chave KMS, CRN ou nome exato na conta autenticada e na região de atendimento. O UUID resolvido é fixado; apagar uma chave e reutilizar seu nome nunca redireciona dados existentes. Uma string vazia seleciona texto simples.
"crn:kms:sa-saopaulo-1:my-account:key/service-key"
Show child attributes
Show child attributes
Resposta
Grupo de log criado
Show child attributes
Show child attributes

