ec2-upload-bundle
Description
Upload a bundled AMI to Amazon S3 storage.
Syntax
ec2-upload-bundle
-b s3_bucket
-m manifest
-a access_key_id
-s secret_key
[--acl acl
]
[--ec2cert certificate
]
[-d directory
]
[--part part
]
[--url url
]
[--location {US | EU}]
[--retry]
[--skipmanifest]
Options
Option | Description | Required |
---|---|---|
|
The name of the Amazon S3 bucket in which to store the bundle, followed by an optional '/'-delimited path prefix. If the bucket doesn't exist it will be created (if the bucket name is available). Example: | Yes |
|
The path to the manifest file. The manifest file is created during the bundling process and can be found in the directory containing the bundle. Example: | Yes |
|
Your AWS access key ID. Example: | Yes |
|
Your AWS secret access key. Example: | Yes |
|
The access control list policy of the bundled image. Valid Values: Default: Example: | No |
|
The path to the Amazon EC2 X.509 public key certificate. Default: Example: | No |
|
The directory containing the bundled AMI parts. Default: The directory containing the manifest file (see the
Example: | No |
|
Starts uploading the specified part and all subsequent parts. Example: | No |
|
The location of the destination Amazon S3 bucket. If the bucket exists and the location is specified, the tool exits with an error. if the specified location does not match the actual location. If the bucket exists and no location is specified, the tool uses the bucket's location. If the bucket does not exist and the location is specified, the tool creates the bucket in the specified location. If the bucket does not exist and location is not specified, the tool creates the bucket without a location constraint (in the US). Default: None Example: | No |
|
The S3 service URL. Default: Example: | No |
|
Automatically retries on all Amazon S3 errors, up to five times per operation. Example: | No |
|
Does not upload the manifest. Example: | No |
Output
Amazon EC2 displays status messages that indicate the stages and status of the upload process.
Example
This example uploads the bundle specified by the
bundled/fred.manifest.xml
manifest.
$
ec2-upload-bundle -b my-s3-bucket -m bundled/fred.manifest.xml -a AKIADQKE4SARGYLE -s eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==
Creating bucket... Uploading bundled image parts to the S3 bucket my-s3-bucket ... Uploaded fred.part.00 Uploaded fred.part.01 Uploaded fred.part.02 Uploaded fred.part.03 Uploaded fred.part.04 Uploaded fred.part.05 Uploaded fred.part.06 Uploaded fred.part.07 Uploaded fred.part.08 Uploaded fred.part.09 Uploaded fred.part.10 Uploaded fred.part.11 Uploaded fred.part.12 Uploaded fred.part.13 Uploaded fred.part.14 Uploading manifest ... Uploaded manifest. Bundle upload completed.