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
Conditionis specified and siblingKeyPrefixEqualsis 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 elementConditionis specified and siblingHttpErrorCodeReturnedEqualsis 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 AWS SDKs, see the following:
