CreateSorryServerRedirectionPolicy

Description

Creates a policy for redirecting to the sorry server when unable to distribute the client request because there are no distribution destination instances in active state.

This policy can be associated only with HTTP/HTTPS listeners.

For this policy, it is necessary to configure the listener that will be applied by SetLoadBalancerPoliciesOfListener.

When this policy is specified, the specified location information is set in the response packet when the load balancer is unable to assign requests to distribution destination instances.

Request parameters

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

  • Location

    URI of the redirection destination location.

    • Type: String
    • Required: Yes
  • LoadBalancerName

    Name of the load balancer that will use the policies.

    • Type: String
    • Required: Yes
  • PolicyName

    Name of the policy to be created.

    The name must be unique among the policies that can be used by the target load balancer.

    • Type: String
    • Required: Yes

Response

The following status code is returned.

  • Normal response code

    This operation was accepted normally.

    • HTTP Status Code: 200

Response Elements

None.

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
  • DuplicatePolicyName

    Policy with the same name exists for this load balancer. Please choose another name.

    • HTTP Status Code: 400

Examples

Sample Request

The example below creates a policy named MyPolicy at the redirection destination location http://XXXXXXXX/ for the load balancer named MyLB01.


       https://loadbalancing.(regionName).cloud.global.fujitsu.com/?Location=http://XXXXXXXX/
       &LoadBalancerName=MyLB01&PolicyName=MyPolicy
       &Version=2014-11-01
       &Action=CreateSorryServerRedirectionPolicy
       

Sample Response (XML)


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

Sample Response (JSON)


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