---
title: "CreatePlannedMaintenance"
slug: "management-cloudinsight-createpm"
updated: 2026-09-17T09:10:23Z
published: 2026-09-17T09:10:23Z
canonical: "api-fin.ncloud-docs.com/management-cloudinsight-createpm"
---

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

# CreatePlannedMaintenance

## 개요

Planned Maintenance를 생성합니다.

## 요청

### API URL

```
URL: https://cw.apigw.fin-ntruss.com/cw_fea/real/cw/api/planned-maintenances
Method: POST
```

### 요청 헤더

공통 설정에 명시된 요청 헤더가 필요합니다.

```
Content-Type: application/json
x-ncp-apigw-signature-v2: {generated signature}
x-ncp-apigw-timestamp: {current timestamp}
x-ncp-iam-access-key: {your iam access key}
```

### 요청 바디

[PMCreateUpdateDto](/docs/common-apidatatype-cipmcreateupdatedto)

## 예시

### 요청 예시

cw_key가 `xxxxxxxxxxxxxxxxxx` 인 상품에서 `fs` 타입의 디멘션이 `mnt_nm: /` 인 Planned Maintenance를 생성하는 예시입니다.

```
POST /cw_fea/real/cw/api/planned-maintenances
Host: cw.apigw.fin-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: {generated signature}
x-ncp-apigw-timestamp: {current timestamp}
x-ncp-iam-access-key: {your iam access key}

Payload:
{
  "desc": "",
  "dimensions": {
        "xxxxxxxxxxxxxxxxxx": [
          {
            "instanceNo": "{instanceNo}",
            "mnt_nm": "/",
            "type": "fs"
          }
        ]
      },
  "endTime": 1721133000000,
  "startTime": 1721129400000,
  "title": "{title}"
}
```

### 응답 예시

오류 없이 정상적으로 생성되었을 경우 생성된 Planned Maintenance의 ID가 반환됩니다.

```
"1234567890123456789"
```