Настроить права доступа к образу

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

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

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

   yc compute image add-access-binding --help
   

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

   yc compute image list
   

3. Посмотрите список ролей, которые уже назначены на ресурс:

   yc compute image list-access-bindings <идентификатор_образа>
   

4. Назначьте роль с помощью команды:

   • Пользователю:

     yc compute image add-access-binding <идентификатор_образа> \
       --user-account-id <идентификатор_пользователя> \
       --role <роль>
     

     Где:

     • --user-account-id — идентификатор пользователя. Чтобы назначить роль для всех аутентифицированных пользователей, воспользуйтесь флагом --all-authenticated-users.
     • --role — назначаемая роль.

   • Сервисному аккаунту:

     yc compute image add-access-binding <идентификатор_образа> \
       --service-account-id <идентификатор_сервисного_аккаунта> \
       --role <роль>
     

     Где:

     • --service-account-id — идентификатор сервисного аккаунта.
     • --role — назначаемая роль.

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

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

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

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

Чтобы назначить роль на образ с помощью Terraform:

1. Опишите в конфигурационном файле Terraform параметры ресурсов, которые необходимо создать:

   resource "yandex_compute_image_iam_binding" "sa-access" {
     image_id = "<идентификатор_образа>"
     role     = "<роль>"
     members  = ["<тип_субъекта>:<идентификатор_субъекта>","<тип_субъекта>:<идентификатор_субъекта>"]
   }
   

   Где:

   • image_id — идентификатор образа.
   • role — назначаемая роль.
   • members — список типов и идентификаторов субъектов, которым назначается роль. Указывается в виде userAccount:<идентификатор_пользователя> или serviceAccount:<идентификатор_сервисного_аккаунта>.

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

2. Создайте ресурсы:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

   Terraform создаст все требуемые ресурсы. Проверить появление ресурсов можно в консоли управления и с помощью команды CLI:

   yc compute image list-access-bindings <идентификатор_образа>
   

Чтобы назначить роль, воспользуйтесь методом REST API updateAccessBindings для ресурса Image или вызовом gRPC API ImageService/UpdateAccessBindings. В теле запроса в свойстве action укажите ADD, а в свойстве subject — тип и идентификатор пользователя.

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

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

Вы можете назначить несколько ролей с помощью команды set-access-bindings.

1. Убедитесь, что на ресурс не назначены роли, которые вы не хотите потерять:

   yc compute image list-access-bindings <идентификатор_образа>
   

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

   yc compute image set-access-bindings --help
   

3. Назначьте роли:

   yc compute image set-access-bindings <идентификатор_образа> \
     --access-binding role=<роль>,subject=<тип_субъекта>:<идентификатор_субъекта> \
     --access-binding role=<роль>,subject=<тип_субъекта>:<идентификатор_субъекта>
   

   Где:

   • --access-binding — параметры для установки прав доступа:

     • role — назначаемая роль.
     • subject — тип и идентификатор субъекта, которому назначается роль.

   Например, назначьте роли нескольким пользователям и сервисному аккаунту:

   yc compute image set-access-bindings my-image \
     --access-binding role=editor,subject=userAccount:gfei8n54hmfh********
     --access-binding role=viewer,subject=userAccount:helj89sfj80a********
     --access-binding role=editor,subject=serviceAccount:ajel6l0jcb9s********
   

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

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

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

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

Чтобы назначить несколько ролей на образ с помощью Terraform:

1. Опишите в конфигурационном файле Terraform параметры ресурсов, которые необходимо создать:

   resource "yandex_compute_image_iam_binding" "role-1" {
     image_id = "<идентификатор_образа>"
     role     = "<роль_1>"
     members  = ["<тип_субъекта>:<идентификатор_субъекта>"]
   }
   
   resource "yandex_compute_image_iam_binding" "role-2" {
     image_id = "<идентификатор_образа>"
     role     = "<роль_2>"
     members  = ["<тип_субъекта>:<идентификатор_субъекта>"]
   }
   

   Где:

   • image_id — идентификатор образа.
   • role — назначаемая роль.
   • members — список типов и идентификаторов субъектов, которым назначается роль. Указывается в виде userAccount:<идентификатор_пользователя> или serviceAccount:<идентификатор_сервисного_аккаунта>.

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

2. Создайте ресурсы:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

   Проверить изменения можно в консоли управления и с помощью команды CLI:

   yc compute image list-access-bindings <идентификатор_образа>
   

Чтобы назначить роли на ресурс, воспользуйтесь методом REST API setAccessBindings для ресурса Image или вызовом gRPC API ImageService/SetAccessBindings.

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

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

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

   yc compute image remove-access-binding --help
   

2. Посмотрите, кому и какие роли назначены на ресурс:

   yc compute image list-access-bindings <идентификатор_образа>
   

3. Чтобы отозвать права доступа, выполните команду:

   yc compute image remove-access-binding <идентификатор_образа> \
     --role=<роль> \
     --subject=<тип_субъекта>:<идентификатор_субъекта> \
   

   Где:

   • --role — идентификатор роли, которую надо отозвать.
   • --subject — тип и идентификатор субъекта, у которого отзывается роль.

   Например, чтобы отозвать роль viewer у пользователя с идентификатором ajel6l0jcb9s******** на образ:

   yc compute image remove-access-binding my-image \
     --role viewer \
     --subject userAccount:ajel6l0jcb9s********
   

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

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

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

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

Чтобы отозвать роль, назначенную на образ диска с помощью Terraform:

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

   ...
   resource "yandex_compute_image_iam_binding" "sa-access" {
     image_id = "<идентификатор_образа>"
     role     = "<роль>"
     members  = ["<тип_субъекта>:<идентификатор_субъекта>"]
   }
   

2. Примените изменения:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

   Проверить изменения можно в консоли управления и с помощью команды CLI:

   yc compute image list-access-bindings <идентификатор_образа>
   

Чтобы отозвать роли на образ диска, воспользуйтесь методом REST API updateAccessBindings для ресурса Image или вызовом gRPC API ImageService/UpdateAccessBindings. В теле запроса в свойстве action укажите REMOVE, а в свойстве subject — тип и идентификатор пользователя.