Suppressions - Create

參考

服務:: Advisor

API 版本:: 2023-01-01

啟用建議的 snoozed 或 dismissed 屬性。 snoozed 或 dismissed 屬性稱為隱藏。使用此 API 來建立或更新建議的已取消或關閉狀態。

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

URI 參數

名稱	位於	必要	類型	Description
name	path	True	string	歸併的名稱。
recommendationId	path	True	string	建議標識碼。
resourceUri	path	True	string	套用建議之資源的完整 Azure Resource Manager 識別碼。
api-version	query	True	string	要與用戶端要求搭配使用的 API 版本。

要求本文

名稱	類型	Description
properties.suppressionId	string	歸併的 GUID。
properties.ttl	string	隱藏有效持續時間。

回應

名稱	類型	Description
200 OK	SuppressionContract	正常。已成功建立隱藏。
404 Not Found	ArmErrorResponse	找不到要隱藏的建議。
Other Status Codes	ArmErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

CreateSuppression

範例要求

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

範例回覆

狀態碼:: 200

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

狀態碼:: 404

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

定義

名稱	Description
ArmErrorResponse
ARMErrorResponseBody	ARM 錯誤回應本文。
createdByType	建立資源的身分識別類型。
SuppressionContract	已取消或已關閉規則的詳細數據;例如，與規則相關聯的持續時間、名稱和 GUID。
systemData	與建立和上次修改資源相關的元數據。

ArmErrorResponse

名稱	類型	Description
error	ARMErrorResponseBody	ARM 錯誤回應本文。

ARMErrorResponseBody

ARM 錯誤回應本文。

名稱	類型	Description
code	string	取得或設定可用來以程式設計方式識別錯誤的字串。
message	string	取得或設定字串，這個字串會詳細描述錯誤並提供偵錯資訊。

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

SuppressionContract

已取消或已關閉規則的詳細數據;例如，與規則相關聯的持續時間、名稱和 GUID。

名稱	類型	Description
id	string	資源的完整資源識別碼。例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties.expirationTimeStamp	string	取得或設定到期時間戳。
properties.suppressionId	string	歸併的 GUID。
properties.ttl	string	隱藏有效持續時間。
systemData	systemData	Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。
type	string	資源類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳 (UTC)
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為