azure.azcollection.azure_rm_servicebus_info – Получение фактов о servicebus

Примечание

Этот плагин входит в коллекцию azure.azcollection (версия 1.3.1).

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

Для использования в playbook укажите: azure.azcollection.azure_rm_servicebus_info.

Добавлено в версии 0.1.2: коллекции azure.azcollection

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

Обзор

Получить факты о конкретном servicebus или обо всех servicebus в группе ресурсов или подписке.

Требования

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

python >= 2.7
azure >= 2.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ad_user строка		Имя пользователя Active Directory. Используется при аутентификации с помощью пользователя Active Directory, а не с помощью принципала службы.
adfs_authority_url строка добавлено в 0.0.1 коллекции azure.azcollection		URL-адрес службы авторизации Azure AD. Используется при аутентификации с именем пользователя/паролем и собственной службой авторизации ADFS.
api_profile строка добавлено в 0.0.1 коллекции azure.azcollection	По умолчанию: "latest"	Выбирает профиль API для взаимодействия с Azure-сервисами. Значение по умолчанию `latest` подходит для общедоступных облаков; будущие значения позволят использовать Azure Stack.
auth_source строка добавлено в 0.0.1 коллекции azure.azcollection	Варианты: auto ← cli credential_file env msi	Управляет источником учетных данных для аутентификации. Также может быть задан через переменную окружения `ANSIBLE_AZURE_AUTH_SOURCE`. При значении `auto` (по умолчанию) приоритет имеет: параметры модуля -> `env` -> `credential_file` -> `cli`. При значении `env`, учетные данные будут считываться из переменных окружения. При значении `credential_file`, будет считываться профиль из `~/.azure/credentials`. При значении `cli`, учетные данные будут взяты из профиля Azure CLI. `subscription_id` или переменная окружения `AZURE_SUBSCRIPTION_ID` может использоваться для определения идентификатора подписки, если их несколько, в противном случае используется стандартная подписка Azure CLI. При значении `msi`, хост-машина должна быть Azure-ресурсом с включенным расширением MSI. `subscription_id` или переменная окружения `AZURE_SUBSCRIPTION_ID` могут использоваться для определения идентификатора подписки, если ресурсу предоставлен доступ к нескольким подпискам, в противном случае выбирается первая подписка. `msi` было добавлено в Ansible 2.6.
cert_validation_mode строка добавлено в 0.0.1 коллекции azure.azcollection	Варианты: ignore validate	Управляет поведением проверки сертификатов для Azure-точек конечных расположений. По умолчанию все модули проверяют сертификат сервера, но при использовании прокси HTTPS или с Azure Stack, может потребоваться отключить это поведение, передав `ignore`. Также может быть задан в профиле файла учетных данных или переменной окружения `AZURE_CERT_VALIDATION`.
client_id строка		Идентификатор клиента Azure. Используется при аутентификации с помощью принципала службы.
cloud_environment строка добавлено в 0.0.1 коллекции azure.azcollection	По умолчанию: "AzureCloud"	Для облачных сред, отличных от общедоступного облака США, используется имя среды (как определено в Azure Python SDK, например, `AzureChinaCloud`, `AzureUSGovernment` ) или URL-адрес точки конечного расположения обнаружения метаданных (необходимо для Azure Stack). Также может быть задан в профиле файла учетных данных или переменной окружения `AZURE_CLOUD_ENVIRONMENT`.
name строка		Ограничить результаты определенным servicebus.
namespace строка		Имя пространства servicebus. Пространство имен является контейнером для всех компонентов обмена сообщениями. Несколько очередей и тем могут находиться в одном пространстве имен, и пространства имен часто служат контейнерами приложений. Требуется при type=namespace.
password строка		Пароль пользователя Active Directory. Используется при аутентификации с помощью пользователя Active Directory, а не с помощью принципала службы.
profile строка		Профиль безопасности, находящийся в файле ~/.azure/credentials.
resource_group строка		Ограничить результаты определенной группой ресурсов.
secret строка		Секрет клиента Azure. Используется при аутентификации с помощью принципала службы.
show_sas_policies логический тип	Варианты: no yes	Показывать ли политики SAS. Не поддерживается при type=subscription. Обратите внимание, если включить этот параметр, модуль фактов выполнит ещё два HTTP-запроса для каждого ресурса, что потребует больше сетевых ресурсов.
subscription_id строка		Ваш идентификатор подписки Azure.
tags строка		Ограничить результаты, указав список тегов. Формат тегов: 'ключ' или 'ключ:значение'.
tenant строка		Идентификатор клиента Azure. Используется при аутентификации с помощью принципала службы.
topic строка		Имя темы. Требуется при type=subscription.
type строка	Варианты: namespace queue topic subscription	Тип ресурса.

