Recommendations - Get

Référence

Service:: Advisor

API Version:: 2023-01-01

Obtient les détails d’une recommandation mise en cache.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.Advisor/recommendations/{recommendationId}?api-version=2023-01-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
recommendationId	path	True	string	ID de recommandation.
resourceUri	path	True	string	L’identificateur complet d’Azure Resource Manager de la ressource à laquelle la recommandation s’applique.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.

Réponses

Nom	Type	Description
200 OK	ResourceRecommendationBase	OK. Obtenir avec succès le détail de la recommandation.
Other Status Codes	ArmErrorResponse	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

GetRecommendationDetail

Sample Request

HTTP

GET https://management.azure.com/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId?api-version=2023-01-01

Sample Response

Status code:: 200

{
  "id": "/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId",
  "name": "recommendationId",
  "properties": {
    "category": "Security",
    "impact": "Medium",
    "impactedField": "Microsoft.Compute/virtualMachines",
    "impactedValue": "armavset",
    "lastUpdated": "2017-02-24T22:24:43.3216408Z",
    "risk": "Warning",
    "shortDescription": {
      "problem": "Monitoring agent should be installed on your machines",
      "solution": "Monitoring agent should be installed on your machines"
    },
    "remediation": {
      "additionalProperties": {
        "httpMethod": "POST",
        "uri": "uri",
        "details": "link to document"
      }
    },
    "resourceMetadata": {
      "resourceId": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Compute/virtualMachines/xyz",
      "source": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Compute/virtualMachines/xyz/providers/Microsoft.Security/assessments/assessmentGuid",
      "action": {
        "additionalProperties": {
          "actionType": "Document",
          "link": "https://link3",
          "caption": "Enable Soft Delete to protect blob data",
          "description": "Enable Soft Delete to protect blob data"
        },
        "metadata": {
          "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Compute/virtualMachines/xyz"
        }
      },
      "singular": "Virtual machine",
      "plural": "Virtual machines"
    },
    "actions": [
      {
        "additionalProperties": {
          "actionType": "Document",
          "link": "https://link1",
          "caption": "Enable Soft Delete to protect blob data",
          "description": "Enable Soft Delete to protect blob data"
        },
        "metadata": {
          "id": "/subscriptions/subscriptionId"
        }
      }
    ],
    "description": "After enabling Soft Delete, deleted data transitions to a soft deleted state instead of being permanently deleted. When data is overwritten, a soft deleted snapshot is generated to save the state of the overwritten data. You can configure the amount of time soft deleted data is recoverable before it permanently expires.",
    "label": "Enable Soft Delete",
    "learnMoreLink": "https://link2",
    "potentialBenefits": "Save and recover your data when blobs or blob snapshots are accidentally overwritten or deleted"
  },
  "type": "Microsoft.Advisor/recommendations"
}

Définitions

Nom	Description
ArmErrorResponse
ARMErrorResponseBody	Corps de réponse d’erreur ARM.
category	Catégorie de la recommandation.
createdByType	Type d’identité qui a créé la ressource.
impact	Impact de la recommandation sur l’entreprise.
ResourceMetadata	Métadonnées de ressource de recommandation
ResourceRecommendationBase	Recommandation advisor.
risk	Risque potentiel de ne pas mettre en œuvre la recommandation.
ShortDescription	Résumé de la recommandation.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

ArmErrorResponse

Nom	Type	Description
error	ARMErrorResponseBody	Corps de réponse d’erreur ARM.

ARMErrorResponseBody

Corps de réponse d’erreur ARM.

Nom	Type	Description
code	string	Obtient ou définit la chaîne qui peut être utilisée pour identifier l’erreur par programmation.
message	string	Obtient ou définit la chaîne qui décrit l’erreur en détail et fournit des informations de débogage.

Nom	Type	Description
Cost	string
HighAvailability	string
OperationalExcellence	string
Performance	string
Security	string

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

impact

Impact de la recommandation sur l’entreprise.

Nom	Type	Description
High	string
Low	string
Medium	string

ResourceMetadata

Métadonnées de ressource de recommandation

Nom	Type	Description
action	object	Action permettant d’afficher la ressource.
plural	string	Nom convivial pluriel du type de ressource. par exemple : machines virtuelles
resourceId	string	ID de ressource Azure de la ressource évaluée
singular	string	Nom convivial unique du type de ressource. par exemple : machine virtuelle
source	string	Source à partir de laquelle la recommandation est générée

ResourceRecommendationBase

Recommandation advisor.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	nom de la ressource.
properties.actions	object[]	Liste des actions recommandées pour implémenter la recommandation.
properties.category	category	Catégorie de la recommandation.
properties.description	string	Description détaillée de la recommandation.
properties.exposedMetadataProperties	object	Propriétés de métadonnées de recommandation exposées au client pour fournir des informations supplémentaires.
properties.extendedProperties	object	Propriétés étendues
properties.impact	impact	Impact de la recommandation sur l’entreprise.
properties.impactedField	string	Type de ressource identifié par Advisor.
properties.impactedValue	string	Ressource identifiée par Advisor.
properties.label	string	Étiquette de recommandation.
properties.lastUpdated	string	L’heure la plus récente où Advisor a vérifié la validité de la recommandation.
properties.learnMoreLink	string	Lien pour en savoir plus sur la logique de recommandation et de génération.
properties.metadata	object	Métadonnées de recommandation.
properties.potentialBenefits	string	L’avantage potentiel de la mise en œuvre de la recommandation.
properties.recommendationTypeId	string	GUID de type recommandation.
properties.remediation	object	Méthode automatisée pour appliquer la recommandation.
properties.resourceMetadata	ResourceMetadata	Métadonnées de ressource évaluées
properties.risk	risk	Risque potentiel de ne pas mettre en œuvre la recommandation.
properties.shortDescription	ShortDescription	Résumé de la recommandation.
properties.suppressionIds	string[]	Liste des règles ignorées et ignorées pour la recommandation.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

risk

Risque potentiel de ne pas mettre en œuvre la recommandation.

Nom	Type	Description
Error	string
None	string
Warning	string

ShortDescription

Résumé de la recommandation.

Nom	Type	Description
problem	string	Problème ou opportunité identifié par la recommandation et la solution proposée.
solution	string	Problème ou opportunité identifié par la recommandation et la solution proposée.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la dernière ressource.
lastModifiedByType	createdByType	Type d’identité qui a modifié la dernière ressource.