你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Policy Set Definition Versions - List All At Management Group
Lists管理组范围内的所有策略集定义版本。
此操作列出管理组范围内所有策略集定义的所有策略集定义版本。
POST https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/listPolicySetDefinitionVersions?api-version=2023-04-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
management
|
path | True |
string |
管理组的名称。 此名称不区分大小写。 |
api-version
|
query | True |
string |
要用于此操作的 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
正常 - 返回策略集定义版本的数组。 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
List all policy definition versions at management group
Sample Request
Sample Response
{
"value": [
{
"properties": {
"displayName": "[Preview]: Enable Monitoring in Azure Security Center",
"policyType": "BuiltIn",
"description": "Monitor all the available security recommendations in Azure Security Center. This is the default policy for Azure Security Center.",
"metadata": {
"category": "Security Center"
},
"version": "1.2.1",
"parameters": {},
"policyDefinitions": [
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/a8bef009-a5c9-4d0f-90d7-6018734e8a16",
"policyDefinitionReferenceId": "RefId1"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/af8051bf-258b-44e2-a2bf-165330459f9d",
"policyDefinitionReferenceId": "RefId2"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/86b3d65f-7626-441e-b690-81a8b71cff60",
"policyDefinitionReferenceId": "RefId3"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/655cb504-bcee-4362-bd4c-402e6aa38759",
"policyDefinitionReferenceId": "RefId4"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/b0f33259-77d7-4c9e-aac6-3aabcfae693c",
"policyDefinitionReferenceId": "RefId5"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/47a6b606-51aa-4496-8bb7-64b11cf66adc",
"policyDefinitionReferenceId": "RefId6"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/44452482-524f-4bf4-b852-0bff7cc4a3ed",
"policyDefinitionReferenceId": "RefId7"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/e1e5fd5d-3e4c-4ce1-8661-7d1873ae6b15",
"policyDefinitionReferenceId": "RefId8"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/af6cd1bd-1635-48cb-bde7-5b15693900b9",
"policyDefinitionReferenceId": "RefId9"
},
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/0961003e-5a0a-4549-abde-af6a37f2724d",
"policyDefinitionReferenceId": "RefId10"
}
]
},
"id": "/providers/Microsoft.Authorization/policySetDefinitions/1f3afdf9-d0c9-4c3d-847f-89da613e70a8/versoins/1.2.1",
"type": "Microsoft.Authorization/policySetDefinitions/versions",
"name": "1.2.1"
},
{
"id": "/providers/Microsoft.Management/managementgroups/MyManagementGroup/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1",
"type": "Microsoft.Authorization/policySetDefinitions/versions",
"name": "1.2.1",
"properties": {
"displayName": "Cost Management",
"description": "Policies to enforce low cost storage SKUs",
"metadata": {
"category": "Cost Management"
},
"version": "1.2.1",
"policyDefinitions": [
{
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
"policyDefinitionReferenceId": "Limit_Skus",
"parameters": {
"listOfAllowedSKUs": {
"value": [
"Standard_GRS",
"Standard_LRS"
]
}
}
},
{
"policyDefinitionId": "/providers/Microsoft.Management/managementgroups/MyManagementGroup/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
"policyDefinitionReferenceId": "Resource_Naming",
"parameters": {
"prefix": {
"value": "DeptA"
},
"suffix": {
"value": "-LC"
}
}
}
]
}
}
]
}
定义
名称 | 说明 |
---|---|
Cloud |
策略操作的错误响应。 |
created |
创建资源的标识类型。 |
Error |
资源管理错误附加信息。 |
Error |
错误响应 |
Metadata |
参数的常规元数据。 |
Parameter |
可提供给策略的参数的定义。 |
parameter |
参数的数据类型。 |
Parameter |
参数的值。 |
Policy |
策略定义组。 |
Policy |
策略定义引用。 |
Policy |
策略设置定义版本。 |
Policy |
策略集定义版本列表。 |
policy |
策略定义的类型。 可能的值为 NotSpecified、BuiltIn、Custom 和 Static。 |
system |
与资源的创建和上次修改相关的元数据。 |
CloudError
策略操作的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
错误响应 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
Metadata
参数的常规元数据。
名称 | 类型 | 说明 |
---|---|---|
assignPermissions |
boolean |
设置为 true 以在策略分配期间Azure 门户此参数的资源 ID 或资源范围值创建角色分配。 如果希望在分配范围之外分配权限,此属性会很有用。 |
description |
string |
参数的说明。 |
displayName |
string |
参数的显示名称。 |
strongType |
string |
在通过门户分配策略定义时使用。 提供上下文感知值列表供用户选择。 |
ParameterDefinitionsValue
可提供给策略的参数的定义。
名称 | 类型 | 说明 |
---|---|---|
allowedValues |
object[] |
参数的允许值。 |
defaultValue |
object |
如果未提供值,则为 参数的默认值。 |
metadata |
参数的常规元数据。 |
|
schema |
object |
使用自定义的 JSON 架构在分配期间提供参数输入的验证。 此属性仅支持对象类型的参数,并遵循 Json.NET 架构 2019-09 实现。 可以了解更多关于在 https://json-schema.org/ 使用架构和在 https://www.jsonschemavalidator.net/ 测试草稿架构的信息。 |
type |
参数的数据类型。 |
parameterType
参数的数据类型。
名称 | 类型 | 说明 |
---|---|---|
Array |
string |
|
Boolean |
string |
|
DateTime |
string |
|
Float |
string |
|
Integer |
string |
|
Object |
string |
|
String |
string |
ParameterValuesValue
参数的值。
名称 | 类型 | 说明 |
---|---|---|
value |
object |
参数值。 |
PolicyDefinitionGroup
策略定义组。
名称 | 类型 | 说明 |
---|---|---|
additionalMetadataId |
string |
包含有关组的其他元数据的资源的资源 ID。 |
category |
string |
组的类别。 |
description |
string |
组的说明。 |
displayName |
string |
组的显示名称。 |
name |
string |
组名称。 |
PolicyDefinitionReference
策略定义引用。
名称 | 类型 | 说明 |
---|---|---|
groupNames |
string[] |
此策略定义引用的组的名称。 |
parameters |
<string,
Parameter |
引用的策略规则的参数值。 键是参数名称。 |
policyDefinitionId |
string |
策略定义或策略集定义的 ID。 |
policyDefinitionReferenceId |
string |
此策略定义引用的策略集定义) 内 (唯一 ID。 |
PolicySetDefinitionVersion
策略设置定义版本。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
策略集定义版本的 ID。 |
name |
string |
策略集定义版本的名称。 |
properties.description |
string |
策略集定义说明。 |
properties.displayName |
string |
策略集定义的显示名称。 |
properties.metadata |
object |
策略集定义元数据。 元数据是一个开放式对象,通常是键值对的集合。 |
properties.parameters |
<string,
Parameter |
策略集可在策略定义引用中使用的定义参数。 |
properties.policyDefinitionGroups |
描述策略集定义中的策略定义引用组的元数据。 |
|
properties.policyDefinitions |
策略定义引用的数组。 |
|
properties.policyType |
策略定义的类型。 可能的值为 NotSpecified、BuiltIn、Custom 和 Static。 |
|
properties.version |
string |
策略以 #.#.# 格式设置定义版本。 |
systemData |
与此资源相关的系统元数据。 |
|
type |
string |
资源类型 (Microsoft.Authorization/policySetDefinitions/versions) 。 |
PolicySetDefinitionVersionListResult
策略集定义版本列表。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
用于获取下一组结果的 URL。 |
value |
策略集定义版本的数组。 |
policyType
策略定义的类型。 可能的值为 NotSpecified、BuiltIn、Custom 和 Static。
名称 | 类型 | 说明 |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
NotSpecified |
string |
|
Static |
string |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源的创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |