CreateLoadBalancerPolicy

Description

ポリシーの種類に応じて、必要な属性を含むポリシーを作成します。

ポリシーはロードバランサー毎に100個まで作成できます。

Request Parameters

すべての動作で使用する一般的なパラメタの情報に関しては、「Common Parameters」を参照してください。

  • LoadBalancerName

    ポリシーを利用するロードバランサーの名前。

    • Type: String
    • Required: Yes
  • PolicyAttributes.member.N

    ポリシーに関連づけられた属性のリスト。

    作成するポリシーの種類名がSSLNegotiationPolicyTypeの場合は省略できません。

  • PolicyName

    作成するポリシーの名前。

    名前は対象のロードバランサーで利用できるポリシーの中で一意にする必要があります。

    • Type: String
    • Required: Yes
  • PolicyTypeName

    作成するポリシーの種類名。

    • Type: String
    • Required: Yes

      以下が指定できます。

      • SSLNegotiationPolicyType

        SSL暗号プロトコルに関するポリシー。

        ProtocolがHTTPS,SSLのListenerに設定できます。

      • LBCookieStickinessPolicyType

        セッション維持に関するポリシー。

        ProtocolがHTTP,HTTPSのListenerに設定できます。

Response

以下のステータスコードを返却します。

  • Normal response code

    本動作は正常に受け付けられました。

    • HTTP Status Code: 200

Response Elements

なし。

Errors

すべての動作に共通のエラー情報に関しては、「Common Errors」を参照してください。

  • AccessPointNotFound

    指定されたロードバランサーが見つかりません。

    • HTTP Status Code: 400
  • DuplicatePolicyName

    同じ名前のポリシーが指定されたロードバランサーに存在しています。他の名前を選択してください。

    • HTTP Status Code: 400
  • InvalidConfigurationRequest

    不正な構成変更です。

    • HTTP Status Code: 409
  • PolicyTypeNotFound

    指定されたポリシータイプのうち、存在しないものが1つ以上あります。

    • HTTP Status Code: 400
  • TooManyPolicies

    指定されたロードバランサーのポリシー数は上限値に達しています。

    • HTTP Status Code: 400
  • PolicyNotFound

    指定されたポリシーのうち、1つ以上のポリシーが見つかりません。

    • HTTP Status Code: 400

Examples

Sample Request(その1)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MySSLNegotiationPolicy かつ、有効な暗号プロトコルを指定したポリシーを作成します。


       https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
       ?LoadBalancerName=MyLB01
       &PolicyAttributes.member.1.AttributeName=Protocol-SSLv3
       &PolicyAttributes.member.1.AttributeValue=true
       &PolicyAttributes.member.2.AttributeName=Protocol-TLSv1
       &PolicyAttributes.member.2.AttributeValue=true
       &PolicyAttributes.member.3.AttributeName=Protocol-TLSv1.1
       &PolicyAttributes.member.3.AttributeValue=true
       &PolicyAttributes.member.4.AttributeName=Protocol-TLSv1.2
       &PolicyAttributes.member.4.AttributeValue=true
       &PolicyName=MySSLNegotiationPolicy
       &PolicyTypeName=SSLNegotiationPolicyType
       &Version=2014-11-01
       &Action=CreateLoadBalancerPolicy
     

Sample Request(その2)

この例では、ロードバランサー名が MyLB01のロードバランサーに対して、ポリシー名が MySSLNegotiationPolicy かつ、有効な暗号プロトコル&暗号スイートが事前定義セキュリティポリシー(LBServiceSecurityPolicy-2017-05)と同じポリシーを参照作成します。


       https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
       ?LoadBalancerName=MyLB01
       &PolicyAttributes.member.1.AttributeName=Reference-Security-Policy
       &PolicyAttributes.member.1.AttributeValue=LBServiceSecurityPolicy-2017-05
       &PolicyName=MySSLNegotiationPolicy
       &PolicyTypeName=SSLNegotiationPolicyType
       &Version=2014-11-01
       &Action=CreateLoadBalancerPolicy
     

Sample Request(その3)

この例では、ロードバランサー名が MyLB01のロードバランサーに対して、ポリシー名が MySSLNegotiationPolicy かつ、有効な暗号プロトコル&暗号スイートを指定したポリシーを作成します。


       https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
       ?LoadBalancerName=MyLB01
       &PolicyAttributes.member.1.AttributeName=Protocol-TLSv1.2
       &PolicyAttributes.member.1.AttributeValue=true
       &PolicyAttributes.member.2.AttributeName=ECDHE-RSA-AES256-GCM-SHA384
       &PolicyAttributes.member.2.AttributeValue=true
       &PolicyAttributes.member.3.AttributeName=ECDHE-ECDSA-AES256-GCM-SHA384
       &PolicyAttributes.member.3.AttributeValue=true
       &PolicyAttributes.member.4.AttributeName=DHE-RSA-AES256-GCM-SHA384
       &PolicyAttributes.member.4.AttributeValue=true
       &PolicyAttributes.member.5.AttributeName=ECDHE-RSA-AES128-GCM-SHA256
       &PolicyAttributes.member.5.AttributeValue=true
       &PolicyAttributes.member.6.AttributeName=ECDHE-ECDSA-AES128-GCM-SHA256
       &PolicyAttributes.member.6.AttributeValue=true
       &PolicyAttributes.member.7.AttributeName=DHE-RSA-AES128-GCM-SHA256
       &PolicyAttributes.member.7.AttributeValue=true
       &PolicyName=MySSLNegotiationPolicy
       &PolicyTypeName=SSLNegotiationPolicyType
       &Version=2014-11-01
       &Action=CreateLoadBalancerPolicy
     

Sample Request(その4)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、 セッション維持時間を指定しないポリシーを作成します。

CreateLBCookieStickinessPolicy でCookieExpirationPeriodを省略した場合と同じです)


       https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
       ?LoadBalancerName=MyLB01
       &PolicyTypeName=LBCookieStickinessPolicyType
       &PolicyName=MyLBCookiePolicy
       &Version=2014-11-01
       &Action=CreateLoadBalancerPolicy  
      

Sample Request(その5)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、 セッション維持時間を指定したポリシーを作成します。

CreateLBCookieStickinessPolicyでCookieExpirationPeriodを指定した場合と同じです)


        https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
        ?LoadBalancerName=MyLB01
        &PolicyAttributes.member.1.AttributeName=CookieExpirationPeriod
        &PolicyAttributes.member.1.AttributeValue=60
        &PolicyName=MyLBCookiePolicy
        &PolicyTypeName=LBCookieStickinessPolicyType
        &Version=2014-11-01
        &Action=CreateLoadBalancerPolicy
      

Sample Request(その6)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、 Path属性を指定したポリシーを作成します。


         https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
         ?LoadBalancerName=MyLB01
         &PolicyAttributes.member.1.AttributeName=CookiePathSetting
         &PolicyAttributes.member.1.AttributeValue=/
         &PolicyName=MyLBCookiePolicy
         &PolicyTypeName=LBCookieStickinessPolicyType
         &Version=2014-11-01
         &Action=CreateLoadBalancerPolicy
      

Sample Request(その7)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、Cookie名を指定したポリシーを作成します。

    
         https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
         ?LoadBalancerName=MyLB01
         &PolicyAttributes.member.1.AttributeName=CookieName
         &PolicyAttributes.member.1.AttributeValue=FRONTELB
         &PolicyName=MyLBCookiePolicy
         &PolicyTypeName=LBCookieStickinessPolicyType
         &Version=2014-11-01
         &Action=CreateLoadBalancerPolicy
      

Sample Request(その8)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、セッション維持時間&Path属性を指定したポリシーを作成します。

    
        https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
        ?LoadBalancerName=MyLB01
        &PolicyAttributes.member.1.AttributeName=CookieExpirationPeriod
        &PolicyAttributes.member.1.AttributeValue=60
        &PolicyAttributes.member.2.AttributeName=CookiePathSetting
        &PolicyAttributes.member.2.AttributeValue=/
        &PolicyName=MyLBCookiePolicy
        &PolicyTypeName=LBCookieStickinessPolicyType
        &Version=2014-11-01
        &Action=CreateLoadBalancerPolicy      
      

Sample Request(その9)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、セッション維持時間&Cookie名を指定したポリシーを作成します。

    
        https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
        ?LoadBalancerName=MyLB01
        &PolicyAttributes.member.1.AttributeName=CookieExpirationPeriod
        &PolicyAttributes.member.1.AttributeValue=60
        &PolicyAttributes.member.2.AttributeName=CookieName
        &PolicyAttributes.member.2.AttributeValue=FRONTELB
        &PolicyName=MyLBCookiePolicy
        &PolicyTypeName=LBCookieStickinessPolicyType
        &Version=2014-11-01
        &Action=CreateLoadBalancerPolicy
      

Sample Request(その10)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、Path属性&Cookie名を指定したポリシーを作成します。

    
        https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
        ?LoadBalancerName=MyLB01
        &PolicyAttributes.member.1.AttributeName=CookiePathSetting
        &PolicyAttributes.member.1.AttributeValue=/
        &PolicyAttributes.member.2.AttributeName=CookieName
        &PolicyAttributes.member.2.AttributeValue=FRONTELB
        &PolicyName=MyLBCookiePolicy
        &PolicyTypeName=LBCookieStickinessPolicyType
        &Version=2014-11-01
        &Action=CreateLoadBalancerPolicy
      

Sample Request(その11)

この例では、ロードバランサー名が MyLB01 のロードバランサーに対して、ポリシー名が MyLBCookiePolicy かつ、セッション維持時間&Path属性&Cookie名を指定したポリシーを作成します。

    
        https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/
        ?LoadBalancerName=MyLB01
        &PolicyAttributes.member.1.AttributeName=CookieExpirationPeriod
        &PolicyAttributes.member.1.AttributeValue=60
        &PolicyAttributes.member.2.AttributeName=CookiePathSetting
        &PolicyAttributes.member.2.AttributeValue=/
        &PolicyAttributes.member.3.AttributeName=CookieName
        &PolicyAttributes.member.3.AttributeValue=FRONTELB
        &PolicyName=MyLBCookiePolicy
        &PolicyTypeName=LBCookieStickinessPolicyType
        &Version=2014-11-01
        &Action=CreateLoadBalancerPolicy
      

Sample Response (XML)


       <CreateLoadBalancerPolicyResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/loadbalancing/api/v1.0">
       <CreateLoadBalancerPolicyResult/>
       <ResponseMetadata>
         <RequestId>99a693e9-12b8-11e3-9ad6-bf3e4EXAMPLE</RequestId>
       </ResponseMetadata>
       </CreateLoadBalancerPolicyResponse>
       

Sample Response (JSON)


       {
        "CreateLoadBalancerPolicyResponse": {
         "CreateLoadBalancerPolicyResult": {
         },
         "ResponseMetadata": {
          "RequestId": "99a693e9-12b8-11e3-9ad6-bf3e4EXAMPLE"
         }
        }
       }