Spec-Zone.ru › Ansible 2.7

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
- / обязательно
    Варианты:
  • machineaccount
  • serviceaccount
  • application
Тип используемых учетных данных.
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
-
    Варианты:
  • editors
  • owners
  • viewers
Команда.
role
-
    Варианты:
  • OWNER
  • READER
  • WRITER
Разрешение доступа для сущности.
scopes
-
Массив используемых областей.
service_account_email
-
Дополнительный адрес электронной почты учетной записи сервиса, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file
-
Путь к файлу JSON учетной записи сервиса, если тип выбран как serviceaccount.
state
-
    Варианты:
  • present ←
  • absent
Требуется ли существование данного объекта в 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API