참조API
프로젝트
projects 묶음의 오퍼레이션 3 개입니다.
| 메서드 | 경로 | 하는 일 |
|---|---|---|
| GET | /v1/orgs/{orgSlug}/projects | — |
| POST | /v1/orgs/{orgSlug}/projects | 프로젝트 생성 |
| GET | /v1/orgs/{orgSlug}/projects/{projectName} | — |
GET /v1/orgs/{orgSlug}/projects
operationId listProjects
| 응답 | 뜻 | 본문 |
|---|---|---|
| 200 | 조직의 프로젝트 | object |
| 403 | — | — |
| 404 | — | — |
POST /v1/orgs/{orgSlug}/projects
프로젝트를 만들면 호스트네임이 함께 발급된다. 배치(assignments)는 아직 만들어지지 않는다 — 첫 배포 시점에 생긴다. 코드가 없는 프로젝트에 노드를 배정하면 아무것도 서빙하지 않는 프로세스가 뜬다.
프로젝트 수 한도가 여기서 집행된다 (docs/limits.md §2). org 행을 잠그고 세므로 동시 생성이 한도를 넘길 수 없다.
operationId createProject
본문 application/json · object
| 응답 | 뜻 | 본문 |
|---|---|---|
| 201 | 생성된 프로젝트 | Project |
| 403 | — | — |
| 409 | 이름이 이미 있거나(project_name_taken·hostname_taken), 요금제의 프로젝트 수 한도를 넘겼다(project_limit). project_limit 의 details 는 {limit, count, plan} 이다 — 숫자를 메시지에서 정규식으로 뜯어내면 문장을 다듬는 날 조용히 잃는다. 409 인 이유는 재시도가 답을 바꾸지 않기 때문이다 (403 은 권한, 429 는 기다리면 된다는 뜻이다). | Error |
GET /v1/orgs/{orgSlug}/projects/{projectName}
operationId getProject
| 응답 | 뜻 | 본문 |
|---|---|---|
| 200 | 프로젝트 | ProjectDetail |
| 403 | — | — |
| 404 | — | — |