ресурс aws_internet_gateways

[редактировать на GitHub]

Используйте ресурс проверки InSpec для проверки свойств всех интернет-шлюзов AWS, принадлежащих учетной записи AWS.

Синтаксис

Блок ресурса aws_internet_gateways собирает все интернет-шлюзы и затем проверяет эту группу.

describe aws_internet_gateways do
  it { should exist }
end

Параметры

Этот ресурс не ожидает параметров.

Свойства

Свойство	Описание
ids	Идентификатор интернет-шлюза. Название поля - id.
names	Значение тега Name. Оно nil, если не определено. Название поля - name.
vpc_ids	Идентификатор подключенной VPC. Оно nil, если ресурс находится в состоянии detached. Название поля - vpc_id.
tags	Хэш, где каждая пара ключ-значение соответствует тегу интернет-шлюза. Название поля - tags.
attachment_states	Указывает, подключен ли интернет-шлюз к VPC (attached или detached). Название поля - attachment_state.
owner_ids	Идентификатор учетной записи AWS, владеющей интернет-шлюзом. Название поля - owner_id.

Примеры

Проверка, что ровно 3 интернет-шлюза

describe aws_internet_gateway do
  its('count') { should cmp 3 }
end

Используйте этот ресурс InSpec для запроса идентификаторов всех интернет-шлюзов, а затем проведите глубокую проверку с помощью aws_internet_gateway.

aws_internet_gateways.ids.each do |id|
  describe aws_internet_gateway(id: id) do
    it { should be_attached }
  end
end

Сопоставители

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

существовать

Контроль пройдет, если описание вернёт по крайней мере один результат. Имена полей, описанные в таблице свойств, должны быть использованы для <property> в where фразе.

Используйте should_not для проверки, что сущность не должна существовать.

describe aws_internet_gateways.where( <property>: <value>) do
  it { should exist }
end

describe aws_internet_gateways.where( <property>: <value>) do
  it { should_not exist }
end

Разрешения AWS

Ваш субъект должен иметь разрешение на действие ec2:DescribeInternetGateways.

Подробную документацию можно найти в Действия, ресурсы и ключи условий для Amazon EC2 и Действия, ресурсы и ключи условий для управления идентификацией и доступом.