Zum Inhalt
HALOWERK

Finopswerk

regional reservation coverage ledger

Whole regional Linux/UNIX default-tenancy reservation package and original usage groups determine internal size factors,eligibility,owner-before-linked and smaller-before-larger normalized benefit,partial coverage and unused units. m5/c5 large/xlarge/2xlarge,one full modelhour,one linked account;own stable input-index tie convention,not claimed native per-row billing identity. Missing platform keeps linux/windows worlds. No prices,zonal capacity,sharing optout,real bills or provider.

POST https://finops.halowerk.com/v1/regional-reservation-coverage-ledger

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
reservationobjectJa
usagearrayJa
reportobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "properties": {
    "reservation": {
      "type": "object",
      "properties": {
        "family": {
          "enum": [
            "m5",
            "c5"
          ]
        },
        "region": {
          "enum": [
            "us-east-1",
            "eu-west-1"
          ]
        },
        "size": {
          "enum": [
            "large",
            "xlarge",
            "2xlarge"
          ]
        },
        "count": {
          "type": "integer",
          "minimum": 0,
          "maximum": 8
        }
      },
      "required": [
        "family",
        "region",
        "size",
        "count"
      ],
      "additionalProperties": false
    },
    "usage": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "family": {
            "enum": [
              "m5",
              "c5"
            ]
          },
          "region": {
            "enum": [
              "us-east-1",
              "eu-west-1"
            ]
          },
          "size": {
            "enum": [
              "large",
              "xlarge",
              "2xlarge"
            ]
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 8
          },
          "account": {
            "enum": [
              "owner",
              "linked"
            ]
          },
          "platform": {
            "enum": [
              "linux",
              "windows",
              null
            ]
          },
          "tenancy": {
            "enum": [
              "default",
              "dedicated"
            ]
          }
        },
        "required": [
          "family",
          "region",
          "size",
          "count",
          "account",
          "platform",
          "tenancy"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 8
    },
    "report": {
      "type": "object",
      "properties": {
        "usage": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "normalized_units": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1024
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "eligible": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "covered_units": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1024
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "uncovered_units": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1024
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "normalized_units",
              "eligible",
              "covered_units",
              "uncovered_units"
            ],
            "additionalProperties": false
          },
          "minItems": 1,
          "maxItems": 8
        },
        "total": {
          "type": "object",
          "properties": {
            "reservation_units": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                },
                {
                  "type": "null"
                }
              ]
            },
            "demand_units": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                },
                {
                  "type": "null"
                }
              ]
            },
            "covered_units": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                },
                {
                  "type": "null"
                }
              ]
            },
            "unused_units": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "reservation_units",
            "demand_units",
            "covered_units",
            "unused_units"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "usage",
        "total"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "reservation",
    "usage",
    "report"
  ],
  "additionalProperties": false
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "reservation": {
    "family": "m5",
    "region": "us-east-1",
    "size": "2xlarge",
    "count": 1
  },
  "usage": [
    {
      "family": "m5",
      "region": "us-east-1",
      "size": "xlarge",
      "count": 1,
      "account": "owner",
      "platform": "linux",
      "tenancy": "default"
    },
    {
      "family": "m5",
      "region": "us-east-1",
      "size": "large",
      "count": 1,
      "account": "linked",
      "platform": "linux",
      "tenancy": "default"
    },
    {
      "family": "m5",
      "region": "us-east-1",
      "size": "2xlarge",
      "count": 1,
      "account": "owner",
      "platform": "linux",
      "tenancy": "default"
    }
  ],
  "report": {
    "usage": [
      {
        "normalized_units": 8,
        "eligible": true,
        "covered_units": 8,
        "uncovered_units": 0
      },
      {
        "normalized_units": 4,
        "eligible": true,
        "covered_units": 0,
        "uncovered_units": 4
      },
      {
        "normalized_units": 16,
        "eligible": true,
        "covered_units": 8,
        "uncovered_units": 8
      }
    ],
    "total": {
      "reservation_units": 16,
      "demand_units": 28,
      "covered_units": 16,
      "unused_units": 0
    }
  }
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-07, 02:42 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →