Редактирование ACL объекта

Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

Посмотрите текущий ACL объекта:

aws s3api get-object-acl \
  --endpoint https://storage.yandexcloud.net \
  --bucket <имя_бакета> \
  --key <ключ_объекта>

Где:

• --endpoint — эндпоинт Object Storage.
• --bucket — имя бакета.
• --key — ключ объекта.

Вы можете применить к объекта предопределенный ACL или настроить разрешения для отдельных пользователей, сервисных аккаунтов, групп пользователей и публичных групп (группа всех пользователей интернета, группа всех аутентифицированных пользователей Yandex Cloud). Эти настройки несовместимы: у объекта должен быть либо предопределенный ACL, либо набор отдельных разрешений.

Предопределенный ACL

Выполните команду:

aws s3api put-object-acl \
  --endpoint https://storage.yandexcloud.net \
  --bucket <имя_бакета> \
  --key <ключ_объекта> \
  --acl <предопределенный_ACL>

Где:

• --endpoint — эндпоинт Object Storage.
• --bucket — имя бакета.
• --key — ключ объекта.
• --acl — предопределенный ACL. Список значений см. в разделе Предопределенные ACL.

Настройка отдельных разрешений

1. Чтобы выдать разрешения ACL для пользователя Yandex Cloud, сервисного аккаунта или группы пользователей, получите их идентификатор:

   • Пользователь.
   • Сервисный аккаунт.
   • Группа пользователей — перейдите на вкладку Группы в интерфейсе Cloud Center.

2. Выполните команду:

   aws s3api put-object-acl \
     --endpoint https://storage.yandexcloud.net \
     --bucket <имя_бакета> \
     --key <ключ_объекта> \
     <тип_разрешения> <получатель_разрешения>
   

   Где:

   • --endpoint — эндпоинт Object Storage.

   • --bucket — имя бакета.

   • --key — ключ объекта.

   • Возможные типы разрешений ACL:

     • --grant-read — доступ к чтению объекта.
     • --grant-full-control — полный доступ к объекту.
     • --grant-read-acp — доступ к чтению ACL объекта.
     • --grant-write-acp — доступ к редактированию ACL объекта.

     Вы можете задать несколько разрешений в одной команде.

   • Возможные получатели разрешений:

     • id=<идентификатор_получателя> — идентификатор пользователя, сервисного аккаунта или группы пользователей, которым нужно дать разрешение.
     • uri=http://acs.amazonaws.com/groups/global/AuthenticatedUsers — публичная группа всех аутентифицированных пользователей Yandex Cloud.
     • uri=http://acs.amazonaws.com/groups/global/AllUsers — публичная группа всех пользователей интернета.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы отредактировать ACL объекта:

1. Откройте файл конфигурации Terraform и добавьте параметр acl в описание объекта.

   ...
   resource "yandex_storage_object" "cute-cat-picture" {
     access_key = "<идентификатор_статического_ключа>"
     secret_key = "<секретный_ключ>"
     bucket     = "cat-pictures"
     key        = "cute-cat"
     source     = "/images/cats/cute-cat.jpg"
     acl        = "public-read"
   }
   ...
   

   Где:

   • access_key — идентификатор статического ключа доступа.

     Примечание

     Кроме статических ключей доступа для аутентификации в Object Storage можно использовать IAM-токен. Подробнее смотрите в разделе Создание бакета и в документации провайдера.

   • secret_key — значение секретного ключа доступа.

   • acl — предопределенный ACL объекта. Значение по умолчанию — private: пользователи Yandex Cloud получают разрешения в соответствии со своими ролями в IAM.

   Более подробную информацию о параметрах ресурса yandex_storage_object в Terraform см. в документации провайдера.

2. Проверьте конфигурацию командой:

   terraform validate
   

   Если конфигурация является корректной, появится сообщение:

   Success! The configuration is valid.
   

3. Выполните команду:

   terraform plan
   

   В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

4. Примените изменения конфигурации:

   terraform apply
   

5. Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

   Проверить изменение группы безопасности можно в консоли управления.

Чтобы отредактировать ACL объекта, воспользуйтесь методом S3 API objectPutAcl.

Чтобы загрузить объект с установкой ACL, воспользуйтесь методом S3 API upload с заголовками X-Amz-Acl, X-Amz-Grant-Read, X-Amz-Grant-Read-Acp, X-Amz-Grant-Write-Acp и X-Amz-Grant-Full-Control.