更新组织策略试运行的配置 - UpdateDryRunConfig

功能介绍

更新组织策略试运行的配置。此操作只能由组织的管理账号调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
organizations:policies:updateDryRunConfig
Write
root *
g:ResourceTag/<tag-key>
-
iam:agencies:pass

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
organizations:policies:updateDryRunConfig	Write	root *	g:ResourceTag/<tag-key>	-	iam:agencies:pass

URI

POST /v1/organizations/dry-run-config

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Security-Token	否	String	如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

表2 请求Body参数
参数	是否必选	参数类型	描述
policy_type	是	String	策略类型的名称，service_control_policy服务控制策略，resource_control_policy资源控制策略，network_control_policy网络控制策略。
root_id	是	String	根的唯一标识符（ID）。
status	否	String	策略试运行的开启状态。enabled：启用；disabled 禁用。
bucket_name	否	String	用户桶名称。
region_id	否	String	用户桶所在的region。
bucket_prefix	否	String	用户桶的前缀。
agency_name	否	String	委托名称。Organizations服务通过此委托将试运行日志写入用户obs桶

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
root	DryRunConfigDto object	策略试运行的详细信息。

表4 DryRunConfigDto
参数	参数类型	描述
root_id	String	根的唯一标识符（ID）。
status	String	策略试运行的开启状态。enabled：启用；pending_enable：启用中；disabled：禁用；pending_disable：禁用中。
bucket_name	String	用户桶名称。
region_id	String	用户桶所在的region。
bucket_prefix	String	用户桶的前缀。
agency_name	String	委托名称。Organizations服务通过此委托将试运行日志写入用户obs桶
policy_type	String	策略类型的名称，service_control_policy服务控制策略，resource_control_policy资源控制策略，network_control_policy网络控制策略。
created_at	String	策略试运行配置的开启时间。
updated_at	String	策略试运行配置的更新时间。

请求示例

更新组织策略试运行的配置

POST https://{endpoint}/v1/organizations/dry-run-policy

{
  "root_id" : "r-o1qqtqfo7xl427v7g",
  "policy_type" : "service_control_policy",
  "bucket_name" : "scp-dry-run-log",
  "region_id" : "region_id",
  "bucket_prefix" : "bucket_prefix",
  "agency_name" : "agency_name_string",
  "status" : "enabled"
}

响应示例

状态码：200

Successful.

{
  "root" : {
    "root_id" : "r-o1qqtqfo7xl427v7g",
    "policy_type" : "service_control_policy",
    "bucket_name" : "scp-dry-run-log",
    "region_id" : "region_id",
    "bucket_prefix" : "bucket_prefix",
    "agency_name" : "agency_name_string",
    "status" : "enabled",
    "created_at" : "2024-11-15T06:31:46Z",
    "updated_at" : "2024-11-15T06:31:46Z"
  }
}