Recommendations - List

Service:

App Service

Version d'API:

2023-12-01

Description de Lister toutes les recommandations pour un abonnement.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations?api-version=2023-12-01

Avec des paramètres facultatifs:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations?featured={featured}&api-version=2023-12-01&$filter={$filter}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
subscriptionId	path	True	string	Votre ID d’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 0000000-0000-0000-0000-000000000000000).
api-version	query	True	string	Version d'API
$filter	query		string	Le filtre est spécifié à l’aide de la syntaxe OData. Exemple : $filter=channel eq 'Api' or channel eq 'Notification' and startTime eq 2014-01-01T00 :00 :00Z and endTime eq 2014-12-31T23 :59 :59Z and timeGrain eq duration'[PT1H|PT1M|P1D]
featured	query		boolean	Spécifiez true pour renvoyer uniquement les recommandations les plus critiques. La valeur par défaut est false, qui retourne toutes les recommandations.

Réponses

Nom	Type	Description
200 OK	RecommendationCollection	Ok
Other Status Codes	DefaultErrorResponse	App Service réponse d’erreur.

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

Définitions

Nom	Description
Channels	Liste des canaux que cette recommandation peut appliquer.
DefaultErrorResponse	App Service réponse d’erreur.
Details
Error	Modèle d’erreur.
NotificationLevel	Niveau indiquant l’impact critique de cette recommandation.
Recommendation	Représente un résultat de recommandation généré par le moteur de recommandation.
RecommendationCollection	Collection de recommandations.
ResourceScopeType	Nom d’un type de ressource que cette recommandation applique, par exemple Abonnement, ServerFarm, Site.

Channels

Liste des canaux que cette recommandation peut appliquer.

Nom	Type	Description
All	string
Api	string
Email	string
Notification	string
Webhook	string

DefaultErrorResponse

App Service réponse d’erreur.

Nom	Type	Description
error	Error	Modèle d’erreur.

Details

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

Error

Modèle d’erreur.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
details	Details[]	Erreurs détaillées.
innererror	string	Informations supplémentaires pour déboguer l’erreur.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

NotificationLevel

Niveau indiquant l’impact critique de cette recommandation.

Nom	Type	Description
Critical	string
Information	string
NonUrgentSuggestion	string
Warning	string

Recommendation

Représente un résultat de recommandation généré par le moteur de recommandation.

Nom	Type	Description
id	string	ID de ressource.
kind	string	Type de ressource.
name	string	Nom de la ressource.
properties.actionName	string	Nom de l’action recommandée par cet objet.
properties.bladeName	string	Lien profond vers un panneau sur le portail.
properties.categoryTags	string[]	Liste des balises de catégorie auxquelles cette recommandation appartient.
properties.channels	Channels	Liste des canaux que cette recommandation peut appliquer.
properties.creationTime	string	Horodatage de la création de ce instance.
properties.displayName	string	Nom convivial de l’interface utilisateur de la règle (peut ne pas être unique).
properties.enabled	integer	True si cette recommandation est toujours valide (c’est-à-dire « actionnable »). False si elle n’est pas valide.
properties.endTime	string	Heure de fin utc d’une plage à laquelle la recommandation fait référence.
properties.extensionName	string	Nom d’extension du portail s’il existe.
properties.forwardLink	string	Lien de transfert vers un document externe associé à la règle.
properties.isDynamic	boolean	True si cette propriété est associée à une règle ajoutée dynamiquement
properties.level	NotificationLevel	Niveau indiquant l’impact critique de cette recommandation.
properties.message	string	Texte de recommandation.
properties.nextNotificationTime	string	Quand notifier cette recommandation ensuite en UTC. Null signifie que cela ne sera plus notifié.
properties.notificationExpirationTime	string	Date et heure UTC d’expiration de cette notification.
properties.notifiedTime	string	Dernier horodatage UTC de cette instance a été effectivement notifié. Null signifie que cette recommandation n’a pas encore été avertie.
properties.recommendationId	string	Valeur GUID à laquelle chaque objet de recommandation est associé.
properties.resourceId	string	Chaîne d’ID de ressource ARM complète à laquelle cet objet de recommandation est associé.
properties.resourceScope	ResourceScopeType	Nom d’un type de ressource que cette recommandation applique, par exemple Abonnement, ServerFarm, Site.
properties.ruleName	string	Nom unique de la règle.
properties.score	number	Valeur de métrique mesurée par la règle.
properties.startTime	string	Heure de début UTC d’une plage à laquelle la recommandation fait référence.
properties.states	string[]	Liste des états de cette recommandation. Si elle est null, elle doit être considérée comme « Active ».
type	string	Type de ressource.

RecommendationCollection

Collection de recommandations.

Nom	Type	Description
nextLink	string	Lien vers la page suivante de ressources.
value	Recommendation[]	Collection de ressources.

ResourceScopeType

Nom d’un type de ressource que cette recommandation applique, par exemple Abonnement, ServerFarm, Site.

Nom	Type	Description
ServerFarm	string
Subscription	string
WebSite	string