Compartir a través de


Suppressions - Create

Habilita el atributo snoozed o descartado de una recomendación. El atributo snoozed o descartado se conoce como una supresión. Use esta API para crear o actualizar el estado snoozed o descartado de una recomendación.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
name
path True

string

Nombre de la supresión.

recommendationId
path True

string

Identificador de recomendación.

resourceUri
path True

string

El identificador completo de Azure Resource Manager del recurso al que se aplica la recomendación.

api-version
query True

string

Versión de la API que se va a usar con la solicitud de cliente.

Cuerpo de la solicitud

Nombre Tipo Description
properties.suppressionId

string

GUID de la supresión.

properties.ttl

string

Duración durante la cual la supresión es válida.

Respuestas

Nombre Tipo Description
200 OK

SuppressionContract

Aceptar. Se ha creado correctamente la supresión.

404 Not Found

ArmErrorResponse

No se encuentra la recomendación que se va a suprimir.

Other Status Codes

ArmErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de 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

CreateSuppression

Sample Request

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

{
  "id": "/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId/suppressions/suppressionName1",
  "name": "suppressionName1",
  "type": "Microsoft.Advisor/suppressions",
  "properties": {
    "suppressionId": "suppressionId",
    "ttl": "07:00:00:00"
  }
}
{
  "error": {
    "code": "NotFound",
    "message": "Recommendation to be suppressed is not found. Subscription Id:{0} Recommendation Id:{1}"
  }
}

Definiciones

Nombre Description
ArmErrorResponse
ARMErrorResponseBody

Cuerpo de respuesta de error de ARM.

createdByType

Tipo de identidad que creó el recurso.

SuppressionContract

Los detalles de la regla snoozed o descartada; por ejemplo, la duración, el nombre y el GUID asociados a la regla.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

ArmErrorResponse

Nombre Tipo Description
error

ARMErrorResponseBody

Cuerpo de respuesta de error de ARM.

ARMErrorResponseBody

Cuerpo de respuesta de error de ARM.

Nombre Tipo Description
code

string

Obtiene o establece la cadena que se puede usar para identificar mediante programación el error.

message

string

Obtiene o establece la cadena que describe el error en detalle y proporciona información de depuración.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

SuppressionContract

Los detalles de la regla snoozed o descartada; por ejemplo, la duración, el nombre y el GUID asociados a la regla.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nombre del recurso.

properties.expirationTimeStamp

string

Obtiene o establece la marca de tiempo de expiración.

properties.suppressionId

string

GUID de la supresión.

properties.ttl

string

Duración durante la cual la supresión es válida.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.