CreateLoadBalancerPolicy

Description

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

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

Request Parameters

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

• LoadBalancerName

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

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

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

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

  • Type: PolicyAttributelist
  • Required: No
• 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

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

  • HTTP Status Code: 400

Examples

Sample Request（その１）

この例では、ロードバランサー名が 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（その２）

この例では、ロードバランサー名が 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（その３）

この例では、ロードバランサー名が 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（その４）

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

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

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

Sample Request（その５）

この例では、ロードバランサー名が 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（その６）

この例では、ロードバランサー名が 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（その７）

この例では、ロードバランサー名が 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（その８）

この例では、ロードバランサー名が 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（その９）

この例では、ロードバランサー名が 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（その１０）

この例では、ロードバランサー名が 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（その１１）

この例では、ロードバランサー名が 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"
         }
        }
       }