通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az policy event

  • 参考

管理策略事件。

命令

名称 说明 类型 状态
az policy event list

列出策略事件。

 核心 GA

az policy event list

编辑

列出策略事件。

az policy event list [--apply]
                     [--filter]
                     [--from]
                     [--management-group]
                     [--namespace]
                     [--order-by]
                     [--parent]
                     [--policy-assignment]
                     [--policy-definition]
                     [--policy-set-definition]
                     [--resource]
                     [--resource-group]
                     [--resource-type]
                     [--select]
                     [--to]
                     [--top]

示例

获取在最近一天创建的当前订阅范围内的策略事件。

az policy event list

获取管理组范围内的策略事件。

az policy event list -m "myMg"

获取当前订阅中资源组范围内的策略事件。

az policy event list -g "myRg"

使用资源 ID 获取资源的策略事件。

az policy event list --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup /providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"

使用资源名称获取资源的策略事件。

az policy event list --resource "myKeyVault" --namespace "Microsoft.KeyVault" --resource-type "vaults" -g "myresourcegroup"

使用资源名称获取嵌套资源的策略事件。

az policy event list --resource "myRule1" --namespace "Microsoft.Network" --resource-type "securityRules" --parent "networkSecurityGroups/mysecuritygroup1" -g "myresourcegroup"

获取当前订阅中策略集定义的策略事件。

az policy event list -s "fff58873-fff8-fff5-fffc-fffbe7c9d697"

获取当前订阅中策略定义的策略事件。

az policy event list -d "fff69973-fff8-fff5-fffc-fffbe7c9d698"

获取当前订阅中策略分配的策略事件。

az policy event list -a "ddd8ef92e3714a5ea3d208c1"

获取当前订阅中指定资源组中策略分配的策略事件。

az policy event list -g "myRg" -a "ddd8ef92e3714a5ea3d208c1"

获取当前订阅中的前 5 个策略事件，选择一部分属性并自定义排序。

az policy event list --top 5 --order-by "timestamp desc, policyAssignmentName asc" --select "timestamp, resourceId, policyAssignmentId, policySetDefinitionId, policyDefinitionId"

在自定义时间间隔内获取当前订阅中的策略事件。

az policy event list --from "2018-03-08T00:00:00Z" --to "2018-03-15T00:00:00Z"

根据某些属性值获取当前订阅筛选结果中的策略事件。

az policy event list --filter "(policyDefinitionAction eq 'deny' or policyDefinitionAction eq 'audit') and resourceLocation ne 'eastus'"

获取当前订阅中的策略事件数。

az policy event list --apply "aggregate($count as numberOfRecords)"

根据某些属性获取当前订阅中的策略事件聚合结果。

az policy event list --apply "groupby((policyAssignmentId, policyDefinitionId, policyDefinitionAction, resourceId), aggregate($count as numEvents))"

根据某些属性获取当前订阅分组结果中的策略事件。

az policy event list --apply "groupby((policyAssignmentName, resourceId))"

根据指定多个分组的某些属性获取当前订阅中的策略事件聚合结果。

az policy event list --apply "groupby((policyAssignmentId, policyDefinitionId, resourceId))/groupby((policyAssignmentId, policyDefinitionId), aggregate($count as numResourcesWithEvents))"

可选参数

--apply

使用 OData 表示法为聚合应用表达式。

--filter

使用 OData 表示法筛选表达式。

--from

ISO 8601 格式化时间戳，指定要查询的时间间隔的开始时间。

--management-group -m

管理组的名称。

--namespace

提供程序命名空间（例如：Microsoft.Provider）。

--order-by

使用 OData 表示法对表达式进行排序。

--parent

父路径（例如：resourceTypeA/nameA/resourceTypeB/nameB）。

--policy-assignment -a

策略分配的名称。

--policy-definition -d

策略定义的名称。

--policy-set-definition -s

策略集定义的名称。

--resource

资源 ID 或资源名称。 如果指定了名称，请提供资源组和其他相关的资源 ID 参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--resource-type

资源类型（例如：resourceTypeC）。

--select

使用 OData 表示法选择表达式。

--to

ISO 8601 格式的时间戳，用于指定要查询的时间间隔的结束时间。

--top

要返回的最大记录数。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。