A.10. 호스트
Ceph RESTful API 호스트
엔드포인트를 사용하여 노드 정보라고도 하는 호스트를 표시하는 메서드 참조입니다.
GET /api/host
- 설명
- 호스트 사양을 나열합니다.
- 매개 변수
쿼리:
-
source
- 호스트 소스의 문자열 값입니다.
-
- 예
GET /api/host HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/host
- 예
POST /api/host HTTP/1.1 Host: example.com Content-Type: application/json { "hostname": "STRING", "status": "STRING" }
- 상태 코드
- 201 생성됨 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
DELETE /api/host/HOST_NAME
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다.
-
- 상태 코드
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 204 콘텐츠 없음 - 리소스가 삭제됨
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/host/HOST_NAME
- 설명
- 지정된 호스트에 대한 정보를 표시합니다.
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다.
-
- 예
GET /api/host/HOST_NAME HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
PUT /api/host/HOST_NAME
- 설명
- 지정된 호스트에 대한 정보를 업데이트합니다. 이 방법은 Ceph Orchestrator가 활성화된 경우에만 지원됩니다.
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다. -
강제
- 호스트가 유지 관리 모드로 전환되도록 강제 적용합니다. -
레이블
- 라벨 목록입니다. -
유지 관리
- 유지 관리 모드를 입력하거나 종료합니다. -
update_labels
- 레이블을 업데이트합니다.
-
- 예
PUT /api/host/HOST_NAME HTTP/1.1 Host: example.com Content-Type: application/json { "force": true, "labels": [ "STRING" ], "maintenance": true, "update_labels": true }
- 상태 코드
- 200 OK - OK
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/host/HOST_NAME/daemons
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다.
-
- 예
GET /api/host/HOST_NAME/daemons HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/host/HOST_NAME/devices
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다.
-
- 예
GET /api/host/HOST_NAME/devices HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/host/HOST_NAME/identify_device
- 설명
- 지정된 초 수의 장치 표시등을 전환하여 장치를 식별합니다.
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다. -
장치
-/dev/dm-0
또는 Cryostat1234DEF567-1R1234_ABC8DE0Q
와 같은 장치 ID입니다. -
duration
- 장치의 gdd가 플래시해야 하는 시간(초)입니다.
-
- 예
POST /api/host/HOST_NAME/identify_device HTTP/1.1 Host: example.com Content-Type: application/json { "device": "STRING", "duration": "STRING" }
- 상태 코드
- 201 생성됨 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/host/HOST_NAME/inventory
- 설명
- 호스트의 인벤토리를 표시합니다.
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다. 쿼리:
-
refresh
- 비동기 새로 고침을 트리거하는 문자열 값입니다.
-
-
- 예
GET /api/host/HOST_NAME/inventory HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/host/HOST_NAME/smart
- 매개 변수
-
HOST_NAME
을 노드 이름으로 바꿉니다.
-
- 예
GET /api/host/HOST_NAME/smart HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
추가 리소스
- 자세한 내용은 Red Hat Ceph Storage 개발자 가이드의 CephRESTful API 장을 참조하십시오.