community.google.gce_labels – Создание, обновление или удаление тегов GCE.

Примечание

Этот плагин входит в коллекцию community.google (версия 1.0.0).

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

Для использования в книге задач укажите: community.google.gce_labels.

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

Обзор

Создает, обновляет или удаляет теги GCE на виртуальных машинах, дисках, моментальных снимках и т. д. При указании ресурса GCE пользователи могут указать полную ссылку на ресурс (его «self_link») или отдельные параметры ресурса (тип, расположение, имя). Примеры обоих вариантов можно найти в документации. Более подробную информацию о тегах GCE см. на странице https://cloud.google.com/compute/docs/label-or-tag-resources. Теги постепенно добавляются к большему количеству ресурсов GCE, поэтому данному модулю потребуется обновление по мере добавления новых ресурсов в API GCE (v1).

Требования

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

python >= 2.6
google-api-python-client >= 1.6.2
google-auth >= 1.0.0
google-auth-httplib2 >= 0.0.2

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
credentials_file строка		Путь к JSON-файлу, связанному с адресом электронной почты учетной записи службы.
labels словарь		Список тегов (пар ключ/значение) для добавления или удаления для ресурса.
pem_file строка		Путь к PEM-файлу, связанному с адресом электронной почты учетной записи службы. Этот параметр устарел и может быть удален в будущих версиях. Используйте credentials_file вместо него.
project_id строка		Идентификатор проекта Google Cloud Platform для использования.
resource_location строка		Расположение ресурса (global, us-central1-f и т. д.).
resource_name строка		Имя ресурса.
resource_type строка		Тип ресурса (виртуальные машины, диски, моментальные снимки, образы).
resource_url строка		«self_link» ресурса (виртуальная машина, диск, моментальный снимок и т. д.).
service_account_email строка		Адрес электронной почты учетной записи службы.
service_account_permissions список / элементы=строка		Адрес электронной почты учетной записи службы.
state строка	Варианты: present ← absent	Состояние тегов. Допустимы только `present` или `absent`.

Примечания

Примечание

Теги поддерживают такие ресурсы, как виртуальные машины, диски, образы и т. д. Список доступных ресурсов API GCE v1 см. на странице https://cloud.google.com/compute/docs/labeling-resources (не бета-версии и не альфа-версии).

Примеры

- name: Add labels on an existing instance (using resource_url)
  community.google.gce_labels:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    labels:
      webserver-frontend: homepage
      environment: test
      experiment-name: kennedy
    resource_url: https://www.googleapis.com/compute/beta/projects/myproject/zones/us-central1-f/instances/example-instance
    state: present
- name: Add labels on an image (using resource params)
  community.google.gce_labels:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    labels:
      webserver-frontend: homepage
      environment: test
      experiment-name: kennedy
    resource_type: images
    resource_location: global
    resource_name: my-custom-image
    state: present
- name: Remove specified labels from the GCE instance
  community.google.gce_labels:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    labels:
      environment: prod
      experiment-name: kennedy
    resource_url: https://www.googleapis.com/compute/beta/projects/myproject/zones/us-central1-f/instances/example-instance
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
labels словарь	Всегда.	Список тегов, существующих на ресурсе. Пример: [{'environment': 'test', 'environment-name': 'kennedy', 'webserver-frontend': 'homepage'}]
resource_location строка	Всегда.	Расположение ресурса GCE. Пример: us-central1-f
resource_name строка	Всегда.	Имя ресурса GCE. Пример: my-happy-little-instance
resource_type строка	Всегда.	Тип ресурса GCE. Пример: виртуальные машины
resource_url строка	Всегда.	«self_link» ресурса GCE. Пример: https://www.googleapis.com/compute/beta/projects/myproject/zones/us-central1-f/instances/example-instance
state строка	Всегда.	Состояние тегов. Пример: present

Авторы

Эрик Джонсон (@erjohnso) <erjohnso@google.com>

© 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/community/google/gce_labels_module.html