Ресурс aws_efs_file_system

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

Используйте ресурс аудита aws_efs_file_system InSpec для проверки свойств одного файла системы AWS EFS. Данный ресурс добавлен в пакет ресурсов AWS InSpec в версии 1.10.0 и доступен с InSpec 4.18.108 и более поздними версиями.

Синтаксис

Блок ресурса aws_efs_file_system описывает тесты для одной файловой системы AWS EFS, используя либо идентификатор файловой системы, либо маркер создания.

describe aws_efs_file_system(file_system_id: 'fs-12345678') do
  it                         { should be_encrypted }
  its('size_in_bytes.value') { should cmp 6144 }
end

describe aws_efs_file_system(creation_token: 'my-token') do
  its('encrypted')       { should cmp true }
  its('throughput_mode') { should eq 'bursting' }
end

Значение file_system_id может быть предоставлено в виде строки.

describe aws_efs_file_system('fs-12345678') do
  it { should exist }
end

Параметры

Необходимо указать либо идентификатор файловой системы EFS, либо маркер создания.

file_system_id (обязательно, если creation_token не указан)

Идентификатор файловой системы EFS. Он имеет формат fs- и содержит 8 или 17 шестнадцатеричных символов. Его можно передать в виде строки или в виде пары file_system_id: 'value' ключ-значение в хеше.

creation_token (обязательно, если file_system_id не указан)

Маркер создания автоматически назначается AWS, если он не указан пользователем при создании. Это строка длиной от 1 до 64 символов. Она должна быть передана в виде пары creation_token: 'value' ключ-значение в хеше.

Свойства

Свойство	Описание
creation_token	Значение маркера создания.
file_system_id	Идентификатор файловой системы, автоматически назначаемый AWS.
encrypted	Указывает, зашифрована ли файловая система.
life_cycle_state	Фаза жизненного цикла файловой системы, например, ‘creating’.
owner_id	AWS-аккаунт, создавший файловую систему.
performance_mode	Режим производительности файловой системы, например, ‘maxIO’.
throughput_mode	Режим пропускной способности файловой системы, например, ‘bursting’.
tags	Хеш с каждой парой ключ-значение, соответствующей тегу, связанному с объектом.

Доступны и другие свойства. Для получения полного списка см. документацию по API.

Примеры

Проверка доступности файловой системы EFS

describe aws_efs_file_system("fs-12345678") do
    its("life_cycle_state") { should eq 'available' }
end

Проверка, что файловая система EFS находится в режиме производительности ‘maxIO’

describe aws_efs_file_system(creation_token: "My Token") do
    its("performance_mode") { should eq "maxIO" }
end

Проверка, что файловая система EFS имеет определенный тег

describe aws_efs_file_system(creation_token: "My Token") do
    its("tags") { should include("companyName" => "My Company") }
end

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

Данный ресурс аудита InSpec имеет следующие специальные сопоставители. Для получения полного списка доступных сопоставителей посетите нашу страницу сопоставителей.

exist

describe aws_efs_file_system(file_system_id: "fs-12345678") do
    it { should exist }
end

be_encrypted

describe aws_efs_file_system(creation_token: "My Token") do
    it { should be_encrypted }
end

Разрешения AWS

Для вашего сущности необходимо elasticfilesystem:DescribeFileSystems действие.

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