Pular para o conteúdo principal
POST
/
metadata
Criar um objeto de metadados
curl --request POST \
  --url https://api.altostrat.io/metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resource_id": "9b52d930-f432-4c0a-bac0-4c12dff85544",
  "type": "mikrotik.device",
  "metadata": {
    "name": "Roteador do Escritório Principal",
    "location": "5º Andar, Sala de Servidores A",
    "contact_person": "joao.silva@example.com"
  }
}'
{
  "resource_id": "9b52d930-f432-4c0a-bac0-4c12dff85544",
  "type": "mikrotik.device",
  "metadata": {
    "circuit_id": "AS12345-XYZ",
    "install_date": "2025-01-15",
    "is_critical": true,
    "rack_units": 2
  }
}

Authorizations

​
Authorization
string
header
required

Um token bearer é necessário para todas as requisições da API.

Body

application/json

O identificador do recurso e os metadados a serem associados a ele.

​
resource_id
string<uuid>
required

O UUID do recurso ao qual associar os metadados.

Example:

"9b52d930-f432-4c0a-bac0-4c12dff85544"

​
type
string
required

Uma string que identifica o tipo do recurso.

Example:

"mikrotik.device"

​
metadata
object
required

Os dados de chave-valor a serem armazenados. Uma chave 'name' é obrigatória ao criar novos metadados.

Example:
{
  "name": "Roteador do Escritório Principal",
  "location": "5º Andar, Sala de Servidores A",
  "contact_person": "joao.silva@example.com"
}

Response

Metadados criados ou atualizados com sucesso.

​
resource_id
string<uuid>

O identificador único do recurso ao qual estes metadados pertencem.

Example:

"9b52d930-f432-4c0a-bac0-4c12dff85544"

​
type
string

Uma string que identifica o tipo do recurso.

Example:

"mikrotik.device"

​
metadata
object

Um objeto de formato livre contendo pares de chave-valor. Os valores podem ser strings, números ou booleanos.

Example:
{
  "circuit_id": "AS12345-XYZ",
  "install_date": "2025-01-15",
  "is_critical": true,
  "rack_units": 2
}