Zum Inhalt
HALOWERK

Finopswerk

locked version cleanup ledger

From original version retention/LegalHold facts and completed local cleanup requests reconstruct blocked/allowed steps, surviving versions, current visibility and data versus UTF8-key marker storage units. Governance bypass requires both supplied capability/header facts; LegalHold independent; simple DELETE adds marker even protected. Exact finite technical simulation, no real IAM/auth/WORM/legal/cloud/price/bill certification. Missing initial hold retains both whole source histories. A.

POST https://finops.halowerk.com/v1/locked-version-cleanup-ledger

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
keystringJa
initial_versionsarrayJa
eventsarrayJa
reportobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "initial_versions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,15}$",
            "minLength": 1,
            "maxLength": 16
          },
          "bytes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "mode": {
            "enum": [
              "none",
              "governance",
              "compliance"
            ]
          },
          "retain_until": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "legal_hold": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "bytes",
          "mode",
          "retain_until",
          "legal_hold"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 4
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "enum": [
              "delete_current",
              "delete_version",
              "set_hold",
              "retain"
            ]
          },
          "at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "version": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,15}$",
            "minLength": 1,
            "maxLength": 16
          },
          "hold": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "until": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000
              },
              {
                "type": "null"
              }
            ]
          },
          "bypass_permission": {
            "type": "boolean"
          },
          "bypass_header": {
            "type": "boolean"
          }
        },
        "required": [
          "kind",
          "at",
          "version",
          "hold",
          "until",
          "bypass_permission",
          "bypass_header"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 8
    },
    "report": {
      "type": "object",
      "properties": {
        "events": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "decision": {
                "anyOf": [
                  {
                    "enum": [
                      "marker_created",
                      "deleted",
                      "hold_updated",
                      "retention_updated",
                      "blocked_hold",
                      "blocked_compliance",
                      "blocked_governance",
                      "NoSuchVersion",
                      "invalid_target"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "data_bytes": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4000000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "marker_bytes": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2048
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total_bytes": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4002048
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "current_version": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_]{0,15}$",
                    "minLength": 1,
                    "maxLength": 16
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "current_visible": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "decision",
              "data_bytes",
              "marker_bytes",
              "total_bytes",
              "current_version",
              "current_visible"
            ],
            "additionalProperties": false
          },
          "minItems": 1,
          "maxItems": 8
        },
        "versions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_]{0,15}$",
                    "minLength": 1,
                    "maxLength": 16
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "kind": {
                "anyOf": [
                  {
                    "enum": [
                      "data",
                      "marker"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "present": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "bytes": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "mode": {
                "anyOf": [
                  {
                    "enum": [
                      "none",
                      "governance",
                      "compliance"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "retain_until": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "legal_hold": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "kind",
              "present",
              "bytes",
              "mode",
              "retain_until",
              "legal_hold"
            ],
            "additionalProperties": false
          },
          "minItems": 1,
          "maxItems": 12
        },
        "final": {
          "type": "object",
          "properties": {
            "data_bytes": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 4000000
                },
                {
                  "type": "null"
                }
              ]
            },
            "marker_bytes": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2048
                },
                {
                  "type": "null"
                }
              ]
            },
            "total_bytes": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 4002048
                },
                {
                  "type": "null"
                }
              ]
            },
            "current_version": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_]{0,15}$",
                  "minLength": 1,
                  "maxLength": 16
                },
                {
                  "type": "null"
                }
              ]
            },
            "current_visible": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "data_bytes",
            "marker_bytes",
            "total_bytes",
            "current_version",
            "current_visible"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "events",
        "versions",
        "final"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "key",
    "initial_versions",
    "events",
    "report"
  ],
  "additionalProperties": false
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "key": "café",
  "initial_versions": [
    {
      "id": "v1",
      "bytes": 100,
      "mode": "governance",
      "retain_until": 50,
      "legal_hold": false
    },
    {
      "id": "v2",
      "bytes": 20,
      "mode": "none",
      "retain_until": 0,
      "legal_hold": false
    }
  ],
  "events": [
    {
      "kind": "delete_current",
      "at": 10,
      "version": "m1",
      "hold": null,
      "until": null,
      "bypass_permission": false,
      "bypass_header": false
    },
    {
      "kind": "delete_version",
      "at": 20,
      "version": "v1",
      "hold": null,
      "until": null,
      "bypass_permission": true,
      "bypass_header": true
    },
    {
      "kind": "set_hold",
      "at": 30,
      "version": "v1",
      "hold": false,
      "until": null,
      "bypass_permission": false,
      "bypass_header": false
    },
    {
      "kind": "retain",
      "at": 35,
      "version": "v1",
      "hold": null,
      "until": 80,
      "bypass_permission": false,
      "bypass_header": false
    },
    {
      "kind": "delete_version",
      "at": 50,
      "version": "v1",
      "hold": null,
      "until": null,
      "bypass_permission": false,
      "bypass_header": false
    },
    {
      "kind": "delete_version",
      "at": 60,
      "version": "m1",
      "hold": null,
      "until": null,
      "bypass_permission": false,
      "bypass_header": false
    },
    {
      "kind": "delete_version",
      "at": 80,
      "version": "v1",
      "hold": null,
      "until": null,
      "bypass_permission": false,
      "bypass_header": false
    }
  ],
  "report": {
    "events": [
      {
        "decision": "marker_created",
        "data_bytes": 120,
        "marker_bytes": 5,
        "total_bytes": 125,
        "current_version": "m1",
        "current_visible": false
      },
      {
        "decision": "deleted",
        "data_bytes": 20,
        "marker_bytes": 5,
        "total_bytes": 25,
        "current_version": "m1",
        "current_visible": false
      },
      {
        "decision": "NoSuchVersion",
        "data_bytes": 20,
        "marker_bytes": 5,
        "total_bytes": 25,
        "current_version": "m1",
        "current_visible": false
      },
      {
        "decision": "NoSuchVersion",
        "data_bytes": 20,
        "marker_bytes": 5,
        "total_bytes": 25,
        "current_version": "m1",
        "current_visible": false
      },
      {
        "decision": "NoSuchVersion",
        "data_bytes": 20,
        "marker_bytes": 5,
        "total_bytes": 25,
        "current_version": "m1",
        "current_visible": false
      },
      {
        "decision": "deleted",
        "data_bytes": 20,
        "marker_bytes": 0,
        "total_bytes": 20,
        "current_version": "v2",
        "current_visible": true
      },
      {
        "decision": "NoSuchVersion",
        "data_bytes": 20,
        "marker_bytes": 0,
        "total_bytes": 20,
        "current_version": "v2",
        "current_visible": true
      }
    ],
    "versions": [
      {
        "id": "v1",
        "kind": "data",
        "present": false,
        "bytes": 0,
        "mode": "none",
        "retain_until": 0,
        "legal_hold": false
      },
      {
        "id": "v2",
        "kind": "data",
        "present": true,
        "bytes": 20,
        "mode": "none",
        "retain_until": 0,
        "legal_hold": false
      },
      {
        "id": "m1",
        "kind": "marker",
        "present": false,
        "bytes": 0,
        "mode": "none",
        "retain_until": 0,
        "legal_hold": false
      }
    ],
    "final": {
      "data_bytes": 20,
      "marker_bytes": 0,
      "total_bytes": 20,
      "current_version": "v2",
      "current_visible": true
    }
  }
}

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 →