PUT origin

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"
    }
}