轮转¶

POST /api/v1/workspace/accesskey/{ak_uuid}/rotate

概述¶

轮转一个工作空间 API Key

路由参数¶

参数名	类型	必选	说明
ak_uuid	string	Y	要轮转的 API Key UUID

参数补充说明¶

为指定的工作空间 API Key 生成新的 ak/sk，保留名称、备注和角色配置。旧 ak/sk 在成功后立即失效；新 ak/sk 明文只在本次响应中返回，调用方必须立即安全保存。

使用当前 API Key 调用自身轮转接口时，当前请求可以正常完成；响应返回后，请使用返回的新凭证继续调用 OpenAPI。

请求例子¶

curl 'https://openapi.guance.com/api/v1/workspace/accesskey/wsak_xxxxx/rotate' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-raw '{}' \
  --compressed

响应¶

{
    "code": 200,
    "content": {
        "uuid": "wsak_xxxxx",
        "name": "sdk-ak",
        "ak": "new-ak",
        "sk": "new-sk",
        "workspaceUUID": "wksp_xxx",
        "roleInfo": [
            {
                "uuid": "readOnly",
                "name": "Read-only"
            }
        ]
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}