Standard Assignments - List

參考

服務:: Defender for Cloud

API 版本:: 2024-08-01

取得範圍中所有相關標準指派的清單

GET https://management.azure.com/{scope}/providers/Microsoft.Security/standardAssignments?api-version=2024-08-01

URI 參數

名稱	位於	必要	類型	Description
scope	path	True	string	標準指派的範圍。有效範圍包括：管理群組（格式：'providers/Microsoft.Management/managementGroups/{managementGroup}'）、訂用帳戶（格式：'subscriptions/{subscriptionId}'），或安全性連接器（格式：'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}）'
api-version	query	True	string	要用於這項作業的 API 版本。

回應

名稱	類型	Description
200 OK	StandardAssignmentsList	依範圍的標準指派清單
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

List standard assignments

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/standardAssignments?api-version=2024-08-01


/**
 * Samples for StandardAssignments List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/StandardAssignments/
     * ListStandardAssignments.json
     */
    /**
     * Sample code: List standard assignments.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listStandardAssignments(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.standardAssignments().list(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/standardAssignments",
      "properties": {
        "displayName": "ASC Default",
        "description": "Set of policies monitored by Azure Security Center for cross cloud",
        "assignedStandard": {
          "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
        },
        "effect": "Audit",
        "excludedScopes": [],
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a9",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/standardAssignments",
      "properties": {
        "displayName": "Test exemption",
        "description": "Exemption description",
        "assignedStandard": {
          "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
        },
        "effect": "Exempt",
        "expiresOn": "2022-05-01T19:50:47.083633Z",
        "exemptionData": {
          "exemptionCategory": "waiver",
          "assignedAssessment": {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          }
        },
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    }
  ]
}

定義

名稱	Description
AssignedAssessmentItem	描述安全性評估物件參考的屬性（依索引鍵）
AssignedStandardItem	描述標準指派對象參考的屬性
attestationComplianceState	此指派的證明類別
AttestationData	具有證明效果之指派的其他數據
AttestationEvidence	描述指派證明的屬性
effect	此指派的預期效果（稽核/豁免/證明）
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
exemptionCategory	此指派的豁免類別
ExemptionData	具有豁免效果之指派的其他數據
StandardAssignment	指定範圍上資源群組的安全性指派
StandardAssignmentMetadata	標準指派元數據
StandardAssignmentsList	標準指派清單的頁面

AssignedAssessmentItem

描述安全性評估物件參考的屬性（依索引鍵）

名稱	類型	Description
assessmentKey	string	安全性評估物件的唯一索引鍵

AssignedStandardItem

描述標準指派對象參考的屬性

名稱	類型	Description
id	string	Microsoft.Security/standard 物件的完整 resourceId

attestationComplianceState

此指派的證明類別

名稱	類型	Description
compliant	string
nonCompliant	string
unknown	string

AttestationData

具有證明效果之指派的其他數據

名稱	類型	Description
assignedAssessment	AssignedAssessmentItem	已套用至指定範圍之此標準指派的索引鍵元件專案
complianceDate	string	證明合規性日期
complianceState	attestationComplianceState	此指派的證明類別
evidence	AttestationEvidence[]	證明辨識項的連結陣列

AttestationEvidence

描述指派證明的屬性

名稱	類型	Description
description	string	辨識項的描述
sourceUrl	string	辨識項的來源 URL

effect

此指派的預期效果（稽核/豁免/證明）

名稱	類型	Description
Attest	string
Audit	string
Exempt	string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

exemptionCategory

此指派的豁免類別

名稱	類型	Description
mitigated	string
waiver	string

ExemptionData

具有豁免效果之指派的其他數據

名稱	類型	Description
assignedAssessment	AssignedAssessmentItem	已套用至指定範圍之此標準指派的索引鍵元件專案
exemptionCategory	exemptionCategory	此指派的豁免類別

StandardAssignment

指定範圍上資源群組的安全性指派

名稱	類型	Description
id	string	資源標識碼
name	string	資源名稱
properties.assignedStandard	AssignedStandardItem	已套用至指定範圍之此標準指派的索引鍵的標準專案
properties.attestationData	AttestationData	具有證明效果之指派的其他數據
properties.description	string	standardAssignment 的描述
properties.displayName	string	standardAssignment 的顯示名稱
properties.effect	effect	此指派的預期效果（稽核/豁免/證明）
properties.excludedScopes	string[]	排除的範圍，篩選出範圍的子系（在管理範圍上）
properties.exemptionData	ExemptionData	具有豁免效果之指派的其他數據
properties.expiresOn	string	此指派的到期日為完整 ISO 日期
properties.metadata	StandardAssignmentMetadata	標準指派元數據。
type	string	資源類型

StandardAssignmentMetadata

標準指派元數據

名稱	類型	Description
createdBy	string	由物件識別碼建立的標準指派（GUID）
createdOn	string	標準指派建立日期
lastUpdatedBy	string	物件識別碼上次更新的標準指派（GUID）
lastUpdatedOn	string	標準指派上次更新日期

StandardAssignmentsList

標準指派清單的頁面

名稱	類型	Description
nextLink	string	要擷取下一頁的 URI
value	StandardAssignment[]	此頁面中的 standardAssignments 集合

共用方式為