A.14. Ceph OSD
Ceph RESTful API osd
엔드포인트를 사용하여 Ceph OSD를 관리하는 메서드 참조입니다.
GET /api/osd
- 예
GET /api/osd HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - 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 - 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 - 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 - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
PUT /api/osd/flags/individual
- 설명
-
Ceph OSD의 개별 하위 집합에 대해
noout
,noin
,nodown
,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 - 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 - 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 - 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 - 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 - OK
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/destroy
- 설명
Ceph OSD가 제거됨을 나타냅니다. Ceph OSD가 제거되기 전에 표시되어 있어야 합니다. 이 작업은 Ceph OSD 식별자를 그대로 유지하지만 Cephx 키, 구성 키 데이터 및 lockbox 키를 제거합니다.
주의이 작업은 데이터를 영구적으로 읽을 수 없게 만듭니다.
- 매개 변수
-
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 - 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 - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
PUT /api/osd/SVC_ID/mark
- 설명
Ceph OSD
를
(, ,down
,lost
)로 표시합니다.참고손실
됨을 표시하기 전에 Ceph OSD를down
으로 표시해야 합니다.- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 예
PUT /api/osd/SVC_ID/mark HTTP/1.1 Host: example.com Content-Type: application/json { "action": "STRING" }
- 상태 코드
- 200 OK - OK
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/purge
- 설명
CRUSH 맵에서 Ceph OSD를 제거합니다.
참고제거하기 전에 Ceph OSD를
down
으로 표시해야 합니다.- 매개 변수
-
SVC_ID
를 Ceph OSD 서비스 식별자의 문자열 값으로 바꿉니다.
-
- 상태 코드
- 201 생성됨 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/osd/SVC_ID/reweight
- 설명
-
Ceph OSD를 일시적으로 재중량합니다. Ceph OSD
가
표시되면 OSD의 weight가0
으로 설정됩니다. Ceph OSD가 다시 표시되면 OSD의 weight가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 서비스 식별자의 문자열 값으로 바꿉니다. 쿼리:
-
deep
-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 - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
추가 리소스
- 자세한 내용은 Red Hat Ceph Storage 개발자 가이드의 CephRESTful API 장을 참조하십시오.