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

Assignments - Get

参考

Service:: Defender for Cloud

API Version:: 2021-08-01-preview

按 resourceId 获取请求范围的特定标准分配

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/assignments/{assignmentId}?api-version=2021-08-01-preview

URI 参数

名称	在	必需	类型	说明
assignmentId	path	True	string	安全分配密钥 - 标准分配的唯一键
resourceGroupName	path	True	string	用户订阅中资源组的名称。此名称不区分大小写。 Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Azure 订阅 ID Regex pattern: `^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$`
api-version	query	True	string	操作的 API 版本

响应

名称	类型	说明
200 OK	Assignment	确定
Other Status Codes	CloudError	描述操作失败原因的错误响应

安全性

azure_auth

Azure Active Directory OAuth2 流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Get security standardAssignments by by specific standardAssignmentId

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.Security/assignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2021-08-01-preview

Sample Response

Status code:: 200

{
  "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.Security/assignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/assignments",
  "location": "East US",
  "etag": "etag value",
  "properties": {
    "displayName": "ASC Default",
    "description": "Set of policies monitored by Azure Security Center for cross cloud",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/Standards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Exempt",
    "expiresOn": "2022-05-01T19:50:47.083633Z",
    "additionalData": {
      "exemptionCategory": "waiver"
    },
    "metadata": {
      "ticketId": 12345
    },
    "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/ResourceGroup/rg"
  },
  "systemData": {
    "createdBy": "user@contoso.com",
    "createdByType": "User",
    "createdAt": "2021-08-31T13:47:50.328Z",
    "lastModifiedBy": "user@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-31T13:47:50.328Z"
  }
}

定义

名称	说明
AdditionalData	有关分配的其他数据
AssignedComponentItem	描述按密钥) (的安全评估对象引用的属性
AssignedStandardItem	描述安全标准对象引用的的属性
Assignment	在给定范围内对资源组进行安全分配
CloudError	对所有 Azure 资源管理器 API 的常见错误响应，可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。
CloudErrorBody	错误详细信息。
createdByType	创建资源的标识类型。
ErrorAdditionalInfo	资源管理错误附加信息。
systemData	与资源的创建和上次修改相关的元数据。

AdditionalData

有关分配的其他数据

名称	类型	说明
exemptionCategory	string	此分配的豁免类别

AssignedComponentItem

描述按密钥) (的安全评估对象引用的属性

名称	类型	说明
key	string	安全评估对象的唯一键

AssignedStandardItem

描述安全标准对象引用的的属性

名称	类型	说明
id	string	Microsoft.Security/standard 对象的 full resourceId

Assignment

在给定范围内对资源组进行安全分配

名称	类型	说明
etag	string	实体标记用于比较同一请求资源中的两个或多个实体。
id	string	资源 ID
kind	string	资源的种类
location	string	存储资源的位置
name	string	资源名称
properties.additionalData	AdditionalData	有关分配的其他数据
properties.assignedComponent	AssignedComponentItem	在给定范围内，具有应用于此标准分配的键的组件项
properties.assignedStandard	AssignedStandardItem	在给定范围内将键应用于此标准分配的标准项
properties.description	string	standardAssignment 的说明
properties.displayName	string	standardAssignment 的显示名称
properties.effect	string	此分配的预期效果 (禁用/豁免/等)
properties.expiresOn	string	此分配的到期日期为完整的 ISO 日期
properties.metadata	object	分配元数据。元数据是一个开放式对象，通常是键值对的集合。
properties.scope	string	standardAssignment 应用的范围 - 可以是订阅路径，也可以是该订阅下的资源组
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	描述资源的键值对的列表。
type	string	资源类型

CloudError

对所有 Azure 资源管理器 API 的常见错误响应，可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。

名称	类型	说明
error.additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
error.code	string	错误代码。
error.details	CloudErrorBody[]	错误详细信息。
error.message	string	错误消息。
error.target	string	错误目标。

CloudErrorBody

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	CloudErrorBody[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

createdByType

创建资源的标识类型。

名称	类型	说明
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

systemData

与资源的创建和上次修改相关的元数据。

名称	类型	说明
createdAt	string	资源创建时间戳 (UTC) 。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识类型。
lastModifiedAt	string	资源上次修改的时间戳 (UTC)
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识类型。

通过