A.11. 호스트
Ceph RESTful API 호스트
끝점을 사용하여 노드 정보라고도 하는 호스트를 표시하는 방법에 대한 메서드 참조입니다.
GET /api/host
- 설명
- 호스트 사양을 나열합니다.
- 매개 변수
쿼리:
-
Source
- 호스트 소스의 문자열 값입니다.
-
- 예제
GET /api/host HTTP/1.1 Host: example.com
- 상태 코드
- 200 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 - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
PUT /api/host/HOST_NAME
- 설명
- 지정된 호스트의 정보를 업데이트합니다. 이 방법은 Ceph Orchestrator가 활성화된 경우에만 지원됩니다.
- 매개 변수
-
HOST_NAME
을 노드 이름으로 교체합니다. -
강제로
- 호스트를 유지 관리 모드로 전환합니다. -
labels
- 레이블 목록입니다. -
유지 관리
- 유지 관리 모드를 입력하거나 종료합니다. -
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 - 확인
- 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 - 확인
- 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 - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
POST /api/host/HOST_NAME/identify_device
- 설명
- 장치의 표시등을 지정된 시간(초)으로 전환하여 장치를 식별합니다.
- 매개 변수
-
HOST_NAME
을 노드 이름으로 교체합니다. -
장치
-/dev/dm-0
또는ABC1234DEF567-1R1234_ABC8DE0Q
와 같은 장치 ID입니다. -
duration
- 장치의 LED가 플래쉬해야 하는 시간(초)입니다.
-
- 예제
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 - A string value to trigger an asynchronous
refresh
.
-
새로 고침 - 비동기 새로 고침을 트리거하는 문자열 값입니다.Refresh - A string value to trigger an asynchronous
-
- 예제
GET /api/host/HOST_NAME/inventory HTTP/1.1 Host: example.com
- 상태 코드
- 200 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 - 확인
- 400 잘못된 요청 - 작동 예외. 자세한 내용은 응답 본문을 확인하십시오.
- 401 승인되지 않음 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 인증되지 않은 액세스입니다. 권한을 확인해 주십시오.
- 500 내부 서버 오류 - 예상되지 않은 오류. 스택 추적에 대한 응답 본문을 확인하십시오.
추가 리소스
- 자세한 내용은 Red Hat Ceph Storage 개발자 가이드의 CephRESTful API 장을 참조하십시오.