- What's New
- Function Overview
- Service Overview
- Getting Started
-
User Guide
- Overview
- Permissions Management
- Basics of Docker
-
Image Management
- Pushing an Image Through a Container Engine Client
- Obtaining a Long-Term Valid Docker Login Command
- Obtaining a Long-Term Valid containerd Pull/Push Command
- Uploading an Image Through the SWR Console
- Pulling an Image
- Setting Image Attributes
- Sharing Private Images
- Adding a Trigger
- Adding an Image Retention Policy
- Image Center
- Organization Management
- User Permissions
- Auditing
- Best Practices
-
API Reference
- Before You Start
- API Overview
- Calling APIs
-
API
- Organization Management
- Image Repository Management
- Image Tag Management
- Shared Account Management
- API Versions
- Organization Permission Management
- Image Permission Management
- Automatic Image Synchronization Task Management
- Trigger Management
- Image Retention Policy Management
- Temporary Login Command
- Quota Management
- Example Applications
- Appendixes
- Change History
- FAQs
- Videos
- SDK Reference
Why Does an Image Fail to Be Uploaded Through SWR Console?
SWR has strict requirements on image name and address format. Invalid image names or addresses could lead to upload failures.
Invalid Image Format
Problem: When you upload an image to SWR through the SWR console, an error message is displayed, indicating that the image format is invalid.
Possible cause: Invalid image address leads to upload failure.
The image tag, which is at the end of an image address, can be omitted. When it is omitted, the latest version of the image will be pushed. Other parts of the image address cannot be omitted. Ensure that they are all correctly configured.
Example: registry.example.com/repo_namespace/repo_name:tag
- registry.example.com is an example address of the SWR image repository. Replace it with the actual address.
- repo_namespace: organization name. It contains a maximum of 64 characters and must meet regular expression ^([a-z]+(?:(?:(?:_|__|[-]*)[a-z0-9]+)+)?)$.
- repo_name:tag: image name and tag. The image name contains a maximum of 128 characters and must meet regular expression ^([a-z0-9]+(?:(?:(?:_|__|[-]*)[a-z0-9]+)+)?)$.
To view the image address, decompress the image. Open the manifest.json file, and check the value of RepoTags.

Solution: Tag the image again according to the naming rules. Run the docker save command, and upload the image on the SWR console.
Stuck at the Upload Page Until It Times Out
Problem: When you upload an image to SWR through the SWR console, the upload progress is stuck and the upload task times out at the end.
Possible cause: Invalid image name leads to upload failures.
Solution: Modify the image name according to the naming rules, and try uploading the image again.
It is the image name in the repositories and manifest.json files that should be checked and modified rather than the name of the image file you select and upload on the SWR console.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.