公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

PUT origin

API情報

HTTPメソッド API名 目的
PUT origin オリジンサーバー情報変更
  • オリジンサーバーの情報を設定します。

個別パラメータ

URL
  • なし

HTTPリクエストボディ

フィールド タイプ 意味
OriginAccessType String

オリジンサーバへのアクセス方法 (ホスト名, IPアドレス)

値: host, ip
OriginIPList Array

オリジンサーバのIP アドレス

  • 最大256個
  • 一般に予約アドレスと呼ばれるIPアドレスは登録できません。
  • OriginAccessTypeが"ip"の場合に指定します。
    • 従来の設備と新設備で動作に差異があるため注意
      • 従来の設備
        • 設定されたすべてのIPアドレスを利用されます。
        • ラウンドロビンでアクセス
      • 新設備
        • 設定されたIPアドレスのうち最初の2個のみ利用されます。
        • 1つ目のIPアドレスがアクティブ、2つ目のIPアドレスがスタンバイとしてアクセス
        • 3つ目以降のIPアドレスは利用されません。
    。
OriginFqdn String

オリジンサーバのホスト名

  • OriginAccessTypeが"host"の場合に指定します。
OriginSendPublicFqdn String

OriginAccessTypeを"host"に設定した場合において、コンテンツ取得時のHostヘッダに付与される値に

  • "off"の場合、オリジンサーバのホスト名を使用します(初期値)
  • "on"の場合、契約FQDNを使用します

OriginAccessTypeが"ip"に設定された場合、このフィールドの値は無視されます。

レスポンス

フィールド タイプ 意味
Result.OriginAccessType String

オリジンサーバへのアクセス方法

値: host, ip
Result.Origin Array

オリジンサーバのFQDNまたはIP アドレス

  • FQDNの場合は、最大1個
  • IPアドレスの場合は、最大256個
  • オリジンサーバをIP アドレス指定した場合、従来の設備と新設備で動作に差異があるため注意
    • 従来の設備
      • 設定されたすべてのIPアドレスを利用されます。
      • ラウンドロビンでアクセス
    • 新設備
      • 設定されたIPアドレスのうち最初の2個のみ利用されます。
      • 1つ目のIPアドレスがアクティブ、2つ目のIPアドレスがスタンバイとしてアクセス
      • 3つ目以降のIPアドレスは利用されません。
Result.OriginSendPublicFqdn String

オリジンサーバへのコンテンツ取得時のHostヘッダの設定値

  • 指定されたサーバホスト名を使用する場合は"off"
  • 契約FQDNを使用する場合は"on"

OriginAccessTypeが"ip"に設定されている場合、このフィールドの値は常に"on"です。
Result.NextOriginAccessType String

占有型契約時、オリジンサーバ情報変更を行った場合の変更予定の値

オリジンサーバへのアクセス方法(ホスト名, IPアドレス)

値: host, ip
Result.NextOrigin Array

占有型契約時、オリジンサーバ情報変更を行った場合の変更予定の値

オリジンサーバのFQDNまたはIP アドレス

  • FQDNの場合は、最大1個
  • IPアドレスの場合は、最大256個
  • オリジンサーバをIP アドレス指定した場合、従来の設備と新設備で動作に差異があるため注意
    • 従来の設備
      • 設定されたすべてのIPアドレスを利用されます。
      • ラウンドロビンでアクセス
    • 新設備
      • 設定されたIPアドレスのうち最初の2個のみ利用されます。
      • 1つ目のIPアドレスがアクティブ、2つ目のIPアドレスがスタンバイとしてアクセス
      • 3つ目以降のIPアドレスは利用されません。
Result.NextOriginSendPublicFqdn String

占有型契約時、オリジンサーバへのコンテンツ取得時のHostヘッダの設定値が変更された後の変更予定の値

  • 指定されたサーバホスト名を使用する場合は"off"
  • 契約FQDNを使用する場合は"on"

エラーコード

  • このAPIに関する個別エラーはありません。
  • 共通エラーコードはエラーレスポンスを参照してください。

制限

  • 予約アドレスや本設備内で利用されているアドレスは登録できません。

サンプル 

リクエスト

PUT /r/(APIVersion)/(ServiceCode)/origin.json
Host: cac.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)

{
    "OriginAccessType": "host",
    "OriginFqdn": "www.example.co.jp",
    "OriginSendPublicFqdn": "off"
}

レスポンスボディ

{
 
    "Result": {
 
        "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
 
        "ServiceCode": "cac########",
 
        "OriginAccessType": "host",
 
        "Origin": ["www.example.co.jp"],
 
        "OriginSendPublicFqdn": "off",
 
        "NextOriginAccessType": "host",
 
        "NextOrigin": ["www.example.co.jp"],
 
        "NextOriginSendPublicFqdn": "off"
 
    }
 
}