AI 助理
文档备案控制台
官方文档
首页 云安全中心 开发参考 API参考指南 API目录 资产管理 AddCloudVendorAccountAK - 新增多云资产授权配置

AddCloudVendorAccountAK - 新增多云资产授权配置

更新时间：
复制 MD 格式
产品详情
我的收藏

新增多云资产配置信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:AddCloudVendorAccountAK

create

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
Vendor

string

是

云资产厂商。取值：

  • Tencent：腾讯云

  • HUAWEICLOUD：华为云

  • Azure：Azure

  • AWS：AWS

  • VOLCENGINE：火山云

  • google：谷歌云

  • CHAITIN：长亭科技

  • FORTINET：飞塔

  • THREATBOOK：微步在线

  • KingsoftCloud：金山云

  • UCloud：UCloud

  • BaiduCloud：百度智能云

  • WIZ：Wiz 安全

AWS
AkType

string

是

AK 类型。取值：

  • primary：主账号

  • sub：子账号

  • ctdr：Agentic SOC
    警告 当厂商是 CHAITIN、FORTINET、THREATBOOK、WIZ 时该参数取值为 ctdr

primary
SecretId

string

是

AK 参数 Id。取值：

1.AkType 取值 primary:

  • Tencent：主账号 AccessKeyId

  • HUAWEICLOUD：主账号 AccessKeyId

  • Azure：ClientId

  • AWS：主账号 AccessKeyId

  • VOLCENGINE：主账号 AccessKeyId

2.AkType 取值 sub:

  • Tencent：子账号 AccessKeyId

  • HUAWEICLOUD：子账号 AccessKeyId

  • Azure：ClientId

  • AWS：子账号 AccessKeyId

  • VOLCENGINE：子账号 AccessKeyId

  • google：private_key_id

说明

AkType 取值为 primary 则该值为他云的主账号 SecretID。AkType 取值为 sub 则该值为他云子账号 Access Key ID。Azure 不做区分，该值为认证信息的 appId。谷歌云是通过服务账号接入的，AkType 默认取值 sub， 该值取自 JSON 格式服务密钥文件的 private_key_id 属性值。

45GLRV4SOT0YFB****
SecretKey

string

是

AK 参数 Secret。取值：

1.AkType 取值 primary:

  • Tencent：主账号 SecretAccessKey

  • HUAWEICLOUD：主账号 SecretAccessKey

  • Azure：ClientSecret

  • AWS：主账号 SecretAccessKey

2.AkType 取值 sub:

  • Tencent：子账号 SecretAccessKey

  • HUAWEICLOUD：子账号 SecretAccessKey

  • Azure：ClientSecret

  • AWS：子账号 SecretAccessKey

  • google：private_key

说明

AkType 取值为 primary 则该值为他云的主账号 Secret Access Key。AkType 取值为 sub 则该值为他云子账号 Secret Access Key。Azure 不做区分，该值为认证信息的 password。谷歌云是通过服务账号接入的，AkType 默认取值 sub， 该值取自 JSON 格式服务密钥文件的 private_key 属性值。

AE6SLd****
Regions

array

否

AK 信息验证所使用的 Region 列表，仅对 Vendor 为 AWS 有效。

说明

调用 ListCloudVendorRegions 接口可以获取该参数。

string

否

AK 信息验证所使用的 Region。

ap-south-1
SubscriptionIds

array

否

订阅 ID 列表。

说明

该参数已无效。

string

否

订阅 ID。

说明

该参数已无效。

9b41e7ae-fcbf-4983-aa32-6fb2e*****
TenantId

string

否

租户 ID，仅对 Vendor 为 Azure 有效。

95304a97-339b-4de5-9a7d-cdbffaf****
Domain

string

否

接入账号域。取值：

  • china：中国

  • global：全球

  • europe：华为欧洲站

说明

该参数仅对 Vendor 为 HUAWEICLOUD、Azure、AWS、VOLCENGINE、KingsoftCloud、UCloud、BaiduCloud 有效，且为必传。其中 KingsoftCloud、BaiduCloud 取值 china，UCloud 取值 global。

global
AuthModules

array

否

AK 关联模块列表。

string

否

AK 关联模块 Code。取值：

  • HOST：主机

  • CSPM：云产品配置检查

  • SIEM：CloudSiem

  • TRIAL：日志审计

