你当前正在访问 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 参数

Name In Required Type Description
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 版本

响应

Name Type Description
200 OK

IoT 建议类型

Other Status Codes

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
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 错误响应格式.) 。

Name Type Description
error.additionalInfo

错误附加信息。

error.code
  • string

错误代码。

error.details

错误详细信息。

error.message
  • string

错误消息。

error.target
  • string

错误目标。

CloudErrorBody

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

IotRecommendationType

IoT 建议类型。

Name Type Description
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

建议的严重性

Name Type Description
Healthy
  • string
High
  • string
Low
  • string
Medium
  • string
NotApplicable
  • string
OffByPolicy
  • string
Unknown
  • string