Skip to content

Commit a8458c4

Browse files
committed
[Stream] Add troubleshooting reference for Media Transformation error codes
Adds a troubleshooting reference for Media Transformation error codes.
1 parent 70e8656 commit a8458c4

File tree

3 files changed

+43
-3
lines changed

3 files changed

+43
-3
lines changed
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: Reference
3+
pcx_content_type: overview
4+
sidebar:
5+
group:
6+
hideIndex: true
7+
---
8+
9+
import { DirectoryListing } from "~/components";
10+
11+
<DirectoryListing />
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Troubleshooting
4+
sidebar:
5+
order: 8
6+
---
7+
8+
## Error responses from Media Transformations
9+
10+
When resizing fails, the response body contains an error message explaining the reason, as well as the `Cf-Resized` header containing `err=code`:
11+
12+
- 9401 — The required options are missing or are invalid. Refer to [Options](/stream/transform-videos/#options) for supported arguments.
13+
- 9402 — The video was too large or the origin server did not respond as expected. Refer to [Source video requirements](/stream/transform-videos/#source-video-requirements) for more information.
14+
- 9404 — The video does not exist on the origin server or the URL used to transform the video is wrong. Verify the video exists and check the URL.
15+
- 9406 & 9419 — The video URL is a non-HTTPS URL or the URL has spaces or unescaped Unicode. Check your URL and try again.
16+
- 9407 — A lookup error occurred with the origin server's domain name. Check your DNS settings and try again.
17+
- 9408 — The origin server returned an HTTP 4xx status code and may be denying access to the video. Confirm your video settings and try again.
18+
- 9412 — The origin server returned a non-video, for example, an HTML page. This usually happens when an invalid URL is specified or server-side software has printed an error or presented a login page.
19+
- 9504 — The origin server could not be contacted because the origin server may be down or overloaded. Try again later.
20+
- 9509 — The origin server returned an HTTP 5xx status code. This is most likely a problem with the origin server-side software, not the transformation.
21+
- 9517 & 9523 — Internal errors. Please contact support if you encounter these errors.
22+
23+
---
24+
25+
## Limits
26+
27+
- Maximum input file size is 100 MB. Maximum duration of input video is 10 minutes.
28+
- Media Transformations is not compatible with [Bring Your Own IP (BYOIP)](/byoip/).
29+
- Input video should be an MP4 with H.264 encoded video and AAC or MP3 encoded audio. Other formats may work but are untested.

src/content/docs/stream/transform-videos/index.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -126,9 +126,9 @@ Specifies the filename to use in the returned Content-Disposition header. If not
126126

127127
## Source video requirements
128128

129-
Input video must be less than 100MB.
130-
131-
Input video should be an MP4 with H.264 encoded video and AAC or MP3 encoded audio. Other formats may work but are untested.
129+
- Input video must be less than 100MB.
130+
- Input video should be an MP4 with H.264 encoded video and AAC or MP3 encoded audio. Other formats may work but are untested.
131+
- Origin must support either HTTP HEAD and range requests, and must return a Content-Range header.
132132

133133
## Limitations
134134

0 commit comments

Comments
 (0)