Server Vulnerability Assessments Settings - Create Or Update
在订阅上创建或更新所请求类型的服务器漏洞评估设置
PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings/azureServersSetting?api-version=2023-05-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
setting
|
path | True |
服务器漏洞评估设置的类型 |
|
|
subscription
|
path | True |
string (uuid) |
目标订阅的 ID。 该值必须是 UUID。 |
|
api-version
|
query | True |
string minLength: 1 |
用于此操作的 API 版本。 |
请求正文
AzureServersSetting
定义范围内的 Azure 服务器上的漏洞评估设置。
| 名称 | 必需 | 类型 | 说明 |
|---|---|---|---|
| kind | True | string: |
服务器漏洞评估设置的类型。 |
| properties.selectedProvider | True |
定义的范围内的 Azure 服务器上的所选漏洞评估提供程序。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK | ServerVulnerabilityAssessmentsSetting: |
还行 |
| 201 Created | ServerVulnerabilityAssessmentsSetting: |
创建 |
| Other Status Codes |
描述操作失败原因的错误响应 |
安全性
azure_auth
Azure Active Directory OAuth2 流
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
| 名称 | 说明 |
|---|---|
| user_impersonation | 模拟用户帐户 |
示例
Set a server vulnerability assessments setting of the kind settingKind on the subscription
示例请求
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings/azureServersSetting?api-version=2023-05-01
{
"kind": "AzureServersSetting",
"properties": {
"selectedProvider": "MdeTvm"
}
}
示例响应
{
"id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings/azureServersSetting",
"name": "azureServersSetting",
"type": "Microsoft.Security/serverVulnerabilityAssessmentsSettings",
"kind": "AzureServersSetting",
"properties": {
"selectedProvider": "MdeTvm"
},
"systemData": {
"createdBy": "user@contoso.com",
"createdByType": "User",
"createdAt": "2022-01-12T13:47:50.328Z",
"lastModifiedBy": "user@contoso.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-01-12T13:47:50.328Z"
}
}
{
"id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/serverVulnerabilityAssessmentsSettings/azureServersSetting",
"name": "azureServersSetting",
"type": "Microsoft.Security/serverVulnerabilityAssessmentsSettings",
"kind": "AzureServersSetting",
"properties": {
"selectedProvider": "MdeTvm"
},
"systemData": {
"createdBy": "user@contoso.com",
"createdByType": "User",
"createdAt": "2023-05-12T13:47:50.328Z",
"lastModifiedBy": "user@contoso.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2023-05-12T13:47:50.328Z"
}
}
定义
| 名称 | 说明 |
|---|---|
|
Azure |
定义范围内的 Azure 服务器上的漏洞评估设置。 |
|
created |
创建资源的标识的类型。 |
|
Error |
资源管理错误附加信息。 |
|
Error |
错误详细信息。 |
|
Error |
错误响应 |
|
Server |
定义的范围内的 Azure 服务器上的所选漏洞评估提供程序。 |
|
Server |
服务器漏洞评估设置的类型 |
|
Server |
服务器漏洞评估设置的类型 |
|
system |
与创建和上次修改资源相关的元数据。 |
AzureServersSetting
定义范围内的 Azure 服务器上的漏洞评估设置。
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string (arm-id) |
资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| kind | string: |
服务器漏洞评估设置的类型。 |
| name |
string |
资源的名称 |
| properties.selectedProvider |
定义的范围内的 Azure 服务器上的所选漏洞评估提供程序。 |
|
| systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
| type |
string |
资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
createdByType
创建资源的标识的类型。
| 值 | 说明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
错误详细信息。 |
|
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
ServerVulnerabilityAssessmentsAzureSettingSelectedProvider
定义的范围内的 Azure 服务器上的所选漏洞评估提供程序。
| 值 | 说明 |
|---|---|
| MdeTvm |
Microsoft Defender for Endpoints 威胁和漏洞管理。 |
ServerVulnerabilityAssessmentsSettingKind
服务器漏洞评估设置的类型
| 值 | 说明 |
|---|---|
| AzureServersSetting |
ServerVulnerabilityAssessmentsSettingKindName
服务器漏洞评估设置的类型
| 值 | 说明 |
|---|---|
| azureServersSetting |
systemData
与创建和上次修改资源相关的元数据。
| 名称 | 类型 | 说明 |
|---|---|---|
| createdAt |
string (date-time) |
资源创建时间戳(UTC)。 |
| createdBy |
string |
创建资源的标识。 |
| createdByType |
创建资源的标识的类型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的资源时间戳(UTC) |
| lastModifiedBy |
string |
上次修改资源的标识。 |
| lastModifiedByType |
上次修改资源的标识的类型。 |