Skip to content

Commit 0139666

Browse files
angelampcostaangelampcosta
authored
[Support] Improvements to the 10xxx page (#20027)
* Updates to 10xxx page * Updates 10xxx page * Updates to 10xxx page
1 parent 724f6f9 commit 0139666

File tree

1 file changed

+108
-93
lines changed

1 file changed

+108
-93
lines changed

‎src/content/docs/support/troubleshooting/cloudflare-errors/troubleshooting-cloudflare-10xxx-errors.mdx‎

Lines changed: 108 additions & 93 deletions
Original file line numberDiff line numberDiff line change
@@ -7,217 +7,232 @@ title: Troubleshooting Cloudflare 10XXX errors
77

88
## Error 10028: The add list items operation contains duplicate items
99

10-
This error occurs when there are duplicate list items in a single operation to add items to a List (either an IP list or a Bulk Redirect List).
10+
This error indicates that the operation to add items to a list contains duplicate entries within the same request.
1111

12-
This error can happen when you:
12+
### Common causes
1313

14-
* Add a repeated IP address to an IP list
15-
* Add a repeated source URL to a Bulk Redirect List
14+
This error occurs when there are duplicate list items in a single operation to add items to a List (either an IP list or a Bulk Redirect List). This error can happen when you:
1615

17-
### **Resolution**
16+
- Add a repeated IP address to an IP list
17+
- Add a repeated source URL to a Bulk Redirect List
1818

19-
Remove the duplicate item and try again.
19+
### Resolution
2020

21-
***
21+
You need to remove the duplicate item and try again.
2222

2323
## Error 10043: Source URL in redirect is too long
2424

25-
This error occurs when the source URL value of a URL redirect is too long. The maximum length of a source URL is 32,768 characters.
25+
This error indicates that the source URL in a redirect exceeds the maximum allowed length.
2626

27-
### **Resolution**
27+
### Common causes
2828

29-
Use a shorter URL as the source URL.
29+
This error occurs when the source URL value of a URL redirect is too long. The maximum length of a source URL is 32,768 characters. Possible causes of this error are:
3030

31-
***
31+
- Dynamic URLs that contain excessive query parameters or tracking codes.
32+
- Unnecessary path segments or redundant subdirectories in the URL.
33+
34+
### Resolution
35+
36+
You need to use a shorter URL as the source URL.
3237

3338
## Error 10044: Target URL in redirect is too long
3439

35-
This error occurs when the target URL value of a URL redirect is too long. The maximum length of a target URL is 32,768 characters.
40+
This error indicates that the target URL in a redirect exceeds the maximum allowed length.
41+
42+
### Common causes
3643

37-
### **Resolution**
44+
This error occurs when the target URL value of a URL redirect is too long. The maximum length of a target URL is 32,768 characters. Possible causes of this error are:
3845

39-
Use a shorter URL as the target URL.
46+
- Dynamic URLs that contain excessive query parameters or tracking codes.
47+
- Unnecessary path segments or redundant subdirectories in the URL.
4048

41-
***
49+
### Resolution
50+
51+
You need to use a shorter URL as the target URL.
4252

4353
## Error 10045: Invalid redirect source URL
4454

45-
This error occurs when you specify a source URL of a URL redirect that is not a valid URL.
55+
This error indicates that the source URL for a redirect is not valid.
4656

47-
### **Resolution**
57+
### Common causes
4858

49-
Specify a valid URL as the source URL.
59+
This error occurs when the source URL provided for a URL redirect is not valid, preventing the redirect from functioning properly due to missing components, such as the scheme (for instance, `http` or `https`) or improper formatting.
5060

51-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
61+
### Resolution
5262

53-
***
63+
You need to specify a valid URL as the source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
5464

5565
## Error 10046: Invalid redirect target URL
5666

57-
This error occurs when you specify a target URL of a URL redirect that is not a valid URL.
67+
This error indicates that the target URL provided for a URL redirect is not valid.
5868

59-
### **Resolution**
69+
### Common causes
6070

61-
Specify a valid URL as the target URL.
71+
This error occurs when the target URL provided for a URL redirect is not valid, preventing the redirect from functioning properly due to missing components, such as the scheme (for instance, `http` or `https`) or improper formatting.
6272

63-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect target URLs.
73+
### Resolution
6474

65-
***
75+
You need to specify a valid URL as the target URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect target URLs.
6676

6777
## Error 10047: Invalid redirect status code
6878

69-
This error occurs when you specify a URL redirect status code that is not supported. 
79+
This error indicates that an unsupported or incorrectly formatted status code was specified for the URL redirect.
7080

71-
### **Resolution**
81+
### Common causes
7282

73-
Use one of the supported status codes in the URL redirect: `301`, `302`, `307`, or `308`.
83+
This error occurs when you specify a URL redirect status code that is not supported, typically due to entering an invalid number or using an unsupported or deprecated status code.
84+
85+
### Resolution
7486

75-
***
87+
Use one of the supported status codes in the URL redirect: `301`, `302`, `307`, or `308`.
7688

7789
## Error 10048: Preserve path suffix requires subpath matching enabled
7890

79-
This error occurs when you enable the **Preserve path suffix** option in a redirect without enabling the **Subpath matching** option.
91+
This error indicates a configuration mismatch where the **Preserve path suffix** option is used without enabling **Subpath matching** in a URL redirect.
8092

81-
The **Preserve path suffix** option of a URL redirect is only applicable when the **Subpath matching** option is also enabled. 
93+
### Common causes
8294

83-
### **Resolution**
95+
This error occurs when you enable the **Preserve path suffix** option in a redirect without enabling the **Subpath matching** option. The **Preserve path suffix** option of a URL redirect is only applicable when the **Subpath matching** option is also enabled.
8496

85-
Enable **Subpath matching** for the URL redirect with **Preserve path suffix** enabled.
97+
### Resolution
8698

87-
***
99+
Enable **Subpath matching** for the URL redirect with **Preserve path suffix** enabled.
88100

89101
## Error 10049: Invalid scheme in redirect source URL
90102

91-
This error occurs when the source URL of a URL redirect has an invalid scheme.
103+
This error indicates that the source URL's scheme is invalid.
92104

93-
**Resolution**
105+
### Common causes
94106

95-
Review the source URL and ensure that it uses one of the supported schemes: `http`, `https`, or empty (no scheme information, which means that it applies to both schemes).
107+
This error occurs when the source URL of a URL redirect has an invalid scheme, which may be due to a misspelled or unsupported scheme or because the scheme is missing or improperly formatted.
96108

97-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
109+
### Resolution
98110

99-
***
111+
Review the source URL and ensure that it uses one of the supported schemes: `http`, `https`, or empty (no scheme information, which means that it applies to both schemes). Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
100112

101113
## Error 10050: Invalid redirect source URL with user info
102114

103-
This error occurs when the source URL of a URL redirect includes a user info component (for example, `https://user:[email protected]`), which is not supported.
115+
This error indicates that the source URL includes unsupported user information.
104116

105-
### **Resolution**
117+
### Common causes
106118

107-
Remove the user info component from the redirect source URL.
119+
This error occurs when the source URL of a URL redirect includes a user info component (for example, `https://user:[email protected]`), which is not supported.
108120

109-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
121+
### Resolution
110122

111-
***
123+
You need to remove the user information component from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
112124

113125
## Error 10051: Missing authority in redirect source URL
114126

115-
This error occurs when the source URL of a URL redirect does not include an authority component (for example, `http:///path`, without a hostname), which is mandatory.
127+
This error indicates that the source URL is missing a required authority component.
116128

117-
### **Resolution**
129+
### Common causes
118130

119-
Add an authority component to the redirect source URL (for example, include a hostname).
131+
This error occurs when the source URL of a URL redirect does not include an authority component (for example, `http:///path`, without a hostname), which is mandatory.
120132

121-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the required URL components for redirect source URLs.
133+
### Resolution
122134

123-
***
135+
Add an authority component to the redirect source URL (for example, include a hostname). Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the required URL components for redirect source URLs.
124136

125137
## Error 10052: Invalid redirect source URL with port
126138

127-
This error occurs when the source URL of a URL redirect includes a port (for example, `https://example.com:8081`), which is not supported.
139+
This error indicates that the source URL includes an unsupported port.
128140

129-
### **Resolution**
141+
### Common causes
130142

131-
Remove the port from the redirect source URL.
143+
This error occurs when the source URL of a URL redirect includes a port (for example, `https://example.com:8081`), which is not supported. Possible causes include using a custom or non-standard port, copying a URL from another environment that includes a port, or mistakenly using a development or testing URL.
132144

133-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
145+
### Resolution
134146

135-
***
147+
Remove the port from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
136148

137149
## Error 10053: Invalid redirect source URL with query string
138150

139-
This error occurs when the source URL of a URL redirect includes a query string component, which is not supported.
151+
This error indicates that the source URL contains an unsupported query string component.
140152

141-
### **Resolution**
153+
### Common causes
142154

143-
Remove the query string from the redirect source URL.
155+
This error occurs when the source URL of a URL redirect includes a query string component, which is not supported. Possible causes include copying a URL with query parameters, misconfiguration during setup, or attempting to redirect based on query parameters instead of the path.
144156

145-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
157+
### Resolution
146158

147-
***
159+
Remove the query string from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
148160

149161
## Error 10054: Invalid redirect source URL with fragment
150162

151-
This error occurs when the source URL of a URL redirect includes a fragment component (for example, `https://example.com/search/#fragment`).
152-
153-
Fragment components are not part of an HTTP request; they are an indication for the browser to scroll to a specific location once the page has loaded.
163+
This error indicates that the source URL includes an unsupported fragment component.
154164

155-
### **Resolution**
165+
### Common causes
156166

157-
Remove the fragment from the redirect source URL.
167+
This error occurs when the source URL of a URL redirect includes a fragment component (for example, `https://example.com/search/#fragment`). Fragment components are not part of an HTTP request; they are an indication for the browser to scroll to a specific location once the page has loaded. Possible causes of this error include copying a URL with a fragment from a browser or external source, or inadvertently adding a fragment during URL configuration or editing.
158168

159-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
169+
### Resolution
160170

161-
***
171+
Remove the fragment from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
162172

163173
## Error 10055: Query string settings incompatible with redirect target URL
164174

165-
This error occurs when you enable the **Preserve query string** option of a URL redirect, but also provide a query string in the redirect target URL. In this case, the URL redirect would have conflicting configuration on how to handle the query string of incoming requests.
175+
This error indicates a conflict between the **Preserve query string** option and the query string in the redirect target URL.
166176

167-
### **Resolution**
177+
### Common causes
168178

169-
Perform one of the following:
179+
This error occurs when you enable the **Preserve query string** option of a URL redirect, but also provide a query string in the redirect target URL. In this case, the URL redirect would have conflicting configuration on how to handle the query string of incoming requests.
170180

171-
* Disable the **Preserve query string** option in the URL redirect
172-
* Remove the query string component from the redirect target URL
181+
### Resolution
173182

174-
***
183+
To resolve this issue, either disable the **Preserve query string** option in the URL redirect or remove the query string component from the redirect target URL to eliminate the conflict.
175184

176185
## Error 10056: The add list items operation contains different types of list items
177186

178-
This error occurs when there are different types of list items (for example, IP addresses, hostnames, and URL redirects) in a single operation to add items to a list. The error may occur for an IP list, a hostname list, or a Bulk Redirect List.
187+
This error indicates that different types of list items were combined in a single add operation.
179188

180-
### **Resolution**
189+
### Common causes
181190

182-
Remove the list items that do not apply to the list type. This means:
191+
This error occurs when different types of list items (such as IP addresses, hostnames, and URL redirects) are included in a single operation to add items to a list. It can occur with an IP list, a hostname list, or a Bulk Redirect List.
183192

184-
* Removing IP addresses from a request to add items to a Bulk Redirect List
185-
* Removing URL redirects from a request to add items to an IP list
193+
### Resolution
186194

187-
***
195+
Remove the list items that do not apply to the list type. This means:
196+
197+
- Removing IP addresses from a request to add items to a Bulk Redirect List.
198+
- Removing URL redirects from a request to add items to an IP list.
188199

189200
## Error 10058: List items incompatible with list type
190201

202+
This error indicates that incompatible items were added to the wrong list type.
203+
204+
### Common causes
205+
191206
This error occurs when you are adding items to a list (either IP list, hostname list, or Bulk Redirect List) and the list items are incompatible with the list type.
192207

193-
### **Resolution**
208+
### Resolution
194209

195210
Make sure you are adding the items to the correct list:
196211

197-
* Custom lists with IP addresses (IP lists) can only contain IP addresses as list items
198-
* Custom lists with hostnames can only contain hostnames as list items
199-
* Bulk Redirect Lists can only contain URL redirects as list items
200-
201-
***
212+
- Custom lists with IP addresses (IP lists) can only contain IP addresses as list items.
213+
- Custom lists with hostnames can only contain hostnames as list items.
214+
- Bulk Redirect Lists can only contain URL redirects as list items.
202215

203216
## Error 10059: Maximum number of repeated URL source paths exceeded
204217

205-
This error occurs when you have more than the maximum number of URL redirects with the same source URL path across all Bulk Redirect Lists in your account, regardless of the URL redirect domain.
218+
This error indicates that the same URL path is repeated too many times across your Bulk Redirect Lists.
206219

207-
### **Resolution**
220+
### Common causes
208221

209-
Review the path of your source URLs so that you do not have more than the maximum number of URL redirects sharing the same URL path in your account, regardless of their domain or the list they belong to.
222+
This error occurs when you have more than the maximum number of URL redirects with the same source URL path across all Bulk Redirect Lists in your account, regardless of the URL redirect domain. Possible causes include multiple lists containing the same redirects, overlapping configurations, or mismanagement resulting in duplicated source URL paths.
210223

211-
Refer to [URL redirect parameters](/rules/url-forwarding/bulk-redirects/reference/parameters/) for more information on the current limits.
224+
### Resolution
212225

213-
***
226+
Review the path of your source URLs so that you do not have more than the maximum number of URL redirects sharing the same URL path in your account, regardless of their domain or the list they belong to. Refer to [URL redirect parameters](/rules/url-forwarding/bulk-redirects/reference/parameters/) for more information on the current limits.
214227

215228
## Error 10060: Missing scheme in redirect target URL
216229

217-
This error occurs when the target URL of a URL redirect does not include a scheme, which is mandatory.
230+
This error indicates that the target URL is missing a scheme.
231+
232+
### Common causes
218233

219-
### **Resolution**
234+
This error occurs when the target URL of a URL redirect does not include a scheme, which is mandatory. This could have happened due to a typo or the URL was copied from a source that did not include the scheme.
220235

221-
Review the target URL of the URL redirect and ensure that it contains a scheme (for example, `https`).
236+
### Resolution
222237

223-
Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the required URL components for redirect target URLs.
238+
Review the target URL of the URL redirect and ensure that it contains a scheme (for example, `https`). Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the required URL components for redirect target URLs.

0 commit comments

Comments
 (0)