콘텐츠로 이동

순환¶

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": "읽기 전용"
            }
        ]
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}