Condition
A container for describing a condition that must be met for the specified redirect to
apply. For example, 1. If request is for pages in the /docs
folder, redirect
to the /documents
folder. 2. If request results in HTTP error 4xx, redirect
request to another host where you might process the error.
Contents
- HttpErrorCodeReturnedEquals
-
The HTTP error code when the redirect is applied. In the event of an error, if the error code equals this value, then the specified redirect is applied. Required when parent element
Condition
is specified and siblingKeyPrefixEquals
is not specified. If both are specified, then both must be true for the redirect to be applied.Type: String
Required: No
- KeyPrefixEquals
-
The object key name prefix when the redirect is applied. For example, to redirect requests for
ExamplePage.html
, the key prefix will beExamplePage.html
. To redirect request for all pages with the prefixdocs/
, the key prefix will be/docs
, which identifies all objects in thedocs/
folder. Required when the parent elementCondition
is specified and siblingHttpErrorCodeReturnedEquals
is not specified. If both conditions are specified, both must be true for the redirect to be applied.Important
Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see XML related object key constraints.
Type: String
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: