Zum Inhalt
HALOWERK

Finopswerk

branch cache restore eviction ledger

Originalbranch/key/version/creation/access/sizecachefacts andsuccessfultrustedjobrequest determine expiry,current-before-defaultExact/Prefix/orderedRestoreKeys selection,accessrefresh,newsaveandLRUquotaendstate. OWNquiescentexpiry-first,7day/MiBcallerquotaprofile/stableIDties;NOTnativebackgroundscheduler/GBdefaultunit/cacheversionhash/security/API/billcertification. Oneboundedlastaccesscapturekeeps2worlds.Strictrecursive reportkeys/objectorderirrelevant/cacheIDsandrestorearrayordersemantic..

POST https://finops.halowerk.com/v1/branch-cache-restore-eviction-ledger

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
cachesarrayJa
requestobjectJa
quota_mibintegerJa
reportobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "properties": {
    "caches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "branch": {
            "enum": [
              "main",
              "feature",
              "other"
            ]
          },
          "key": {
            "type": "string",
            "pattern": "^[a-z-]{1,16}$",
            "minLength": 1,
            "maxLength": 16
          },
          "version": {
            "type": "string",
            "pattern": "^[a-z]{1,8}$",
            "minLength": 1,
            "maxLength": 8
          },
          "created_min": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20159
          },
          "last_access_domain": {
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 0,
              "maximum": 20159
            },
            "minItems": 1,
            "maxItems": 2
          },
          "size_mib": {
            "type": "integer",
            "minimum": 1,
            "maximum": 6000
          }
        },
        "required": [
          "branch",
          "key",
          "version",
          "created_min",
          "last_access_domain",
          "size_mib"
        ],
        "additionalProperties": false
      },
      "minItems": 0,
      "maxItems": 6
    },
    "request": {
      "type": "object",
      "properties": {
        "branch": {
          "enum": [
            "main",
            "feature"
          ]
        },
        "key": {
          "type": "string",
          "pattern": "^[a-z-]{1,16}$",
          "minLength": 1,
          "maxLength": 16
        },
        "version": {
          "type": "string",
          "pattern": "^[a-z]{1,8}$",
          "minLength": 1,
          "maxLength": 8
        },
        "restore_keys": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[a-z-]{1,16}$",
            "minLength": 1,
            "maxLength": 16
          },
          "minItems": 0,
          "maxItems": 2
        },
        "save": {
          "type": "boolean"
        },
        "save_size_mib": {
          "type": "integer",
          "minimum": 1,
          "maximum": 6000
        }
      },
      "required": [
        "branch",
        "key",
        "version",
        "restore_keys",
        "save",
        "save_size_mib"
      ],
      "additionalProperties": false
    },
    "quota_mib": {
      "type": "integer",
      "minimum": 1,
      "maximum": 32768
    },
    "report": {
      "type": "object",
      "properties": {
        "selected_id": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "stage": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "restore_index": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "exact_hit": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "restored_mib": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "saved": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "expired": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000
              },
              {
                "type": "null"
              }
            ]
          },
          "minItems": 0,
          "maxItems": 6
        },
        "eviction_rank": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000
              },
              {
                "type": "null"
              }
            ]
          },
          "minItems": 1,
          "maxItems": 7
        },
        "survives": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000
              },
              {
                "type": "null"
              }
            ]
          },
          "minItems": 1,
          "maxItems": 7
        },
        "last_access": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000
              },
              {
                "type": "null"
              }
            ]
          },
          "minItems": 1,
          "maxItems": 7
        },
        "before_mib": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "after_mib": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "selected_id",
        "stage",
        "restore_index",
        "exact_hit",
        "restored_mib",
        "saved",
        "expired",
        "eviction_rank",
        "survives",
        "last_access",
        "before_mib",
        "after_mib"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "caches",
    "request",
    "quota_mib",
    "report"
  ],
  "additionalProperties": false
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "caches": [
    {
      "branch": "feature",
      "key": "npm-a",
      "version": "x",
      "created_min": 10000,
      "last_access_domain": [
        10080
      ],
      "size_mib": 4000
    },
    {
      "branch": "main",
      "key": "npm",
      "version": "x",
      "created_min": 10001,
      "last_access_domain": [
        10081
      ],
      "size_mib": 4000
    }
  ],
  "request": {
    "branch": "feature",
    "key": "npm",
    "version": "x",
    "restore_keys": [],
    "save": true,
    "save_size_mib": 3000
  },
  "quota_mib": 10000,
  "report": {
    "selected_id": 1,
    "stage": 2,
    "restore_index": 0,
    "exact_hit": 0,
    "restored_mib": 4000,
    "saved": 1,
    "expired": [
      0,
      0
    ],
    "eviction_rank": [
      0,
      1,
      0
    ],
    "survives": [
      1,
      0,
      1
    ],
    "last_access": [
      20160,
      0,
      20160
    ],
    "before_mib": 8000,
    "after_mib": 7000
  }
}

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 →