---
title: "Generate Random Secret"
slug: "secretmanager-generate-random-secret"
updated: 2026-09-17T09:58:30Z
published: 2026-09-17T09:58:30Z
canonical: "api.ncloud-docs.com/secretmanager-generate-random-secret"
---

> ## 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.

# Generate Random Secret

VPC環境で利用できます。

シークレット値として使用可能なランダム文字列を作成します。ランダム文字列は、英数字、記号、スペースを含めるかどうかなどの条件を追加して作成でき、作成後は、 [Update Pending Stage](/docs/ja/secretmanager-update-pending-stage)で Pendingステージのシークレット値として指定できます。シークレットローテーション対象の値を自動的に埋めて Pendingステージとして登録する方法の詳細は、[Add Pending Stage](/secretmanager-add-pending-stage)をご参照ください。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /action/v1/secrets/{secretId}/jobs/{jobToken}/generate-random-secret |

### リクエストヘッダ

Secret Manager APIで共通して使用されるヘッダの詳細は、[Secret Managerのリクエストヘッダ](/docs/ja/secretmanager-api-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `secretId` | String | Required | シークレット ID - [Get Secret List](/docs/ja/secretmanager-getsecretlist)または[Get Secret Logs](/docs/ja/secretmanager-getsecretlogs)を参照 - トリガーを実行したアプリケーションに自動的に注入され、環境変数で確認可能 - [](https://guide.ncloud-docs.com/docs/ja/secretmanager-rotate-action#%EC%8B%9C%ED%81%AC%EB%A6%BF-%EA%B5%90%EC%B2%B4-%EC%95%A1%EC%85%98-%EC%98%88%EC%A0%9C-%EC%BD%94%EB%93%9C){target="_blank"} |
| `jobToken` | String | Required | ジョブトークン - [Get Secret Logs](/docs/ja/secretmanager-getsecretlogs)を参照 - トリガーを実行したアプリケーションに自動的に注入され、環境変数で確認可能 - [シークレットローテーションアクションのサンプルコード](https://guide.ncloud-docs.com/docs/ja/secretmanager-rotate-action#%EC%8B%9C%ED%81%AC%EB%A6%BF-%EA%B5%90%EC%B2%B4-%EC%95%A1%EC%85%98-%EC%98%88%EC%A0%9C-%EC%BD%94%EB%93%9C) |

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `length` | Integer | Required | ランダム文字列の長さ - 5~32(デフォルト: 12) |
| `excludeCharacters` | String | Optional | 除外文字 - 複数の場合は、区切り文字なしで1つの文字列で並べる |
| `excludeNumbers` | Boolean | Optional | 数字を除外するか - `true` \| `false` (デフォルト) - `true`: 除外 - `false`: 除外しない |
| `excludePunctuation` | Boolean | Optional | 記号を除外するか - `true` \| `false` (デフォルト) - `true`: 除外 - `false`: 除外しない |
| `excludeUppercase` | Boolean | Optional | 大文字を除外するか - `true` \| `false` (デフォルト) - `true`: 除外 - `false`: 除外しない |
| `excludeLowercase` | Boolean | Optional | 小文字を除外するか - `true` \| `false` (デフォルト) - `true`: 除外 - `false`: 除外しない |
| `includeSpace` | Boolean | Optional | スペースを含めるか - `true` (デフォルト) \| `false` - `true`: 含める - `false`: 含めない |
| `requireEachIncludedType` | Boolean | Optional | 除外しない文字タイプ(大文字、小文字、数字、記号、スペース)をすべてを含めるか - `true` (デフォルト) \| `false` - `true`: すべてを含める - `false`: すべて含めない |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request POST 'https://secretmanager.apigw.ntruss.com/action/v1/secrets/{secretId}/jobs/{jobToken}/generate-random-secret' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "length": 5,
    "excludeCharacters": "",
    "excludeNumbers": false,
    "excludePunctuation": false,
    "excludeUppercase": false,
    "excludeLowercase": false,
    "includeSpace": false,
    "requireEachIncludedType": true
}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `randomString` | String | - | ランダム文字列 |

### レスポンスステータスコード

Secret Manager APIで共通して使用されるレスポンスステータスコードの詳細は、[Secret Managerのレスポンスステータスコード](/docs/ja/secretmanager-api-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "randomString": "2!?xY"
}
```