A.3. Ceph 파일 시스템
Ceph RESTful API cephfs
엔드포인트를 사용하여 Ceph File Systems(CephFS)를 관리하기 위한 메서드 참조입니다.
GET /api/cephfs
- 예
GET /api/cephfs HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/cephfs/FS_ID
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다.
-
- 예
GET /api/cephfs/FS_ID HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
DELETE /api/cephfs/FS_ID/client/CLIENT_ID
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. -
CLIENT_ID
를 Ceph 클라이언트 ID 문자열로 교체합니다.
-
- 상태 코드
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인하십시오.
- 204 콘텐츠 없음 - 리소스가 삭제됨
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/cephfs/FS_ID/clients
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다.
-
- 예
GET /api/cephfs/FS_ID/clients HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/cephfs/FS_ID/get_root_directory
- 설명
-
ls_dir
API 호출을 사용하여 가져올 수 없는 루트 디렉터리입니다. - 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다.
-
- 예
GET /api/cephfs/FS_ID/get_root_directory HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/cephfs/FS_ID/ls_dir
- 설명
- 지정된 경로의 디렉터리를 나열합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. 쿼리:
-
path
- 목록을 시작할 문자열 값입니다. 지정되지 않은 경우 기본 경로는/
입니다. -
깊이
- 디렉터리 트리 아래로 이동할 단계 수를 지정하는 정수 값입니다.
-
-
- 예
GET /api/cephfs/FS_ID/ls_dir HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/cephfs/FS_ID/mds_counters
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. 쿼리:
-
카운터
- 정수 값입니다.
-
-
- 예
GET /api/cephfs/FS_ID/mds_counters HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
GET /api/cephfs/FS_ID/quota
- 설명
- 지정된 경로의 CephFS 할당량을 표시합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. 쿼리:
-
path
- 디렉터리 경로를 지정하는 필수 문자열 값입니다.
-
-
- 예
GET /api/cephfs/FS_ID/quota?path=STRING HTTP/1.1 Host: example.com
- 상태 코드
- 200 OK - OK
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
PUT /api/cephfs/FS_ID/quota
- 설명
- 지정된 경로에 대한 할당량을 설정합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. -
max_bytes
- 바이트 제한을 정의하는 문자열 값입니다. -
max_files
- 파일 제한을 정의하는 문자열 값입니다. -
path
- 디렉터리 또는 파일의 경로를 정의하는 문자열 값입니다.
-
- 예
PUT /api/cephfs/FS_ID/quota HTTP/1.1 Host: example.com Content-Type: application/json { "max_bytes": "STRING", "max_files": "STRING", "path": "STRING" }
- 상태 코드
- 200 OK - OK
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인합니다.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
DELETE /api/cephfs/FS_ID/snapshot
- 설명
- snapsnot를 제거합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. 쿼리:
-
name
- 스냅샷 이름을 지정하는 필수 문자열 값입니다. -
path
- 디렉터리의 경로를 정의하는 필수 문자열 값입니다.
-
-
- 상태 코드
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인합니다.
- 204 콘텐츠 없음 - 리소스가 삭제됨
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/cephfs/FS_ID/snapshot
- 설명
- 스냅샷을 생성합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. -
name
- 스냅샷 이름을 지정하는 문자열 값입니다. 이름을 지정하지 않으면 RFC3339 UTC 형식의 현재 시간을 사용하는 이름이 생성됩니다. -
path
- 디렉터리의 경로를 정의하는 문자열 값입니다.
-
- 예
POST /api/cephfs/FS_ID/snapshot HTTP/1.1 Host: example.com Content-Type: application/json { "name": "STRING", "path": "STRING" }
- 상태 코드
- 201 생성됨 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인합니다.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
DELETE /api/cephfs/FS_ID/tree
- 설명
- 디렉터리를 제거합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. 쿼리:
-
path
- 디렉터리의 경로를 정의하는 필수 문자열 값입니다.
-
-
- 상태 코드
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인합니다.
- 204 콘텐츠 없음 - 리소스가 삭제됨
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
POST /api/cephfs/FS_ID/tree
- 설명
- 디렉터리를 생성합니다.
- 매개 변수
-
FS_ID
를 Ceph File System ID 문자열로 바꿉니다. -
path
- 디렉터리의 경로를 정의하는 문자열 값입니다.
-
- 예
POST /api/cephfs/FS_ID/tree HTTP/1.1 Host: example.com Content-Type: application/json { "path": "STRING" }
- 상태 코드
- 201 생성됨 - 리소스가 생성되었습니다.
- 202 허용 - 작업이 계속 실행 중입니다. 작업 대기열을 확인합니다.
- 400 잘못된 요청 - 예외 작업 자세한 내용은 응답 본문을 확인하십시오.
- 401 무단 - 인증되지 않은 액세스 먼저 로그인하십시오.
- 403 forbidden - 무단 액세스 권한을 확인하십시오.
- 500 내부 서버 오류 - 예기치 않은 오류. 스택 추적을 위해 응답 본문을 확인하십시오.
추가 리소스
- 자세한 내용은 Red Hat Ceph Storage 개발자 가이드의 CephRESTful API 장을 참조하십시오.