Skip to content

Commit 1ac7aa8

Browse files
chore: update api schema dump
Co-authored-by: octodog <mu001@lablup.com>
1 parent 7950ea6 commit 1ac7aa8

1 file changed

Lines changed: 66 additions & 7 deletions

File tree

docs/manager/rest-reference/openapi.json

Lines changed: 66 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1119,6 +1119,17 @@
11191119
"title": "UpdateAppConfigFragmentInput",
11201120
"type": "object"
11211121
},
1122+
"AppConfigAccessLevel": {
1123+
"description": "Minimum principal tier allowed to read or write a config layer (BEP-1052).\n\nOrdered least → most privileged: ``public`` < ``authenticated`` < ``owner`` < ``admin``.\nStored per ``(config_name, scope_type)`` on the allow-list — once for read, once for\nwrite — so read-enablement and write-authorization are independent concerns. The\nallow-list row's existence no longer implies write access: it only registers the layer\nand its merge ``rank`` (the read side), while ``write_access`` decides who may write.\n\n``owner`` is resolved relative to the fragment's scope: the user itself for ``user``\nscope, the domain admin for ``domain``. ``admin`` (superadmin) always satisfies any tier.",
1124+
"enum": [
1125+
"public",
1126+
"authenticated",
1127+
"owner",
1128+
"admin"
1129+
],
1130+
"title": "AppConfigAccessLevel",
1131+
"type": "string"
1132+
},
11221133
"CreateAppConfigAllowListInput": {
11231134
"description": "Input for registering a new app config allow-list entry.",
11241135
"properties": {
@@ -1145,6 +1156,30 @@
11451156
"default": null,
11461157
"description": "Merge rank applied to fragments under this entry (low to high; higher wins). Defaults to the scope type's default rank (public=100, domain=200, user=300).",
11471158
"title": "Rank"
1159+
},
1160+
"read_access": {
1161+
"anyOf": [
1162+
{
1163+
"$ref": "#/components/schemas/AppConfigAccessLevel"
1164+
},
1165+
{
1166+
"type": "null"
1167+
}
1168+
],
1169+
"default": null,
1170+
"description": "Minimum principal tier allowed to read the fragments under this entry. Defaults to the scope type's default (public=public, domain=authenticated, user=owner)."
1171+
},
1172+
"write_access": {
1173+
"anyOf": [
1174+
{
1175+
"$ref": "#/components/schemas/AppConfigAccessLevel"
1176+
},
1177+
{
1178+
"type": "null"
1179+
}
1180+
],
1181+
"default": null,
1182+
"description": "Minimum principal tier allowed to write the fragments under this entry. Defaults to the scope type's default (public=admin, domain=admin, user=owner)."
11481183
}
11491184
},
11501185
"required": [
@@ -1405,7 +1440,7 @@
14051440
"type": "object"
14061441
},
14071442
"UpdateAppConfigAllowListInput": {
1408-
"description": "Input for updating an app config allow-list entry.\n\nOnly ``rank`` is updatable — the identity pair (``config_name``, ``scope_type``)\nis immutable (purge and recreate to change it).",
1443+
"description": "Input for updating an app config allow-list entry.\n\n``rank`` and the access tiers (``read_access`` / ``write_access``) are updatable — the\nidentity pair (``config_name``, ``scope_type``) is immutable (purge and recreate to\nchange it).",
14091444
"properties": {
14101445
"id": {
14111446
"description": "App config allow-list entry id to update.",
@@ -1425,6 +1460,30 @@
14251460
"default": null,
14261461
"description": "New merge rank applied to fragments under this entry (low to high; higher wins). Omit to leave unchanged.",
14271462
"title": "Rank"
1463+
},
1464+
"read_access": {
1465+
"anyOf": [
1466+
{
1467+
"$ref": "#/components/schemas/AppConfigAccessLevel"
1468+
},
1469+
{
1470+
"type": "null"
1471+
}
1472+
],
1473+
"default": null,
1474+
"description": "New minimum principal tier allowed to read the fragments under this entry. Omit to leave unchanged."
1475+
},
1476+
"write_access": {
1477+
"anyOf": [
1478+
{
1479+
"$ref": "#/components/schemas/AppConfigAccessLevel"
1480+
},
1481+
{
1482+
"type": "null"
1483+
}
1484+
],
1485+
"default": null,
1486+
"description": "New minimum principal tier allowed to write the fragments under this entry. Omit to leave unchanged."
14281487
}
14291488
},
14301489
"required": [
@@ -39177,7 +39236,7 @@
3917739236
},
3917839237
"/v2/app-config-fragments/": {
3917939238
"post": {
39180-
"operationId": "v2/app-config-fragments.admin_create",
39239+
"operationId": "v2/app-config-fragments.create",
3918139240
"tags": [
3918239241
"v2/app-config-fragments"
3918339242
],
@@ -39201,7 +39260,7 @@
3920139260
}
3920239261
},
3920339262
"parameters": [],
39204-
"description": "Create a fragment at any scope (superadmin only).\n\n**Preconditions:**\n* Superadmin privilege required.\n"
39263+
"description": "Create a fragment; authorized by the layer's write_access tier (auth required).\n\n**Preconditions:**\n* User privilege required.\n"
3920539264
}
3920639265
},
3920739266
"/v2/app-config-fragments/search": {
@@ -39291,7 +39350,7 @@
3929139350
"description": "Get a fragment by id (superadmin only).\n\n**Preconditions:**\n* Superadmin privilege required.\n"
3929239351
},
3929339352
"patch": {
39294-
"operationId": "v2/app-config-fragments.admin_update",
39353+
"operationId": "v2/app-config-fragments.update",
3929539354
"tags": [
3929639355
"v2/app-config-fragments"
3929739356
],
@@ -39324,10 +39383,10 @@
3932439383
}
3932539384
}
3932639385
],
39327-
"description": "Update a fragment's config document by id (superadmin only).\n\n**Preconditions:**\n* Superadmin privilege required.\n"
39386+
"description": "Update a fragment's config; authorized by the layer's write_access tier (auth required).\n\n**Preconditions:**\n* User privilege required.\n"
3932839387
},
3932939388
"delete": {
39330-
"operationId": "v2/app-config-fragments.admin_purge",
39389+
"operationId": "v2/app-config-fragments.purge",
3933139390
"tags": [
3933239391
"v2/app-config-fragments"
3933339392
],
@@ -39351,7 +39410,7 @@
3935139410
}
3935239411
}
3935339412
],
39354-
"description": "Purge a fragment by id (superadmin only).\n\n**Preconditions:**\n* Superadmin privilege required.\n"
39413+
"description": "Purge a fragment by id; authorized by the layer's write_access tier (auth required).\n\n**Preconditions:**\n* User privilege required.\n"
3935539414
}
3935639415
},
3935739416
"/v2/app-config-allow-list/": {

0 commit comments

Comments
 (0)