你当前正在访问 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 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
iot
|
path | True |
string |
建议类型的名称 |
resource
|
path | True |
string |
用户订阅中的资源组的名称。 此名称不区分大小写。 Regex pattern: |
solution
|
path | True |
string |
IoT 安全解决方案的名称。 |
subscription
|
path | True |
string |
Azure 订阅 ID Regex pattern: |
api-version
|
query | True |
string |
操作的 API 版本 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
IoT 建议类型 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
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"
}
}
定义
名称 | 说明 |
---|---|
Cloud |
对所有 Azure 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。 |
Cloud |
错误详细信息。 |
Error |
资源管理错误附加信息。 |
Iot |
IoT 建议类型。 |
recommendation |
建议的严重性 |
CloudError
对所有 Azure 资源管理器 API 的常见错误响应,可返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式.) 。
名称 | 类型 | 说明 |
---|---|---|
error.additionalInfo |
错误附加信息。 |
|
error.code |
string |
错误代码。 |
error.details |
错误详细信息。 |
|
error.message |
string |
错误消息。 |
error.target |
string |
错误目标。 |
CloudErrorBody
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
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 |
建议的严重性 |
|
properties.vendorName |
string |
提出建议的供应商的名称 |
type |
string |
资源类型 |
recommendationSeverity
建议的严重性
名称 | 类型 | 说明 |
---|---|---|
Healthy |
string |
|
High |
string |
|
Low |
string |
|
Medium |
string |
|
NotApplicable |
string |
|
OffByPolicy |
string |
|
Unknown |
string |