삭제¶
GET /api/v1/dialing_region/{region_uuid}/delete
개요¶
자체 호스팅 노드를 삭제하고 해당 노드에 연관된 테스트 구성을 중지합니다.
호출 전 및 사용 단계¶
주의: 이 레거시 API는 실제로 GET이지만 삭제 부작용이 있습니다. 명확히 삭제할 때만 호출해야 하며, 자동 프리페치, 활성 상태 확인 또는 무작위 재도를 해서는 안 됩니다. 반드시 이 워크스페이스의 owner=custom 노드여야 합니다. 먼저 연관된 테스트를 조회하여 해당 노드를 테스트의 regions에서 제거하고, 노드 서비스에 이 리전의 테스트 구성을 일괄 삭제하도록 요청합니다. 그런 다음 로컬 테스트 업데이트를 제출하고, 마지막으로 트랜잭션 외부에서 노드를 삭제합니다. 원래 이미 보고된 데이터는 노드 구성 삭제와 함께 삭제되지 않습니다. 다른 노드는 계속 실행할 수 있으며, 마지막 노드가 제거된 후에도 테스트는 남아 있을 수 있지만 실행 리전이 없으며 테스트가 자동으로 삭제되지는 않습니다.
이 과정은 서비스 간 원자적 트랜잭션이 아닙니다. 테스트/원격 리전 중지 또는 로컬 커밋이 성공했더라도 최종 노드 삭제는 여전히 실패할 수 있습니다. 오류 발생 시 먼저 노드 목록과 각 연관 테스트의 regions를 확인해야 하며, 완전히 실행되지 않았다고 바로 단정해서는 안 됩니다. 노드가 이미 목록에 없다면 다시 삭제할 때 403이 발생할 수 있습니다. 레거시 regionsInfo에는 이전 노드 스냅샷이 남아 있을 수 있습니다. 실제 실행 선택은 업데이트된 regions와 플랫폼 상태를 대조하여 확인해야 하며, 이전 표시 스냅샷만으로 아직 실행 중이라고 판단해서는 안 됩니다.
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| region_uuid | string | Y | 기본 공용 노드, 모바일 노드 ID, keycode 또는 테스트 UUID가 아닙니다. 예시: regn_example획득 또는 입력 방법: 자체 호스팅 노드 목록에서 현재 워크스페이스의 owner=custom 노드의 uuid를 가져옵니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/dialing_region/regn_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | JSON | 업스트림 삭제 content를 그대로 반환하며, 일반적으로 {}이고 고정된 true가 아닙니다. 명시적 업스트림 []도 그대로 반환할 수 있습니다. 성공 딕셔너리에 content가 없으면 SDK가 {}를 보충합니다. |
| content.declaration | object | 비어 있지 않은 객체일 때만 추가되며, 빈 {}에는 없습니다. 비어 있지 않은 객체 배열은 객체별로 추가됩니다. |
{
"code": 200,
"content": {},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
일반 신서틱 SDK는 다운스트림 error_code=dialtesting.invalidRegion을 ft.DialingRegionError로 일괄 매핑하고 실제 HTTP(400에 국한되지 않음)를 유지합니다. 기타 다운스트림 4xx는 실제 HTTP와 error_code/message(ft 접두사가 없는 업스트림 코드 포함)를 유지하며, 나열되지 않은 코드도 반환될 수 있습니다. >=500은 공개 진입점에서 일괄적으로 500 ft.InternalServerError로 래핑됩니다. SDK는 업스트림 content를 반환하며, 이 컨트롤러는 이를 특정 regionInfo/ak 구조로 일괄 재래핑하지 않으므로 실제 배포 버전에 따라 평면 또는 호환 래핑을 식별해야 하며, 알 수 없는 추가 필드는 호환성을 위해 유지됩니다.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 403 | ft.ForbiddenInvalidSelfBuiltNode | UUID가 이 워크스페이스의 자체 호스팅 노드 집합에 없음 | 잘못된 작업, 유효하지 않은 자체 호스팅 노드 ID | 이 워크스페이스의 자체 호스팅 목록에서 확인하십시오. 이미 삭제된 객체는 멱등 성공이 보장되지 않습니다. |
| 406 | ft.DialingBrandNoSetError | 워크스페이스에 대응하는 신서틱 서비스 브랜드 구성이 누락됨 | {} 브랜드의 신서틱 구성이 구성되지 않았습니다. |
관리자가 현재 워크스페이스의 신서틱 서비스를 확인합니다. |
| 400 | ft.DialingAKNoSetError | 신서틱 서비스 서명 자격 증명이 구성되지 않음 | 신서틱 AK 정보가 구성되지 않았습니다. Launcher 활성화 구성을 확인하십시오 | 관리자가 서비스 활성화 정보를 확인하며, 클라이언트는 이 본문에서 이러한 자격 증명을 제출하지 않습니다. |
| 400 | ft.DialingServerError | 다운스트림 신서틱 노드 인터페이스가 400 비즈니스 실패를 반환했거나 응답 미디어를 파싱할 수 없음 | 신서틱 서비스 인터페이스 호출 실패 | message/traceId를 확인하고 관리자가 노드 서비스를 점검하도록 하십시오. 실패를 노드 없음으로 간주해서는 안 됩니다. |
| 500 | ft.InternalServerError | 일반 다운스트림 5xx/연결 예외, 또는 레거시 노드/연관 필드 형식, 이름 및 응답 조립 예외 | 내부 오류 | 특정 노드/필터로 범위를 좁혀 업스트림 응답 형식과 서비스 가용성을 확인하십시오. 지속적으로 실패하면 traceId를 보관하십시오. |
| 400 | ft.DialingRegionError | 다운스트림 HTTP400이고 error_code=dialtesting.invalidRegion인 경우. 기타 4xx도 동일한 코드로 매핑되며 실제 HTTP를 유지합니다 | 현재 테스트에 일부 신서틱 노드가 유효하지 않습니다. 구성을 업데이트한 후 다시 저장하십시오. | 유효한 자체 호스팅 노드 및 노드 서비스 상태를 확인하고, 원래 dialtesting 코드로 고정 매칭하지 마십시오. |