A.16. Ceph OSD
Ceph RESTful API osd
엔드포인트를 사용하여 Ceph OSD를 관리하는 방법 참조입니다.
GET /api/osd
- 예제
GET /api/osd HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
POST /api/osd
- 예제
POST /api/osd HTTP/1.1 Host: example.com Content-Type: application/json { "data": "STRING", "method": "STRING", "tracking_id": "STRING" }
- 상태 코드
- 201 생성 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/flags
- 설명
- Ceph OSD 플래그를 확인합니다.
- 예제
GET /api/osd/flags HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
PUT /api/osd/flags
- 설명
- 전체 스토리지 클러스터의 Ceph OSD 플래그를 설정합니다.
- 매개 변수
-
recovery_deletes
,sortbitwise
,pglog_hardlimit
플래그는 설정을 해제할 수 없습니다. purged_snapshots
플래그를 설정할 수 없습니다.중요성공적인 작업을 위해 다음 4개의 플래그를 포함해야 합니다.
-
- 예제
PUT /api/osd/flags HTTP/1.1 Host: example.com Content-Type: application/json { "flags": [ "STRING" ] }
- 상태 코드
- 200 OK - 확인
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/flags/individual
- 설명
- 개별 Ceph OSD 플래그를 확인합니다.
- 예제
GET /api/osd/flags/individual HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
PUT /api/osd/flags/individual
- 설명
-
Ceph OSD의 개별 하위 집합에 대한
no
outnoin
,noup
플래그를 업데이트합니다. - 예제
PUT /api/osd/flags/individual HTTP/1.1 Host: example.com Content-Type: application/json { "flags": { "nodown": true, "noin": true, "noout": true, "noup": true }, "ids": [ 1 ] }
- 상태 코드
- 200 OK - 확인
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/safe_to_delete
- 매개 변수
쿼리:
-
svc_ids
- Ceph OSD 서비스 식별자의 필수 문자열입니다.
-
- 예제
GET /api/osd/safe_to_delete?svc_ids=STRING HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/safe_to_destroy
- 설명
- Ceph OSD가 안전한지 확인합니다.
- 매개 변수
쿼리:
-
ID
- Ceph OSD 서비스 식별자의 필수 문자열입니다.
-
- 예제
GET /api/osd/safe_to_destroy?ids=STRING HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
DELETE /api/osd/SVC_ID
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다. 쿼리:
-
preserve_id
- 문자열 값입니다. -
force
- 문자열 값입니다.
-
-
- 상태 코드
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 204 콘텐츠 없음 - 리소스가 삭제되었습니다.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/SVC_ID
- 설명
- Ceph OSD에 대한 수집된 데이터를 반환합니다.
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
GET /api/osd/SVC_ID HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
PUT /api/osd/SVC_ID
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
PUT /api/osd/SVC_ID HTTP/1.1 Host: example.com Content-Type: application/json { "device_class": "STRING" }
- 상태 코드
- 200 OK - 확인
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/destroy
- 설명
Ceph OSD가 삭제됨으로 표시됩니다. 제거되기 전에 Ceph OSD를 축소해야 합니다. 이 작업은 Ceph OSD ID를 그대로 유지하지만 Cephx 키, 구성 키 데이터, 잠금 상자 키를 제거합니다.
주의이 작업은 데이터를 영구적으로 읽을 수 없도록 렌더링합니다.
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 상태 코드
- 201 생성 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/SVC_ID/devices
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
GET /api/osd/SVC_ID/devices HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/SVC_ID/histogram
- 설명
- Ceph OSD 히스토그램 데이터를 반환합니다.
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
GET /api/osd/SVC_ID/histogram HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
PUT /api/osd/SVC_ID/mark
- 설명
Ceph OSD
를
,아래쪽으로
표시하고손실된
를 표시합니다.참고손실된
것으로 표시하기 전에 Ceph OSD를축소
해야 합니다.- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
PUT /api/osd/SVC_ID/mark HTTP/1.1 Host: example.com Content-Type: application/json { "action": "STRING" }
- 상태 코드
- 200 OK - 확인
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/purge
- 설명
ArgoCD 맵에서 Ceph OSD를 제거합니다.
참고제거 전에 Ceph OSD를 표시해야합니다.
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 상태 코드
- 201 생성 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/reweight
- 설명
-
Ceph OSD를 일시적으로 다시 스케일링합니다. Ceph OSD가 임을 표시하면 OSD의 가중치가
0
으로 설정됩니다.Ceph OSD가 다시
으로
표시되면 OSD의 가중치가1
로 설정됩니다. - 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
POST /api/osd/SVC_ID/reweight HTTP/1.1 Host: example.com Content-Type: application/json { "weight": "STRING" }
- 상태 코드
- 201 생성 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/scrub
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다. 쿼리:
-
딥
- 부울 값(true
또는false
)입니다.
-
-
- 예제
POST /api/osd/SVC_ID/scrub HTTP/1.1 Host: example.com Content-Type: application/json { "deep": true }
- 상태 코드
- 201 생성 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
GET /api/osd/SVC_ID/smart
- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예제
GET /api/osd/SVC_ID/smart HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
추가 리소스
- 자세한 내용은 Red Hat Ceph Storage 개발자 가이드의 CephRESTful API 장을 참조하십시오.