Assessments Metadata - Get In Subscription

  • リファレンス
Service:
Defender for Cloud
API Version:
2020-01-01

特定のサブスクリプションの評価の種類に関するメタデータ情報を取得する

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata/{assessmentMetadataName}?api-version=2020-01-01

URI パラメーター

名前 / 必須 型 説明
assessmentMetadataName
 path True

string

評価キー - 評価の種類の一意キー
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

SecurityAssessmentMetadata

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 assessment metadata for subscription

Sample Request

GET https://management.azure.com/subscriptions/0980887d-03d6-408c-9566-532f3456804e/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01

Sample Response

Status code:
200 
{
  "id": "/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b",
  "name": "21300918-b2e3-0346-785f-c77ff57d243b",
  "type": "Microsoft.Security/assessmentMetadata",
  "properties": {
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/26a828e1-e88f-464e-bbb3-c134a282b9de",
    "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
    "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "BuiltIn"
  }
}

定義

名前 説明
assessmentType

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

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

エラーの詳細。
ErrorAdditionalInfo

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

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

セキュリティ評価メタデータ
SecurityAssessmentMetadataPartnerData

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

評価の重大度レベル
threats
userImpact

評価のユーザーへの影響

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 に接続した場合に、検証済みのサード パーティによって作成された評価

categories

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

追加情報の種類。

implementationEffort

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

名前 型 説明
High

string

Low

string

Moderate

string

SecurityAssessmentMetadata

セキュリティ評価メタデータ

名前 型 説明
id

string

リソース ID
name

string

リソース名
properties.assessmentType

assessmentType

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

categories[]

評価が異常な場合に危険にさらされるリソースのカテゴリ
properties.description

string

評価の人間が判読できる説明
properties.displayName

string

評価のわかりやすい表示名
properties.implementationEffort

implementationEffort

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

SecurityAssessmentMetadataPartnerData

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

string

この評価の計算を有効にするポリシー定義の Azure リソース ID
properties.preview

boolean

True の 場合、この評価は、プレビュー リリースの状態です。
properties.remediationDescription

string

このセキュリティの問題を軽減するために行うべきことを人間が判読できる説明
properties.severity

severity

評価の重大度レベル
properties.threats

threats[]

評価の脅威への影響
properties.userImpact

userImpact

評価のユーザーへの影響
type

string

リソースの種類

SecurityAssessmentMetadataPartnerData

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

名前 型 説明
partnerName

string

パートナーの会社の名前
productName

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