이 페이지는 공개 계약에서 생성하며 설명은 원문(한국어) 그대로 표시합니다.
stly collections create#
Collection 생성
- HTTP 요청:
POST /api/databases/{database_id}/collections - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 예
- 입력 JSON(
--input) 필수
입력 JSON 구조는 stly schema collections create로 확인합니다.
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--database | string | 예 | 부모 Database ID |
--input | string | 예 | JSON 원문 파일 또는 stdin(-) |
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: created_at, database_id, definition, description, id, name, summary, updated_at |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections create --database 00000000-0000-0000-0000-000000000001 --input input.jsonstly collections delete#
Collection 삭제
- HTTP 요청:
DELETE /api/collections/{id} - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 예
--if-match필수
인수
id: ID
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--if-match | string | 예 | 상세 GET에서 얻은 단일 strong ETag |
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections delete 00000000-0000-0000-0000-000000000001 --if-match '"상세 GET의 ETag"'stly collections get#
Collection 상세 조회
- HTTP 요청:
GET /api/collections/{id} - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 아니요
인수
id: ID
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: created_at, database_id, definition, description, id, name, summary, updated_at |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections get 00000000-0000-0000-0000-000000000001stly collections list#
Collection 목록 조회
- HTTP 요청:
GET /api/databases/{database_id}/collections - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 아니요
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--database | string | 예 | 부모 Database ID |
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: created_at, database_id, definition, description, id, name, summary, updated_at |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections list --database 00000000-0000-0000-0000-000000000001stly collections service-links get#
Collection 연결 Service 집합 조회
- HTTP 요청:
GET /api/collections/{id}/service-links - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 아니요
인수
id: ID
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: collection_id, service_ids, updated_at |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections service-links get 00000000-0000-0000-0000-000000000001stly collections service-links update#
Collection 연결 Service 집합 전체 교체
- HTTP 요청:
PUT /api/collections/{id}/service-links - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 예
- 입력 JSON(
--input) 필수 --if-match필수
입력 JSON 구조는 stly schema collections service-links update로 확인합니다.
인수
id: ID
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--if-match | string | 예 | 상세 GET에서 얻은 단일 strong ETag |
--input | string | 예 | JSON 원문 파일 또는 stdin(-) |
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: collection_id, service_ids, updated_at |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections service-links update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'stly collections services#
Collection의 직접 연결 Service 목록
- HTTP 요청:
GET /api/collections/{id}/services - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 아니요
인수
id: ID
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: created_at, description, handle, id, name, status, summary, updated_at |
--page | string | 아니요 | 1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드 |
--per-page | string | 아니요 | 1~500 정수, 생략 시 100 |
--q | string | 아니요 | name 필드의 대소문자 구분 리터럴 부분 일치 검색. summary·description·본문은 검색하지 않으며 정규식·와일드카드를 지원하지 않습니다 |
--sort | string | 아니요 | 리소스 기본 필드명 또는 - 접두 역순만 허용 |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections services 00000000-0000-0000-0000-000000000001 --q "검색어"stly collections update#
Collection 수정
- HTTP 요청:
PUT /api/collections/{id} - 인증 모드: Agent 토큰, User 세션
- 기록 변경: 예
- 입력 JSON(
--input) 필수 --if-match필수
입력 JSON 구조는 stly schema collections update로 확인합니다.
인수
id: ID
옵션
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
--if-match | string | 예 | 상세 GET에서 얻은 단일 strong ETag |
--input | string | 예 | JSON 원문 파일 또는 stdin(-) |
--fields | string | 아니요 | 응답 최상위 필드, 쉼표로 구분 값: created_at, database_id, definition, description, id, name, summary, updated_at |
공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run
예시
stly collections update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'