华为云用户手册

URI GET /v1/organizations/organizational-units 表1 Query参数 参数 是否必选 参数类型 描述 parent_id 否 String 父节点（根或组织单元）的唯一标识符（ID）。 最大长度：100 limit 否 Integer 页面中最大结果数量。 最小值：1 最大值：2000 缺省值：200 marker 否 String 分页标记。 最小长度：4 最大长度：400

响应示例 状态码： 200 Successful. { "trusted_services" : [ { "service_principal" : "autoservice0922102321263V58H", "enabled_at" : "2022-09-22T02:23:21Z" } ], "page_info" : { "next_marker" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "current_count" : 100 } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 trusted_services Array of TrustedServiceDto objects 启用与组织集成的服务主体列表。 page_info PageInfoDto object 分页信息 表4 TrustedServiceDto 参数 参数类型 描述 service_principal String 可信服务的名称。 最小长度：1 最大长度：100 enabled_at String 可信服务与组织集成的日期。 表5 PageInfoDto 参数 参数类型 描述 next_marker String 如果存在，则表示可用的输出比当前响应中包含的输出多。在对操作的后续调用中，在标签请求参数中使用此值，以获取输出的下一部分。您应该重复此操作，直到next_marker响应元素返回为null。 current_count Integer 本页返回条目数量 最小值：1 最大值：2000

URI GET /v1/organizations/resources/{resource_id}/tags 表1 路径参数 参数 是否必选 参数类型 描述 resource_id 是 String 根、组织单元、账号或策略的唯一标识符（ID）。 最大长度：130 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 页面中最大结果数量。 最小值：1 最大值：2000 缺省值：200 marker 否 String 分页标记。 最小长度：4 最大长度：400

响应示例 状态码： 200 Successful. { "tags" : [ { "key" : "auto09230Uv5key", "value" : "auto0923XXFmvalue" } ], "page_info" : { "next_marker" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "current_count" : 100 } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 tags Array of TagDto objects 标签列表。 page_info PageInfoDto object 分页信息 表5 TagDto 参数 参数类型 描述 key String 标签键的密钥标识符或名称。 最小长度：1 最大长度：128 value String 与标签键关联的字符串值。您可以将标签的值设置为空字符串，但不能将标签的值设置为NULL。 最小长度：0 最大长度：255 表6 PageInfoDto 参数 参数类型 描述 next_marker String 如果存在，则表示可用的输出比当前响应中包含的输出多。在对操作的后续调用中，在标签请求参数中使用此值，以获取输出的下一部分。您应该重复此操作，直到next_marker响应元素返回为null。 current_count Integer 本页返回条目数量 最小值：1 最大值：2000

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 最大长度：2048 表3 请求Body参数 参数 是否必选 参数类型 描述 tags 是 Array of TagDto objects 要添加到指定资源的标签列表。 数组长度：1 - 20 表4 TagDto 参数 是否必选 参数类型 描述 key 是 String 标签键的密钥标识符或名称。 最小长度：1 最大长度：128 value 是 String 与标签键关联的字符串值。您可以将标签的值设置为空字符串，但不能将标签的值设置为NULL。 最小长度：0 最大长度：255

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 最大长度：2048 表2 请求Body参数 参数 是否必选 参数类型 描述 service_principal 是 String 服务主体名称。 最小长度：0 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 roots Array of RootDto objects 在组织中定义的根列表。 page_info PageInfoDto object 分页信息 表4 RootDto 参数 参数类型 描述 id String 根的唯一标识符（ID）。 最小长度：1 最大长度：34 urn String 根的统一资源名称。 最小长度：1 最大长度：1500 name String 根的名称。 最小长度：1 最大长度：64 policy_types Array of PolicyTypeSummaryDto objects 策略类型在当前根已启用，则该类型策略可以绑定到根或其组织单元或账号。 created_at String 根的创建时间。 表5 PolicyTypeSummaryDto 参数 参数类型 描述 status String 与根关联的策略类型状态。要将指定类型的策略绑定到根或该根中的组织单元或账号，该策略必须在组织中可用，并在该根已启用。enabled：启用；pending_enable：启用中；disabled：禁用；pending_disable：禁用中。 最小长度：1 最大长度：64 type String 策略类型的名称，service_control_policy：服务控制策略；tag_policy：标签策略。 最小长度：1 最大长度：64 表6 PageInfoDto 参数 参数类型 描述 next_marker String 如果存在，则表示可用的输出比当前响应中包含的输出多。在对操作的后续调用中，在标签请求参数中使用此值，以获取输出的下一部分。您应该重复此操作，直到next_marker响应元素返回为null。 current_count Integer 本页返回条目数量 最小值：1 最大值：2000

响应示例 状态码： 200 Successful. { "roots" : { "id" : "r-rpjghpbmumu2hffplsj5edt1z3vybb94", "urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:root:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/r-rpjghpbmumu2hffplsj5edt1z3vybb94", "name" : "root", "policy_types" : [ { "status" : "enabled", "type" : "service_control_policy" } ], "created_at" : "2022-08-24T06:31:46Z" }, "page_info" : { "next_marker" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "current_count" : 100 } }

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝对指定资源在特定条件下进行某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。 IAM 项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。管理员可以在授权项列表中查看授权项是否支持IAM项目或企业项目，“√”表示支持，“×”表示暂不支持。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。

请求示例 创建组织单元 POST https://{hostname}/v1/organizations/organizational-units { "name" : "autoOU0923152728692gqQc", "parent_id" : "ou-kz0blhbszb6w9a2lzb", "tags" : [ { "key" : "keystring", "value" : "keystring" } ] }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 最大长度：2048 表2 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 要分配给新组织单元的名称。 最小长度：1 最大长度：64 parent_id 是 String 要在其中创建新组织单元的根或组织单元的唯一标识符。 最大长度：100 tags 否 Array of TagDto objects 要附加到新创建的组织单元的标签列表。 表3 TagDto 参数 是否必选 参数类型 描述 key 是 String 标签键的密钥标识符或名称。 最小长度：1 最大长度：128 value 是 String 与标签键关联的字符串值。您可以将标签的值设置为空字符串，但不能将标签的值设置为NULL。 最小长度：0 最大长度：255

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 organizational_unit OrganizationalUnitDto object 包含有关新创建的组织单元的详细信息的结构。 表5 OrganizationalUnitDto 参数 参数类型 描述 id String 与组织单元关联的唯一标识符（ID）。 最小长度：1 最大长度：35 urn String 组织单元的统一资源名称。 最小长度：1 最大长度：1500 name String 组织单元的名称。 最小长度：1 最大长度：64 created_at String 组织单元的创建时间。

响应示例 状态码： 201 Successful { "organizational_unit" : { "id" : "ou-fi0rv9jbjgc6nifokh65jjo8c24fnujv", "urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:ou:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/ou-fi0rv9jbjgc6nifokh65jjo8c24fnujv", "name" : "autoOU0923152728692gqQc", "created_at" : "2022-09-23T07:27:28Z" } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 organizational_unit OrganizationalUnitDto object 包含有关新创建的组织单元的详细信息的结构。 表5 OrganizationalUnitDto 参数 参数类型 描述 id String 与组织单元关联的唯一标识符（ID）。 最小长度：1 最大长度：35 urn String 组织单元的统一资源名称。 最小长度：1 最大长度：1500 name String 组织单元的名称。 最小长度：1 最大长度：64 created_at String 组织单元的创建时间。

响应示例 状态码： 200 Successful { "organizational_unit" : { "id" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:ou:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/ou-fi0rv9jbjgc6nifokh65jjo8c24fnujv", "name" : "autoOU0923152729270Pkgk", "created_at" : "2022-09-23T07:27:28Z" } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 最大长度：2048 表3 请求Body参数 参数 是否必选 参数类型 描述 entity_id 是 String 根、组织单元或账号的唯一标识符（ID）。 最大长度：100

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 最大长度：2048 表3 请求Body参数 参数 是否必选 参数类型 描述 entity_id 是 String 根、组织单元或账号的唯一标识符（ID）。 最大长度：100

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 最大长度：2048 表2 请求Body参数 参数 是否必选 参数类型 描述 service_principal 是 String 服务主体名称。 最小长度：0 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 organizational_unit OrganizationalUnitDto object 包含有关新创建的组织单元的详细信息的结构。 表4 OrganizationalUnitDto 参数 参数类型 描述 id String 与组织单元关联的唯一标识符（ID）。 最小长度：1 最大长度：35 urn String 组织单元的统一资源名称。 最小长度：1 最大长度：1500 name String 组织单元的名称。 最小长度：1 最大长度：64 created_at String 组织单元的创建时间。

响应示例 状态码： 200 Successful { "organizational_unit" : { "id" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:ou:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "name" : "autoOU0923152729270Pkgk", "created_at" : "2022-09-23T07:27:28Z" } }

标签策略简介 标签策略是策略的一种类型，可帮助您在组织账号中对资源添加的标签进行标准化管理。标签策略对未添加标签的资源或未在标签策略中定义的标签不会生效。 例如：标签策略规定为某资源添加的标签A，需要遵循标签策略中定义的大小写规则和标签值。若标签A使用的大小写、标签值不符合标签策略，则资源将会被标记为不合规。 标签策略有如下两种应用方式： 1. 事后检查 —— 资源标签如果违反标签策略，则在资源在合规性结果中显示为不合规。 2. 事前拦截 —— 标签策略开启强制执行后，则会阻止在指定的资源类型上完成不合规的标记操作。 标签策略可以绑定到组织的根、OU和账号。当绑定到根和OU时，所有子OU和子账号都继承该标签策略。账号继承的所有标签策略和直接绑定到账户上的所有标签策略，根据继承运算符最终聚合为有效标签策略。

API概览 微服务引擎API为开发者、合作伙伴提供微服务开发的开放接口，帮助用户快速、低成本地实现业务上云，使能微服务应用的高效运行。 对应的接口参考请参考下表： 表1 接口简介 类型 子类型 说明 CS E接口 动态配置 提供从配置管理中心导入、导出配置信息的接口。 引擎管理 提供创建、查询、删除微服务引擎的引擎管理接口。 微服务治理 提供治理策略的创建、修改、删除和查询等相关治理接口。 Nacos接口 Nacos API 提供命名空间创建、修改、查询和删除等相关接口。 ServiceComb原生接口 认证 提供微服务身份认证功能的相关操作接口。 微服务 提供微服务管理的相关操作接口。 契约 提供微服务契约查询、上传等相关操作接口。 微服务实例 提供微服务实例注册、上报心跳等相关操作接口。 依赖关系 提供微服务依赖关系查询接口。 配置管理 提供配置中心配置管理功能的相关操作接口。 微服务、契约、微服务实例、依赖关系接口只在华北-北京一、华北-北京四、华北-乌兰察布一、华东-上海一、华东-上海二、华南-广州、西南-贵阳一、中国-香港、亚太-新加坡、拉美-墨西哥城二、中东-利雅德局点支持。

资源和成本规划 表1 资源和成本规划内容说明 华为云服务产品* 规格* 可用区 计费模式 购买个数* 单价 (￥) 合计(￥） 弹性公网IP 带宽费用: 独享 | 全动态BGP | 按带宽计费 | 5Mbit/s 华北-北京四,通用可用区, 包月 1 115.00 115.00 虚拟专用网络 规格: 全动态BGP | 按带宽计费 | 5Mbit/s | 连接(个): 10 华北-北京四,通用可用区, 包月 1 375 375.00 弹性负载均衡 实例规格类型: 共享型负载均衡 带宽: 全动态BGP | 带宽 | 5Mbit/s IP费用: 1个 | 全动态BGP 华北-北京四,通用可用区, 包月 1 265 265.00 云服务器ECS 规格: X86计算 | 通用计算增强型 | c3ne.xlarge.2 | 4核 | 8GB 镜像: Ubuntu | Ubuntu 20.04 server 64bit 系统盘: 通用型SSD | 40GB 弹性公网IP: 全动态BGP | 独享 | 按带宽计费 | 5Mbit/s 华北-北京四,通用可用区, 包月 2 604 1,208.00 Web应用防火墙 入门版 华北-北京四,通用可用区, 包月 1 99 99.00 企业主机安全 基础版 华北-北京四,通用可用区, 包月 2 10 20.00 云备份 存储库类型: 云服务器备份存储库 | 1000GB 华北-北京四,通用可用区, 包月 1 200 200.00 云监控服务 500M 华北-北京四,通用可用区, 包月 1 免费 0.00 云日志 服务 日志读写流量: 59.51 GB 日志索引流量: 299.51 GB 日志存储空间: 2096.09 GB 华北-北京四,通用可用区, 包月 1 130.65 130.65 Anti-DDoS流量清洗 500M 华北-北京四,通用可用区, 包月 1 免费 0.00 弹性伸缩 500M 华北-北京四,通用可用区, 包月 1 免费 0.00 数据库安全服务 数据库安全审计 | 基础版 华北-北京四,通用可用区, 包月 2 3000 6,000.00 云堡垒机 实例类型: 单机 性能规格: 10资产标准版 华北-北京四,通用可用区, 包月 1 700 700.00 分布式缓存服务Redis 基础版 | 5.0 | 主备 | X86 | D RAM | 2 | 128 MB 华北-北京四,通用可用区, 包月 2 8.44 16.88 分布式消息服务 Kafka版 kafka.2u4g.cluster | 代理个数：3 单个代理存储空间: 超高IO | 100GB 华北-北京四,通用可用区, 包月 1 2190 2,190.00 云数据库 GaussDB (for Influx) InfluxDB | 集群 | 1.7 | x86 | 2核8GB | 2 个 存储空间: 超高IO | 100GB 冷存储空间: 冷数据 | 500GB 华北-北京四,通用可用区, 包月 1 1545.6 1,545.60 云数据库 RDS(for PostgreSQL) PostgreSQL | 12 | 主备 | 通用型 | 2核4GB 存储空间: SSD云盘 | 40GB 华北-北京四,通用可用区, 包月 2 470 940.00 消息&短信 通用可用区 | 按需计费 | 验证码和通知短信 按需 华北-北京四,通用可用区, 按需 1 0.07/条 0.07 域名 注册 英文域名 | 注册 | 1年 华北-北京四,通用可用区, 包年 1 34 34

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data Object 返回的数据信息 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码，如DS.000，请求处理成功 error_msg String 错误信息 data Object 返回的数据信息 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，如DS.000，请求处理成功 error_msg String 错误信息 data Object 返回的数据信息 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，如DS.000，请求处理成功 error_msg String 错误信息 data Object 返回的数据信息 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，如DS.000，请求处理成功 error_msg String 错误信息 data Object 返回的数据信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token workspace 是 String DataArts Studio 工作空间ID 表3 请求Body参数 参数 是否必选 参数类型 描述 ids 是 Array of longs ID列表 del_types 否 String 删除物理表 枚举值： PHYSICAL_TABLE

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 data Object 返回的数据信息 状态码： 400 表6 响应Body参数 参数 参数类型 描述 data Object 返回的数据信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 data Object 返回的数据信息 状态码： 403 表8 响应Body参数 参数 参数类型 描述 data Object 返回的数据信息

URI POST /v2/{project_id}/design/models/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 action-id 是 String 需要执行的动作，根据导入的对象不同而选择不同的导入动作 枚举值： import_relation import_dimension import_codetable import_datastandard import_bizmetric import_bizcatalog import_atomic import_derivative import_compound import_aggregation model_id 否 String 模型id，在导入模型（import_relation）时必填 directory_id 否 String 导入的目录id，在导入码表（import_datastandard）和数据标准（import_datastandard）时生效，选填 skip-exist 否 Boolean 是否需要覆盖更新已有的实体 缺省值：false

响应示例 状态码： 200 Success，返回data数据是 AtomicIndexVO 数组, 以及总数 { "data" : { "value" : { "records" : [ { "id" : "873264909264257024", "name_en" : "sum_total_amount", "name_ch" : "总车费", "description" : "", "create_by" : "abc", "cal_exp" : "sum(${873264563087376397})", "cal_fn_ids" : null, "l1_id" : "873232498044411904", "l2_id" : "873232716601204736", "l3_id" : "873233440420560896", "table_id" : "873264563070599168", "tb_name" : "行程订单", "dw_type" : " DLI ", "field_ids" : [ "873264563087376397" ], "field_names" : null, "status" : "PUBLISHED", "biz_type" : "FACT_ LOG IC_TABLE", "create_time" : "2021-08-06T18:02:59+08:00", "update_time" : "2021-08-06T18:02:59+08:00", "l1" : "城市交通", "l2" : "行程记录", "l3" : "行程事实", "approval_info" : { "id" : "873264909926957056", "tenant_id" : null, "name_ch" : null, "name_en" : null, "biz_id" : "873264909264257024", "biz_type" : null, "biz_info" : null, "biz_info_obj" : null, "biz_version" : 0, "biz_status" : "PUBLISHED", "approval_status" : "APPROVED", "approval_type" : null, "submit_time" : "2021-08-06T18:02:59+08:00", "create_by" : null, "l1" : null, "l2" : null, "l3" : null, "approval_time" : "2021-08-06T18:02:59+08:00", "approver" : "abc", "email" : null, "msg" : "Fast Approval OK.", "directory_path" : null }, "new_biz" : null } ] } } }