Примечания

Примечание

Для аутентификации с Azure можно передавать параметры, устанавливать переменные окружения, использовать профиль, сохраненный в ~/.azure/credentials, или войти в систему перед выполнением задач или playbook с помощью az login.
Аутентификация также возможна с помощью принципала службы или пользователя Active Directory.
Для аутентификации с помощью принципала службы передайте subscription_id, client_id, secret и tenant или установите переменные окружения AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_SECRET и AZURE_TENANT.
Для аутентификации с помощью пользователя Active Directory передайте ad_user и password или установите AZURE_AD_USER и AZURE_PASSWORD в окружении.
В качестве альтернативы учетные данные могут быть сохранены в ~/.azure/credentials. Это ini-файл, содержащий раздел [default] и следующие ключи: subscription_id, client_id, secret и tenant или subscription_id, ad_user и password. Также можно добавить дополнительные профили. Укажите профиль, передав profile или установив AZURE_PROFILE в окружении.

См. также

Авторизация с помощью Azure CLI: Как выполнить аутентификацию, используя команду az login.

Примеры

- name: Get all namespaces under a resource group
  azure_rm_servicebus_info:
    resource_group: myResourceGroup
    type: namespace

- name: Get all topics under a namespace
  azure_rm_servicebus_info:
    resource_group: myResourceGroup
    namespace: bar
    type: topic

- name: Get a single queue with SAS policies
  azure_rm_servicebus_info:
    resource_group: myResourceGroup
    namespace: bar
    type: queue
    name: sbqueue
    show_sas_policies: true

- name: Get all subscriptions under a resource group
  azure_rm_servicebus_info:
    resource_group: myResourceGroup
    type: subscription
    namespace: bar
    topic: sbtopic

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

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

