Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
AWS_POLICY_EQUAL
Порівнює два рядки JSON із політиками AWS IAM (або масиви тегів AWS) і повертає 1, якщо вони семантично еквівалентні згідно з правилами оцінювання політик AWS, і 0 в іншому разі.
Див. також:
[SELECT] [DESCRIBE] [JSON_EQUAL] [JSON_EXTRACT] [ Типи даних ]
Функція aws_policy_equal - це власна функція розширення StackQL. Вона порівнює політики AWS IAM згідно з правилами оцінювання політик AWS, за якими певні елементи (як-от Action, Resource, Principal і Tags) розглядаються як невпорядковані множини. Якщо обидва аргументи є масивами JSON верхнього рівня (наприклад, необробленим масивом тегів AWS), вони також порівнюються як невпорядковані множини. Функція aws_policy_equal доступна в StackQL версії 0.8.175 і новіших і підтримується лише з вбудованим бекендом SQL у пам'яті, який StackQL використовує за замовчуванням.
Синтаксис
SELECT AWS_POLICY_EQUAL(policy1, policy2);
Аргументи
policy1
Рядок JSON, що містить документ політики AWS IAM, або масив JSON із тегами AWS.
policy2
Інший рядок JSON, що містить документ політики AWS IAM або масив тегів, для порівняння з першим.
Обидва аргументи мають бути допустимим JSON. Під час порівняння документів політик обидва мають бути допустимим JSON політики AWS IAM.
Значення, що повертається
Ціле число: 1, якщо документи семантично еквівалентні, і 0, якщо ні.
Приклади
Порівняння політик AWS IAM
SELECT
AssumeRolePolicyDocument as current_policy,
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}' as desired_policy,
AWS_POLICY_EQUAL(AssumeRolePolicyDocument, '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}') as compliant
FROM aws.iam.roles
WHERE RoleName = 'my-lambda-role';
/* returns...
|------------------------------------------------------------------|------------------------------------------------------------------|-----------|
| current_policy | desired_policy | compliant |
|------------------------------------------------------------------|------------------------------------------------------------------|-----------|
| {"Version":"2012-10-17","Statement":[{"Effect":"Allow", | {"Version":"2012-10-17","Statement":[{"Effect":"Allow", | 1 |
| "Principal":{"Service":"lambda.amazonaws.com"}, | "Principal":{"Service":"lambda.amazonaws.com"}, | |
| "Action":"sts:AssumeRole"}]} | "Action":"sts:AssumeRole"}]} | |
|------------------------------------------------------------------|------------------------------------------------------------------|-----------|
*/
Порівняння політик із різним порядком елементів
SELECT
aws_policy_equal(
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:GetObject","s3:PutObject"],"Resource":"*"}]}',
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:PutObject","s3:GetObject"],"Resource":"*"}]}'
) as unordered_action_equal,
aws_policy_equal(
'{"Version":"2012-10-17","Statement":[{"Condition":{"StringEquals":{"sts:ExternalId":"0000"}},"Action":"sts:AssumeRole","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:role/role1"}}]}',
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:role/role1"},"Action":"sts:AssumeRole","Condition":{"StringEquals":{"sts:ExternalId":"0000"}}}]}'
) as reordered_elements_equal
;
/* returns...
|------------------------|--------------------------|
| unordered_action_equal | reordered_elements_equal |
|------------------------|--------------------------|
| 1 | 1 |
|------------------------|--------------------------|
*/
Порівняння різних форматів політик (масив і рядок)
SELECT
aws_policy_equal(
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:GetObject"],"Resource":"*"}]}',
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":"s3:GetObject","Resource":"*"}]}'
) as array_string_equal
;
/* returns...
|--------------------|
| array_string_equal |
|--------------------|
| 1 |
|--------------------|
*/
Порівняння масивів тегів AWS
AWS не гарантує порядку тегів, які повертають API AWS. Скористайтеся функцією aws_policy_equal, щоб порівнювати масиви тегів без урахування порядку елементів.
SELECT
aws_policy_equal(
tags,
'[{"Key":"stackql:stack-name","Value":"stackql-serverless"},{"Key":"stackql:stack-env","Value":"dev"},{"Key":"stackql:resource-name","Value":"aws_s3_workspace_bucket"}]'
) as tags_match
FROM awscc.s3.buckets
WHERE region = 'us-east-1'
AND Identifier = 'my-workspace-bucket';
/* returns...
|------------|
| tags_match |
|------------|
| 1 |
|------------|
-- Returns 1 regardless of the order AWS returns the tags array
*/
Порівняння тегів ресурсу, вкладених в об'єкт ресурсу
Коли теги вбудовано в об'єкт ресурсу як поле Tags, функція aws_policy_equal все одно розглядає масив тегів як невпорядковану множину.
SELECT
aws_policy_equal(
'{"BucketName":"my-bucket","Tags":[{"Key":"env","Value":"prod"},{"Key":"team","Value":"platform"}]}',
'{"BucketName":"my-bucket","Tags":[{"Key":"team","Value":"platform"},{"Key":"env","Value":"prod"}]}'
) as nested_tags_equal
;
/* returns...
|--------------------|
| nested_tags_equal |
|--------------------|
| 1 |
|--------------------|
*/
Докладніше див. aws_policy_equal.