Ресурс azurerm_mysql_databases

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

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

Версия Azure REST API

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

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

Доступность

Установка

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

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

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

Версия

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

Синтаксис

Блок ресурса azurerm_mysql_databases возвращает все базы данных MySQL на сервере MySQL в группе ресурсов.

describe azurerm_mysql_databases(resource_group: ..., server_name: ...) do
  ...
end

Примеры

В следующих примерах показано, как использовать этот ресурс аудита InSpec.

Проверка наличия баз данных MySQL

describe azurerm_mysql_databases(resource_group: 'resource-group-1', server_name: 'production') do
  it            { should exist }
  its('names')  { should include 'my-database-name' }
end

Критерии фильтрации

• azure_mysql_databases ресурсы могут быть отфильтрованы по всем доступным свойствам. Ниже приведены некоторые примеры.

names

Фильтровать результаты, чтобы включить только те базы данных, которые соответствуют заданному имени. Это строковое значение.

describe azurerm_mysql_databases(resource_group: 'rg', server_name: 'server').where{ name.eql?('production-database') } do
  it { should exist }
end

location

Фильтровать результаты, чтобы включить только те группы ресурсов, которые находятся в заданном расположении. Это строковое значение.

describe azurerm_mysql_databases(resource_group: 'rg', server_name: 'server').where{ location.eql?('eastus') } do
  it { should exist }
end

Атрибуты

• id
• name
• type
• properties

ids

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

names

Имя базы данных SQL, например my-sql-database.

its('names') { should include 'my-sql-database' }

type

Тип ресурса, обычно Microsoft.Sql/servers/databases.

properties

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

Матчеры

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

exists

Контроль пройдет, если фильтр вернёт хотя бы один результат. Используйте should_not если ожидается ноль совпадений.

describe azurerm_mysql_databases do
  it { should exist }
end

Разрешения Azure

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