gcp_compute_address - Создаёт адрес GCP

Новая версия с версии 2.6.

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

Представляет ресурс типа Address.
Каждый виртуальный экземпляр машины имеет временный внутренний IP-адрес и, необязательно, внешний IP-адрес. Для связи между экземплярами в одной сети можно использовать внутренний IP-адрес экземпляра. Для связи с Интернетом и экземплярами вне одной сети необходимо указать внешний IP-адрес экземпляра.
Внутренние IP-адреса временные и принадлежат экземпляру только на срок его существования; если экземпляр удаляется и воссоздаётся, экземпляру назначается новый внутренний IP-адрес, либо Compute Engine, либо вами. Внешние IP-адреса могут быть либо временными, либо статическими.

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address		Статический внешний IP-адрес, представленный этим ресурсом. Поддерживается только IPv4.
auth_kind обязательно	Варианты: machineaccount serviceaccount application	Тип используемых учетных данных.
description		Необязательное описание этого ресурса.
name		Имя ресурса. Длина имени должна составлять 1-63 символа и соответствовать RFC1035. Точнее, длина имени должна быть 1-63 символа и соответствовать регулярному выражению [a-z]([-a-z0-9]*[a-z0-9])?, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.
project		Проект Google Cloud Platform для использования.
region обязательно		Ссылка на ресурс типа Region.
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.
Значения переменных окружения будут использоваться только в том случае, если значения в playbook не заданы.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: create a address
  gcp_compute_address:
      name: 'test-address1'
      region: 'us-west1'
      project: testProject
      auth_kind: service_account
      service_account_file: /tmp/auth.pem
      scopes:
        - https://www.googleapis.com/auth/compute
      state: present

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

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

Ключ	Возвращаемое значение	Описание
address str	success	Статический внешний IP-адрес, представленный этим ресурсом. Поддерживается только IPv4.
creation_timestamp str	success	Дата и время создания в формате RFC3339.
description str	success	Необязательное описание этого ресурса.
id int	success	Уникальный идентификатор ресурса.
name str	success	Имя ресурса. Длина имени должна составлять 1-63 символа и соответствовать RFC1035. Точнее, длина имени должна быть 1-63 символа и соответствовать регулярному выражению [a-z]([-a-z0-9]*[a-z0-9])?, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.
region str	success	Ссылка на ресурс типа Region.
users list	success	URL ресурсов, использующих этот адрес.

Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

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.6/modules/gcp_compute_address_module.html