Service Status

The Object Storage Unit (OSU) service is now END OF SALE. For more information, see End-of-Life Policy.

You can get information about the permissions you set for a bucket using the Access Control List (ACL). For more information, see Access Control List (ACL) Reference.

This action also returns information about the permissions for the buckets you created or for the buckets you have the appropriate permissions for.

  • To get information about the ACL of your bucket, use the get-bucket-acl command following this syntax:

    Request Sample
    $ aws s3api get-bucket-acl \ 
        --profile YOUR_PROFILE \
        --bucket BUCKET \
        --endpoint ENDPOINT

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

    • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.
    • bucket: The name of the bucket.
    • endpoint: The endpoint corresponding to the service (oos or osuand Region you want to send the request to, in the following format: https://<SERVICE>.<REGION>.outscale.com


The get-bucket-acl command returns the following elements:

    • Owner: Information about the owner of the bucket. This element contains the following information:
      • DisplayName: The first and last name of the owner of the bucket.
      • ID: The S3 user ID of the owner of the bucket if oos was specified as the endpoint, or their OUTSCALE account ID if osu was specified as the endpoint.
    • Grants: Information about the permissions. This element contains the following information:
      • Grantee: Information about the user granted permissions. This element contains the following information:
        • Type: The scope of the permission. If the permission is for an individual user, CanonicalUser. If the permission is for a group of users, Group. For more information, see Access Control List (ACL) Reference.
        • DisplayName: The first and last name of the grantee.
        • ID: The S3 user ID of the grantee if oos was specified as the endpoint, or their OUTSCALE account ID if osu was specified as the endpoint.
        • URI: The grantee group (AllUsers | AuthenticatedUsers).
      • Permission: The granted permission (READ | WRITE | READ_ACP | WRITE_ACP | FULL_CONTROL).

      Result Sample
      {
          "Owner": {
              "DisplayName": "ACCOUNT",
              "ID": "USER_ID"
          },
          "Grants": [
              {
                  "Grantee": {
                      "Type": "Group",
                      "URI": "http://acs.amazonaws.com/groups/global/AllUsers"
                  },
                  "Permission": "READ"
              },
              {
                  "Grantee": {
                      "Type": "CanonicalUser",
                      "DisplayName": "ACCOUNT",
                      "ID": "USER_ID"
                  },
                  "Permission": "FULL_CONTROL"
              }
          ]
      }


AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.