CreateLBCookieStickinessPolicy
Description
セッション維持のポリシーを作成します。
このポリシーはHTTP/HTTPSのリスナーの場合に利用できます。
このポリシーはSetLoadBalancerPoliciesOfListenerにより適用するリスナーを設定する必要があります。
このポリシーが指定された場合、ロードバランサーは分散先インスタンスを識別するCookie情報をレスポンスパケットに指定します。
ロードバランサーはクライアントからのリクエストにこのCookie情報が指定されていた場合、指定されたインスタンスへの振り分けを行います。
なお、インスタンスを識別するCookie情報には、ポリシーで指定されたセッションを維持する期間に関する情報を付加します。
Request Parameters
すべての動作で使用する一般的なパラメタの情報に関しては、「Common Parameters」を参照してください。
- CookieExpirationPeriod
Cookieによりセッションを維持する最大時間。
時間は秒単位に1から2147483647の範囲で指定します。
本パラメタを省略した場合は、有効期間が設定されません。
- Type: Long
- Default: なし
- Required: No
注意:本パラメタは最終アクセスからの経過時間となります。本パラメタの設定値でタイムアウトさせるためには、以下の設定が必要となります。- ロードバランサーの定義でCookieの設定が有効になっていること。
- CookieMax-Age属性に対応しているブラウザ(IE9以降またはChrome,firefox等)でアクセスしており、且つブラウザでCookieが有効であること。
- LoadBalancerName
ポリシーを利用するロードバランサーの名前。
- Type: String
- Required: Yes
- PolicyName
作成するポリシーの名前。
名前は対象のロードバランサーで利用できるポリシーの中で一意にする必要があります。
- Type: String
- Required: Yes
Response
以下のステータスコードを返却します。
- Normal response code
本動作は正常に受け付けられました。
- HTTP Status Code: 200
Response Elements
なし。
Errors
すべての動作に共通のエラー情報に関しては、「Common Errors」を参照してください。
- AccessPointNotFound
指定したロードバランサーが見つかりませんでした。
- HTTP Status Code: 400
- DuplicatePolicyName
指定したロードバランサーには、同じ名前のポリシーが存在します。他の名前を選択してください。
- HTTP Status Code: 400
- TooManyPolicies
指定したロードバランサーのポリシー数が上限値にすでに達しています。
- HTTP Status Code: 400
Examples
Sample Request
この例では、ロードバランサー名がMyLB01のロードバランサーに対して、ポリシー名がMyLoadBalancerCookiePolicyのポリシーをセッション維持時間を60秒で作成します。
https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/?CookieExpirationPeriod=60
&LoadBalancerName=MyLB01&PolicyName=MyLoadBalancerCookiePolicy
&Version=2014-11-01
&Action=CreateLBCookieStickinessPolicy
Sample Response (XML)
<CreateLBCookieStickinessPolicyResponse xmlns=" http://docs.cloudcommunity.global.fujitsu.com/loadbalancing/api/v1.0">
<CreateLBCookieStickinessPolicyResult/>
<ResponseMetadata>
<RequestId>99a693e9-12b8-11e3-9ad6-bf3e4EXAMPLE</RequestId>
</ResponseMetadata>
</CreateLBCookieStickinessPolicyResponse>
Sample Response (JSON)
{
"CreateLBCookieStickinessPolicyResponse": {
"CreateLBCookieStickinessPolicyResult": {
},
"ResponseMetadata": {
"RequestId": "99a693e9-12b8-11e3-9ad6-bf3e4EXAMPLE"
}
}
}