HOST
Lang

string

否

请求和接收消息的语言类型。默认值为 zh。取值：

  • zh：中文

  • en：英文

zh
VendorAuthAlias

string

否

AK 账号名称。

说明

用于标识三方主机资产的所属账号信息。

test
ExtendInfo

string

否

扩展信息。

说明

用于记录不同厂商扩展信息。 谷歌云是通过服务账号接入的，ExtendInfo 存储的是 json 格式服务密钥文件，排除了 private_key_id 和 zprivate_key 字段。文件中包含字段：type，project_id，client_email，client_id，auth_uri，token_uri，auth_provider_x509_cert_url，client_x509_cert_url，universe_domain。

{\"product\":\"webFirewall\",\"remark\":\"remark\"}
CtdrCloudUserId

string

否

账号 ID。

说明

接入的云厂商的账号 ID，当权限说明包含威胁分析与响应时必填。

azure_demo_1

返回参数

名称

类型

描述

示例值

object

RequestId

string

本次请求的 ID。

A60DA4EC-7CD8-577D-AD73-***
Data

object

当前添加 AK 信息。

Status

integer

AK 状态。取值：

  • 0：开启

  • 1：未开启

0
AuthId

integer

AK 唯一 ID。

2158
AkType

string

AK 类型。取值：

  • primary：主账号

  • sub：子账号

sub
SecretId

string

AK 参数 ID。

AE6SLd****
ServiceStatus

integer

AK 使用状态。取值：

  • 0：使用中

  • 1：使用异常

  • 2：有效性验证中

  • 3：有效性验证超时

0
Vendor

string

云资产厂商。取值：

  • Tencent：腾讯云

  • HUAWEICLOUD：华为云

  • Azure：Azure

  • AWS：AWS

  • VOLCENGINE：火山云

  • google：谷歌云

  • CHAITIN：长亭科技

  • FORTINET：飞塔

  • THREATBOOK：微步在线

Tencent
Message

string

AK 异常信息。

The IAM user is forbidden in the currently selected region
AuthModules

array<object>

AK 关联模块列表。

object

ModuleDisp

string

模块显示名称。

Host Assets
ModuleStatement

string

模块关联权限说明。

Read permission of the cloud server or virtual machine
Module

string

模块 Code。取值：

  • HOST：主机

  • CSPM：云产品配置检查

  • SIEM：CloudSiem

  • TRIAL：日志审计

HOST
ModuleAssetType

string

模块关联云资产说明。

Cloud server or virtual machine
ModuleServiceStatus

integer

模块状态。取值：

  • 0：使用中

  • 1：使用异常

  • 2：有效性验证中

  • 3：有效性验证超时

0
Message

string

模块异常信息。

ak_domain_error
VendorAuthAlias

string

AK 账号名称。

说明

用于标识三方主机资产的所属账号信息。

test
CtdrCloudUserId

string

账号 ID。

说明

接入的云厂商的账号 ID。

azure_demo_1

示例

正常返回示例

JSON格式

{
  "RequestId": "A60DA4EC-7CD8-577D-AD73-***",
  "Data": {
    "Status": 0,
    "AuthId": 2158,
    "AkType": "sub",
    "SecretId": "AE6SLd****",
    "ServiceStatus": 0,
    "Vendor": "Tencent",
    "Message": "The IAM user is forbidden in the currently selected region",
    "AuthModules": [
      {
        "ModuleDisp": "Host Assets",
        "ModuleStatement": "Read permission of the cloud server or virtual machine",
        "Module": "HOST",
        "ModuleAssetType": "Cloud server or virtual machine",
        "ModuleServiceStatus": 0,
        "Message": "ak_domain_error"
      }
    ],
    "VendorAuthAlias": "test",
    "CtdrCloudUserId": "azure_demo_1"
  }
}

错误码

HTTP status code

错误码

错误信息

描述
400 CreateAkError Failed to create an AK. 创建AK错误。
500 ServerError ServerError 服务故障，请稍后重试！
403 NoPermission caller has no permission 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：ListCloudVendorRegions - 获取站点下他云的同步Region同步配置列表下一篇：DeleteCloudVendorAccountAK - 删除多云资产授权配置