gcp_storage_bucket_access_control – Создаёт GCP BucketAccessControl
Новое в версии 2.6.
Обзор
- Ресурс BucketAccessControls представляет списки управления доступом (ACL) для ведёр в Google Cloud Storage. ACL позволяют указать, кто имеет доступ к вашим данным и в какой степени.
- Существует три роли, которые могут быть назначены сущности: READERы могут получить ведро, хотя свойство acl возвращено не будет, и перечислить объекты ведра. WRITERы являются READERами и могут вставлять объекты в ведро и удалять объекты ведра. OWNERы являются WRITERами и могут получить свойство acl ведра, обновить ведро и вызвать все методы BucketAccessControls для ведра. Дополнительную информацию см. в разделе Управление доступом, с оговоркой, что этот API использует READER, WRITER и OWNER вместо READ, WRITE и FULL_CONTROL.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| auth_kind - / обязательно |
| Тип используемых учетных данных. | |
| bucket - / обязательно | Имя ведра. | ||
| entity - / обязательно | Сущность, обладающая разрешениями, в одном из следующих форматов: user-userId user-email group-groupId group-email domain-domain project-team-projectId allUsers allAuthenticatedUsers Примеры: Пользователь liz@example.com будет user-liz@example.com. Группа example@googlegroups.com будет group-example@googlegroups.com. Для ссылки на всех участников домена Google Apps for Business example.com сущность будет domain-example.com. | ||
| entity_id - | Идентификатор сущности. | ||
| project - | По умолчанию: null | Проект Google Cloud Platform для использования. | |
| project_team - | Команда проекта, связанная с сущностью. | ||
| project_number - | Команда проекта, связанная с сущностью. | ||
| team - |
| Команда. | |
| role - |
| Разрешение доступа для сущности. | |
| scopes - | Массив используемых областей. | ||
| service_account_email - | Дополнительный адрес электронной почты учетной записи сервиса, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию. | ||
| service_account_file - | Путь к файлу JSON учетной записи сервиса, если тип выбран как serviceaccount. | ||
| state - |
| Требуется ли существование данного объекта в GCP | |
Примечания
Примечание
- Для аутентификации можно установить service_account_file, используя переменную среды
GCP_SERVICE_ACCOUNT_FILE. - Для аутентификации можно установить service_account_email, используя переменную среды
GCP_SERVICE_ACCOUNT_EMAIL. - Для аутентификации можно установить auth_kind, используя переменную среды
GCP_AUTH_KIND. - Для аутентификации можно установить scopes, используя переменную среды
GCP_SCOPES. - Значения переменных среды будут использоваться только в том случае, если значения в данном файле не заданы.
- Параметры service_account_email и service_account_file являются взаимоисключающими.
Примеры
- name: create a bucket
gcp_storage_bucket:
name: "bucket-bac"
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: bucket
- name: create a bucket access control
gcp_storage_bucket_access_control:
bucket: "{{ bucket }}"
entity: user-alexstephen@google.com
role: WRITER
project: "test_project"
auth_kind: "service_account"
service_account_file: "/tmp/auth.pem"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| bucket словарь | успех | Имя ведра. | |
| domain строка | успех | Домен, связанный с сущностью. | |
| email строка | успех | Адрес электронной почты, связанный с сущностью. | |
| entity строка | успех | Сущность, обладающая разрешениями, в одном из следующих форматов: user-userId user-email group-groupId group-email domain-domain project-team-projectId allUsers allAuthenticatedUsers Примеры: Пользователь liz@example.com будет user-liz@example.com. Группа example@googlegroups.com будет group-example@googlegroups.com. Для ссылки на всех участников домена Google Apps for Business example.com сущность будет domain-example.com. | |
| entity_id строка | успех | Идентификатор сущности. | |
| id строка | успех | Идентификатор записи управления доступом. | |
| project_team сложный тип | успех | Команда проекта, связанная с сущностью. | |
| project_number строка | успех | Команда проекта, связанная с сущностью. | |
| team строка | успех | Команда. | |
| role строка | успех | Разрешение доступа для сущности. | |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [бета-версия]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Google Inc. (@googlecloudplatform)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/gcp_storage_bucket_access_control_module.html