google.cloud.gcp_iam_role – Создаёт роль GCP

Примечание

Этот плагин входит в сборку google.cloud (версия 1.0.2).

Для его установки используйте: ansible-galaxy collection install google.cloud.

Для использования в плейбуке укажите: google.cloud.gcp_iam_role.

Описание
Требования
Параметры
Примеры
Возвращаемые значения

Описание

Роль в API управления идентификацией и доступом.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно	Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
description строка		Описание роли, понятное для человека.
env_type строка		Указывает, в какой среде Ansible выполняется этот модуль. Это значение не следует устанавливать, если вы не знаете, что делаете. Это изменяет только строку User Agent для всех запросов к API.
included_permissions список / элементы=строка		Имена разрешений, предоставляемых этой ролью при связывании в политике IAM.
name строка / обязательно		Имя роли.
project строка		Проект Google Cloud Platform для использования.
scopes список / элементы=строка		Массив используемых областей
service_account_contents jsonarg		Содержание файла JSON учетной записи сервиса, представленного как словарь или строка JSON.
service_account_email строка		Дополнительный адрес электронной почты учетной записи сервиса, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь		Путь к файлу JSON учетной записи сервиса, если выбран тип serviceaccount.
stage строка		Текущая фаза запуска роли. Некоторые допустимые значения включают: "ALPHA", "BETA", "GA", "DEPRECATED", "DISABLED", "EAP"
state строка	Варианты: present ← absent	Требуется ли существование данного объекта в GCP
title строка		Читаемое человеком название роли. Обычно ограничено 100 байтами UTF-8.

Примеры

- name: create a role
  google.cloud.gcp_iam_role:
    name: myCustomRole2
    title: My Custom Role
    description: My custom role description
    included_permissions:
    - iam.roles.list
    - iam.roles.create
    - iam.roles.delete
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
deleted логическое	успешно	Текущее состояние удаления роли.
description строка	успешно	Описание роли, понятное для человека.
includedPermissions список / элементы=строка	успешно	Имена разрешений, предоставляемых этой ролью при связывании в политике IAM.
name строка	успешно	Имя роли.
stage строка	успешно	Текущая фаза запуска роли.
title строка	успешно	Читаемое человеком название роли. Обычно ограничено 100 байтами UTF-8.

Авторы

Google Inc. (@googlecloudplatform)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/google/cloud/gcp_iam_role_module.html