stly

stly systems

이 페이지의 내용

이 페이지는 공개 계약에서 생성하며 설명은 원문(한국어) 그대로 표시합니다.

stly systems component-links get#

System 직접 구성 집합 조회

HTTP 요청: GET /api/systems/{id}/component-links
인증 모드: Agent 토큰, User 세션
기록 변경: 아니요

인수

id: ID

옵션

이름	타입	필수	설명
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `api_ids`, `database_ids`, `service_ids`, `system_id`, `system_ids`, `updated_at`

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems component-links get 00000000-0000-0000-0000-000000000001

stly systems component-links update#

System 직접 구성 집합 전체 교체

HTTP 요청: PUT /api/systems/{id}/component-links
인증 모드: Agent 토큰, User 세션
기록 변경: 예
입력 JSON(--input) 필수
--if-match 필수

입력 JSON 구조는 stly schema systems component-links update로 확인합니다.

인수

id: ID

옵션

이름	타입	필수	설명
`--if-match`	`string`	예	상세 GET에서 얻은 단일 strong ETag
`--input`	`string`	예	JSON 원문 파일 또는 stdin(-)
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `api_ids`, `database_ids`, `service_ids`, `system_id`, `system_ids`, `updated_at`

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems component-links update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'

stly systems components#

System 직접·간접 구성 조회

HTTP 요청: GET /api/systems/{id}/components
인증 모드: Agent 토큰, User 세션
기록 변경: 아니요

인수

id: ID

옵션

이름	타입	필수	설명
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `description`, `id`, `inclusion`, `kind`, `name`, `summary`
`--kind`	`string`	아니요	구성 종류 system·service·api·database 값: `system`, `service`, `api`
`--page`	`string`	아니요	1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드
`--per-page`	`string`	아니요	1~500 정수, 생략 시 100
`--q`	`string`	아니요	name 필드의 대소문자 구분 리터럴 부분 일치 검색. summary·description·본문은 검색하지 않으며 정규식·와일드카드를 지원하지 않습니다
`--scope`	`string`	아니요	direct 또는 recursive 구성 범위 값: `direct`, `recursive`
`--sort`	`string`	아니요	리소스 기본 필드명 또는 - 접두 역순만 허용

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems components 00000000-0000-0000-0000-000000000001 --q "검색어"

stly systems composition#

대상까지의 모든 포함 연결 조회

HTTP 요청: GET /api/systems/{id}/composition
인증 모드: Agent 토큰, User 세션
기록 변경: 아니요

인수

id: ID

옵션

이름	타입	필수	설명
`--target-id`	`string`	예	포함 경로 대상 ID
`--target-kind`	`string`	예	포함 경로 대상 종류(system·service·api·database) 값: `system`, `service`, `api`
`--composition-revision`	`string`	아니요	첫 페이지의 composition_revision, 두 번째 페이지부터 필수
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `component`, `parent_id`
`--page`	`string`	아니요	1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드
`--per-page`	`string`	아니요	1~500 정수, 생략 시 100

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems composition 00000000-0000-0000-0000-000000000001 --target-kind service --target-id 00000000-0000-0000-0000-000000000001

stly systems create#

System 생성

HTTP 요청: POST /api/systems
인증 모드: Agent 토큰, User 세션
기록 변경: 예
입력 JSON(--input) 필수

입력 JSON 구조는 stly schema systems create로 확인합니다.

옵션

이름	타입	필수	설명
`--input`	`string`	예	JSON 원문 파일 또는 stdin(-)
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `created_at`, `description`, `handle`, `id`, `name`, `summary`, `updated_at`

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems create --input input.json

stly systems delete#

System 삭제

HTTP 요청: DELETE /api/systems/{id}
인증 모드: Agent 토큰, User 세션
기록 변경: 예
--if-match 필수

인수

id: ID

옵션

이름	타입	필수	설명
`--if-match`	`string`	예	상세 GET에서 얻은 단일 strong ETag
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems delete 00000000-0000-0000-0000-000000000001 --if-match '"상세 GET의 ETag"'

stly systems get#

System 상세 조회

HTTP 요청: GET /api/systems/{id}
인증 모드: Agent 토큰, User 세션
기록 변경: 아니요

인수

id: ID

옵션

이름	타입	필수	설명
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `created_at`, `description`, `handle`, `id`, `name`, `summary`, `updated_at`

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems get 00000000-0000-0000-0000-000000000001

stly systems list#

System 목록 조회

HTTP 요청: GET /api/systems
인증 모드: Agent 토큰, User 세션
기록 변경: 아니요

옵션

이름	타입	필수	설명
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `created_at`, `description`, `handle`, `id`, `name`, `summary`, `updated_at`
`--handle`	`string`	아니요	Web 주소 이름 정확 일치 필터. 앞뒤 공백 제거·소문자 정규화 후 비교하며 결과는 최대 1건
`--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 systems list --q "검색어"

stly systems parents#

상위 System 조회

HTTP 요청: GET /api/systems/{id}/parents
인증 모드: Agent 토큰, User 세션
기록 변경: 아니요

인수

id: ID

옵션

이름	타입	필수	설명
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `description`, `id`, `inclusion`, `kind`, `name`, `summary`
`--page`	`string`	아니요	1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드
`--per-page`	`string`	아니요	1~500 정수, 생략 시 100
`--q`	`string`	아니요	name 필드의 대소문자 구분 리터럴 부분 일치 검색. summary·description·본문은 검색하지 않으며 정규식·와일드카드를 지원하지 않습니다
`--scope`	`string`	아니요	direct 또는 recursive 구성 범위 값: `direct`, `recursive`
`--sort`	`string`	아니요	리소스 기본 필드명 또는 - 접두 역순만 허용

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems parents 00000000-0000-0000-0000-000000000001 --q "검색어"

stly systems update#

System 수정

HTTP 요청: PUT /api/systems/{id}
인증 모드: Agent 토큰, User 세션
기록 변경: 예
입력 JSON(--input) 필수
--if-match 필수

입력 JSON 구조는 stly schema systems update로 확인합니다.

인수

id: ID

옵션

이름	타입	필수	설명
`--if-match`	`string`	예	상세 GET에서 얻은 단일 strong ETag
`--input`	`string`	예	JSON 원문 파일 또는 stdin(-)
`--fields`	`string`	아니요	응답 최상위 필드, 쉼표로 구분 값: `created_at`, `description`, `handle`, `id`, `name`, `summary`, `updated_at`

공통 옵션: --server, --env-file, --timeout, --auth-mode, --dry-run

예시

stly systems update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'