你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Suppressions - Create

参考

服务:: Advisor

API 版本:: 2023-01-01

启用建议的已取消或已消除属性。已取消或消除的属性称为抑制。使用此 API 创建或更新建议的已取消或已消除状态。

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

URI 参数

名称	在	必需	类型	说明
name	path	True	string	抑制的名称。
recommendationId	path	True	string	建议 ID。
resourceUri	path	True	string	应用建议的资源的完全限定的 Azure 资源管理器标识符。
api-version	query	True	string	要与客户端请求一起使用的 API 的版本。

请求正文

名称	类型	说明
properties.suppressionId	string	抑制的 GUID。
properties.ttl	string	抑制有效的持续时间。

响应

名称	类型	说明
200 OK	SuppressionContract	没问题。已成功创建抑制。
404 Not Found	ArmErrorResponse	找不到要取消的建议。
Other Status Codes	ArmErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
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}"
  }
}

定义

名称	说明
ArmErrorResponse
ARMErrorResponseBody	ARM 错误响应正文。
createdByType	创建资源的标识类型。
SuppressionContract	推迟或消除的规则的详细信息;例如，与规则关联的持续时间、名称和 GUID。
systemData	与资源的创建和上次修改相关的元数据。

ArmErrorResponse

名称	类型	说明
error	ARMErrorResponseBody	ARM 错误响应正文。

ARMErrorResponseBody

ARM 错误响应正文。

名称	类型	说明
code	string	获取或设置可用于以编程方式标识错误的字符串。
message	string	获取或设置详细描述错误并提供调试信息的字符串。

createdByType

创建资源的标识类型。

名称	类型	说明
Application	string
Key	string
ManagedIdentity	string
User	string

SuppressionContract

推迟或消除的规则的详细信息;例如，与规则关联的持续时间、名称和 GUID。

名称	类型	说明
id	string	资源的完全限定的资源 ID。例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties.expirationTimeStamp	string	获取或设置过期时间戳。
properties.suppressionId	string	抑制的 GUID。
properties.ttl	string	抑制有效的持续时间。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

systemData

与资源的创建和上次修改相关的元数据。

名称	类型	说明
createdAt	string	资源创建时间戳 (UTC) 。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识类型。
lastModifiedAt	string	资源上次修改的时间戳 (UTC)
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识类型。

通过