---
title: "POST /kms/keys/{resource_id}/schedule-destruction"
method: POST
path: "/kms/keys/{resource_id}/schedule-destruction"
tags: ["kms-key"]
---

# POST /kms/keys/{resource_id}/schedule-destruction

`POST /kms/keys/{resource_id}/schedule-destruction`

## Request

- Base URL: `https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1`
- URL: `https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/kms/keys/{resource_id}/schedule-destruction`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/sakura/apis/kms-secretmanager-cloudhsm-api/docs/kms/keys/:resource_id/schedule-destruction/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `resource_id` string, required

## Request body

- WrappedScheduleDestructionKeyRequest
  - `Key` ScheduleDestructionKeyRequest, required: 鍵の削除スケジュール設定
    - `PendingDays` integer: 削除をスケジュールする日数

## Response `200`

- WrappedKeyScheduledDestruction
  - `Key` KeyScheduledDestruction, required
    - `Status` 'active' | 'restricted' | 'suspended' | 'pending_destruction' | 'destroyed', required: * `active` - 有効 * `restricted` - 制限付き * `suspended` - 一時停止 * `pending_destruction` - 削除保留 * `destroyed` - 削除済み
    - `DeletionScheduledAfter` string, date-time, nullable, required
  - `is_ok` boolean, required

---

[API](https://skmtc.dev/sakura/apis/kms-secretmanager-cloudhsm-api.md) - [All operations](https://skmtc.dev/sakura/apis/kms-secretmanager-cloudhsm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sakura/apis/kms-secretmanager-cloudhsm-api/revisions/9a535fabbdfa?raw)