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
指定されたポリシーのうち、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"
}
}
}