Suppressions - Create

Referência

Serviço:: Advisor

Versão da API:: 2023-01-01

Ativa o atributo snoozed ou dispensado de uma recomendação. O atributo snoozed ou dispensado é referido como uma supressão. Utilize esta API para criar ou atualizar o estado suspenso ou dispensado de uma recomendação.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
name	path	True	string	O nome da supressão.
recommendationId	path	True	string	O ID da recomendação.
resourceUri	path	True	string	O identificador de Resource Manager completamente qualificado do Azure do recurso ao qual a recomendação se aplica.
api-version	query	True	string	A versão da API a ser utilizada com o pedido de cliente.

Corpo do Pedido

Name	Tipo	Description
properties.suppressionId	string	O GUID da supressão.
properties.ttl	string	A duração para a qual a supressão é válida.

Respostas

Name	Tipo	Description
200 OK	SuppressionContract	OK. Supressão criada com êxito.
404 Not Found	ArmErrorResponse	A recomendação a ser suprimida não foi encontrada.
Other Status Codes	ArmErrorResponse	Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

CreateSuppression

Pedido de amostra

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"
  }
}

Resposta da amostra

Código de estado:: 200

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

Código de estado:: 404

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

Definições

Name	Description
ArmErrorResponse
ARMErrorResponseBody	Corpo da resposta a erros do ARM.
createdByType	O tipo de identidade que criou o recurso.
SuppressionContract	Os detalhes da regra snoozed ou dispensado; por exemplo, a duração, o nome e o GUID associados à regra.
systemData	Metadados relativos à criação e última modificação do recurso.

ArmErrorResponse

Name	Tipo	Description
error	ARMErrorResponseBody	Corpo da resposta a erros do ARM.

ARMErrorResponseBody

Corpo da resposta a erros do ARM.

Name	Tipo	Description
code	string	Obtém ou define a cadeia que pode ser utilizada para identificar programaticamente o erro.
message	string	Obtém ou define a cadeia que descreve o erro em detalhe e fornece informações de depuração.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

SuppressionContract

Os detalhes da regra snoozed ou dispensado; por exemplo, a duração, o nome e o GUID associados à regra.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.expirationTimeStamp	string	Obtém ou define o carimbo de data/hora de expiração.
properties.suppressionId	string	O GUID da supressão.
properties.ttl	string	A duração para a qual a supressão é válida.
systemData	systemData	O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via