Инструкции
In this article:
Инструкции#
Настройка собственного домена для веб-сайта#
По умолчанию бакет, работающий в режиме веб-сайта, доступен по адресу „bucket-name“:, где bucket-name — это имя бакета. Вместо доменного имени, приведённого выше, можно использовать собственное произвольное доменное имя.
Настроить собственный домен третьего уровня для сайта#
Для размещения сайта вы можете использовать собственный домен. Например, домен третьего уровня img.example.com в зоне example.com.
Прежде всего вам нужно создать бакет с именем img.example.com, загрузить в него содержимое будущего веб-сайта и включить режим веб-сайта.
Чтобы веб-сайт стал доступен по адресу http://img.example.com, необходимо настроить DNS-сервер, обслуживающий зону example.com.
В настройках зоны example.com создайте запись типа CNAME:
img.example.com. IN CNAME img.example.com.website.k2.cloud
После внесения этих изменений веб-сайт будет доступен по адресу: http://img.example.com, а также (по умолчанию) по адресу: http://img.example.com.website.k2.cloud.
Настроить собственный домен второго уровня для сайта#
Для размещения сайта вы можете использовать собственный домен. Например, домен второго уровня example.com.
Создайте бакет с именем example.com, загрузите в него содержимое будущего веб-сайта и включите режим веб-сайта.
Чтобы веб-сайт стал доступен по адресу http://example.com, необходимо настроить DNS-сервер, обслуживающий зону example.com.
Важно
В данном примере используется домен второго уровня, он же основной домен (zone apex) зоны example.com.
Спецификация DNS не допускает создание записи типа CNAME для такого домена, но некоторые DNS-серверы и сервисы позволяют создавать подобные записи.
Убедитесь, что ваш DNS-сервер/сервис поддерживает такую возможность.
Часто такие записи называются не CNAME, а, например, ALIAS или ANAME.
В настройках зоны example.com создайте запись типа ALIAS или ANAME (в зависимости от того, что использует ваш DNS-провайдер):
example.com. IN ALIAS example.com.website.k2.cloud
Настройка HTTPS для веб-сайта#
По умолчанию бакет, работающий в режиме веб-сайта, доступен только по протоколу HTTP по адресу http://bucket-name.website.k2.cloud, где bucket-name — это имя бакета.
Вы можете включить поддержку протокола HTTPS, а также настроить автоматическое перенаправление с HTTP на HTTPS.
На данный момент API для включения протокола HTTPS средствами автоматизации не предусмотрен.
Важно
Чтобы включить HTTPS для конкретного веб-сайта, оставьте заявку на портале поддержки или в письме на адрес support@k2.cloud. Примеры обращений указаны ниже.
Настроить доступ к веб-сайту по протоколу HTTPS#
Чтобы веб-сайт http://bucket1.website.k2.cloud был доступен по протоколу HTTPS, создайте бакет bucket1 и включите режим веб-сайта.
После выполнения этих действий оставьте заявку на портале поддержки.
Пример заявки
Тема: HTTPS для http://bucket1.website.k2.cloud Описание: - Имя бакета: bucket1 - Домен веб-сайта: bucket1.website.k2.cloud - Включить принудительное перенаправление с HTTP на HTTPS: да/нет где: - Имя бакета — Ваш бакет в объектном хранилище (S3), который должен быть доступен по HTTPS в режиме веб-сайта. - Доменное имя веб-сайта — Имя веб-сайта, на которое будет выпущен сертификат для работы по HTTPS. - Включить принудительное перенаправление с HTTP на HTTPS — Если вы хотите, чтобы пользователи, посещающие веб-сайт по HTTP, автоматически перенаправлялись на HTTPS-версию веб-сайта, укажите да. Если вы хотите сохранить возможность посещать веб-сайт по HTTP, укажите нет.
После проверки обращения для указанного доменного имени будет выпущен сертификат и включён HTTPS. В качестве центра сертификации будет использован Let’s Encrypt.
Настроить доступ к веб-сайту с собственным доменом по протоколу HTTPS#
Чтобы веб-сайт http://img.example.com был доступен по протоколу HTTPS, создайте бакет img.example.com и включите режим веб-сайта. Затем настройте ваш DNS для того, чтобы веб-сайт стал доступен по адресу http://img.example.com.
После выполнения этих действий оставьте заявку на портале поддержки.
Пример заявки
Тема: HTTPS для img.example.com Описание: - Имя бакета: img.example.com - Домен веб-сайта: img.example.com - Включить принудительное перенаправление с HTTP на HTTPS: да/нет - Использовать собственный сертификат: да/нет где: - Имя бакета — ваш бакет в объектном хранилище (S3), который должен быть доступен по HTTPS в режиме веб-сайта. - Доменное имя веб-сайта — имя веб-сайта, на которое будет выпущен сертификат для работы по HTTPS. - Включить принудительное перенаправление с HTTP на HTTPS — если вы хотите, чтобы пользователи, посещающие веб-сайт по HTTP, автоматически перенаправлялись на HTTPS-версию веб-сайта, укажите да. Если вы хотите сохранить возможность заходить на веб-сайт по HTTP, укажите нет. - Использовать собственный сертификат. При использовании собственного домена для веб-сайта вы можете передать нам свой сертификат. В этом случае вам нужно указать да и вложить в обращение сертификат для указанного доменного имени. Это может быть нужно в тестовых целях или в тех случаях, когда необходимо, чтобы сертификат обладал особыми атрибутами. Если вы укажите нет, то для этого домена будет выпущен и использован сертификат от центра сертификации Let's Encrypt.
Настройка правил перенаправления веб-сайта#
Бакет, работающий в режиме веб-сайта, может быть настроен для перенаправления всех или некоторых приходящих запросов на другие бакеты или внешние ресурсы.
В документации можно ознакомиться с составом поддерживаемых в К2 Облаке команд S3 API и инструкцией по настройке AWS CLI.
Для получения текущей конфигурации веб-сайта конкретного бакета можно воспользоваться командой aws s3api get-bucket-website.
aws --endpoint-url https://s3.ru-msk.k2.cloud s3api get-bucket-website --bucket bucket1
{
"IndexDocument": {
"Suffix": "index.html"
}
}
Для задания конфигурации веб-сайта бакета используйте команду s3api put-bucket-website.
Существует несколько вариантов перенаправления:
Поддерживаемые параметры правил перенаправления#
Condition — блок для описания условия, которое должно быть выполнено для применения указанного перенаправления.
Redirect — блок для перенаправления информации.
Вы можете перенаправлять запросы на другой хост, на другую страницу или по другому протоколу.
В случае ошибки можно указать другой код ошибки для возврата.
Блок |
Параметр |
Описание |
|---|---|---|
|
|
Код ошибки HTTP при применении перенаправления.
Если код возникшей ошибки равен этому значению, то применяется указанный редирект.
Требуется, если задан блок |
|
|
Префикс имени ключа объекта при применении перенаправления.
Например, для перенаправления запросов к ExamplePage.html префиксом ключа будет |
|
|
Имя хоста в запросе при перенаправлении. |
|
|
HTTP-код в ответе при перенаправлении. |
|
|
Протокол, используемый при перенаправлении запросов. По умолчанию используется протокол в исходном запросе. |
|
|
Префикс ключа объекта для использования в запросе на перенаправление.
Например, чтобы перенаправить запросы для всех страниц с префиксом |
|
|
Конкретный ключ объекта для использования в запросе на перенаправление.
Например, запрос перенаправления на error.html.
Может присутствовать только при отсутствии |
Перенаправить все запросы на другой ресурс#
Если вы хотите, чтобы все запросы перенаправлялись на другой ресурс, подготовьте JSON-файл со следующими параметрами бакета bucket1.json.
Файл bucket1.json
{
"RedirectAllRequestsTo": {
"HostName": "new-site.com",
"Protocol": "http"
}
}
В этом примере бакет bucket1.website.k2.cloud конфигурируется как веб-сайт. Однако конфигурация указывает, что все GET-запросы для эндпоинта сайта bucket1.website.k2.cloud будут перенаправлены на хост new-site.com. Этот редирект может быть полезен, когда у вас есть два веб-сайта: старый — old-site.com (в нашем примере это bucket1.website.k2.cloud) и новый — new-site.com, и вы хотите, чтобы все запросы, которые приходят на старый веб-сайт, перенаправлялись на новый.
aws --endpoint-url https://s3.ru-msk.k2.cloud s3api put-bucket-website --bucket old-site.com --website-configuration file://bucket1.json
Примечание
Если в конфигурации вы укажете параметр RedirectAllRequestsTo, вы не сможете указать другой параметр.
Настроить гибкие правила перенаправления на другой ресурс#
Если вы хотите гибко конфигурировать правила перенаправления на один или несколько объектов, добавьте правила маршрутизации.
Предположим, что ваш бакет bucket2 содержит следующие объекты:
index.html
docs/site1.html
docs/site2.html
Если вы решили переименовать папку docs/ в documents/, вам нужно перенаправить запросы на префикс docs/ в documents/.
Например, если запрос docs/site1.html должен быть перенаправлен на documents/site1.html, вы обновляете конфигурацию сайта и добавляете правило маршрутизации, как показано в следующем JSON-файле bucket2.json:
Файл bucket2.json
{
"IndexDocument": {
"Suffix": "index.html"
}
"ErrorDocument": {
"Key": "Error.html"
}
"RoutingRules": [
{
"Condition": {
"KeyPrefixEquals": "docs/"
}
"Redirect": {
"ReplaceKeyPrefixWith": "documents/"
}
}
]
}
aws --endpoint-url https://s3.ru-msk.k2.cloud s3api put-bucket-website --bucket bucket2 --website-configuration file://bucket2.json
Настроить несколько правил перенаправления на другой ресурс#
Если вы хотите использовать нескольких правил перенаправления одновременно, подготовьте соответствующий JSON-файл. Например, чтобы настроить разные правила редиректа для русской локализации веб-сайта отдельно от английской, необходимо подготовить JSON-файл bucket3.json:
Файл bucket3.json
{
"IndexDocument": {
"Suffix": "index.html"
},
"ErrorDocument": {
"Key": "error.html"
},
"RoutingRules": [
{
"Redirect": {
"ReplaceKeyWith": "ru/data.html",
"HostName": "new-site.com",
"Protocol": "https",
"HttpRedirectCode": "302"
},
"Condition": {
"KeyPrefixEquals": "ru/manual/data.html"
}
},
{
"Redirect": {
"ReplaceKeyWith": "en/data.html",
"HostName": "new-site.com",
"Protocol": "https",
"HttpRedirectCode": "302"
},
"Condition": {
"KeyPrefixEquals": "en/manual/data.html"
}
}
]
}
aws --endpoint-url https://s3.ru-msk.k2.cloud s3api put-bucket-website --bucket old-site --website-configuration file://bucket3.json
Настройка жизненного цикла объектов в бакете#
Чтобы хранение объектов в бакете было экономически эффективным, можно настроить жизненный цикл. Если вы используете бакет для хранения лог-файлов или регулярных отчётов, то в какой-то момент файлов может стать слишком много. В таком случае можно сократить время на хранение и время, затрачиваемое на ручное удаление объектов, настроив автоудаление объектов из бакета с помощью правил жизненного цикла.
Правила жизненного цикла можно описать в JSON-файле (см. примеры ниже). Для применения заданных правил выполните команду:
aws s3api put-bucket-lifecycle-configuration --bucket <your_bucket> --lifecycle-configuration file://lifecycle.json --endpoint-url https://s3.ru-msk.k2.cloud
Удаление объектов из бакета#
Пример правила из файла lifecycle.json, в соответствии с которым лог-файлы будут автоматически удаляться из бакета через 30 дней после загрузки.
Пример правила для удаления объектов
{
"Rules": [
{
"ID": "Expire old logs",
"Filter": {
"Prefix": "logs/"
},
"Status": "Enabled",
"Expiration": {
"Days": 30
}
}
]
}
Удаление версий объектов из бакета#
Пример правила из файла lifecycle.json, в соответствии с которым неактуальные версии объектов и маркеры удаления будут автоматически удаляться из бакета через 30 дней после создания.
Пример правила для удаления версий объектов
{
"Rules": [
{
"Expiration": {
"ExpiredObjectDeleteMarker": true
},
"ID": "delete-old-versions",
"Prefix": "",
"Status": "Enabled",
"NoncurrentVersionExpiration": {
"NoncurrentDays": 30
}
}
]
}
Удаление частей составной загрузки#
Пример правила из файла lifecycle.json, в соответствии с которым части составной загрузки (multipart upload) будут автоматически удаляться из бакета через 30 дней после создания.
Пример правила для удаления частей составной загрузки
{
"Rules": [
{
"ID": "abort-multipart",
"Prefix": "",
"Status": "Enabled",
"AbortIncompleteMultipartUpload": {
"DaysAfterInitiation": 30
}
}
]
}
Подробнее про объектное хранилище.
Настройка блокировки версий объектов#
Если вы хотите запретить удаление и перезапись объектов и их версий, то можете воспользоваться методами блокировки S3 Object Lock. В данной инструкции рассматриваются основные действия для настройки блокировки, более подробное описание принципов и методов блокировки можно найти в справочнике API по методам Object Lock. Для настройки блокировки используется утилита командной строки AWS (см. как её установить и сконфигурировать).
Создание бакета#
Блокирование объектов в бакете возможно, только если при создании бакета была включена блокировка объектов. Для её включения при создании бакета необходимо указать опцию –object-lock-enabled-for-bucket.
aws s3api create-bucket --bucket <bucket-name> --object-lock-enabled-for-bucket --endpoint-url=https://s3.ru-msk.k2.cloud
Задание политики по умолчанию#
Вы можете задать политику блокировки для бакета, которая по умолчанию будет применяться ко всем загружаемым объектам (если для конкретного объекта не указаны иные параметры блокировки).
Политика устанавливает срок хранения версии объекта и режим хранения (COMPLIANCE или GOVERNANCE).
Политику по умолчанию определять не обязательно, однако при её отсутствии придётся задавать параметры блокировки при загрузке каждого объекта, который требуется защитить.
Режим COMPLIANCE предусматривает строгую блокировку — версию объекта нельзя удалить или перезаписать до окончания срока хранения.
При использовании режима GOVERNANCE срок хранения может изменить любой пользователь с правами на объектное хранилище.
В приводимом примере для загружаемого объекта устанавливается блокировка сроком на 360 дней в режиме COMPLIANCE.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object-lock-configuration \
--bucket <bucket-name> \
--object-lock-configuration "ObjectLockEnabled=Enabled,Rule={DefaultRetention={Mode=COMPLIANCE,Days=360}}"
Заданную по умолчанию политику можно посмотреть с помощью команды get-object-lock-configuration:
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud get-object-lock-configuration \
--bucket <bucket-name>
{
"ObjectLockConfiguration": {
"ObjectLockEnabled": "Enabled",
"Rule": {
"DefaultRetention": {
"Mode": "GOVERNANCE",
"Days": 360
}
}
}
}
Загрузка объекта#
Указываемые при загрузке параметры блокировки имеют приоритет над заданной по умолчанию политикой блокировки для бакета. Вы можете использовать этот метод для блокировки загружаемых объектов сразу после создания бакета и не задавать политику по умолчанию.
В данном примере для загружаемого объекта устанавливается режим GOVERNANCE со сроком хранения до 20 октября 2024 г.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object \
--bucket <bucket-name> \
--key <object-name> \
--body <path-to-file> \
--object-lock-mode GOVERNANCE \
--object-lock-retain-until-date "2024-11-20"
{
"ETag": "\"dff23456a91215d7153f85a7c127aaa9\"",
"VersionId": "<version-id>"
}
Изменение параметров блокировки#
Если для версии объекта задан режим COMPLIANCE, то вы можете только увеличить срок хранения версии.
Если же задан режим GOVERNANCE, то вы можете как увеличить, так и уменьшить срок хранения версии, а также изменить сам режим хранения.
Для сокращения срока хранения и изменения режима блокировки необходимо использовать опцию –bypass-governance-retention.
Пример увеличения срока хранения.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object-retention \
--bucket <bucket-name> \
--key <object-name> \
--version-id <version-id> \
--retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2024-12-01T00:00:00" }'
Пример уменьшения срока хранения.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object-retention \
--bucket <bucket-name> \
--key <object-name> \
--version-id <version-id> \
--bypass-governance-retention \
--retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2024-10-01T00:00:00" }'
Текущие параметры блокировки для версии объекта можно узнать с помощью команды get-object-retention.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud get-object-retention \
--bucket <bucket-name> \
--key <object-name> \
--version-id <version-id>
{
"Retention": {
"Mode": "GOVERNANCE",
"RetainUntilDate": "2024-10-01T00:00:00.000000000Z"
}
}
Включение бессрочной блокировки#
Для версии объекта можно также включить бессрочную блокировку (Legal Hold). Этот способ блокировки независим от блокировки на предопределённый период времени. При его включении версия объекта будет защищена от удаления, даже когда закончится срок её хранения (Retention Period).
Пример включения бессрочной блокировки при загрузке объекта.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object \
--bucket <bucket-name> \
--key <object-name> \
--body <path-to-file> \
--object-lock-legal-hold-status ON
{
"ETag": "\"dff23456a91215d7153f85a7c127aaa9\"",
"VersionId": "1TrVY0XDY44WvOmMqxw04HbSIemIHtG"
}
Пример включения бессрочной блокировки для версии объекта.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object-legal-hold \
--bucket <bucket-name> \
--key <object-name> \
--legal-hold Status=ON \
--version-id <version-id>
Пример отключения бессрочной блокировки у версии объекта.
Примечание
Отключить бессрочную блокировку может любой пользователь проекта с полным набором привилегий для работы с объектным хранилищем.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud put-object-legal-hold \
--bucket <bucket-name> \
--key <object-name> \
--version-id <version-id> \
--legal-hold Status=OFF
Текущий статус блокировки для версии объекта можно узнать с помощью команды get-object-legal-hold.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud get-object-legal-hold \
--bucket <bucket-name> \
--key <object-name> \
--version-id <version-id>
{
"LegalHold": {
"Status": "ON"
}
}
Удаление объекта#
При удалении объекта из бакета с включённым версионированием последняя версия объекта не удаляется — создаётся лишь маркер удаления. Однако если версию объекта без блокировки можно затем удалить, то версия объекта с блокировкой защищена от удаления.
В режиме COMPLIANCE заблокированную версию объекта невозможно удалить до окончания срока хранения.
В режиме GOVERNANCE версию можно удалить с помощью обхода блокировки (опция x-amz-bypass-governance-retention).
Пример удаления объекта с созданием маркера удаления.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud delete-object \
--bucket <bucket-name> \
--key <object-name>
{
"DeleteMarker": true,
"VersionId": "<delete-marker-id>"
}
Пример удаления версии объекта с обходом блокировки для версии с режимом GOVERNANCE.
aws s3api --endpoint-url=https://s3.ru-msk.k2.cloud delete-object \
--bucket <bucket-name> \
--key <object-name> \
--version-id <version-id> \
--bypass-governance-retention
{
"VersionId": "<version-id>"
}
Управление составной загрузкой#
Составная загрузка (multipart upload) позволяет ускорить загрузку больших файлов за счёт параллельной загрузки нескольких частей файла.
Примечание
Для загрузки больших файлов рекомендуем использовать утилиту s3cmd. Она автоматически разбивает загружаемые файлы больше 15 Мбайт на несколько частей.
Загрузка файла по частям#
Составную загрузку рекомендуется использовать, когда размер файла превышает 100 Мбайт.
Файл необходимо предварительно разбить на несколько частей, например с помощью команды split или утилиты 7-Zip в Windows.
Каждая часть файла (кроме последней) не должна быть по объёму меньше 5 Мбайт.
Инициируйте составную загрузку.
$ aws s3api create-multipart-upload --bucket <bucket> --key <large_file> --endpoint-url=https://s3.ru-msk.k2.cloud { "Bucket": "bucket", "Key": "large_file", "UploadId": "2~Lp183FiHlNDzKDO5LIwd4X2AmhbuyLf" }
В выводе содержится идентификатор составной загрузки, который необходимо использовать в последующих командах для идентификации загрузки.
Загрузите каждую часть.
Примечание
У каждой новой загружаемой части не забывайте увеличивать её номер.
$ aws s3api upload-part --bucket <bucket> --key <large_file> --part-number 1 --upload-id 2~Lp183FiHlNDzKDO5LIwd4X2AmhbuyLf --body <part_1> --endpoint-url=https://s3.ru-msk.k2.cloud { "ETag": "\"3977495e279a33abe9c8795beaa52c45\"" } $ aws s3api upload-part --bucket <bucket> --key <large_file> --part-number 2 --upload-id 2~Lp183FiHlNDzKDO5LIwd4X2AmhbuyLf --body <part_2> --endpoint-url=https://s3.ru-msk.k2.cloud { "ETag": "\"f1c7c253aec96cb9af8910c55dd13cb0\"" }
В выводе команды для загрузки каждой части содержится
ETag, который необходимо сохранить. Он потребуется для сборки файла из частей.Создайте JSON-файл с описанием частей составной загрузки, из которых надо собрать объект в бакете:
$ cat parts.json { "Parts": [{ "ETag": "3977495e279a33abe9c8795beaa52c45", "PartNumber":1 }, { "ETag": "f1c7c253aec96cb9af8910c55dd13cb0", "PartNumber":2 }] }
Завершите составную загрузку.
$ aws s3api complete-multipart-upload --multipart-upload file://parts.json --bucket <bucket> --key <large_file> --upload-id 2~Lp183FiHlNDzKDO5LIwd4X2AmhbuyLf --endpoint-url=https://s3.ru-msk.k2.cloud { "Location": "s3.ru-msk.k2.cloud/bucket/large_file", "Bucket": "bucket", "Key": "large_file", "ETag": "7ab490b300478451de681d1859d8a6a2-2" }
Прерывание загрузки файла по частям#
Незавершённую составную загрузку можно отменить.
Проверьте, есть ли в бакете незавершённые составные загрузки:
$ aws s3api list-multipart-uploads --bucket <bucket> --endpoint-url=https://s3.ru-msk.k2.cloud { "Uploads": [ { "UploadId": "2~mdty_HtKZOHy6rIHFq9Vv7dUWK7EIBC", "Key": "large_file", "Initiated": "2024-08-27T10:00:28.060Z", "StorageClass": "STANDARD", "Owner": { "DisplayName": "User@company", "ID": "S3_user_id" }, "Initiator": { "ID": "S3_user_id", "DisplayName": "User@company" } } ] }
Прервите незавершённую составную загрузку. В результате уже загруженные части объекта будут удалены из бакета. Однако команду может потребоваться повторить ещё раз, если во время её выполнения продолжалась загрузка каких-либо частей.
$ aws s3api abort-multipart-upload --bucket <bucket> --key <large_file> --upload-id 2~mdty_HtKZOHy6rIHFq9Vv7dUWK7EIBC --endpoint-url=https://s3.ru-msk.k2.cloud
Проверьте, остались ли неудалённые части.
$ aws s3api list-parts --bucket <bucket> --key <large_file> --upload-id 2~mdty_HtKZOHy6rIHFq9Vv7dUWK7EIBC --endpoint-url=https://s3.ru-msk.k2.cloud { "Parts": [ { "PartNumber": 1, "LastModified": "2024-08-27T10:01:30.270Z", "ETag": "\"496431d179b88aa424ed7a8a17587a8b\"", "Size": 5922 }, { "PartNumber": 2, "LastModified": "2024-08-27T10:02:46.818Z", "ETag": "\"fdaba5b0e698fe4a16e591d1753ebccb\"", "Size": 5923 } ], "Initiator": null, "Owner": { "DisplayName": "", "ID": "" }, "StorageClass": "STANDARD" }
Расширенные возможности управления объектным хранилищем с помощью S3cmd#
Расширенные возможности даёт утилита S3cmd. Ниже приведена последовательность действий для её установки.
Перед установкой вам необходимо получить настройки для доступа по API. Сделать это можно в консоли управления облаком. Нажмите на логин пользователя в правом верхнем углу и выберите Профиль Получить настройки доступа к API.
Утилита S3cmd входит по умолчанию в репозитории Ubuntu, Debian, Fedora, CentOS и RHEL Linux. Её можно установить с помощью следующих команд.
# yum install epel-release -y # yum install s3cmd -y
# sudo apt-get install s3cmdДалее настройте S3cmd (access key и secret key содержатся в настройках для доступа по API):
Настройки s3cmd
$ s3cmd --configure Enter new values or accept defaults in brackets with Enter. Refer to user manual for detailed description of all options. Access key and Secret key are your identifiers for Amazon S3. Leave them empty for using the env variables. Access Key: <имя проекта в К2 Облаке>:<учётная запись в К2 Облаке> Secret Key: XXXXXXXXXXXXXXXXXXXXXX Default Region [US]: Use "s3.amazonaws.com" for S3 Endpoint and not modify it to the target Amazon S3. S3 Endpoint [s3.amazonaws.com]: s3.ru-msk.k2.cloud Use "%(bucket)s.s3.amazonaws.com" to the target Amazon S3. "%(bucket)s" and "%(location)s" vars can be used if the target S3 system supports dns based buckets. DNS-style bucket+hostname:port template for accessing a bucket [%(bucket)s.s3.amazonaws.com]: %(bucket)s.s3.ru-msk.k2.cloud Encryption password is used to protect your files from reading by unauthorized persons while in transfer to S3 Encryption password: Path to GPG program [/usr/bin/gpg]: When using secure HTTPS protocol all communication with Amazon S3 servers is protected from 3rd party eavesdropping. This method is slower than plain HTTP, and can only be proxied with Python 2.7 or newer Use HTTPS protocol [No]: yes On some networks all internet access must go through a HTTP proxy. Try setting it here if you can't connect to S3 directly HTTP Proxy server name: New settings: Access Key: <имя проекта в К2 Облаке>:<учётная запись в К2 Облаке> Secret Key: XXXXXXXXXXXXXXXXXXXXXX Default Region: US S3 Endpoint: s3.ru-msk.k2.cloud DNS-style bucket+hostname:port template for accessing a bucket: %(bucket)s.s3.ru-msk.k2.cloud Encryption password: Path to GPG program: /usr/bin/gpg Use HTTPS protocol: True HTTP Proxy server name: HTTP Proxy server port: 0 Test access with supplied credentials? [Y/n] y Save settings? [y/N] y
После этого вы можете использовать утилиту S3cmd.
Если вам нужна помощь в использовании утилиты, откройте руководство посредством команды s3cmd --help.
Предоставление пользователям разных прав доступа к бакету#
Детальное разграничение прав доступа (гранулярный доступ) для отдельных пользователей находится в разработке.
Для настройки дифференцированного доступа, например, для предоставления одному пользователю прав только на чтение, а другому — на чтение и запись, необходимо добавить их в разные проекты и определить политики бакетов (Bucket Policy).
Особенности использования Bucket Policy:
Права назначаются на уровне проектов. Политика бакета предоставляет права проектам целиком, а не отдельным пользователям.
Единая учётная запись S3 для проекта. Все пользователи из одного проекта с доступом к объектному хранилищу получают одинаковые права в рамках общей учётной записи S3.
Идентификация посредством S3 User ID. При создании правил доступа в политике бакета в качестве субъекта (Principal) необходимо указывать S3 User ID соответствующего проекта.
Разделение ролей. Для каждого уникального набора прав доступа требуется создать отдельный проект.
Схема организации доступа#
В примере используются бакет access-demo и три проекта.
Проект |
Кто работает в проекте |
Доступ к |
|---|---|---|
storage-owner |
Администратор хранилища |
Управление настройками бакета от имени его владельца |
storage-ro |
Пользователь reader |
Просмотр списка объектов и скачивание |
storage-rw |
Пользователь writer |
Просмотр списка объектов, скачивание и загрузка |
Бакет находится в проекте storage-owner. Проекты storage-ro и storage-rw получают доступ к нему в соответствии с политикой бакета. Если группе пользователей требуются идентичные права доступа, то таких пользователей рекомендуется объединять в рамках одного проекта.
Если бакет, для которого необходимо настроить права доступа, уже существует, оставьте его в текущем проекте и используйте этот проект вместо storage-owner. Для одного внешнего пользователя reader достаточно добавить один проект. Если второй пользователь должен иметь полные права владельца, он может работать в проекте владельца: всего потребуется два проекта. Отдельные проекты для пользователей reader и writer нужны, когда обоим требуется ограничить доступ к бакету.
Примечание
Далее вместо access-demo укажите имя своего бакета, в том числе в документах политики.
Создание проектов и назначение пользователей#
Для настройки прав доступа администратору необходимо иметь привилегии на управление IAM. Порядок работы с пользователями и проектами описан в разделе Пользователи и проекты.
Создайте проекты storage-ro и storage-rw в разделе IAM Проекты. При необходимости создайте проект storage-owner, где будет находиться бакет.
Если пользователей ещё нет, создайте их в разделе IAM Пользователи.
Откройте проект storage-ro, перейдите на вкладку Пользователи и нажмите Добавить. Выберите пользователя reader и назначьте ему проектную политику S3FullAccess.
Аналогично добавьте пользователя writer в проект storage-rw и назначьте ему проектную политику S3FullAccess.
Примечание
Политика S3FullAccess позволяет пользователю работать с объектным хранилищем в выбранном проекте. Доступ к бакету в другом проекте настраивает его владелец посредством политики бакета. Поэтому привилегии S3FullAccess в проекте пользователя reader совместимы с доступом только на чтение к бакету другого проекта.
Получение идентификаторов#
В каждом из проектов storage-ro и storage-rw откройте Профиль, найдите S3 User ID соответствующего проекта и сохраните его. Чтобы открыть профиль, нажмите на логин пользователя в правом верхнем углу и выберите Профиль.
В политике используйте идентификатор в таком формате:
arn:aws:iam:::user/<S3_USER_ID_ПРОЕКТА>
Настройка AWS CLI#
Нажмите на логин пользователя в правом верхнем углу и выберите Профиль Получить настройки доступа к API. В открывшемся окне выберите необходимые регион и проект.
Установите и настройте AWS CLI. Создайте три именованных профиля:
aws configure --profile s3-owner
aws configure --profile s3-ro
aws configure --profile s3-rw
В каждом профиле задайте Access Key ID и Secret Access Key для нужного сочетания проекта и пользователя.
При настройке укажите регион US и формат вывода json.
Примечание
При использовании AWS CLI версии 1.37.0 и старше, либо версии 2.23.0 и старше, проверку контрольных сумм следует включать, только когда она требуется для операции.
Для каждого профиля выполните:
aws configure set request_checksum_calculation when_required --profile s3-owner
aws configure set response_checksum_validation when_required --profile s3-owner
aws configure set request_checksum_calculation when_required --profile s3-ro
aws configure set response_checksum_validation when_required --profile s3-ro
aws configure set request_checksum_calculation when_required --profile s3-rw
aws configure set response_checksum_validation when_required --profile s3-rw
Подготовка бакета#
Используйте существующий бакет проекта владельца либо создайте новый в разделе Объектное хранилище Бакеты этого проекта. Для первого знакомства со схемой удобнее создать отдельный тестовый бакет.
Для существующего бакета проверьте текущую политику. Если бакет только что создан и политика ещё не задавалась, пропустите этот шаг:
aws s3api --profile s3-owner get-bucket-policy --bucket access-demo --output text --endpoint-url https://s3.ru-msk.k2.cloud
Если команда вернула данные в формате JSON, сохраните содержимое политики в файл policy-before.json в кодировке UTF-8.
Если получена ошибка NoSuchBucketPolicy, это означает, что политика раньше не была задана.
При ошибке AccessDenied или другой ошибке сначала выясните её причину.
Важно
Бакет использует один документ политики.
Команда применения политики заменяет его целиком.
Если политика уже существует, добавьте нужные правила в массив Statement, сохранив действующие ограничения и необходимые разрешения.
Не заменяйте рабочую политику примером, не проверив её содержимое.
Проверьте также ACL бакета и при необходимости ACL объектов:
aws s3api --profile s3-owner get-bucket-acl --bucket access-demo --endpoint-url https://s3.ru-msk.k2.cloud
Разрешающая политика ниже сама по себе не отменяет права, выданные другим способом.
Чтобы режим доступа соответствовал ожиданиям — только чтение или чтение с загрузкой, у проектов не должно быть задано дополнительных разрешений на запись и удаление посредством ACL или других правил в той же политике бакета.
Например, явное задание Deny в действующей политике может блокировать и разрешённые ниже действия.
Подготовка политики с двумя правилами#
Сохраните следующий документ JSON в файл policy.json.
Замените <RO_PROJECT_S3_USER_ID> и <RW_PROJECT_S3_USER_ID> на S3 User ID проектов пользователей reader и writer.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ReadOnlyProject",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<RO_PROJECT_S3_USER_ID>"
},
"Action": ["s3:ListBucket", "s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"]
},
{
"Sid": "ReadWriteProject",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<RW_PROJECT_S3_USER_ID>"
},
"Action": ["s3:ListBucket", "s3:GetObject", "s3:PutObject"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"]
}
]
}
Первое правило разрешает проекту пользователя reader просмотр списка и скачивание. Второе разрешает проекту пользователя writer те же операции и загрузку объектов. Операции удаления и изменения политики бакета этот документ не разрешает.
Действие |
Назначение |
Ресурс |
|---|---|---|
|
Получить список объектов |
|
|
Скачать объект и получить его заголовки |
|
|
Загрузить объект или записать данные по существующему ключу |
|
В каждом правиле указаны ресурсы бакета и его объектов, чтобы объединить эти действия в одном Statement.
Несколько значений Resource оформляются массивом в квадратных скобках.
ListBucket не даёт права скачивать объекты, а GetObject не даёт права просматривать их список.
Для пользователя reader нужно разрешить оба действия.
Маска /* охватывает ключи объектов любой вложенности и распространяется не только на уже существующие, но и на загруженные в будущем объекты, если для них выполняются условия доступа.
Важно
Запись допускает перезапись: PutObject разрешает загрузить данные по уже существующему ключу объекта.
Иначе говоря, отсутствие прав DeleteObject не защищает существующие данные от изменения, поскольку объекты можно перезаписывать.
Применение политики#
Выполните команду от имени проекта владельца:
aws s3api --profile s3-owner put-bucket-policy --bucket access-demo --policy file://policy.json --endpoint-url https://s3.ru-msk.k2.cloud
Убедитесь, что команда завершилась без ошибки, затем прочитайте установленную политику:
aws s3api --profile s3-owner get-bucket-policy --bucket access-demo --endpoint-url https://s3.ru-msk.k2.cloud
Сравните S3 User ID, имя бакета и действия с подготовленным JSON. Успешное чтение политики подтверждает, что она сохранена. Сами права нужно проверить отдельными запросами.
Другие варианты политики#
Следующие примеры являются отдельными документами политики.
Чтобы совместить несколько вариантов для одного бакета, объедините нужные правила Statement в один документ, проверьте разрешения и запреты, а затем примените его целиком.
Разграничение доступа на чтение и загрузку#
Только чтение#
Если нужно предоставить права только чтения, достаточно одного правила для проекта c пользователем reader:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ReadOnlyProject",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<RO_PROJECT_S3_USER_ID>"
},
"Action": ["s3:ListBucket", "s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"]
}
]
}
Если для бакета уже заданы другие разрешения на запись, разрешающее правило на чтение их не отменяет.
Только загрузка без чтения и просмотра списка объектов#
Политика ниже запрещает пользователю writer-only чтение, получение списка, удаление и изменение ACL для объектов. Она также отклоняет загрузки без указанного ACL, чтобы пользователь writer-only не мог сделать объект публичным и скачать его анонимно.
Используйте отдельный проект только для записи и профиль s3-write-only.
Настройте профиль, как описано выше, и подставьте S3 User ID этого проекта вместо <WRITE_ONLY_PROJECT_S3_USER_ID>.
В этом варианте политики при загрузке объекта параметр --acl bucket-owner-full-control обязателен.
Он предоставляет владельцу бакета полный доступ к загруженному объекту.
Владельцем самого объекта остаётся проект пользователя writer-only.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowUpload",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<WRITE_ONLY_PROJECT_S3_USER_ID>"
},
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::access-demo/*"
]
},
{
"Sid": "DenyReadingListingAndDeletion",
"Effect": "Deny",
"Principal": {
"AWS": "arn:aws:iam:::user/<WRITE_ONLY_PROJECT_S3_USER_ID>"
},
"Action": [
"s3:GetObject",
"s3:GetObjectVersion",
"s3:ListBucket",
"s3:ListBucketVersions",
"s3:DeleteObject",
"s3:DeleteObjectVersion",
"s3:PutObjectAcl",
"s3:PutObjectVersionAcl"
],
"Resource": [
"arn:aws:s3:::access-demo",
"arn:aws:s3:::access-demo/*"
]
},
{
"Sid": "DenyUploadWithoutBucketOwnerControl",
"Effect": "Deny",
"Principal": {
"AWS": "arn:aws:iam:::user/<WRITE_ONLY_PROJECT_S3_USER_ID>"
},
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::access-demo/*"
],
"Condition": {
"StringNotEqualsIfExists": {
"s3:x-amz-acl": "bucket-owner-full-control"
}
}
}
]
}
Политика разрешает обычную загрузку с ACL bucket-owner-full-control и запрещает проекту чтение, получение списка, удаление и последующую смену ACL объектов.
Поэтому пользователь writer-only не сможет сделать загружаемые объекты публичными посредством ACL и скачать их анонимно.
Владельцем объекта остаётся проект пользователя writer-only, а владелец бакета получает полные права FULL_CONTROL.
Если к бакету помимо пользователя writer-only необходимо предоставить доступ пользователю reader, добавьте разрешающее правило пользователя reader из проекта storage-ro к этим трём правилам.
Получится четыре элемента Statement.
Для чтения параметр --acl bucket-owner-full-control указывать не требуется.
Права на чтение для двух проектов и права на чтение и загрузку для третьего#
Примечание
Чтобы предоставить права на чтение двум пользователям, создавать два отдельных проекта для этого не нужно — достаточно добавить их в проект с правами на чтение.
Перечислите S3 User ID проектов с одинаковыми правами в массиве Principal.AWS:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ReadOnlyProjects",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam:::user/<PROJECT_1_S3_USER_ID>",
"arn:aws:iam:::user/<PROJECT_2_S3_USER_ID>"
]
},
"Action": ["s3:ListBucket", "s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"]
},
{
"Sid": "ReadWriteProject",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<PROJECT_3_S3_USER_ID>"
},
"Action": ["s3:ListBucket", "s3:GetObject", "s3:PutObject"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"]
}
]
}
При добавлении следующего проекта с теми же правами добавьте строку с его S3 User ID в нужный массив. Для другого набора прав создайте отдельное правило. Не указывайте один проект одновременно в группах с разными ожидаемыми ограничениями: его разрешения суммируются, а подходящий явный запрет имеет приоритет.
Загрузка больших файлов по частям#
Операции запуска составной загрузки, передачи частей и её завершения используют разрешение PutObject.
Клиенту дополнительно могут понадобиться разрешения на следующие действия:
Действие |
Для чего нужно |
|---|---|
|
Отменить незавершённую загрузку |
|
Получить список частей загрузки |
|
Получить список незавершённых загрузок бакета |
Для такого клиента добавьте необходимые действия из таблицы в массив Action правила пользователя writer из основного примера.
Начните с минимального набора и добавляйте операции, которые нужны используемому клиенту.
При необходимости удаления добавьте s3:DeleteObject только проекту, которому это требуется.
Чтение конкретных версий требует прав на s3:GetObjectVersion, получение списка версий — s3:ListBucketVersions, а удаление конкретных версий — s3:DeleteObjectVersion.
Базовые примеры этих прав не предоставляют.
Ограничение доступа по ключам/префиксам#
Чтение объектов с определённым префиксом#
Следующая политика разрешает читать ключи reports/* и получать их список для всех пользователей проекта:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ListReports",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<RO_PROJECT_S3_USER_ID>"
},
"Action": ["s3:ListBucket"],
"Resource": ["arn:aws:s3:::access-demo"],
"Condition": {
"StringLike": {
"s3:prefix": ["reports/", "reports/*"]
}
}
},
{
"Sid": "ReadReports",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<RO_PROJECT_S3_USER_ID>"
},
"Action": ["s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo/reports/*"]
}
]
}
Для запроса списка объектов с разрешённым политикой префиксом используйте:
aws s3api --profile s3-ro list-objects-v2 --bucket access-demo --prefix reports/ --endpoint-url https://s3.ru-msk.k2.cloud
Запрос списка без префикса или с другими префиксами этим документом не разрешён.
Ограничение ресурса применяется к ключам, а условие s3:prefix в ListBucket — к запросу списка.
Для изоляции нужны оба правила.
Анонимный доступ для скачивания объектов с префиксом public#
Правило подходит, когда в одном бакете хранятся общедоступные и закрытые файлы:
Новые объекты с префиксом public/ также становятся доступны для скачивания.
Прочитать список объектов правило не позволяет.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "PublicReadPublishedObjects",
"Effect": "Allow",
"Principal": "*",
"Action": ["s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo/public/*"]
}
]
}
Без ключей доступа можно скачать, например, public/manual.pdf, но нельзя скачать private/report.pdf, если на него нет других разрешений.
Ограничение доступа по IP-адресам#
Анонимный доступ для скачивания с разрешённых IP-адресов#
Замените адреса в примере на адреса своих клиентов:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "PublicReadFromAllowedIPs",
"Effect": "Allow",
"Principal": "*",
"Action": ["s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo/*"],
"Condition": {
"IpAddress": {
"aws:SourceIp": ["203.0.113.10/32", "198.51.100.0/24"]
}
}
}
]
}
При работе через NAT, VPN или прокси адрес, с которого поступает запрос на эндпоинт объектного хранилища, может отличаться от адреса клиента. В этом случае потребуется указать публичный IP-адрес NAT/VPN/прокси-узла, через который идёт трафик.
Это разрешающее правило: оно не блокирует доступ, уже выданный через ACL или другое правило. Например, владелец бакета может сохранить доступ с других адресов.
Запрет анонимного доступа с остальных IP-адресов#
Правило запрещает все операции с указанным бакетом и его объектами, если запрос пришёл не с разрешённого адреса.
Запрет действует и для владельца бакета, если его адрес не включён в разрешённые.
В Resource нужно указать и сам бакет, и его объекты с маской /*, поскольку запись arn:aws:s3:::access-demo/ не охватывает объекты.
Внимание
Доступ к бакету через веб-интерфейс будет заблокирован, если IP-адрес запросов консоли к объектному хранилищу не входит в разрешённый список. Перед применением политики убедитесь также, что ваш текущий IP-адрес входит в разрешённый список. Иначе вы запретите себе также изменение и удаление политики.
Само правило не выдаёт никаких разрешений.
Ранее выданные права владельца, ACL и разрешающие правила продолжают действовать при доступе с разрешённых адресов.
Для доступа из другого проекта добавьте к этому документу нужные разрешающие правила Statement из предыдущих примеров.
Важно
Ограничение по IP-адресу не заменяет авторизацию.
Чтобы из разрешённой сети был возможен только доступ с ключами проектов, для бакета и объектов не должно быть задано публичных ACL и разрешающих правил для анонимных клиентов.
Запрет с условием NotIpAddress не отменяет публичный доступ из разрешённой сети.
В приведённом примере замените адреса на свои.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "DenyOutsideAllowedIPs",
"Effect": "Deny",
"Principal": "*",
"Action": ["s3:*"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"],
"Condition": {
"NotIpAddress": {
"aws:SourceIp": ["203.0.113.10/32", "198.51.100.0/24"]
}
}
}
]
}
Чтение только с IP-адреса проекта#
Внимание
Для указанного проекта доступ к бакету через веб-интерфейс также будет заблокирован, если IP-адрес запросов консоли к объектному хранилищу не входит в разрешённый список. Проект владельца это правило не ограничивает.
В отличие от запрета доступа по IP-адресу для всех пользователей, здесь ограничения вводятся только для конкретного проекта:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ReadOnlyProject",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/<RO_PROJECT_S3_USER_ID>"
},
"Action": ["s3:ListBucket", "s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"],
"Condition": {
"IpAddress": {
"aws:SourceIp": ["203.0.113.10/32"]
}
}
},
{
"Sid": "DenyProjectOutsideAllowedIPs",
"Effect": "Deny",
"Principal": {
"AWS": "arn:aws:iam:::user/<RO_PROJECT_S3_USER_ID>"
},
"Action": ["s3:*"],
"Resource": ["arn:aws:s3:::access-demo", "arn:aws:s3:::access-demo/*"],
"Condition": {
"NotIpAddress": {
"aws:SourceIp": ["203.0.113.10/32"]
}
}
}
]
}
Первое правило позволяет проекту читать список объектов и скачивать их с разрешённого адреса. Второе запрещает этому проекту любые операции с бакетом с остальных адресов, в том числе при наличии дополнительных прав через ACL. Другие проекты этим запретом не ограничены.
Условие по IP-адресу не разделяет пользователей одного проекта: для разных ограничений по-прежнему нужны разные проекты.
Анонимный доступ для скачивания всех объектов#
Политика разрешает любому клиенту, в том числе без ключей доступа, скачать объект по известному ключу:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "PublicReadGetObject",
"Effect": "Allow",
"Principal": "*",
"Action": ["s3:GetObject"],
"Resource": ["arn:aws:s3:::access-demo/*"]
}
]
}
Разрешение распространяется на существующие и загружаемые впоследствии объекты, ключи которых соответствуют шаблону access-demo/*.
Оно не даёт права просматривать список, загружать или удалять объекты.
Подходящий явный запрет Deny имеет приоритет.
Изменение и отзыв прав доступа#
Примечание
Перед внесением изменений рекомендуем сохранить документ с политикой.
Чтобы отозвать права доступа, предоставляемые проекту политикой, удалите строку с его S3 User ID из соответствующих разрешающих правил или удалите их, а затем повторно примените документ.
При удалении всей политики удаляются также все содержащиеся в ней ограничения. Чтобы отозвать права доступа у одного проекта, обычно достаточно изменить только его правила. ACL и права владельца при удалении политики сохраняются.
Если права доступа отличаются от ожидаемых#
Список возвращается, а объект не скачивается. Проверьте наличие разрешения для
GetObject, ресурс с маской/*, ключ объекта, его владельца и ACL. Право на просмотр ACL бакета не даёт права скачивать объект.Пользователь reader может записывать или удалять объекты. Проверьте выбранный профиль, S3 User ID, доступ пользователя к проектам, ACL и остальные правила политики.
Новый объект другого проекта не читается. Проверьте, что владелец и ACL нового объекта такие же, как и у объекта, загруженного владельцем бакета. Чтение ранее загруженного объекта не гарантирует доступ к вновь загруженным объектам в бакете другого проекта — права принадлежат конкретному объекту, а не бакету.
Файл JSON с политикой не принимается. Проверьте кавычки, запятые, массивы, кодировку UTF-8 и отсутствие незаменённых шаблонов. Если ресурсов несколько, они должны находиться внутри одного массива
Resource.Нужный бакет отсутствует в общем списке. Обратитесь к известному бакету напрямую. Бакет в другом проекте не отображается в общем списке бакетов вашего проекта.
Маленький файл загружается, а большой — нет. Проверьте операции составной загрузки и параметры контрольных сумм клиента.
Ошибка AccessDenied при действующем разрешающем правиле. Проверьте правила
Deny, эндпоинт, ключ проекта, ресурс и дополнительные условия. Не добавляйте"Principal": "*"для обхода закрытого доступа: разрешающее правило без дополнительных ограничений может открыть доступ к бакету посторонним.
Дополнительные сведения: права доступа к объектному хранилищу, поддерживаемые возможности S3 API и AWS CLI.