---
title: "Traffic Profileの概要"
slug: "globaltrafficmanager-profile-overview"
tags: ["Global Traffic Manager"]
updated: 2026-09-17T09:58:20Z
published: 2026-09-17T09:58:20Z
canonical: "api.ncloud-docs.com/globaltrafficmanager-profile-overview"
---

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

# Traffic Profileの概要

## 概要

Global Traffic Managerが提供する Traffic Profileの作成、変更、削除機能を、規定の APIを通じて呼び出すことができる機能です。 ダッシュボードで発行した、許可された API Keyを使用すると呼び出せます。

## Global Traffic Managerの共通設定

Global Traffic Manager APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

### API URL

リクエスト API URLは次の通りです。

```
https://globaltrafficmanager.apigw.ntruss.com
```

### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1)を参照 |
| `Content-Type` | Optional | リクエストデータの形式 - `application/json` |

#### レスポンスボディ

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

**error** errorは API呼び出し失敗情報を定義します。errorの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `result` | String | - | API呼び出し結果 - `FAIL`: 呼び出しが失敗した場合、表示 |
| `error` | Object | - | エラーコードとメッセージ - `success`が`false`の場合に表示 |
| `error.errorCode` | Integer | - | エラーコード |
| `error.message` | String | - | エラーメッセージ |
| `error.devMessage` | String | - | 開発者用エラーメッセージ |
| `error.moreInfo` | Object | - | 追加のエラー情報 |
| `error.moreInfo.validationInfo` | Array | - | 有効性検査エラー情報 |
| `error.moreInfo.validationInfo.fieldPath` | String | - | 有効性検査エラーが発生したフィールドのパス |
| `error.moreInfo.validationInfo.msg` | String | - | 有効性検査エラーメッセージ |
| `error.moreInfo.timestamp` | String | - | エラー発生時刻 |

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

Global Traffic Manager APIは NAVERクラウドプラットフォームの共通レスポンスステータスコードを使用します。NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

#### レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

```
{
  "result": "FAIL",
  "error": {
    "errorCode": "05X000",
    "message": "有効でない値です。<br>表示された領域にマウスオーバーすると、ツールチップで詳細内容を確認できます。",
    "devMessage": "無効な値です。",
    "moreInfo": {
      "validationInfo": [
        {
          "fieldPath": "monitor.hostHeader",
          "msg": "protocolが HTTP/HTTPSの場合にのみ hostHeaderを入力できます。"
        }
      ],
      "timestamp": "2022-11-16T10:54:47.191+09:00"
    }
  }
}
```