Recommendations - Get
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 |
---|---|---|---|---|
recommendation
|
path | True |
string |
ID de recommandation. |
resource
|
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 |
OK. Obtenir avec succès le détail de la recommandation. |
|
Other Status Codes |
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
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
GetRecommendationDetail
Exemple de requête
GET https://management.azure.com/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId?api-version=2023-01-01
Exemple de réponse
{
"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 |
---|---|
Arm |
|
ARMError |
Corps de réponse d’erreur ARM. |
category |
Catégorie de la recommandation. |
created |
Type d’identité qui a créé la ressource. |
impact |
Impact de la recommandation sur l’entreprise. |
Resource |
Métadonnées de ressource de recommandation |
Resource |
Recommandation advisor. |
risk |
Risque potentiel de ne pas mettre en œuvre la recommandation. |
Short |
Résumé de la recommandation. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
ArmErrorResponse
Nom | Type | Description |
---|---|---|
error |
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. |
category
Catégorie de la recommandation.
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 |
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 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 |
Métadonnées de ressource évaluées |
|
properties.risk |
Risque potentiel de ne pas mettre en œuvre la recommandation. |
|
properties.shortDescription |
Résumé de la recommandation. |
|
properties.suppressionIds |
string[] |
Liste des règles ignorées et ignorées pour la recommandation. |
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 |
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 |
Type d’identité qui a modifié la dernière ressource. |