Ключ			Возвращаемое значение	Описание
servicebuses сложный			всегда	Список словарей servicebus.
	accessed_at строка		всегда	Последнее время, когда сообщение было отправлено или запрос был получен для этой темы. Пример: 2019-01-25 02:46:55.543953+00:00
	auto_delete_on_idle_in_seconds целое число		всегда	Интервал простоя по времени ISO 8061, после которого очередь или тема автоматически удаляются. Минимальная продолжительность составляет 5 минут. Пример: True
	count_details сложный		всегда	Подробности о количестве сообщений.
		active_message_count целое число	всегда	Количество активных сообщений в `queue`, `topic`, или `subscription`.
		dead_letter_message_count целое число	всегда	Количество сообщений, помеченных в список несохраненных.
		scheduled_message_count целое число	всегда	Количество запланированных сообщений.
		transfer_dead_letter_message_count целое число	всегда	Количество сообщений, переданных в список несохраненных.
		transfer_message_count целое число	всегда	Количество сообщений, переданных в другую `queue`, `topic`, или `subscription`.
	created_at строка		всегда	Точное время создания сообщения. Пример: 2019-01-25 02:46:55.543953+00:00
	dead_lettering_on_filter_evaluation_exceptions целое число		всегда	Значение, указывающее, поддерживает ли подписка отказ от сообщений по исключениям оценки фильтра.
	dead_lettering_on_message_expiration целое число		всегда	Значение, указывающее, поддерживает ли эта `queue` или `topic` отказ от сообщений при истечении срока действия сообщения.
	default_message_time_to_live_seconds целое число		всегда	Значение по умолчанию интервала времени жизни сообщения ISO 8061. Это продолжительность, после которой сообщение истекает, начиная с момента отправки сообщения в Service Bus. Это значение по умолчанию используется, когда параметр TimeToLive не задан для самого сообщения.
	duplicate_detection_time_in_seconds целое число		всегда	Структура времени ISO 8601, определяющая продолжительность истории обнаружения дубликатов. Пример: 600
	enable_batched_operations логическое		всегда	Значение, указывающее, включены ли пакетные операции на стороне сервера. Пример: True
	enable_express логическое		всегда	Значение, указывающее, включены ли сущности Express. Тема express временно хранит сообщение в памяти перед записью его в постоянное хранилище. Пример: True
	enable_partitioning логическое		всегда	Значение, указывающее, включена ли возможность разбиения `queue` или `topic` по нескольким брокерам сообщений. Пример: True
	forward_dead_lettered_messages_to строка		всегда	Имя `queue` или `topic` для переадресации сообщений из списка несохраненных. Пример: corge
	forward_to строка		всегда	Имя `queue` или `topic` для переадресации сообщений. Пример: quux
	id строка		всегда	Идентификатор ресурса. Пример: /subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/foo/providers/Microsoft.ServiceBus/ namespaces/bar/topics/baz/subscriptions/qux
	location строка		всегда	Географическое расположение ресурса. Пример: eastus
	lock_duration_in_seconds целое число		всегда	Продолжительность блокировки по времени ISO 8601. Время, на которое сообщение блокируется для других получателей. Максимальное значение для LockDuration составляет 5 минут. Пример: 60
	max_delivery_count целое число		всегда	Максимальное количество поставок. Сообщение автоматически помещается в список несохраненных после этого количества поставок. Пример: 10
	max_size_in_mb целое число		всегда	Максимальный размер `queue` или `topic` в мегабайтах, который соответствует размеру памяти, выделенной для `topic`. Пример: 5120
	message_count целое число		всегда	Количество сообщений. Пример: 10
	metric_id строка		всегда	Идентификатор метрик Azure Insights для пространства имен. Пример: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:bar
	name строка		всегда	Имя ресурса. Пример: qux
	namespace строка		всегда	Имя пространства имен `queue` или `topic`, `subscription`. Пример: bar
	provisioning_state строка		всегда	Состояние подготовки пространства имен. Пример: Успешно
	requires_duplicate_detection логическое		всегда	Значение, указывающее, требуется ли обнаружение дубликатов для этого `queue` или `topic`. Пример: True
	requires_session логическое		всегда	Значение, указывающее, поддерживает ли `queue` или `topic` концепцию сеансов. Пример: True
	sas_policies словарь		всегда	Словарь политик SAS. Не будет возвращено, пока не будет установлено show_sas_policy. Пример: {'testpolicy1': {'id': '/subscriptions/XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/ foo/providers/Microsoft.ServiceBus/namespaces/bar/queues/qux/authorizationRules/testpolicy1', 'keys': {'key_name': 'testpolicy1', 'primary_connection_string': 'Endpoint=sb://bar.servicebus.windows.net/; SharedAccessKeyName=testpolicy1;SharedAccessKey=XXXXXXXXXXXXXXXXX;EntityPath=qux', 'primary_key': 'XXXXXXXXXXXXXXXXX', 'secondary_connection_string': 'Endpoint=sb://bar.servicebus.windows.net/; SharedAccessKeyName=testpolicy1;SharedAccessKey=XXXXXXXXXXXXXXX;EntityPath=qux', 'secondary_key': 'XXXXXXXXXXXXXXX'}, 'name': 'testpolicy1', 'rights': 'listen_send', 'type': 'Microsoft.ServiceBus/Namespaces/Queues/AuthorizationRules'}}
	service_bus_endpoint строка		всегда	Точка входа, которую можно использовать для выполнения операций Service Bus. Пример: https://bar.servicebus.windows.net:443/
	size_in_bytes целое число		всегда	Размер `queue` или `topic` в байтах.
	sku строка		всегда	Свойства SKU пространства имен. Пример: Стандартный
	status строка		всегда	Состояние сущности обмена сообщениями. Пример: активный
	subscription_count целое число		всегда	Количество подписок в рамках темы. Пример: 1

support_ordering boolean	always	Значение, указывающее, поддерживает ли `topic` порядок. Пример: True
tags dictionary	always	Теги ресурса. Пример: {'env': 'sandbox'}
topic string	always	Имя темы подписки. Пример: baz
type string	always	Тип ресурса. Пространство имен — это контейнер для всех компонентов обмена сообщениями. Очередь позволяет хранить сообщения до тех пор, пока получающее приложение не сможет их принять и обработать. Тема и подписки обеспечивают 1:n отношения между издателями и подписчиками. Пример: Microsoft.ServiceBus/Namespaces/Topics
updated_at string	always	Точное время обновления сообщения. Пример: 2019-01-25 02:46:55.543953+00:00

Авторы

Yuwei Zhou (@yuwzho)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/azure/azcollection/azure_rm_servicebus_info_module.html