Call UpdateOpaStrategyNew to update blocking rules for at-risk images - Security Center

Updates the blocking rule for at-risk images.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-sas:UpdateOpaStrategyNew

update

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
StrategyId	integer	No	The ID of the rule. Note You can call the ListOpaClusterStrategyNew operation to query the ID.	1003
StrategyTemplateId	integer	No	The ID of the rule template. Note You can call the GetOpaStrategyTemplateSummary operation to query the ID of the rule template.	109
ClusterId	string	No	The cluster ID. Note This parameter is deprecated. You can use the Scopes parameter to specify a scope in which cluster parameters take effect.	c870ec78ecbcb41d2a35c679823ef****
StrategyName	string	No	The rule name.	test
Description	string	No	The rule description.	4566
ClusterName	string	No	The cluster name. Note This parameter is deprecated.	docker-law
UnScanedImage	boolean	No	Specifies whether the rule supports unscanned images. Valid values: true false	true
MaliciousImage	boolean	No	Specifies whether the rule supports malicious Internet images. Valid values: true false	true
ImageName	array	No	The image names.
	string	No	The image name. Note You can call the GetOpaClusterImageList operation to query the image name.	muximux:latest
Label	array	No	The image tags.
	string	No	The image tag. Note You can call the GetOpaClusterLabelList operation to query the image tag.	alertmanager:main
RuleAction	integer	No	The action that is performed when the rule is hit. Valid values: 1: alert 2: block 3: allow	1
WhiteList	array	No	The whitelists.
	string	No	The name of the image that is added to the whitelist.	repo-016
AlarmDetail	object	No	The risks that you want to detect by using the rule.
Baseline	object	No	The baseline risks.
RiskLevel	array	No	The risk levels.
	string	No	The risk level. Valid values: high medium low	medium
Item	array<object>	No	The baseline check items.
	object	No
Id	string	No	The ID of the baseline check item. Note You can call the GetOpaClusterBaseLineList operation to query the ID.	hc.image.checklist.identify.hc_exploit_couchdb_linux.item
Name	string	No	The name of the baseline check item. Note You can call the GetOpaClusterBaseLineList operation to query the name.	passwd
Vul	object	No	The vulnerability risks.
RiskLevel	array	No	The risk levels.
	string	No	The risk level. Valid values: high medium low	high
Item	array<object>	No	The vulnerabilities.
	object	No
Id	string	No	The ID of the vulnerability. Note You can call the DescribeVulListPage operation to query the ID.	CVE-2023-36034
Name	string	No	The name of the vulnerability. Note You can call the DescribeVulListPage operation to query the name.	oval:com.redhat.rhsa:def:20227002
RiskClass	array<object>	No	Risk type of vulnerability.
	object	No
Id	string	No	The ID of the vulnerability types. Valid values: cve: system vulnerability app: application vulnerability	cve
Name	string	No	The name of the vulnerability. Valid values: system vulnerability application vulnerability	System vulnerability
MaliciousFile	object	No	The malicious sample risks.
RiskLevel	array	No	The risk levels.
	string	No	The risk level. Valid values: high medium low	medium
Item	array<object>	No	The malicious samples.
	object	No
Id	string	No	The ID of the malicious sample. Note You can call the DescribeMatchedMaliciousNames operation to query the ID.	65201
Name	string	No	The name of the malicious sample. Note You can call the DescribeMatchedMaliciousNames operation to query the name.	abnormal binary file
SensitiveFile	object	No	The configuration of sensitive file.
RiskLevel	array	No	The risk levels.
	string	No	The risk level. Valid values: high medium low	high
Item	array<object>	No	The configuration of sensitive file.
	object	No
Id	string	No	The ID of the sensitive files. Note You can call the GetSensitiveDefineRuleConfig operation to query the ID of the malicious sample.	key
Name	string	No	The name of the sensitive files. Note You can call the GetSensitiveDefineRuleConfig operation to query the ID of the malicious sample.	name
BuildRisk	object	No	The configuration of image build risk.
RiskLevel	array	No	The risk levels.
	string	No	The risk level. Valid values: high medium low	high
Item	array<object>	No	The configuration of image build risk.
	object	No
Id	string	No	The ID of the image build risk. Note You can call the ListImageBuildRiskItem operation to query the ID of the malicious sample.	key
Name	string	No	The name of the image build risk. Note You can call the ListImageBuildRiskItem operation to query the ID of the malicious sample.	name
Scopes	array<object>	No	The application scope.
	object	No
ClusterId	string	No	The cluster ID. Note You can call the DescribeGroupedContainerInstances operation to query the cluster ID.	cdcb56a931c**
AllNamespace	integer	No	Specifies whether all namespaces are included. Valid values: 0: Not all namespaces are included. 1: All namespaces are included.	1
NamespaceList	array	No	The namespaces. Note This parameter is valid only when the AllNamespace parameter is set to 0.
	string	No	The namespaces.	m1
AckPolicyInstanceId	string	No	The ID of the cluster node to which the rule is applied. Note You can call the GetOpaStrategyDetailNew operation to query the ID of the cluster node to which the rule is applied.	ack-1

Response elements

Element	Type	Description	Example
	object	BaseResult
Success	boolean	Indicates whether the request was successful. Valid values: true false	true
Code	string	The status code returned. The status code 200 indicates that the request was successful. Other status codes indicate that the request failed. You can identify the cause of the failure based on the status code.	200
Message	string	The returned message.	success
RequestId	string	The request ID.	F75B5FF5-DCB2-59CE-8978-08510707A9E6
HttpStatusCode	integer	The HTTP status code.	200
Data	array	The IDs of the clusters that failed to be updated.
	string	The ID of the cluster that failed to be updated.	['c8d**7614df1bf']

Examples

Success response

JSON format

{
  "Success": true,
  "Code": "200",
  "Message": "success",
  "RequestId": "F75B5FF5-DCB2-59CE-8978-08510707A9E6",
  "HttpStatusCode": 200,
  "Data": [
    "['c8d**7614df1bf']"
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
500	ServerError	ServerError
403	NoPermission	caller has no permission	You are not authorized to do this operation.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.