Assessments Metadata - Create In Subscription

リファレンス

サービス:: Defender for Cloud

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

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

PUT 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 pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$	Azure サブスクリプション ID
api-version	query	True	string	操作の API バージョン

要求本文

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

応答

名前	型	説明
200 OK	SecurityAssessmentMetadata	わかりました
Other Status Codes	CloudError	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Create security assessment metadata for subscription

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/0980887d-03d6-408c-9566-532f3456804e/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7?api-version=2020-01-01

{
  "properties": {
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "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": "CustomerManaged"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7",
  "name": "ca039e75-a276-4175-aebc-bcd41e4b14b7",
  "type": "Microsoft.Security/assessmentMetadata",
  "properties": {
    "displayName": "My organization security assessment",
    "description": "Assessment that my organization created to view our security assessment in Azure Security Center",
    "remediationDescription": "Fix it with these remediation instructions",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "CustomerManaged"
  }
}

定義

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

値	説明
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	追加情報の種類。

implementationEffort

列挙

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

値	説明
High
Low
Moderate

SecurityAssessmentMetadata

Object

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

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

Object

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

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

severity

列挙

評価の重大度レベル

値	説明
High
Low
Medium

threats

列挙

値	説明
accountBreach
dataExfiltration
dataSpillage
denialOfService
elevationOfPrivilege
maliciousInsider
missingCoverage
threatResistance

userImpact

列挙

評価のユーザーへの影響

値	説明
High
Low
Moderate

次の方法で共有

Assessments Metadata - Create In Subscription

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create security assessment metadata for subscription

要求のサンプル

応答のサンプル

定義

assessmentType

categories

CloudError

CloudErrorBody

ErrorAdditionalInfo

implementationEffort

SecurityAssessmentMetadata

SecurityAssessmentMetadataPartnerData

severity

threats

userImpact

その他のリソース