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