콘텐츠로 이동

AWS Role 클라우드 계정 삭제



POST /api/v1/cloud_account/{cloud_account_uuid}/do/delete

개요

현재 워크스페이스의 AWS assume_role 계정 및 해당 수집기 설정을 삭제합니다.

호출 전 및 사용 단계

대상 워크스페이스의 API Key를 사용합니다. 관리 4개 진입점에는 cloudAccount.accountManage 권한이 필요하며 무료 플랜은 명시적으로 거부됩니다. 계정 범위는 Key가 속한 워크스페이스에서 가져옵니다. 임시 자격 증명 읽기에는 별도의 cloudAccount.temporaryCredentialsRead 권한이 필요하며, 관리 권한에 자동으로 포함되지 않습니다. 플랫폼 권한 부여는 이 워크스페이스의 브랜드와 cn/intl 파티션에 따라 선택되며 다른 브랜드로 대체되지 않습니다. 모든 응답에는 Cache-Control: no-store, Pragma: no-cache가 포함됩니다.

반드시 JSON 빈 객체 {}를 POST해야 하며, source/워크스페이스/공급업체 등의 추가 Body 필드는 받지 않습니다. 기존 수집기와 외부 자동화가 더 이상 해당 레코드에 의존하지 않는지 먼저 확인합니다. 먼저 수집기 제거 스크립트를 배포한 다음 수집기와 클라우드 계정 설정을 소프트 삭제하고 커밋합니다. 고객의 AWS IAM Role, 권한/신뢰 정책은 삭제하지 않으며, AWS가 이미 발급한 임시 자격 증명도 회수하지 않습니다. 남은 유효 기간 동안의 액세스를 중지하려면 고객 측에서 AWS 권한 부여를 별도로 관리해야 합니다.

데이터베이스와 외부 스크립트 제거는 원자적이지 않습니다. 실패 시 스크립트는 중지되었지만 설정은 삭제되지 않았을 수 있으므로, 먼저 설정과 실제 수집 작업을 조회해야 하며 500 응답만으로 전혀 변경되지 않았다고 판단해서는 안 됩니다. 존재하지 않음/워크스페이스 간/이미 삭제됨은 404를 반환하며, 중복 요청을 아무 작업도 하지 않은 성공으로 처리하지 않습니다. AWS assume_role만 사용할 수 있습니다.

경로 매개변수

매개변수 이름 유형 필수 설명
cloud_account_uuid string Y 경로 필수이며, 삭제되지 않은 AWS assume_role 레코드여야 합니다. 고객 Account ID, 역할 ARN 또는 다른 워크스페이스 UUID는 사용하지 않습니다.
빈 문자열 허용: False
예: clac_example
가져오기 또는 입력 방법: 클라우드 계정 목록의 content.data[].uuid 또는 생성 성공 시 content.uuid에서 현재 워크스페이스의 clac_ 레코드를 가져옵니다.

요청 헤더

매개변수 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

매개변수 추가 설명

이 워크스페이스의 AWS assume_role만 지원하며, cloudAccount.accountManage가 필요하고 body는 반드시 {}여야 합니다.

삭제는 Front 동작을 따릅니다. 클라우드 계정을 소프트 삭제하고 연결된 수집기와 작업을 제거하지만, 과거 관측 데이터나 고객 AWS IAM Role은 삭제하지 않습니다. 프라이빗 Func 대기열에 추가된 것만으로 제거가 완료된 것은 아닙니다. 실행 전에 대상 UUID 및 연결된 수집기를 확인하고, 수집을 유지해야 하는 경우 삭제를 중지합니다.

중복 삭제는 원래의 존재하지 않음 오류를 반환하며 자동으로 성공 처리되지 않습니다. 삭제 후 다시 생성하면 새 UUID/External ID가 생성되므로 고객은 신뢰 정책과 수집기를 다시 구성해야 하며, 이전 요청 결과를 복구할 수 없습니다. 고객 Role은 고객이 직접 관리하며, 플랫폼은 AWS 전반에 걸쳐 자동으로 롤백하지 않습니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/cloud_account/clac_example/do/delete' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{}'

응답

HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content.uuid string 삭제된 클라우드 계정 UUID입니다.
content.declaration object 공용 선언입니다.
응답 헤더 유형 설명
Cache-Control string no-store, 성공 및 이 블루프린트 라우트 오류 모두 캐싱을 금지합니다.
Pragma string no-cache.
{
  "code": 200,
  "content": {
    "uuid": "clac_example",
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공용 요청 오류는 공용 오류 정의를 참조하세요.

공개 선언/인증 계층 실패 시에는 표준 content={}만 있을 수 있으며, validationResult가 반드시 나타난다고 보장되지 않습니다. 관리 4개 진입점이 비즈니스 어댑테이션에 들어간 후 생성/수정 실패 시 안전 작업 결과가 포함될 수 있습니다. 내부의 일반 5xx는 자체적으로 500 ft.CodeError를 반환하며, content는 이번 검증 상태를 유지하고 전역적으로 InternalServerError로 대체되지 않습니다. 임시 자격 증명 진입점의 일반적인 미처리 예외만 전역 500 ft.InternalServerError로 처리됩니다. HTTP 또는 success만 확인하지 말고 작업 결과, 검증 결과, saved 및 다시 읽은 레코드를 함께 확인해 판단해야 합니다.

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방식
406 ft.ParameterValidationFailed 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반함 매개변수 파싱 실패 매개변수 위치, 필드 이름, 유형 및 값을 확인합니다.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않음 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정합니다.
400 ft.JsonFormatError Body 최상위가 JSON 객체가 아님 일부 json 파일 형식 오류 예시에 맞는 JSON 객체를 제출합니다.
403 ft.Forbidden 관리 4개 진입점이 무료 플랜 워크스페이스에서 명시적 버전 검사로 거부됨 작업 권한이 없습니다 워크스페이스 버전과 관리 권한을 확인하고, 해당 기능과 권한 부여가 있는 대상 워크스페이스로 전환합니다.
404 ft.CloudAccountNotFound 대상 UUID가 현재 워크스페이스의 삭제되지 않은 클라우드 계정 범위에 없음 클라우드 계정이 존재하지 않습니다 현재 워크스페이스의 AWS Role 클라우드 계정 목록 content.data[].uuid에서 대상을 다시 가져옵니다. 이 읽기는 쓰기 잠금을 기다리지 않습니다.
404 ft.InvalidCloudAccountType 전달된 값 또는 대상 레코드가 AWS assume_role이 아님 유효하지 않은 클라우드 계정 유형 현재 워크스페이스의 전용 클라우드 계정 목록에서 레코드를 가져옵니다. 기존 accessKey/role 및 다른 공급업체는 이 진입점에 사용할 수 없습니다.
400 ft.ParamsValidateError JSON Body가 빈 객체 {}가 아니거나, 이전에 저장된 AWS assume_role 설정이 계정/역할/External ID 규격에 맞지 않음 매개변수 검증 실패: {} 요청에는 {}만 제출합니다. 기존 설정이 유효하지 않으면 권한이 있는 클라우드 계정 관리 절차를 통해 확인하고 수정하며, 이 인터페이스에서는 dryRun/설정 업데이트 필드를 전달하지 않습니다.
429 ft.OperationTooFrequently 쓰기 잠금 경합/잠금 손실, 대기 중 다른 요청에 의해 설정이 수정됨 작업이 너무 빈번합니다. 잠시 후 다시 시도하세요 제한된 백오프 전에 UUID로 다시 읽고, 이전 스냅샷을 기준으로 새 제출을 덮어쓰지 않습니다. 생성 결과를 알 수 없으면 먼저 Account ID를 기준으로 복구합니다.
500 ft.CodeError 클라우드 계정/이전 JSON/수집기 자료 또는 플랫폼 권한 부여 표시를 읽는 중 내부 예외 발생 내부 처리 오류 traceId 및 Query를 보존하고, 이전 설정/데이터베이스 및 플랫폼 권한 부여를 확인합니다. 이 읽기는 수집기 스크립트 배포 또는 설정 쓰기를 수행하지 않습니다.

관련 문서

문서 평가

이 페이지가 도움이 되었나요?