updateTemplateLocationOrName

Prev Next

Classic/VPC環境で利用できます。

ユーザーが作成したメールテンプレートの位置と名前を変更します。

リクエスト

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

メソッド URI
PUT /template/{templateSid}/name-location

リクエストヘッダ

Cloud Outbound Mailer APIで共通して使用されるヘッダの詳細は、Cloud Outbound Mailerのリクエストヘッダをご参照ください。

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

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
templateSid Integer Required 変更対象テンプレートの SID

リクエストボディ

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

フィールド タイプ 必須の有無 説明
templateName String Required 変更対象のテンプレートの名前
  • 0~100文字
parentSid Integer Optional 親カテゴリの SID
lowerSid Integer Optional 下位に配置するテンプレートまたはカテゴリの SID
  • 位置調整目的で使用
  • 存在しない場合、無視

リクエスト例

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

curl --location --request PUT 'https://mail.apigw.ntruss.com/api/v1/template/259/name-location' 
--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 '{
  "templateName": "AD Template",
  "parentSid": 252,
  "lowerSid": 255
}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
sid Integer Required 変更したテンプレートの SID
createDate NesDateTime Required 作成日時
name String Required 変更したテンプレートの名前
description String Optional 変更したテンプレートの説明
title String Required メールの件名
senderAddress String Required 送信者のメールアドレス
senderName String Optional 送信者名
body String Required メールの本文
isUse Boolean Required テンプレートの使用有無
category Category Optional 親カテゴリの情報

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

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード 説明
200 - リクエスト成功
400 - 認証失敗、無効なリクエスト
400 77101 ログイン情報エラー
400 77102 リクエストエラー
400 77103 リクエストしたリソースが存在しない
403 77201 リクエストしたリソースに対する権限がない
403 77202 メールサービスの使用を申し込んでいないユーザーが呼び出した場合
405 77001 サポートしないメソッドタイプ
415 77002 サポートしないメディアタイプ
500 - サーバエラー
500 77301 基本プロジェクトが存在しない
500 77302 外部システム API連携エラー
500 77303 その他の内部サーバエラー

レスポンス例

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

{
  "sid": 259,
  "createDate": {
    "utc": 1589349277158,
    "formattedDate": "2020-05-13",
    "formattedDateTime": "2020-05-13 14:54:37 158"
  },
  "name": "AD Template",
  "description": null,
  "title": "[EN] Naver Cloud Platform",
  "senderAddress": "admin@master.com",
  "senderName": "Admin",
  "body": "Congratulations on your membership.",
  "isUse": true,
  "category": {
    "sid": 252,
    "parentSid": -1,
    "name": "testCategory"
  }
}