---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 프로젝트 포트폴리오 관리 API

# 프로젝트 포트폴리오 관리 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 7분

프로젝트 포트폴리오 관리 API는 비용 계획 및 프로젝트 작업을 대량 임포트할 수 있는 엔드포인트를 제공합니다.
이 API에 액세스하려면 PPM 표준 플러그인(com.snc.financial_planning_pmo)이 필요합니다. 호출 사용자에게 it_project_manager 역할이 있어야 합니다.

이 API는 `Now` 네임스페이스 내에서 제공됩니다.

## 프로젝트 포트폴리오 관리 - POST /now/ppm/insert_cost_plans {#ariaid-title2}

비용 계획 \[cost_plan\] 테이블에 비용 계획을 생성합니다.

### URL 형식

기본 URL: /api/now/ppm/insert_cost_plans

### 지원되는 요청 매개변수

{#ppm-POST-costplans__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 1. 경로 매개변수]

{#ppm-POST-costplans__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 2. 쿼리 매개변수]

{#ppm-POST-costplans__entry__10}

| 이름 | 설명 |
|-|-|
| end_fiscal_period | 필수 비용 계획에 대한 종료 회계 기간의 Sys_id입니다. 데이터 유형: 문자열 테이블: 회계 기간 \[fiscal_period\] |
| 이름 | 필수 비용 계획의 이름입니다. 데이터 유형: 문자열 |
| resource_type | 필수 자원 유형의 Sys_id입니다. 데이터 유형: 문자열 테이블: 자원 유형 정의 \[resource_type_definition\] |
| start_fiscal_period | 필수 비용 계획의 시작 회계 기간의 Sys_id입니다. 데이터 유형: 문자열 테이블: 회계 기간 \[fiscal_period\] |
| 작업 | 필수 비용 계획에 대한 프로젝트 또는 요구의 Sys_id입니다. 데이터 유형: 문자열 테이블: 프로젝트 \[pm_project\] 또는 요구 \[dmn_demand\] |
| unit_cost | 필수 비용 계획의 단가입니다. 데이터 유형: 문자열 |
[표 3. 요청 본문 매개변수(JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#ppm-POST-costplans__entry__24}{#ppm-POST-costplans__accept-JSON-only-entry-RESTAPI}{#ppm-POST-costplans__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 4. 요청 헤더]

{#ppm-POST-costplans__entry__30}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#ppm-POST-costplans__entry__34}{#ppm-POST-costplans__entry-200-status-code}{#ppm-POST-costplans__entry-401-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON)

{#ppm-POST-costplans__entry__40}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청의 상태에 대한 정보를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "status": "String" } |
| 결과.상태 | API 요청의 상태입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예제에서는 두 개의 비용 계획을 임포트합니다.

    curl "https://instance.servicenow.com/api/now/ppm/insert_cost_plans" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "[
       {
          "name": "Cost plan 1",
          "resource_type": "3d16eaf79330120064f572edb67ffb04",
          "start_fiscal_period": "ed47e5d90b3010108d9ac74363673a98",
          "end_fiscal_period": "0a47e5d90b3010108d9ac74363673afd",
          "task": "0fc9f992db601810852ca6dc13961951",
          "unit_cost": 1200
       },
       {
          "name": "Cost plan 2",
          "resource_type": "3d16eaf79330120064f572edb67ffb04",
          "start_fiscal_period": "ed47e5d90b3010108d9ac74363673a98",
          "end_fiscal_period": "7947e5d90b3010108d9ac74363673ac9",
          "task": "0fc9f992db601810852ca6dc13961951",
          "unit_cost": 3600
       }
    ]" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "status": "success"
       }
    }

## 프로젝트 포트폴리오 관리 - 게시 /now/ppm/insert_project_tasks {#ariaid-title3}

프로젝트 및 관련 프로젝트 작업을 생성합니다.
프로젝트는 프로젝트 \[pm_project\] 테이블에 생성되고 프로젝트 작업은 프로젝트 작업 \[pm_project_task\] 테이블에 생성됩니다.

### URL 형식

기본 URL: /api/now/ppm/insert_project_tasks

### 지원되는 요청 매개변수

{#ppm-POST-projecttasks__table_m1f_w5s_bwb__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 7. 경로 매개변수]

{#ppm-POST-projecttasks__table_m1f_w5s_bwb} {#ppm-POST-projecttasks__table_nhq_w5s_bwb__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 8. 쿼리 매개변수]

{#ppm-POST-projecttasks__table_nhq_w5s_bwb} {#ppm-POST-projecttasks__table_qqf_x5s_bwb__entry__2}

| 이름 | 설명 |
|-|-|
| child_tasks | 프로젝트의 작업 배열입니다. 각 작업은 배열의 객체입니다. 데이터 유형: 배열 "child_tasks": [ { "child_tasks": [Array], "external_id": "String", "short_description": "String" } ] |
| child_tasks.child_tasks | 상위 작업의 하위 작업 배열입니다. 각 하위 작업은 배열의 객체입니다. 각 하위 작업에는 고유한 하위 작업 배열이 있을 수 있습니다. 데이터 유형: 배열 "child_tasks": [ { "child_tasks": [Array], "external_id": "String", "short_description": "String" } ] |
| child_tasks.external_id | 외부 시스템에서 작업의 고유 식별자입니다. 데이터 유형: 문자열 |
| child_tasks.short_description | 작업에 대한 간단한 설명입니다. 데이터 유형: 문자열 |
| end_date | 프로젝트의 종료 날짜입니다. 데이터 유형: 문자열 |
| external_id | 외부 시스템에서 가져온 프로젝트의 고유 식별자입니다. 데이터 유형: 문자열 |
| short_description | 프로젝트에 대한 짧은 설명입니다. 데이터 유형: 문자열 |
| start_date | 프로젝트의 시작 날짜입니다. 데이터 유형: 문자열 |
[표 9. 요청 본문 매개변수(JSON)]

{#ppm-POST-projecttasks__table_qqf_x5s_bwb}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#ppm-POST-projecttasks__table_gtc_jbt_bwb__entry__2}{#ppm-POST-projecttasks__accept-JSON-only-entry-RESTAPI}{#ppm-POST-projecttasks__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 10. 요청 헤더]

{#ppm-POST-projecttasks__table_gtc_jbt_bwb} {#ppm-POST-projecttasks__entry__34}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#ppm-POST-projecttasks__table_acm_3bt_bwb__entry__2}{#ppm-POST-projecttasks__entry-200-status-code}{#ppm-POST-projecttasks__entry-401-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
[표 12. 상태 코드]

{#ppm-POST-projecttasks__table_acm_3bt_bwb}

### 응답 본문 매개변수(JSON) {#ppm-POST-projecttasks__section_vtd_kbt_bwb}

{#ppm-POST-projecttasks__table_wtd_kbt_bwb__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청의 상태에 대한 정보를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "status": "String" } |
| 결과.상태 | API 요청의 상태입니다. 데이터 유형: 문자열 |
[ ]

{#ppm-POST-projecttasks__table_wtd_kbt_bwb}  

### cURL 요청

이 예에서는 두 개의 작업(zpq_T1 및 zpq_T2)이 있는 프로젝트를 임포트합니다. 첫 번째 작업에는 여러 하위 작업이 포함되며, 두 번째 작업에는 첫 번째 작업의 하위 작업에 대한 의존성이 있습니다.

    curl "https://instance.servicenow.com/api/now/ppm/insert_project_tasks" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       "start_date": "2022-05-18 08:00:00",
       "end_date": "2022-05-18 17:00:00",
       "short_description": "zpq_Project",
       "external_id": "0",
       "child_tasks": [
          {
             "short_description": "zpq_T1",
             "external_id": "1",
             "child_tasks": [
                {
                   "external_id": "1.1",
                   "short_description": "zpq_T11",
                   "child_tasks": [
                      {
                         "external_id": "1.1.1",
                         "short_description": "zpq_T111"
                      }
                   ]
                },
                {
                   "external_id": "1.2",
                   "short_description": "zpq_T12"
                }
             ]
          },
          {
             "short_description": "zpq_T2",
             "external_id": "2",
             "dependencies": [
                {
                   "external_id": "1.1",
                   "lag": -1,
                   "type": "fs"
                },
                {
                   "external_id": "1.2",
                   "lag": 2,
                   "type": "fs"
                }
             ]
          }
       ]
    }" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "status": "success"
       }
    }