Iot Recommendations - List
Enumeración de recomendaciones de IoT
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions/{solutionName}/iotRecommendations?api-version=2019-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions/{solutionName}/iotRecommendations?api-version=2019-08-01&recommendationType={recommendationType}&deviceId={deviceId}&$limit={$limit}&$skipToken={$skipToken}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre distingue mayúsculas de minúsculas. Regex pattern: |
solution
|
path | True |
string |
Nombre de la solución de seguridad de IoT. |
subscription
|
path | True |
string |
Identificador de suscripción de Azure Regex pattern: |
api-version
|
query | True |
string |
Versión de API para la operación |
$limit
|
query |
integer int32 |
Limitar el número de elementos devueltos en una sola página |
|
$skip
|
query |
string |
Omitir token usado para la paginación |
|
device
|
query |
string |
Filtrar por identificador de dispositivo |
|
recommendation
|
query |
string |
Filtrar por tipo de recomendación |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
Get IoT Recommendations
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myGroup/providers/Microsoft.Security/iotSecuritySolutions/mySolution/iotRecommendations?api-version=2019-08-01&recommendationType=IoT_Baseline&deviceId=device-1&$limit=1
Sample Response
{
"value": [
{
"name": "IoT_Baseline|device-1",
"properties": {
"recommendationType": "IoT_Baseline",
"deviceId": "device-1",
"discoveredTimeUtc": "2020-05-13T06:32:25Z",
"recommendationAdditionalData": {
"SnapshotId": "48519d58-4e35-46cd-aed5-6251af95ed50",
"TotalFailedRules": "7",
"TotalRulesFailedDuoToError": "1",
"TotalInformationalFailedRules": "2",
"TotalCriticalFailedRules": "3",
"TotalWarningFailedRules": "1"
}
}
}
],
"nextLink": "https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myGroup/providers/Microsoft.Security/iotSecuritySolutions/mySolution/iotRecommendations?api-version=2019-08-01&recommendationType=IoT_Baseline&deviceId=device-1&$limit=1&$skipToken=903e76ff-17eb-4bac-ac8a-2bc31ab68fd8",
"totalCount": 23
}
Definiciones
Nombre | Description |
---|---|
Cloud |
Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData). |
Cloud |
Detalle del error. |
Error |
Información adicional sobre el error de administración de recursos. |
Iot |
Recomendación de IoT |
Iot |
Lista de recomendaciones de IoT |
CloudError
Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).
Nombre | Tipo | Description |
---|---|---|
error.additionalInfo |
Información adicional del error. |
|
error.code |
string |
Código de error. |
error.details |
Los detalles del error. |
|
error.message |
string |
El mensaje de error. |
error.target |
string |
Destino del error. |
CloudErrorBody
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
IotRecommendation
Recomendación de IoT
Nombre | Tipo | Description |
---|---|---|
id |
string |
Id. de recurso |
name |
string |
Nombre del recurso |
properties.deviceId |
string |
Identificador del dispositivo en el que se notifica |
properties.discoveredTimeUtc |
string |
Hora de detección de la recomendación |
properties.recommendationAdditionalData |
object |
Un contenedor de campos que amplía la información de recomendación |
properties.recommendationType |
string |
Nombre de tipo de la recomendación |
type |
string |
Tipo de recurso |
IotRecommendationList
Lista de recomendaciones de IoT
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Cuando esté disponible, siga el URI para obtener la siguiente página de datos. |
totalCount |
integer |
Recuento total de recomendaciones que se ajustan a las opciones de filtro especificadas (no afectadas por el tamaño de página) |
value |
Enumerar datos |