你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Iot Recommendation Types - Get

获取 IoT 建议类型

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions/{solutionName}/iotRecommendationTypes/{iotRecommendationTypeName}?api-version=2019-08-01

URI 参数

名称 必需 类型 说明
iotRecommendationTypeName
path True

string

建议类型的名称

resourceGroupName
path True

string

用户订阅中的资源组的名称。 此名称不区分大小写。

Regex pattern: ^[-\w\._\(\)]+$

solutionName
path True

string

IoT 安全解决方案的名称。

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

IotRecommendationType

IoT 建议类型

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 IoT Recommendation Type

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myGroup/providers/Microsoft.Security/iotSecuritySolutions/mySolution/iotRecommendationTypes/IoT_VulnerableTLSCipherSuite?api-version=2019-08-01

Sample Response

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myGroup/providers/Microsoft.Security/iotSecuritySolutions/mySolution/iotRecommendationTypes/IoT_VulnerableTLSCipherSuite",
  "name": "IoT_VulnerableTLSCipherSuite",
  "type": "Microsoft.Security/iotSecuritySolutions/iotRecommendationTypes",
  "properties": {
    "recommendationDisplayName": "TLS cipher suite upgrade needed",
    "severity": "Medium",
    "description": "Insecure TLS configurations detected. Immediate TLS cipher suite upgrade recommended.",
    "remediationSteps": [
      "Upgrade your TLS cipher suite to a secure configuration. See the Guide to TLS Standards Compliance for more information."
    ],
    "vendorName": "Microsoft",
    "control": "Communication between device and IoT Hub is not optimized",
    "productName": "Azure Security Center for IoT",
    "productComponentName": "IoT Hub"
  }
}

定义

名称 说明
CloudError

对所有 Azure 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。

CloudErrorBody

错误详细信息。

ErrorAdditionalInfo

资源管理错误附加信息。

IotRecommendationType

IoT 建议类型。

recommendationSeverity

建议的严重性

CloudError

对所有 Azure 资源管理器 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

其他信息类型。

IotRecommendationType

IoT 建议类型。

名称 类型 说明
id

string

资源 ID

name

string

资源名称

properties.control

string

建议的控件类别的名称

properties.dataSource

string

警报的数据源

properties.description

string

可疑漏洞和含义的说明。

properties.productComponentName

string

生成建议的产品中的组件的名称

properties.productName

string

发布此建议的产品的名称

properties.recommendationDisplayName

string

建议的显示名称

properties.remediationSteps

string[]

要执行的手动操作项来解决建议

properties.severity

recommendationSeverity

建议的严重性

properties.vendorName

string

提出建议的供应商的名称

type

string

资源类型

recommendationSeverity

建议的严重性

名称 类型 说明
Healthy

string

High

string

Low

string

Medium

string

NotApplicable

string

OffByPolicy

string

Unknown

string