Настройка публичного доступа к бакету

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для изменения бакета:

   yc storage bucket update --help
   

2. Получите список бакетов в каталоге по умолчанию:

   yc storage bucket list
   

   Результат:

   +------------------+----------------------+-------------+-----------------------+---------------------+
   |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
   +------------------+----------------------+-------------+-----------------------+---------------------+
   | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
   +------------------+----------------------+-------------+-----------------------+---------------------+
   

3. Сохраните имя бакета (столбец NAME), к которому нужно открыть публичный доступ.

4. Откройте публичный доступ к операциям с бакетом:

   yc storage bucket update \
     --name <имя_бакета> \
     --public-read \
     --public-list \
     --public-config-read
   

   Где:

   • --name — имя бакета, к которому нужно открыть публичный доступ.
   • --public-read — флаг для включения публичного доступа на чтение объектов в бакете.
   • --public-list — флаг для включения публичного доступа на просмотр списка объектов в бакете.
   • --public-config-read — флаг для включения публичного доступа на чтение настроек в бакете.

   name — обязательный параметр. Остальные параметры необязательны. По умолчанию публичный доступ к бакету выключен.

   Результат:

   name: first-bucket
   folder_id: b1gmit33ngp6********
   anonymous_access_flags:
     read: true
     list: true
     config_read: true
   default_storage_class: STANDARD
   versioning: VERSIONING_DISABLED
   max_size: "53687091200"
   acl: {}
   created_at: "2022-12-16T13:58:18.933814Z"
   

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

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

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

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

Чтобы открыть публичный доступ к операциям с бакетом:

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

   resource "yandex_storage_bucket" "log_bucket" {
     access_key = "<идентификатор_статического_ключа>"
     secret_key = "<секретный_ключ>"
     bucket     = "<имя_бакета>"
   
     anonymous_access_flags {
       read        = true
       list        = true
       config_read = true
     }
   }
   

   Где:

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

     Примечание

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

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

   • bucket — имя бакета, к которому нужно открыть публичный доступ.

   • anonymous_access_flags — параметры публичного доступа:

     • read — публичный доступ на чтение объектов в бакете.
     • list — публичный доступ к списку объектов в бакете.
     • config_read — публичный доступ к чтению настроек бакета.

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

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

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

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

Чтобы открыть публичный доступ к операциям с бакетом, воспользуйтесь методом REST API update для ресурса Bucket или вызовом gRPC API BucketService/Update.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для изменения бакета:

   yc storage bucket update --help
   

2. Получите список бакетов в каталоге по умолчанию:

   yc storage bucket list
   

   Результат:

   +------------------+----------------------+-------------+-----------------------+---------------------+
   |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
   +------------------+----------------------+-------------+-----------------------+---------------------+
   | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
   +------------------+----------------------+-------------+-----------------------+---------------------+
   

3. Сохраните имя бакета (столбец NAME), к которому нужно закрыть публичный доступ.

4. Закройте публичный доступ к операциям с бакетом:

   yc storage bucket update \
     --name <имя_бакета> \
     --public-read=false \
     --public-list=false \
     --public-config-read=false
   

   Где:

   • --name — имя бакета, к которому нужно закрыть публичный доступ.
   • --public-read — флаг для управления публичным доступом на чтение объектов в бакете. Для выключения публичного доступа задайте значение false.
   • --public-list — флаг для управления публичным доступом на просмотр списка объектов в бакете. Для выключения публичного доступа задайте значение false.
   • --public-config-read — флаг для управления публичным доступом на чтение настроек в бакете. Для выключения публичного доступа задайте значение false.

   name — обязательный параметр. Остальные параметры необязательны. По умолчанию публичный доступ к бакету выключен.

   Результат:

   name: first-bucket
   folder_id: b1gmit33ngp6********
   anonymous_access_flags:
     read: false
     list: false
     config_read: false
   default_storage_class: STANDARD
   versioning: VERSIONING_DISABLED
   max_size: "53687091200"
   acl: {}
   created_at: "2022-12-16T13:58:18.933814Z"
   

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

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

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

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

Чтобы закрыть публичный доступ к операциям с бакетом:

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

   resource "yandex_storage_bucket" "log_bucket" {
     access_key = "<идентификатор_статического_ключа>"
     secret_key = "<секретный_ключ>"
     bucket     = "<имя_бакета>"
   
     anonymous_access_flags {
       read        = false
       list        = false
       config_read = false
     }
   }
   

   Где:

   • access_key — идентификатор статического ключа доступа.
   • secret_key — значение секретного ключа доступа.
   • bucket — имя бакета, к которому нужно закрыть публичный доступ.
   • anonymous_access_flags — параметры публичного доступа:
     • read — публичный доступ на чтение объектов в бакете.
     • list — публичный доступ к списку объектов в бакете.
     • config_read — публичный доступ к чтению настроек бакета.

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

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

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

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

Чтобы закрыть публичный доступ к операциям с бакетом, воспользуйтесь методом REST API update для ресурса Bucket или вызовом gRPC API BucketService/Update.