共用方式為

Security Standards - List

  • 參考
服務:
Defender for Cloud
API 版本:
2024-08-01

取得範圍中所有相關安全性標準的清單

GET https://management.azure.com/{scope}/providers/Microsoft.Security/securityStandards?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

SecurityStandardList

依範圍列出安全性標準清單
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 security standards by management group scope
List security standards by security connector scope
List security standards by subscription scope

List security standards by management group scope

範例要求

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards?api-version=2024-08-01

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 1",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "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": "providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/155afdf9-d239-4a5c-847f-89da613e7143",
      "name": "155afdf9-d239-4a5c-847f-89da613e7143",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 2",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "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"
        }
      }
    }
  ]
}

List security standards by security connector scope

範例要求

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

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 1",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "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/securityStandards/155afdf9-d239-4a5c-847f-89da613e7143",
      "name": "155afdf9-d239-4a5c-847f-89da613e7143",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 2",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "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"
        }
      }
    }
  ]
}

List security standards by subscription scope

範例要求

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

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 1",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "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/providers/Microsoft.Security/securityStandards/155afdf9-d239-4a5c-847f-89da613e7143",
      "name": "155afdf9-d239-4a5c-847f-89da613e7143",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 2",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "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
ErrorAdditionalInfo

資源管理錯誤其他資訊。
ErrorDetail

錯誤詳細數據。
ErrorResponse

錯誤回應
PartialAssessmentProperties

描述與標準相關的評量屬性
SecurityStandard

資源的安全性標準
SecurityStandardList

標準清單的頁面
StandardMetadata

標準元數據
StandardSupportedCloud

支援標準的雲端。
standardType

標準類型（僅限自定義或預設或合規性目前）

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。
type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。
code

string

錯誤碼。
details

ErrorDetail[]

錯誤詳細數據。
message

string

錯誤訊息。
target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

PartialAssessmentProperties

描述與標準相關的評量屬性

名稱 類型 Description
assessmentKey

string

評定金鑰

SecurityStandard

資源的安全性標準

名稱 類型 Description
id

string

資源標識碼
name

string

資源名稱
properties.assessments

PartialAssessmentProperties[]

要套用至標準範圍的評定金鑰清單。
properties.cloudProviders

StandardSupportedCloud[]

所有標準支援的雲端清單。
properties.description

string

標準的描述
properties.displayName

string

標準顯示名稱，相當於 standardId
properties.metadata

StandardMetadata

安全性標準元數據。
properties.policySetDefinitionId

string

與標準相關聯的原則集定義標識碼。
properties.standardType

standardType

標準類型（僅限自定義或預設或合規性目前）
type

string

資源類型

SecurityStandardList

標準清單的頁面

名稱 類型 Description
nextLink

string

要擷取下一頁的 URI
value

SecurityStandard[]

此頁面中的標準集合

StandardMetadata

標準元數據

名稱 類型 Description
createdBy

string

標準 由物件識別碼建立 （GUID）
createdOn

string

標準建立日期
lastUpdatedBy

string

物件識別碼上次更新的標準 （GUID）
lastUpdatedOn

string

標準上次更新日期

StandardSupportedCloud

支援標準的雲端。

名稱 類型 Description
AWS

string

Azure

string

GCP

string

standardType

標準類型（僅限自定義或預設或合規性目前）

名稱 類型 Description
Compliance

string

Custom

string

Default

string