These operations are not presented in their comprehensive form. For more information, see the linked complete procedures.

Creating a Bucket

• To create a bucket, use the create-bucket command following this syntax:

  
  

  Code Block
  language text title Request sample
  $>$ aws s3api create-bucket \ --profile YOUR_PROFILE \ --bucket BUCKET \ --endpoint https://oos.<REGION>.outscale.com

  
  

This command contains the following attribute that you need to specify:

• bucket: The name you want to give to your bucket, according to the corresponding naming rules.
  

  Note
  As a reminder, the name of a bucket must: Be unique for the whole Region Contain between 3 and 63 characters Contain only lowercase characters, numbers and hyphens (-) Start with an alphanumeric character

  
  

The bucket is created.

Uploading an Object to a Bucket

• To upload a local object in a bucket, use the put-object command following this syntax:

  Code Block
  language text title Request Sample
  $>$ aws s3api put-object \ --profile YOUR_PROFILE \ --bucket BUCKET \ --key OBJECT \ --body usr/bin/OBJECT \ --endpoint https://oos.<REGION>.outscale.com

  
  

• bucket: The name you want to give to your bucket, according to the corresponding naming rules.
  

• key: The name you want to give to the object in the bucket.

• body: The access path to the object on your machine.

The object is uploaded to the bucket.

Configuring a Bucket ACL

• To configure the ACL of a bucket, use the put-bucket-acl command following this syntax:

  Code Block
  language text title Request Sample
  $>$ aws s3api put-bucket-acl \ --profile YOUR_PROFILE \ --bucket BUCKET \ --grant-read emailaddress=email@domain.com \ --endpoint https://oos.<REGION>.outscale.com

  
  

• bucket: The name you want to give to your bucket, according to the corresponding naming rules.
  

• grant-read emailaddress=: The email address of the Cloud account to which you grant the read permission.

The ACL is configured for the bucket.

Configuring an Object ACL

• To set the ACL for an object, use the put-object-acl command following this syntax:

  Code Block
  language text title Request Sample
  $>$ aws s3api put-object-acl \ --profile YOUR_PROFILE \ --bucket BUCKET \ --key OBJECT \ --grant-read emailaddress=email@domain.com \ --endpoint https://oos.<REGION>.outscale.com

  
  

• bucket: The name you want to give to your bucket, according to the corresponding naming rules.

• key:  The name of the object in the bucket.
  

• grant-read emailaddress=:The email address of the Cloud account to which you grant the read permission.

 The ACL is configured for the object.

Configuring a Pre-signed URL

• To configure a pre-signed URL, use the presign command following this syntax:

  Code Block
  language text title Request Sample
  $>$ aws s3 presign s3://BUCKET/OBJECT \ --profile YOUR_PROFILE \ --expires-in 3600 \ --endpoint ENDPOINT

  
  

• s3://BUCKET/OBJECT: The path to the object you want to share in the bucket.
  

• expires-in: The time left before the URL expires, in seconds.

Creating a Website

1. Copy an index.html object in your bucket and configure a public-read ACL:
   

   Code Block
   language text title Request Sample
   $>$ aws s3 cp index.html s3://BUCKET/ \ --profile YOUR_PROFILE \ --acl public-read \ --endpoint https://oos.<REGION>.outscale.com

   
   

2. Copy an error.html object in your bucket and configure a public-read ACL:
   

   Code Block
   language text title Request Sample
   $>$ aws s3 cp error.html s3://BUCKET/ \ --profile YOUR_PROFILE \ --acl public-read \ --endpoint https://oos.<REGION>.outscale.com

   
   

3. Create a website.json file with the following content:
   

   Code Block
   language text
   { "IndexDocument": { "Suffix": "index.html" }, "ErrorDocument": { "Key": "error.html" } }

   
   

4. Copy the website.json file in your bucket and configure a public-read ACL:
   

   Code Block
   language text title Request Sample
   $>$ aws s3 cp website.json s3://BUCKET/ \ --profile YOUR_PROFILE \ --acl public-read \ --endpoint https://oos.<REGION>.outscale.com

   
   

5. Create your website with the website command following this syntax:
   

   Code Block
   language text title Request Sample
   $>$ aws s3 website s3://BUCKET/ \ --profile YOUR_PROFILE \ --index-document index.html \ --error-document error.html \ --endpoint https://oos.<REGION>.outscale.com

   
   

Your website is created and accessible with the following address format: https://<BUCKET>.oos-website.<REGION>.outscale.com

s3api/OOS Compatibility

s3api Command	Operation Type	Supported by OOS
delete-bucket	Bucket
get-bucket-versioning	Bucket
get-bucket-location	Bucket
list-objects	Bucket
list-object-versions	Bucket
head-bucket	Bucket
create-bucket	Bucket
put-bucket-versioning	Bucket
get-bucket-acl	Bucket
put-bucket-acl	Bucket
list-multipart-uploads	Bucket
put-bucket-website	Bucket
get-bucket-website	Bucket
delete-bucket-website	Bucket
delete-bucket-policy	Bucket
get-bucket-replication	Bucket
get-bucket-policy	Bucket
put-bucket-policy	Bucket
delete-object	Objet
get-object	Objet
get-object-acl	Objet
put-object	Objet
copy-object	Objet
create-multipart-upload	Multipart upload
upload-part	Multipart upload
upload-part-copy	Multipart upload
complete-multipart-upload	Multipart upload
abort-multipart-upload	Multipart upload
list-parts	Multipart upload