Getting Information About a Bucket ACL

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 https://oos.eu-west-2.outscale.com

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 Region you want to send the request to.

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 OUTSCALE account ID of the owner of the bucket.

    • ID: The S3 user ID of the owner of the bucket.

  • 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 OUTSCALE account ID of the grantee.

      • ID: The S3 user ID of the grantee.

      • URI: The grantee group (AllUsers | AuthenticatedUsers).

    • Permission: The granted permission (READ | WRITE | READ_ACP | WRITE_ACP | FULL_CONTROL).

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

Related Pages

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