Assessments - Get

リファレンス

サービス:: Defender for Cloud

API バージョン:: 2020-01-01

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

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

省略可能なパラメーターを含む:

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	わかりました
Other Status Codes	CloudError	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
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

要求のサンプル

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

応答のサンプル

状態コード:: 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

要求のサンプル

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

応答のサンプル

状態コード:: 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

Object

評価に関連するリンク

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

AssessmentStatus

Object

評価の結果

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

AssessmentStatusCode

列挙

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

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

assessmentType

列挙

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

値	説明
BuiltIn	Microsoft Defender for Cloud マネージド評価
CustomPolicy	Azure Policy から Microsoft Defender for Cloud に自動的に取り込まれるユーザー定義ポリシー
CustomerManaged	ユーザーまたは他のサードパーティによって Microsoft Defender for Cloud に直接プッシュされたユーザー評価
VerifiedPartner	ユーザーが ASC に接続した場合に、検証済みのサードパーティによって作成された評価

AzureResourceDetails

Object

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

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

値	説明
Compute
Data
IdentityAndAccess
IoT
Networking

CloudError

Object

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。

名前	型	説明
error.additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
error.code	string	エラーコード。
error.details	CloudErrorBody[]	エラーの詳細。
error.message	string	エラーメッセージ。
error.target	string	エラーターゲット。

CloudErrorBody

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	CloudErrorBody[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorAdditionalInfo

Object

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

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

ExpandEnum

列挙

OData 展開。任意

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

implementationEffort

列挙

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

値	説明
High
Low
Moderate

OnPremiseResourceDetails

Object

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

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

OnPremiseSqlResourceDetails

Object

評価されたオンプレミス 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

Object

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

名前	型	説明
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

Object

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

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

SecurityAssessmentMetadataProperties

Object

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

名前	型	説明
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

Object

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

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

severity

列挙

評価の重大度レベル

値	説明
High
Low
Medium

threats

列挙

値	説明
accountBreach
dataExfiltration
dataSpillage
denialOfService
elevationOfPrivilege
maliciousInsider
missingCoverage
threatResistance

userImpact

列挙

評価のユーザーへの影響

値	説明
High
Low
Moderate

次の方法で共有

Assessments - Get

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

Get security recommendation task from security data location

要求のサンプル

応答のサンプル

Get security recommendation task from security data location with expand parameter

要求のサンプル

応答のサンプル

定義

AssessmentLinks

AssessmentStatus

AssessmentStatusCode

assessmentType

AzureResourceDetails

categories

CloudError

CloudErrorBody

ErrorAdditionalInfo

ExpandEnum

implementationEffort

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecurityAssessment

SecurityAssessmentMetadataPartnerData

SecurityAssessmentMetadataProperties

SecurityAssessmentPartnerData

severity

threats

userImpact

その他のリソース