삭제¶
GET /api/v1/workspace/member_group/{group_uuid}/delete
개요¶
팀, 멤버 및 역할 연결을 삭제하고, 마지막 팀 권한을 잃은 수집 Token을 동시에 무효화합니다.
호출 전 및 사용 단계¶
이 API 메서드는 GET이지만 실제로 팀을 삭제합니다. 읽기 전용 프로브 또는 자동 재실행 용도로 사용할 수 없습니다. 먼저 팀 상세에서 대상을 확인하고, 해당 팀이 권한을 부여한 수집 Token과 이러한 Token을 사용 중인 데이터 수집을 점검하십시오. 해당 팀이 권한을 부여한 사용자 정의 Token만 무효화되며, 다른 팀의 권한 부여가 남아 있는 Token은 유지됩니다. 팀 및 관련 연결이 삭제된 후 캐시와 비동기 권한이 새로 고쳐지며, Token 동기화는 커밋 후 실패할 수 있습니다. 이미 존재하지 않는 팀을 반복 삭제하면 오류가 반환되며, 멱등적 성공은 보장되지 않습니다.
라우트 파라미터¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| group_uuid | string | Y | 대상 팀 UUID이며, 현재 워크스페이스에 속해야 합니다. 예: group_example획득 또는 입력 방법: 팀 목록의 content[].uuid에서 팀 UUID를 가져옵니다. |
요청 헤더¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
파라미터 추가 설명¶
409 오류의 message는 실패 단계에 따라 달라집니다. content에는 committed, syncStatus, syncFailureReason, syncRequiresVerification, tokenRecordUUID 및 isDefault가 포함될 수 있으며, 나타나지 않은 필드를 false로 간주해서는 안 됩니다. 기존 Token 값은 티켓이나 로그에 넣을 필요가 없습니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/workspace/member_group/group_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| content | boolean | 팀 삭제 처리가 완료되면 true이며, Token 영향 상세 정보는 반환하지 않습니다. |
{
"code": 200,
"content": true,
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 400 | ft.WorkspaceTokenInvalidGroups | 삭제 전 검사에서 대상 팀이 존재하지 않거나, 이미 삭제되었거나, 현재 워크스페이스에 속하지 않는 것으로 확인됨 | 팀이 존재하지 않거나 현재 워크스페이스에 속하지 않습니다 | 팀 목록에서 활성 팀 UUID를 확인하고, 이미 존재하지 않는 대상을 반복 삭제하지 마십시오. |
| 404 | ft.MemberGroupNoExists | 대상 팀이 존재하지 않거나, 이미 삭제되었거나, 이 워크스페이스에 없음 | 팀이 존재하지 않습니다 | 팀 목록에서 활성 팀 UUID를 다시 복사하십시오. |
| 401 | ft.WKSPNotExistOrReleased | 대상 워크스페이스가 더 이상 존재하지 않거나 사용할 수 없음 | 워크스페이스가 존재하지 않거나 해제되었습니다 | 현재 워크스페이스 상태를 확인하고, 해제된 워크스페이스를 재시도하지 마십시오. |
| 409 | ft.WorkspaceTokenOperationBusy | 동일 워크스페이스에서 다른 수명 주기 작업이 진행 중임 | 현재 워크스페이스에서 다른 작업이 진행 중이므로 이번 작업이 저장되지 않았습니다. 잠시 후 다시 시도하십시오. | committed=false이면 대기 후 재시도하고, 동시 삭제를 피하십시오. |
| 409 | ft.WorkspaceTokenSyncPending | 워크스페이스에 아직 완료되지 않은 Token 동기화가 있거나, 이번 삭제는 저장되었지만 이후 Token 동기화가 아직 완료되지 않음 | 변경 사항은 저장되었지만 동기화가 아직 완료되지 않았습니다. 먼저 동기화 문제를 처리하십시오. 이번 작업을 반복 제출할 필요는 없습니다. | 반드시 content.committed를 읽어야 합니다. true이면 삭제된 팀과 Token 동기화를 먼저 확인하고 반복 삭제하지 마십시오. false이면 기존 동기화를 먼저 완료한 후 재시도하십시오. syncRequiresVerification=true이면 결과를 먼저 검증해야 하며, 무작정 재실행해서는 안 됩니다. |
| 500 | ft.InternalServerError | Token 트랜잭션 데이터베이스 작업, 삭제 커밋, 캐시 또는 후속 감사 실패 | 내부 오류 | 먼저 팀 및 Token 현황을 확인하고 커밋 여부를 확인한 후 재시도 여부를 결정하며 traceId를 보존하십시오. |
{
"code": 409,
"content": {
"committed": true,
"syncStatus": "pending",
"syncRequiresVerification": true,
"tokenRecordUUID": "wst_example",
"isDefault": false
},
"errorCode": "ft.WorkspaceTokenSyncPending",
"message": "변경 사항은 저장되었지만 이전 동기화 결과가 아직 확인되지 않았습니다. 먼저 동기화 결과를 검증하십시오. 이번 작업을 반복 제출할 필요는 없습니다.",
"success": false,
"traceId": "TRACE-EXAMPLE"
}