azurerm_postgresql_server ресурс

[изменить на GitHub]

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

Версия Azure REST API

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

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

Доступность

Установка

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

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

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

Версия

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

Синтаксис

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

describe azurerm_postgresql_server(resource_group: 'inspec-resource-group-9', server_name: 'example_server') do
  it { should exist }
end

Примеры

Если сервер PostgreSQL указан с валидным Resource Group и Server Name

describe azurerm_postgresql_server(resource_group: 'my-rg', server_name: 'sql-server-1') do
  it { should exist }
end

Если сервер PostgreSQL указан с невалидным Resource Group или Server Name

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

Параметры

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

Атрибуты

• id
• name
• sku
• location
• properties
• type

id

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

name

Имя сервера, например my-sql-server.

sku

SKU сервера. Это свойства, связанные с оплатой, относящиеся к серверу.

location

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

properties

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

type

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

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

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

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

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

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

exists

describe azurerm_postgresql_server(resource_group: 'my-rg', server_name: 'server-name-1') do
  it { should exist }
end

Разрешения Azure

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