Assessments - Get

リファレンス

Service:: Defender for Cloud

API Version:: 2020-01-01

スキャンしたリソースのセキュリティ評価を取得する

GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01

With optional parameters:

GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01&$expand={$expand}

URI パラメーター

名前	/	必須	型	説明
assessmentName	path	True	string	評価キー - 評価の種類の一意キー
resourceId	path	True	string	リソースの識別子。
api-version	query	True	string	操作の API バージョン
$expand	query		ExpandEnum	OData 展開。省略可能。

応答

名前	型	説明
200 OK	SecurityAssessment	OK
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 recommendation task from security data location

Get security recommendation task from security data location with expand parameter

Get security recommendation task from security data location

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
  "name": "21300918-b2e3-0346-785f-c77ff57d243b",
  "type": "Microsoft.Security/assessments",
  "properties": {
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
    },
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "status": {
      "code": "NotApplicable",
      "cause": "OffByPolicy",
      "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on"
    },
    "additionalData": {
      "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
    }
  }
}

Get security recommendation task from security data location with expand parameter

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01&$expand=links

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
  "name": "21300918-b2e3-0346-785f-c77ff57d243b",
  "type": "Microsoft.Security/assessments",
  "properties": {
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
    },
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "status": {
      "code": "NotApplicable",
      "cause": "OffByPolicy",
      "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on"
    },
    "additionalData": {
      "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
    },
    "links": {
      "azurePortalUri": "https://www.portal.azure.com/?fea#blade/Microsoft_Azure_Security/RecommendationsBlade/assessmentKey/21300918-b2e3-0346-785f-c77ff57d243b"
    }
  }
}

定義

名前	説明
AssessmentLinks	評価に関連するリンク
AssessmentStatus	評価の結果
AssessmentStatusCode	評価の状態のプログラムコード
assessmentType	組み込みのAzure Policy定義に基づく評価の場合は BuiltIn、カスタム Azure Policy定義に基づく評価の場合は Custom
AzureResourceDetails	評価された Azure リソースの詳細
categories
CloudError	失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは、OData エラー応答形式にも従います)。
CloudErrorBody	エラーの詳細。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ExpandEnum	OData 展開。省略可能。
implementationEffort	この評価を修復するために必要な実装作業
OnPremiseResourceDetails	評価されたオンプレミスリソースの詳細
OnPremiseSqlResourceDetails	評価されたオンプレミス Sql リソースの詳細
SecurityAssessment	リソースのセキュリティ評価
SecurityAssessmentMetadataPartnerData	評価を作成したパートナーについて説明します
SecurityAssessmentMetadataProperties	評価メタデータのプロパティについて説明します。
SecurityAssessmentPartnerData	サードパーティのパートナー統合に関するデータ
severity	評価の重大度レベル
threats
userImpact	評価のユーザーへの影響

AssessmentLinks

評価に関連するリンク

名前	型	説明
azurePortalUri	string	Azure Portal での評価へのリンク

AssessmentStatus

評価の結果

名前	型	説明
cause	string	評価状態の原因のプログラムコード
code	AssessmentStatusCode	評価の状態のプログラムコード
description	string	人間が判読できる評価状態の説明

AssessmentStatusCode

評価の状態のプログラムコード

名前	型	説明
Healthy	string	リソースが正常である
NotApplicable	string	このリソースの評価は行われませんでした
Unhealthy	string	リソースに対処する必要があるセキュリティの問題がある

assessmentType

組み込みのAzure Policy定義に基づく評価の場合は BuiltIn、カスタム Azure Policy定義に基づく評価の場合は Custom

名前	型	説明
BuiltIn	string	クラウド管理評価のMicrosoft Defender
CustomPolicy	string	Azure Policyから Microsoft Defender for Cloud に自動的に取り込まれるユーザー定義ポリシー
CustomerManaged	string	ユーザーまたはその他の第三者によってクラウドのMicrosoft Defenderに直接プッシュされたユーザー評価
VerifiedPartner	string	ユーザーが ASC に接続した場合に、検証済みのサードパーティによって作成された評価

AzureResourceDetails

評価された Azure リソースの詳細

名前	型	説明
id	string	評価されたリソースの Azure リソース ID
source	string: Azure	評価されたリソースが存在するプラットフォーム

名前	型	説明
Compute	string
Data	string
IdentityAndAccess	string
IoT	string
Networking	string

CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager 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	エラーのターゲット。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ExpandEnum

OData 展開。省略可能。

