DeleteLoadBalancer

Amazon Elastic Load Balancing: 2009-05-15

previous page next page

DeleteLoadBalancer

Description

This API deletes the specified LoadBalancer. On deletion, all of the configured properties of the LoadBalancer will be deleted. If you attempt to recreate the LoadBalancer, you need to reconfigure all the settings. The DNS name associated with a deleted LoadBalancer is no longer be usable. Once deleted, the name and associated DNS record of the LoadBalancer no longer exist and traffic sent to any of its IP addresses will no longer be delivered to your instances. You will not get the same DNS name even if you create a new LoadBalancer with same LoadBalancerName.

To successfully call this API, you must provide the same account credentials as those that were used to create the LoadBalancer.

[Note]Note

Because this API has been designed to be idempotent, even if the LoadBalancer does not exist or has been deleted, DeleteLoadBalancer still returns a success.

Request Parameters

NameDescriptionRequired

LoadBalancerName

The mnemonic name associated with the LoadBalancer. The name must be unique within your AWS account.

Type: String

Default: None

Constraints: Must only use alphanumeric characters (case sensitive) and dash (-). Dash cannot be first or last character. Maximum length of name is 32 characters (characters are 16-bit Unicode).

Yes

Response Elements

None.

Special Errors

Common errors for all calls are listed and described in a separate section, please see

API Error Codes.
ErrorDescriptionHTTP Status CodeSOAP Prefix

ValidationError

One or more input parameters are invalid.

400 Bad RequestClient

Examples

Sample Request

Example Request (Query) 

 https://elasticloadbalancing.amazonaws.com /
 ?LoadBalancerName=ReferanceAP1
 &Action=DeleteLoadBalancer
 &Version=2009-05-15
 &AWSAccessKeyId=XXX YOUR ACCESS KEY XXX
 &SignatureVersion=2
 &SignatureMethod=HmacSHA1
 &Timestamp=2009-10-17T05%3A47%3A28.000Z
 &Signature=%XXX YOUR SIGNATURE XXX%3D

Sample Response

Example Query Response 

<DeleteLoadBalancerResult/>

CreateLoadBalancer

previous page start next page