ApplySecurityGroupsToLoadBalancer

Description

Associates one or more security groups with a load balancer.

The specified security groups override the previously associated security groups.

Request parameters

Refer to "Common Parameters" for details on standard parameter information used by all actions.

• LoadBalancerName

  Name of the load balancer.

  The name must be unique among the load balancers in the projects to which the account belongs.

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

  List of security group IDs to associate with the load balancer.

  It is necessary to specify security group IDs not as a security group name, but as an ID.

  • Type: String list
  • Required: Yes

Response

The following status code is returned.

• Normal response code

  This operation was accepted normally.

  • HTTP Status Code: 200

Response Elements

The following element is returned in a structure called the ApplySecurityGroupsToLoadBalancerResult.

• SecurityGroups

  List of security ID groups associated with the load balancer.

  • Type: String list

Errors

Refer to "Common Errors" for details on error information common to all operations.

• AccessPointNotFound

  The specified load balancer could not be found.

  • HTTP Status Code: 400
• InvalidSecurityGroup

  One or more of the specified security groups do not exist.

  • HTTP Status Code: 400

Examples

Sample Request

The example below applies the security groups MySecurityGroup-XXXXX and MySecurityGroup-YYYYY security groups to the load balancer with the name MyLB01.

https://loadbalancing.(regionName).cloud.global.fujitsu.com/?SecurityGroups.member.1=MySecurityGroup-XXXXX
&SecurityGroups.member.2=MySecurityGroup-YYYYY
&LoadBalancerName=MyLB01
&Version=2014-11-01
&Action=ApplySecurityGroupsToLoadBalancer       
     

Sample Response (XML)

<ApplySecurityGroupsToLoadBalancerResponse xmlns=" http://docs.cloudcommunity.global.fujitsu.com/loadbalancing/api/v1.0">
  <ApplySecurityGroupsToLoadBalancerResult>
    <SecurityGroups>
      <member>MySecurityGroup-XXXXX</member>
      <member>MySecurityGroup-YYYYY</member>
    </SecurityGroups>
  </ApplySecurityGroupsToLoadBalancerResult>
  <ResponseMetadata>
    <RequestId>06b5decc-102a-11e3-9ad6-bf3e4EXAMPLE</RequestId>
  </ResponseMetadata>
</ApplySecurityGroupsToLoadBalancerResponse>       
     

Sample Response (JSON)

{
	"ApplySecurityGroupsToLoadBalancerResponse": {
		"ApplySecurityGroupsToLoadBalancerResult": {
			"SecurityGroups": {
				"member": [
					"MySecurityGroup-XXXXX",
					"MySecurityGroup-YYYYY"
				]
			}
		},
		"ResponseMetadata": {
			"RequestId": "06b5decc-102a-11e3-9ad6-bf3e4EXAMPLE"
		}
	}
}