Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Devices
Build
Test
Publish
Connect
Documentation
Skip to main content
After you’ve verified that your catalog file is valid and set up your AWS account, you’re ready to upload your catalog file to the S3 bucket that Amazon set up for your catalog. You can upload your catalog using the AWS command line interface.

Upload Your Catalog File

You upload your catalog files to a catalogs folder inside the S3 bucket that was set up for you. Use any S3 tool to upload your catalog file to this bucket and folder. (If you haven’t yet set up your AWS account, see Step 3: Set Up Your AWS Account for Catalog Ingestion first.) To upload a catalog file to an S3 bucket:
  1. Type the following command, substituting your catalog file name for <catalog_file_name.xml> and S3 bucket name for <s3_bucket_name>. Note that the --acl bucket-owner-full-control option is required so that Amazon will be able to read the file that you upload upload, and thus ingest your catalog.
    This command successfully uploads files up to 2GB in size. If successful, the AWS CLI will display a set of tags for the VersionID, ETag, and Expiration for the file.
  2. Verify that you see your catalog file in your S3 bucket. Type the following command to list all files in your S3 bucket:
    (Replace <s3_bucket_name> with your bucket name.) You can upload multiple catalogs to the catalog bucket. However, Amazon uses only the most recently uploaded catalog, regardless of its name. If you find a problem with your catalog, or need to update the data in the catalog file, just upload a new file.

Example Workflow

The following example command uploads a catalog file named my-catalog.xml to an S3 bucket named cdf-bucket:
This command returns the following sample output:
To verify that the my-catalog.xml file was successfully uploaded, use the following command:
This command returns a list of all catalog files currently found in the bucket:

Automating the Validation and Upload Process

You can usually write a script that will automate the validation and upload process. Amazon strongly recommends validating your catalog file before attempting to upload. If you create a script, please include a validation step as part of your upload process.

Additional Resources for AWS

These links provide further information on AWS and Amazon S3.

Catalog Uploading FAQ

Troubleshooting

The following are common errors when uploading catalog files. “AccessDenied” response when when calling the PutObject operation. Check two things: “InvalidAccessKeyId” response when calling the PutObject operation. The AWS Access Key Id is no longer be valid. Check your IAM user for new access keys. Review the section Grant IAM Users Access to Your Amazon S3 Bucket (this section appears in Step D in Step 3: Set Up Your AWS Account for Catalog Ingestion).

Next Steps

Now that you’ve uploaded your catalog file, go to the next step: Step 5: Verify Your Uploaded Catalog File.
Last modified on May 27, 2026