PUT ttl

API情報

管理権限HTTPメソッドAPI名目的
不要PUTttl標準TTL値の設定
  • 指定したゾーンの標準TTL値を設定します。

個別パラメータ

URL
フィールドタイプ必須意味
ZoneNameString

操作対象のゾーン名 (例: example.jp, 192.0.2.0/24)

TTLString

変更後の標準TTL値 (単位: 秒)

値: 300, 600, 3600, 28800, 43200

  • 上記以外の値は設定できません。
  • 操作対象のゾーン名は、GET zonesで取得した文字列を指定してください。
  • ゾーン名に"/"を指定する場合は、URLエンコードして"%2F"を指定します。同様に":"を指定する場合は、URLエンコードして"%3A"を指定します。詳しくは、Signature生成時のURLエンコード方法を参照してください。
HTTPリクエストボディ
  • なし

レスポンス

エラーコード

エラーHTTP Status CodeErrorTypeErrorMessage説明備考
パラメーターエラー200ParameterErrorThere are invalid parameters.

以下のパラメータの形式が不正

  • DoServiceCode
  • ZoneName

設定できないTTL値を指定した場合は、共通エラーコードが返ります。

リソースエラー200ResourceNotExistResource is not found.

以下のいずれかのリソースが存在しない

  • 契約情報
  • ゾーン 
 

制限

  • 契約外のゾーンに対する操作は実行できません。
  • ここで設定したTTL値は、編集中の同じTTL値を持つ、すべてのレコードに反映されます。また、レコードを追加するときに初期表示されます。

サンプル

リクエスト

PUT /r/(APIVersion)/(DoServiceCode)/(ZoneName)/ttl/(TTL).json HTTP/1.1
Host: do.api.iij.jp
Content-Type: application/json
Date: Mon, 20 Jan 2014 12:34:56 GMT
x-iijapi-Expire: (Expire)
x-iijapi-SignatureMethod: (SignatureMethod)
x-iijapi-SignatureVersion: (SignatureVersion)
Authorization: IIJAPI (AccessKeyId):(Signature)

(HTTPリクエストボディは空)

レスポンスボディ

JSON
{
	"RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx"
}