---
title: "파이프라인 조회"
slug: "devtools-sourcepipeline-projectdetail"
tags: ["SourcePipeline"]
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/devtools-sourcepipeline-projectdetail"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 파이프라인 조회

Classic/VPC 환경에서 이용 가능합니다.

파이프라인의 상세 정보를 조회합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /api/v1/project/{projectId} |

### 요청 헤더

SourcePipeline API에서 공통으로 사용하는 헤더에 대한 정보는 [SourcePipeline 요청 헤더](/docs/devtools-sourcepipeline#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `projectId` | String | Required | 파이프라인 아이디 - [파이프라인 목록 조회](/docs/devtools-sourcepipeline-projectlist) 참조 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://vpcsourcepipeline.apigw.ntruss.com/api/v1/project/2***' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `result` | Object | - | 응답 결과 |
| `result.id` | Number | - | 파이프라인 아이디 |
| `result.name` | String | - | 파이프라인 이름 |
| `result.description` | String | - | 파이프라인 설명 |
| `result.tasks` | Array | - | 작업 목록: [tasks](/docs/devtools-sourcepipeline-projectdetail#tasks) |
| `result.trigger` | Object | - | 트리거 설정 |
| `result.trigger.repository` | Array | - | Push 트리거 설정: [repository](/docs/devtools-sourcepipeline-projectdetail#repository) |
| `result.trigger.schedule` | Array | - | 예약 트리거 설정: [schedule](/docs/devtools-sourcepipeline-projectdetail#schedule) |
| `result.trigger.sourcepipeline` | Array | - | 파이프라인 트리거 설정: [sourcepipeline](/docs/devtools-sourcepipeline-projectdetail#sourcepipeline) |

#### `tasks`

`tasks`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `id` | Number | - | 작업 아이디 |
| `name` | String | - | 작업 이름 |
| `type` | String | - | 작업 타입 - `SourceBuild` \| `SourceDeploy` |
| `linkedTasks` | Array | - | 선행 작업 목록 |
| `config` | Object | - | 작업 설정 |
| `config.projectId` | Number | - | 작업 프로젝트 아이디 |
| `config.stageId` | Number | - | 배포 스테이지 아이디 - `type`이 `SourceDeploy`인 경우, 표시 |
| `config.scenarioId` | Number | - | 배포 시나리오 아이디 - `type`이 `SourceDeploy`인 경우, 표시 |
| `config.target` | Object | - | 연결 정보 |
| `config.target.type` | String | - | 연결 타입 - `SourceCommit` \| `GitHub` \| `Bitbucket` \| `Github Enterprise Server` \| `SourceBuild` \| `ObjectStorage` \| `KubernetesService` |
| `config.target.name` | String | - | 연결 프로젝트 이름 - `type`이 `SourceBuild`인 경우, 표시 |
| `config.target.info` | Object | - | 상세 연결 정보 |
| `config.target.info.repository` | String | - | 리포지토리 이름 - `type`이 `SourceBuild`인 경우, 표시 |
| `config.target.info.workspace` | Object | - | Bitbucket 워크스페이스 정보 - `config.target.type`이 `Bitbucket`인 경우, 하위 정보 포함하여 표시 |
| `config.target.info.workspace.id` | String | - | Bitbucket 워크스페이스 아이디 |
| `config.target.info.workspace.name` | String | - | Bitbucket 워크스페이스 이름 |
| `config.target.info.branch` | String | - | 브랜치 이름 - `type`이 `SourceBuild`인 경우, 표시 |
| `config.target.info.authType` | String | - | Github Enterprise Server 로그인 타입 - `config.target.type`이 `Github Enterprise Server`인 경우, 표시 |
| `config.target.info.url` | String | - | Git 리포지토리 URL - `config.target.type`이 `Github Enterprise Server`이고 `config.target.info.authType`이 `ssh`인 경우, 표시 |
| `config.target.info.serverUrl` | String | - | 서버 URL - `config.target.type`이 `Github Enterprise Server`이고 `config.target.info.authType`이 `OAuth`, `Personal Access Token`, `Username/Password`인 경우, 표시 |
| `config.target.info.owner` | String | - | Github Enterprise Server 소유자 - `config.target.type`이 `Github Enterprise Server`인 경우, 표시 |
| `config.target.info.projectName` | String | - | 빌드 프로젝트 이름 - `config.target.type`이 `SourceBuild`인 경우, 표시 |
| `config.target.info.file` | String | - | Object Storage 내 파일 위치 - `config.target.type`이 `ObjectStorage`인 경우, 표시 |
| `config.target.info.storageType` | String | - | 매니페스트 파일 저장소 - `config.target.type`이 `KubernetesService`인 경우, 표시 |
| `config.target.info.repository` | String | - | 매니페스트 저장 리포지토리 - `config.target.info.storageType`이 `SourceCommit`인 경우, 표시 |
| `config.target.info.branch` | String | - | 매니페스트 저장 리포지토리의 브랜치 - `config.target.info.storageType`이 `SourceCommit`인 경우, 표시 |
| `config.target.info.manifest` | String | - | 매니페스트 파일 - `config.target.type`이 `KubernetesService`인 경우, 표시 |
| `config.target.info.fullManifest` | String | - | 매니페스트 파일 목록 - `config.target.type`이 `KubernetesService`인 경우, 표시 |

#### `repository`

`repository`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `type` | String | - | 리포지토리 종류 - `sourcecommit`: SourceCommit (유효 값) |
| `name` | String | - | 리포지토리 이름 |
| `branch` | String | - | 브랜치 이름 |

#### `schedule`

`schedule`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `day` | Array | - | 예약 실행 요일 목록 - `MON` \| `TUE` \| `WED` \| `THU` \| `FRI` \| `SAT` \| `SUN` |
| `time` | String | - | 예약 실행 시간 |
| `timeZone` | String | - | 예약 트리거 타임존 |
| `scheduleOnlyWithChange` | Boolean | - | SourceCommit, SourcePipeline 변경 시 실행 여부 - `true` \| `false` - `true`: 실행 - `false`: 실행 안 함 |

#### `sourcepipeline`

`sourcepipeline`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `id` | Number | - | 파이프라인 아이디 |
| `name` | String | - | 파이프라인 이름 |

### 응답 상태 코드

SourcePipeline API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [SourcePipeline 응답 상태 코드](/docs/devtools-sourcepipeline#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "result": {
        "id": 2***,
        "name": "pipeline1",
        "description": "pipeline 1",
        "tasks": [
            {
                "id": 6***,
                "name": "task-build",
                "type": "SourceBuild",
                "linkedTasks": [],
                "config": {
                    "projectId": 20***,
                    "target": {
                        "type": "SourceCommit",
                        "name": "build1",
                        "info": {
                            "repository": "rep1",
                            "branch": "master"
                        }
                    }
                }
            },
            {
                "id": 6***,
                "name": "task-deploy",
                "type": "SourceDeploy",
                "linkedTasks": [
                    "task-build"
                ],
                "config": {
                    "projectId": 2***,
                    "stageId": 3***,
                    "scenarioId": 2***,
                    "target": {
                        "type": "SourceBuild",
                        "info": {
                            "projectName": "build1"
                        }
                    }
                }
            }
        ],
        "trigger": {
            "repository": [
                {
                    "type": "sourcecommit",
                    "name": "rep1",
                    "branch": "master"
                }
            ],
            "schedule": [],
            "sourcepipeline": []
        }
    }
}
```