aws_sgw_facts – Вывод фактов AWS Storage Gateway
Новая в версии 2.6.
Краткое описание
- Вывод фактов AWS Storage Gateway
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key - | Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key | |
| aws_secret_key - | Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key | |
| ec2_url - | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где регион обязателен. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если она есть. | |
| gather_file_shares boolean |
| Сбор информации о файловых разделах для шлюзов хранения данных в режиме s3. |
| gather_local_disks boolean |
| Сбор информации о локальных дисках, подключенных к шлюзу хранения данных. |
| gather_tapes boolean |
| Сбор информации о лентах для шлюзов хранения данных в режиме ленты. |
| gather_volumes boolean |
| Сбор информации о томах для шлюзов хранения данных в режимах iSCSI (кэшированные и хранящиеся). |
| profile - добавлен в 1.6 | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region - | AWS регион для использования. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если она есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| security_token - добавлен в 1.6 | Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token | |
| validate_certs boolean добавлен в 1.5 |
| При установке в "no", сертификаты SSL не будут проверены для версий boto >= 2.6.0. |
Примечания
Примечание
- Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONобычно используется для указания AWS региона, когда это необходимо, но это также можно настроить в конфигурационном файле boto
Примеры
# Note: These examples do not set authentication details, see the AWS Guide for details.
- name: "Get AWS storage gateway facts"
aws_sgw_facts:
- name: "Get AWS storage gateway facts for region eu-west-3"
aws_sgw_facts:
region: eu-west-3
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание | ||
|---|---|---|---|---|
| шлюзы сложный | всегда | список объектов шлюзов | ||
| file_shares сложный | когда gateway_type == "FILE_S3" | Файловые ресурсы шлюза хранения | ||
| file_share_arn строка | всегда | ARN файлового ресурса Пример: arn:aws:storagegateway:eu-west-1:399805793479:share/share-AF999C88 | ||
| file_share_id строка | всегда | Идентификатор файлового ресурса Пример: share-AF999C88 | ||
| file_share_status строка | всегда | Статус файлового ресурса Пример: AVAILABLE | ||
| gateway_arn строка | всегда | ARN шлюза хранения Пример: arn:aws:storagegateway:eu-west-1:367709993819:gateway/sgw-9999F888 | ||
| gateway_id строка | всегда | Идентификатор шлюза хранения Пример: sgw-9999F888 | ||
| gateway_name строка | всегда | Название шлюза хранения (для удобства) Пример: my-sgw-01 | ||
| gateway_operational_state строка | всегда | Состояние работы шлюза хранения Пример: ACTIVE | ||
| gateway_type строка | всегда | Тип шлюза хранения Пример: FILE_S3 | ||
| local_disks сложный | всегда | Локальные диски шлюза хранения | ||
| disk_allocation_type строка | всегда | Тип выделения диска Пример: CACHE STORAGE | ||
| disk_id строка | всегда | Идентификатор диска в системе Пример: pci-0000:00:1f.0 | ||
| disk_node строка | всегда | Родительский блок-устройство диска Пример: /dev/sdb | ||
| disk_path строка | всегда | Путь к диску, используемому для кэширования Пример: /dev/nvme1n1 | ||
| disk_size_in_bytes целое число | всегда | Размер диска в байтах Пример: 107374182400 | ||
| disk_status строка | всегда | Статус диска Пример: present | ||
| tapes сложный | когда gateway_type == "VTL" | Ленты шлюза хранения | ||
| tape_arn строка | всегда | ARN ленты Пример: arn:aws:storagegateway:eu-west-1:399805793479:tape/tape-AF999C88 | ||
| tape_barcode строка | всегда | ARN ленты Пример: tape-AF999C88 | ||
| tape_size_in_bytes целое число | всегда | ARN ленты Пример: 555887569 | ||
| tape_status строка | всегда | ARN ленты Пример: AVAILABLE | ||
Состояние
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Loic Blot <loic.blot@unix-experience.fr>
Подсказка
Если вы заметили какие-либо проблемы в данной документации, вы можете отредактировать этот документ для улучшения.
© 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/aws_sgw_facts_module.html
