调用UpdateSecurityPolicyAttribute接口更新安全策略属性。
使用说明
UpdateSecurityPolicyAttribute接口属于异步接口,即系统返回一个请求ID,但该安全策略属性尚未更新成功,系统后台的更新任务仍在进行。您可以调用ListSecurityPolicies查询安全策略属性的更新状态:
- 当安全策略属性处于Configuring状态时,表示安全策略属性正在更新中。
- 当安全策略属性处于Available状态时,表示安全策略属性已更新完成。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateSecurityPolicyAttribute |
要执行的操作。取值:UpdateSecurityPolicyAttribute。 |
ClientToken | String | 否 | 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3 |
客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
|
DryRun | Boolean | 否 | true |
是否只预检此次请求,取值:
|
SecurityPolicyId | String | 是 | spy-n0kn923**** |
安全策略实例ID。 |
TLSVersions.N | String | 否 | TLSv1.0 |
支持的TLS协议版本,取值:TLSv1.0、TLSv1.1、TLSv1.2和TLSv1.3。 最多支持添加4个TLS协议版本。 |
Ciphers.N | String | 否 | ECDHE-ECDSA-AES128-SHA |
支持的加密套件,具体依赖TLSVersions的取值。 最多支持添加32个加密套件。 Cipher只要被任何一个传入的TLSVersions支持即可。 说明 选择了TLSv1.3那么Cipher列表必须包含TLSv1.3支持的Cipher。
|
SecurityPolicyName | String | 否 | test-secrity |
安全策略名称。 长度为2~128个英文或中文字符,必须以大小字母或中文开头,可包含数字,半角句点(.),下划线(_)和短划线(-)。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
JobId | String | 72dcd26b-f12d-4c27-b3af-18f6aed5**** |
异步任务ID。 |
RequestId | String | 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=UpdateSecurityPolicyAttribute
&ClientToken=593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
&DryRun=true
&SecurityPolicyId=spy-n0kn923****
&TLSVersions=["TLSv1.0"]
&Ciphers=["ECDHE-ECDSA-AES128-SHA"]
&SecurityPolicyName=test-secrity
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateSecurityPolicyAttributeResponse>
<JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
<RequestId>593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3</RequestId>
</UpdateSecurityPolicyAttributeResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****",
"RequestId" : "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IncorrectStatus.SecurityPolicy | The status of %s [%s] is incorrect. | 资源%s [%s]的状态无效。 |
404 | ResourceNotFound.SecurityPolicy | The specified resource %s is not found. | 资源%s不存在。 |
访问错误中心查看更多错误码。