
put-object-acl
**************


DESCRIPTION
===========

uses the acl subresource to set the access control list (ACL)
permissions for an object that already exists in a bucket


SYNOPSIS
========

   aws s3 put-object-acl
     --key <value>
     --bucket <value>
     [--grant-full-control <value>]
     [--grant-write-acp <value>]
     [--content-md5 <value>]
     [--acl <value>]
     [--access-control-policy <value>]
     [--grant-write <value>]
     [--grant-read <value>]
     [--grant-read-acp <value>]


REQUIRED PARAMETERS
===================

"--key"  (string)

"--bucket"  (string)


OPTIONAL PARAMETERS
===================

"--grant-full-control"  (string)Allows grantee the read, write, read
ACP, and write ACP permissions on the bucket.

"--grant-write-acp"  (string)Allows grantee to write the --acl for the
applicable bucket.

"--content-md5"  (string)

"--acl"  (string)The canned --acl to apply to the bucket.

"--access-control-policy"  (structure)
   "owner"  (structure)
      "display_name"  (string)

      "id"  (string)

   "grants"  (list)A list of grants.
      (structure)
         "grantee"  (structure)
            "email_address"  (string)Email address of the grantee.

            "type"  (string)Type of grantee

            "display_name"  (string)Screen name of the grantee.

            "id"  (string)The canonical user ID of the grantee.

            "uri"  (string)URI of the grantee group.

         "permission"  (string)Specifies the permission given to the
         grantee.

   *Parameter Syntax*

      {
        "owner": {
          {
            "display_name": "string",
            "id": "string"
          },
        "grants":
          [
            {
              "grantee": {
                {
                  "email_address": "string",
                  "type": "CanonicalUser"|"AmazonCustomerByEmail"|"Group",
                  "display_name": "string",
                  "id": "string",
                  "uri": "string"
                },
              "permission": "FULL_CONTROL"|"WRITE"|"WRITE_ACP"|"READ"|"READ_ACP"
            }
            ...
          ]
      }

"--grant-write"  (string)Allows grantee to create, overwrite, and
delete any object in the bucket.

"--grant-read"  (string)Allows grantee to list the objects in the
bucket.

"--grant-read-acp"  (string)Allows grantee to read the bucket ACL.
