作用域影响预览¶
POST /api/v1/tag/{tag_uuid}/scope/preview
概述¶
修改作用域前只读预览受影响资源，返回十分钟有效的确认凭据。
路由参数¶
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| tag_uuid | string | Y | 标签 UUID |
Body 请求参数¶
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| scope | any | Y | 多作用域数组，all与具体作用域互斥；兼容旧单值字符串 允许为空: False |
| pageIndex | integer | 页码 $minValue: 1 |
|
| pageSize | integer | 每页数量 $minValue: 1 $maxValue: 1000 |
响应¶
响应的 content 包含 tagUUID、oldScope、newScope、requiresConfirmation 和 previewToken。受影响的资源在 content.data，计数与汇总在 content.affectedResourceCount、content.affectedRelationCount、content.affectedConfigCount 和 content.summary。分页信息位于响应顶层 pageInfo。
如需在后续修改标签时附带预览凭据，将 previewToken 作为 scopePreviewToken 提交，并沿用本次预览的目标作用域。