名前	型	説明
links	string	評価に関連付けられているすべてのリンク
metadata	string	評価メタデータ

implementationEffort

この評価を修復するために必要な実装作業

名前	型	説明
High	string
Low	string
Moderate	string

OnPremiseResourceDetails

評価されたオンプレミスリソースの詳細

名前	型	説明
machineName	string	マシンの名前
source	string: OnPremise	評価されたリソースが存在するプラットフォーム
sourceComputerId	string	マシンにインストールされている oms エージェント ID
vmuuid	string	マシンの一意の ID
workspaceId	string	マシンがアタッチされているワークスペースの Azure リソース ID

OnPremiseSqlResourceDetails

評価されたオンプレミス Sql リソースの詳細

名前	型	説明
databaseName	string	マシンにインストールされている Sql データベース名
machineName	string	マシンの名前
serverName	string	マシンにインストールされている Sql Server 名
source	string: OnPremiseSql	評価されたリソースが存在するプラットフォーム
sourceComputerId	string	マシンにインストールされている oms エージェント ID
vmuuid	string	マシンの一意の ID
workspaceId	string	マシンがアタッチされているワークスペースの Azure リソース ID

SecurityAssessment

リソースのセキュリティ評価

名前	型	説明
id	string	リソース ID
name	string	リソース名
properties.additionalData	object	評価に関する追加データ
properties.displayName	string	評価のわかりやすい表示名
properties.links	AssessmentLinks	評価に関連するリンク
properties.metadata	SecurityAssessmentMetadataProperties	評価メタデータのプロパティについて説明します。
properties.partnersData	SecurityAssessmentPartnerData	サードパーティのパートナー統合に関するデータ
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	評価されたリソースの詳細
properties.status	AssessmentStatus	評価の結果
type	string	リソースの種類

SecurityAssessmentMetadataPartnerData

評価を作成したパートナーについて説明します

名前	型	説明
partnerName	string	パートナーの会社の名前
productName	string	評価を作成したパートナーの製品の名前
secret	string	パートナーを認証し、評価が作成されたことを確認するためのシークレット - 書き込み専用

SecurityAssessmentMetadataProperties

評価メタデータのプロパティについて説明します。

名前	型	説明
assessmentType	assessmentType	組み込みのAzure Policy定義に基づく評価の場合は BuiltIn、カスタム Azure Policy定義に基づく評価の場合は Custom
categories	categories[]	評価が異常な場合に危険にさらされるリソースのカテゴリ
description	string	評価の人間が判読できる説明
displayName	string	評価のわかりやすい表示名
implementationEffort	implementationEffort	この評価を修復するために必要な実装作業
partnerData	SecurityAssessmentMetadataPartnerData	評価を作成したパートナーについて説明します
policyDefinitionId	string	この評価の計算を有効にするポリシー定義の Azure リソース ID
preview	boolean	True の場合、この評価は、プレビューリリースの状態です。
remediationDescription	string	このセキュリティの問題を軽減するために行うべきことを人間が判読できる説明
severity	severity	評価の重大度レベル
threats	threats[]	評価の脅威への影響
userImpact	userImpact	評価のユーザーへの影響

SecurityAssessmentPartnerData

サードパーティのパートナー統合に関するデータ

名前	型	説明
partnerName	string	パートナーの会社の名前
secret	string	パートナーを認証するためのシークレット - 書き込み専用

severity

評価の重大度レベル

名前	型	説明
High	string
Low	string
Medium	string

threats

名前	型	説明
accountBreach	string
dataExfiltration	string
dataSpillage	string
denialOfService	string
elevationOfPrivilege	string
maliciousInsider	string
missingCoverage	string
threatResistance	string

userImpact

評価のユーザーへの影響

名前	型	説明
High	string
Low	string
Moderate	string

次の方法で共有

Assessments - Get

URI パラメーター

応答

セキュリティ

azure_auth

Scopes

例

Get security recommendation task from security data location

Sample Request

Sample Response

Get security recommendation task from security data location with expand parameter

Sample Request

Sample Response

定義

AssessmentLinks

AssessmentStatus

AssessmentStatusCode

assessmentType

AzureResourceDetails

categories

CloudError

CloudErrorBody

ErrorAdditionalInfo

ExpandEnum

implementationEffort

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecurityAssessment

SecurityAssessmentMetadataPartnerData

SecurityAssessmentMetadataProperties

SecurityAssessmentPartnerData

severity

threats

userImpact

その他のリソース