azurerm_network_interface ресурс

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

Используйте azurerm_network_interface ресурс проверки InSpec для проверки свойств и конфигурации сетевого интерфейса Azure.

Версия Azure REST API

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

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

Доступность

Установка

Этот ресурс доступен в 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 может не всегда возвращать ключи, у которых нет связанных данных. Может быть случаи, когда глубоко вложенное свойство не имеет нужного атрибута в вашей цепочке вызовов. Если вы обнаружите, что пишете тесты для свойств, которые могут быть null, видоизмените этот пакет ресурсов и добавьте аксессор к ресурсу. В этом аксессоре вы сможете защититься от null-ключей. Запросы на добавление всегда приветствуются.

Обработчики соответствия

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

exists

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

Разрешения Azure

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