azurerm_postgresql_server ресурс

[edit on 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_name — уникальное имя SQL-сервера.

Атрибуты

• 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 на подписке, которую вы хотите проверить.