azurerm_network_interface ресурс

[править на GitHub]

Используйте azurerm_network_interface ресурс проверки InSpec, чтобы протестировать свойства и конфигурацию сетевого интерфейса Azure.

Версия Azure REST API

Этот ресурс взаимодействует с версией 2018-11-01 API управления Azure. Дополнительную информацию можно найти в официальной документации Azure.

В настоящее время нет способа выбрать версию документации API Azure. Если вы обнаружите более новую версию, упоминаемую в официальной документации, откройте вопрос или отправьте запрос на вытягивание с обновленной версией.

Доступность

Установка

Этот ресурс доступен в inspec-azure пакете ресурсов. Для использования добавьте следующее в свой inspec.yml в вашем профиле верхнего уровня:

depends:
  inspec-azure:
    git: https://github.com/inspec/inspec-azure.git

Вам также потребуется настроить учетные данные Azure; см. README пакета ресурсов.

Версия

Этот ресурс впервые стал доступен в версии 1.7.2 пакета ресурсов inspec-azure.

Синтаксис

resource_group и name должны быть заданы в качестве параметра.

describe azurerm_network_interface(resource_group: 'inspec-resource-group-9',name: 'example-nic-name') do
  it { should exist }
end

Примеры

Если сетевой интерфейс ссылается с корректным Resource Group и Name

describe azurerm_network_interface(resource_group: 'my-rg', name: 'name-nic') do
  it { should exist }
end

Если сетевой интерфейс ссылается с некорректным Resource Group или Name

describe azurerm_network_interface(resource_group: 'invalid-rg', name: 'i-dont-exist') do
  it { should_not exist }
end

Параметры

• resource_group - Группа ресурсов, к которой принадлежит сетевой интерфейс.
• name - Уникальное имя сетевого интерфейса.

Атрибуты

• id
• name
• location
• properties
• tags
• type
• private_ip
• public_ip

id

Идентификатор ресурса Azure.

name

Имя сетевого интерфейса, например vm-nic.

location

Расположение ресурса, например eastus.

properties

Коллекция дополнительных свойств конфигурации, связанных с сетевым интерфейсом, например ipConfigurations.

теги

Теги ресурсов, примененные к сетевому интерфейсу.

type

Тип ресурса, обычно Microsoft.Network/networkInterfaces.

private_ip

Приватный IP-адрес сетевого интерфейса.

public_ip

Публичный IP-адрес сетевого интерфейса.

Другие атрибуты

Существуют дополнительные атрибуты, к которым можно получить доступ, которые мы не задокументировали. Пожалуйста, ознакомьтесь с документацией Azure. Любой атрибут в ответе можно получить с помощью ключей, разделенных точками (.).

API может не всегда возвращать ключи, не имеющие связанных данных. Может быть, что глубоко вложенное свойство может не содержать нужного атрибута по цепочке вызовов. Если вы обнаруживаете себя, составляя тесты на свойства, которые могут быть nil, скопируйте этот пакет ресурсов и добавьте к нему аксессор ресурса. Внутри этого аксессора вы сможете защититься от nil-ключей. Запросы на вытягивание всегда приветствуются.

Обработчики

Этот ресурс проверки InSpec имеет следующие специальные обработчики. Полный список доступных обработчиков можно найти на нашей странице Универсальные обработчики.

exists

describe azurerm_network_interface(resource_group: 'my-rg', name: 'nic-name-1') do
  it { should exist }
end

Разрешения Azure

Ваш сервисный принцип должен быть настроен с ролью contributor на подписке, которую вы хотите проверить.