Suppressions - Create

Service:

Advisor

API Version:

2023-01-01

Aktiviert das verworfene oder verworfene Attribut einer Empfehlung. Das verworfene oder verworfene Attribut wird als Unterdrückung bezeichnet. Verwenden Sie diese API, um die status einer Empfehlung zu erstellen oder zu aktualisieren.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
name	path	True	string	Der Name der Unterdrückung.
recommendationId	path	True	string	Die Empfehlungs-ID.
resourceUri	path	True	string	Der vollqualifizierte Azure Resource Manager Bezeichner der Ressource, für die die Empfehlung gilt.
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.suppressionId	string	Die GUID der Unterdrückung.
properties.ttl	string	Die Dauer, für die die Unterdrückung gültig ist.

Antworten

Name	Typ	Beschreibung
200 OK	SuppressionContract	OK. Die Unterdrückung wurde erfolgreich erstellt.
404 Not Found	ArmErrorResponse	Die Empfehlung, unterdrückt zu werden, wurde nicht gefunden.
Other Status Codes	ArmErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

CreateSuppression

Sample Request

HTTP

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

{
  "properties": {
    "ttl": "07:00:00:00"
  }
}

Sample Response

Status code:

200

{
  "id": "/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId/suppressions/suppressionName1",
  "name": "suppressionName1",
  "type": "Microsoft.Advisor/suppressions",
  "properties": {
    "suppressionId": "suppressionId",
    "ttl": "07:00:00:00"
  }
}

Status code:

404

{
  "error": {
    "code": "NotFound",
    "message": "Recommendation to be suppressed is not found. Subscription Id:{0} Recommendation Id:{1}"
  }
}

Definitionen

Name	Beschreibung
ArmErrorResponse
ARMErrorResponseBody	ARM-Fehlerantworttext.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
SuppressionContract	Die Einzelheiten der vernommten oder verworfenen Regel; beispielsweise die Dauer, der Name und die GUID, die der Regel zugeordnet sind.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

ArmErrorResponse

Name	Typ	Beschreibung
error	ARMErrorResponseBody	ARM-Fehlerantworttext.

ARMErrorResponseBody

ARM-Fehlerantworttext.

Name	Typ	Beschreibung
code	string	Ruft die Zeichenfolge ab, die zum programmgesteuerten Identifizieren des Fehlers verwendet werden kann, oder legt diese fest.
message	string	Ruft die Zeichenfolge ab, die den Fehler detailliert beschreibt und Debuginformationen bereitstellt, oder legt diese fest.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

SuppressionContract

Die Einzelheiten der vernommten oder verworfenen Regel; beispielsweise die Dauer, der Name und die GUID, die der Regel zugeordnet sind.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.expirationTimeStamp	string	Ruft den Ablaufzeitstempel ab oder legt diese fest.
properties.suppressionId	string	Die GUID der Unterdrückung.
properties.ttl	string	Die Dauer, für die die Unterdrückung gültig ist.
systemData	systemData	Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.
type	string	Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.