华为云用户手册

初始表创建 此小节所附为本Tutorial首次创建表时所用到的表创建语法。这些表没有设置存储方式、分布键、分布方式和压缩方式。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 CREATE TABLE store_sales ( ss_sold_date_sk integer , ss_sold_time_sk integer , ss_item_sk integer not null, ss_customer_sk integer , ss_cdemo_sk integer , ss_hdemo_sk integer , ss_addr_sk integer , ss_store_sk integer , ss_promo_sk integer , ss_ticket_number bigint not null, ss_quantity integer , ss_wholesale_cost decimal(7,2) , ss_list_price decimal(7,2) , ss_sales_price decimal(7,2) , ss_ext_discount_amt decimal(7,2) , ss_ext_sales_price decimal(7,2) , ss_ext_wholesale_cost decimal(7,2) , ss_ext_list_price decimal(7,2) , ss_ext_tax decimal(7,2) , ss_coupon_amt decimal(7,2) , ss_net_paid decimal(7,2) , ss_net_paid_inc_tax decimal(7,2) , ss_net_profit decimal(7,2) ) ; CREATE TABLE date_dim ( d_date_sk integer not null, d_date_id char(16) not null, d_date date , d_month_seq integer , d_week_seq integer , d_quarter_seq integer , d_year integer , d_dow integer , d_moy integer , d_dom integer , d_qoy integer , d_fy_year integer , d_fy_quarter_seq integer , d_fy_week_seq integer , d_day_name char(9) , d_quarter_name char(6) , d_holiday char(1) , d_weekend char(1) , d_following_holiday char(1) , d_first_dom integer , d_last_dom integer , d_same_day_ly integer , d_same_day_lq integer , d_current_day char(1) , d_current_week char(1) , d_current_month char(1) , d_current_quarter char(1) , d_current_year char(1) ) ; CREATE TABLE store ( s_store_sk integer not null, s_store_id char(16) not null, s_rec_start_date date , s_rec_end_date date , s_closed_date_sk integer , s_store_name varchar(50) , s_number_employees integer , s_floor_space integer , s_hours char(20) , s_manager varchar(40) , s_market_id integer , s_geography_class varchar(100) , s_market_desc varchar(100) , s_market_manager varchar(40) , s_division_id integer , s_division_name varchar(50) , s_company_id integer , s_company_name varchar(50) , s_street_number varchar(10) , s_street_name varchar(60) , s_street_type char(15) , s_suite_number char(10) , s_city varchar(60) , s_county varchar(30) , s_state char(2) , s_zip char(10) , s_country varchar(20) , s_gmt_offset decimal(5,2) , s_tax_precentage decimal(5,2) ) ; CREATE TABLE item ( i_item_sk integer not null, i_item_id char(16) not null, i_rec_start_date date , i_rec_end_date date , i_item_desc varchar(200) , i_current_price decimal(7,2) , i_wholesale_cost decimal(7,2) , i_brand_id integer , i_brand char(50) , i_class_id integer , i_class char(50) , i_category_id integer , i_category char(50) , i_manufact_id integer , i_manufact char(50) , i_size char(20) , i_formulation char(20) , i_color char(20) , i_units char(10) , i_container char(10) , i_manager_id integer , i_product_name char(50) ) ; CREATE TABLE time_dim ( t_time_sk integer not null, t_time_id char(16) not null, t_time integer , t_hour integer , t_minute integer , t_second integer , t_am_pm char(2) , t_shift char(20) , t_sub_shift char(20) , t_meal_time char(20) ) ; CREATE TABLE promotion ( p_promo_sk integer not null, p_promo_id char(16) not null, p_start_date_sk integer , p_end_date_sk integer , p_item_sk integer , p_cost decimal(15,2) , p_response_target integer , p_promo_name char(50) , p_channel_dmail char(1) , p_channel_email char(1) , p_channel_catalog char(1) , p_channel_tv char(1) , p_channel_radio char(1) , p_channel_press char(1) , p_channel_event char(1) , p_channel_demo char(1) , p_channel_details varchar(100) , p_purpose char(15) , p_discount_active char(1) ) ; CREATE TABLE customer_demographics ( cd_demo_sk integer not null, cd_gender char(1) , cd_marital_status char(1) , cd_education_status char(20) , cd_purchase_estimate integer , cd_credit_rating char(10) , cd_dep_count integer , cd_dep_employed_count integer , cd_dep_college_count integer ) ; CREATE TABLE customer_address ( ca_address_sk integer not null, ca_address_id char(16) not null, ca_street_number char(10) , ca_street_name varchar(60) , ca_street_type char(15) , ca_suite_number char(10) , ca_city varchar(60) , ca_county varchar(30) , ca_state char(2) , ca_zip char(10) , ca_country varchar(20) , ca_gmt_offset decimal(5,2) , ca_location_type char(20) ) ; CREATE TABLE household_demographics ( hd_demo_sk integer not null, hd_income_band_sk integer , hd_buy_potential char(15) , hd_dep_count integer , hd_vehicle_count integer ) ; CREATE TABLE customer ( c_customer_sk integer not null, c_customer_id char(16) not null, c_current_cdemo_sk integer , c_current_hdemo_sk integer , c_current_addr_sk integer , c_first_shipto_date_sk integer , c_first_sales_date_sk integer , c_salutation char(10) , c_first_name char(20) , c_last_name char(30) , c_preferred_cust_flag char(1) , c_birth_day integer , c_birth_month integer , c_birth_year integer , c_birth_country varchar(20) , c_login char(13) , c_email_address char(50) , c_last_review_date char(10) ) ; CREATE TABLE income_band ( ib_income_band_sk integer not null, ib_lower_bound integer , ib_upper_bound integer ) ; 父主题： 附录：表创建语法

设计调优后二次表创建 本节所附为调优表实践中进行了存储方式、压缩级别、分布方式和分布列选择后，二次建表语法。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 CREATE TABLE store_sales ( ss_sold_date_sk integer , ss_sold_time_sk integer , ss_item_sk integer not null, ss_customer_sk integer , ss_cdemo_sk integer , ss_hdemo_sk integer , ss_addr_sk integer , ss_store_sk integer , ss_promo_sk integer , ss_ticket_number bigint not null, ss_quantity integer , ss_wholesale_cost decimal(7,2) , ss_list_price decimal(7,2) , ss_sales_price decimal(7,2) , ss_ext_discount_amt decimal(7,2) , ss_ext_sales_price decimal(7,2) , ss_ext_wholesale_cost decimal(7,2) , ss_ext_list_price decimal(7,2) , ss_ext_tax decimal(7,2) , ss_coupon_amt decimal(7,2) , ss_net_paid decimal(7,2) , ss_net_paid_inc_tax decimal(7,2) , ss_net_profit decimal(7,2) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY hash (ss_item_sk); CREATE TABLE date_dim ( d_date_sk integer not null, d_date_id char(16) not null, d_date date , d_month_seq integer , d_week_seq integer , d_quarter_seq integer , d_year integer , d_dow integer , d_moy integer , d_dom integer , d_qoy integer , d_fy_year integer , d_fy_quarter_seq integer , d_fy_week_seq integer , d_day_name char(9) , d_quarter_name char(6) , d_holiday char(1) , d_weekend char(1) , d_following_holiday char(1) , d_first_dom integer , d_last_dom integer , d_same_day_ly integer , d_same_day_lq integer , d_current_day char(1) , d_current_week char(1) , d_current_month char(1) , d_current_quarter char(1) , d_current_year char(1) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; CREATE TABLE store ( s_store_sk integer not null, s_store_id char(16) not null, s_rec_start_date date , s_rec_end_date date , s_closed_date_sk integer , s_store_name varchar(50) , s_number_employees integer , s_floor_space integer , s_hours char(20) , s_manager varchar(40) , s_market_id integer , s_geography_class varchar(100) , s_market_desc varchar(100) , s_market_manager varchar(40) , s_division_id integer , s_division_name varchar(50) , s_company_id integer , s_company_name varchar(50) , s_street_number varchar(10) , s_street_name varchar(60) , s_street_type char(15) , s_suite_number char(10) , s_city varchar(60) , s_county varchar(30) , s_state char(2) , s_zip char(10) , s_country varchar(20) , s_gmt_offset decimal(5,2) , s_tax_precentage decimal(5,2) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; CREATE TABLE item ( i_item_sk integer not null, i_item_id char(16) not null, i_rec_start_date date , i_rec_end_date date , i_item_desc varchar(200) , i_current_price decimal(7,2) , i_wholesale_cost decimal(7,2) , i_brand_id integer , i_brand char(50) , i_class_id integer , i_class char(50) , i_category_id integer , i_category char(50) , i_manufact_id integer , i_manufact char(50) , i_size char(20) , i_formulation char(20) , i_color char(20) , i_units char(10) , i_container char(10) , i_manager_id integer , i_product_name char(50) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; CREATE TABLE time_dim ( t_time_sk integer not null, t_time_id char(16) not null, t_time integer , t_hour integer , t_minute integer , t_second integer , t_am_pm char(2) , t_shift char(20) , t_sub_shift char(20) , t_meal_time char(20) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; CREATE TABLE promotion ( p_promo_sk integer not null, p_promo_id char(16) not null, p_start_date_sk integer , p_end_date_sk integer , p_item_sk integer , p_cost decimal(15,2) , p_response_target integer , p_promo_name char(50) , p_channel_dmail char(1) , p_channel_email char(1) , p_channel_catalog char(1) , p_channel_tv char(1) , p_channel_radio char(1) , p_channel_press char(1) , p_channel_event char(1) , p_channel_demo char(1) , p_channel_details varchar(100) , p_purpose char(15) , p_discount_active char(1) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; CREATE TABLE customer_demographics ( cd_demo_sk integer not null, cd_gender char(1) , cd_marital_status char(1) , cd_education_status char(20) , cd_purchase_estimate integer , cd_credit_rating char(10) , cd_dep_count integer , cd_dep_employed_count integer , cd_dep_college_count integer ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY hash (cd_demo_sk); CREATE TABLE customer_address ( ca_address_sk integer not null, ca_address_id char(16) not null, ca_street_number char(10) , ca_street_name varchar(60) , ca_street_type char(15) , ca_suite_number char(10) , ca_city varchar(60) , ca_county varchar(30) , ca_state char(2) , ca_zip char(10) , ca_country varchar(20) , ca_gmt_offset decimal(5,2) , ca_location_type char(20) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY hash (ca_address_sk); CREATE TABLE household_demographics ( hd_demo_sk integer not null, hd_income_band_sk integer , hd_buy_potential char(15) , hd_dep_count integer , hd_vehicle_count integer ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; CREATE TABLE customer ( c_customer_sk integer not null, c_customer_id char(16) not null, c_current_cdemo_sk integer , c_current_hdemo_sk integer , c_current_addr_sk integer , c_first_shipto_date_sk integer , c_first_sales_date_sk integer , c_salutation char(10) , c_first_name char(20) , c_last_name char(30) , c_preferred_cust_flag char(1) , c_birth_day integer , c_birth_month integer , c_birth_year integer , c_birth_country varchar(20) , c_login char(13) , c_email_address char(50) , c_last_review_date char(10) ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY hash (c_customer_sk); CREATE TABLE income_band ( ib_income_band_sk integer not null, ib_lower_bound integer , ib_upper_bound integer ) WITH (ORIENTATION = column,COMPRESSION=middle) DISTRIBUTE BY replication; 父主题： 附录：表创建语法

附录使用说明 本节所附为调优表实践中使用到的SQL测试语句，推荐您将每节的SQL语句拷贝并另存为.sql文件。例如，创建一个包含“初始表创建”SQL语句的create_table_fir.sql文件。创建后使用SQL客户端工具执行.sql文件效率更高，且利于统计用例的总耗费时间。使用gsql运行.sql文件的方法如下： 1 gsql -d database_name -h dws_ip -U username -p port_number -W password -f XXX.sql 示例中的部分信息请替换成您所用GaussDB(DWS)集群的实际值： 1 gsql -d postgres -h 10.10.0.1 -U dbadmin -p 8000 -W password -f create_table_fir.sql 如示例中涉及的以下信息可根据实际情况替换： postgres：所要连接的数据库名称。 10.10.0.1：集群连接地址。 dbadmin：集群数据库的用户名。默认管理员用户为“dbadmin”。 8000：创建集群时设置的“数据库端口”。 password：创建集群时设置的密码。 父主题： 附录：表创建语法

共享带宽 当您有大量业务在云上时，如果每个ECS单独使用一条独享带宽，则需要较多的带宽实例，并且总的带宽费用会较高，如果所有实例共用一条带宽，就可以节省企业的网络运营成本，同时方便运维统计。共享带宽是独立的带宽产品，支持将多个按需计费的弹性公网IP添加到共享带宽，对多个弹性公网IP进行集中限速。您可以将EIP绑定到ECS、NAT网关、ELB等产品，从而使这些产品使用共享带宽。 支持两种计费模式： 按带宽计费：如果您使用的弹性公网IP较多，并且错峰明显，使用共享带宽可以大幅节约成本。 按增强型95计费：如果您部署的业务经常有突发峰值，可以选择增强型95计费。既可以保证业务系统不受峰值带宽不够的影响，又可以避免带宽峰值设置过大带来的成本浪费。

共享流量包 共享流量包是公网流量的预付费套餐，价格比后付费流量更低，大大降低了公网流量成本。共享流量包购买后立即生效，自动抵扣按需计费（按流量计费）的EIP带宽产生的流量资费，使用简单，无需额外操作。 共享流量包适用哪些场景？ 对于按流量计费的带宽，启用共享流量包后，该带宽所产生的流量费用优先从共享流量包中进行抵扣。共享流量包全部使用完后，再按后付费流量进行结算。从节约成本的角度看，流量越大，节省的成本越多。 共享流量包使用说明 只能抵扣同一区域产生的带宽流量，不支持跨区域抵扣。 共享流量包包括动态和静态两种类型，分别抵扣全动态BGP和静态BGP产生的流量。 共享流量包具有使用有效期（从购买开始计算1个自然月或1个自然年）。超过有效期后，没有使用完的流量无法继续使用。建议根据业务系统历史情况仔细评估需要多少共享流量包。 共享流量包支持自动续费功能。如果您开通了自动续费功能，那么共享流量包到期前7天内，系统会尝试自动续费扣款，续费成功后，共享流量包中剩余的流量可以在新的有效期内继续使用。 共享流量包全部使用完后，系统会自动按后付费流量进行结算，不会导致业务系统无法使用。

应用场景 将弹性公网IP绑定到弹性云服务器上，可以实现弹性云服务器访问公网的目的。如果您需要为弹性云服务器更换弹性公网IP，暂不支持直接更换弹性云服务器的弹性公网IP。您可以先解绑当前的弹性公网IP，再重新为弹性云服务器绑定新的弹性公网IP。 如果无可更换的弹性公网IP，您需要先申请新的弹性公网IP，再进行更换操作。 为防止误删除操作，弹性公网IP存在24小时缓存机制，对于已释放过弹性公网IP的用户，24小时内会优先分配之前使用过的弹性公网IP。 如需申请新的弹性公网IP地址，建议您先购买新的弹性公网IP后再释放旧的弹性公网IP。 详细内容请参考弹性公网IP的分配策略。

约束与限制 一个弹性公网IP只能绑定一个云资源，且弹性公网IP和云资源必须位于同一个区域。 通用可用区的EIP不支持绑定至边缘可用区的实例，边缘可用区的EIP也不支持绑定至通用可用区的实例。 关于边缘可用区和普通可用区的区别请参考《智能边缘小站用户指南》。 弹性公网IP与云资源属于不同的资源，弹性公网IP的计费方式和云资源不同的情况下，不影响绑定。 比如，包年/包月的弹性公网IP可以绑定给按需计费的弹性云服务器使用。 资源欠费被冻结的EIP，或绑定的服务器对外有攻击行为等安全原因被冻结的EIP，无法进行绑定、解绑等操作。需要先解除冻结，具体参见EIP资源在什么情况下会被冻结，如何解除被冻结的EIP资源

为弹性云服务器更换弹性公网IP流程 本章节介绍为弹性云服务器更换新的弹性公网IP总体流程，流程说明如表1所示。 表1 为ECS更换新的EIP流程说明 步骤 说明 步骤一：解绑弹性公网IP 将已绑定的弹性公网IP EIP-A从弹性云服务器ECS-A中解绑。 步骤二：绑定新的弹性公网IP 在绑定弹性公网IP页面，为弹性云服务器ECS-A绑定新的弹性公网IP EIP-B。 步骤三：释放已被解绑的弹性公网IP 如果不及时释放该弹性公网IP，会产生弹性公网IP保有费，当您无需继续使用此弹性公网IP时，您可以释放EIP-A。 父主题： 为弹性云服务器更换弹性公网IP

资源规划 为弹性云服务器更换弹性公网IP，您需要规划资源，本示例中为您详细介绍资源情况。 虚拟私有云VPC、弹性公网IP、弹性云服务器ECS位于同一个区域内。 以下资源规划详情仅为示例，您可以根据需要自行修改。 虚拟私有云VPC：1个，资源规划详情如表1所示。 表1 VPC资源规划详情 VPC名称 VPC网段 子网名称 子网网段 关联路由表 VPC 192.168.0.0/16 Subnet 192.168.1.0/24 默认路由表 弹性云服务器ECS：1个，资源规划详情如表2所示。 表2 ECS资源规划详情 ECS名称 镜像 VPC名称 子网名称 安全组 私有IP地址 ECS-A 公共镜像： EulerOS 2.5 64bit VPC Subnet sg-demo： 通用We b服务器 192.168.1.99 弹性公网IP：2个，资源规划详情如表3所示。 表3 EIP资源规划详情 EIP名称 线路 带宽大小 购买时长：1个月 规格 EIP-A 全动态BGP 1 Mbit/s Subnet-A 122.xx.xx.189 EIP-B 全动态BGP 5 Mbit/s Subnet-A 122.xx.xx.166 父主题： 为弹性云服务器更换弹性公网IP

权限控制 全球SIM联接服务客户默认拥有服务提供的所有功能权限。如若需要给管理员创建的IAM子用户授权，只需给该子用户所在用户组配置“cn-north-4 [华北-北京四]”区域的Tenant Guest权限。 关于Tenant Guest权限的介绍和开通方法，详细参见系统权限，将其加入用户组，并给用户组授予策略或角色。 只有管理员才有购买全球SIM联接服务资源和进行续费操作的权限，子用户只能对已有资源进行日常维护。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 表5 响应Body参数 参数 参数类型 描述 total Integer 查询结果的总元素数量 callback_config Array of RecordCallbackConfig objects 转码模板 表6 RecordCallbackConfig 参数 参数类型 描述 id String 配置规则ID，在创建配置规则成功后服务端返回 publish_domain String 直播推流域名 app String app名称。如果需要匹配任意应用则需填写*。录制规则匹配的时候，优先精确app匹配，如果匹配不到，则匹配* notify_callback_url String 录制回调通知url地址 notify_event_subscription Array of strings 订阅录制通知消息。消息类型。RECORD_NEW_FILE_START开始创建新的录制文件。RECORD_FILE_COMPLETE录制文件生成完成。RECORD_OVER录制结束。RECORD_FAILED表示录制失败。如果不填写,默认订阅RECORD_FILE_COMPLETE sign_type String 加密类型，包含如下取值 HMACSHA256 MD5 create_time String 创建时间，格式：yyyy-mm-ddThh:mm:ssZ，UTC时间。 在查询的时候返回 update_time String 修改时间，格式：yyyy-mm-ddThh:mm:ssZ，UTC时间。 在查询的时候返回 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 200 查询录制回调成功 { "total" : 1, "callback_config" : [ { "id" : "e2fe84def7e476651034ec4b9e92bc30", "publish_domain" : "publish.xxx.com", "app" : "*", "notify_callback_url" : "http://100.95.129.234:8456/base_record_notify", "notify_event_subscription" : [ "RECORD_FILE_COMPLETE", "RECORD_NEW_FILE_START" ], "create_time" : "2020-03-02T08:59:45Z", "update_time" : "2020-03-09T08:59:45Z" } ]} 状态码： 400 查询录制回调失败 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal"}

URI GET /v1/{project_id}/record/callbacks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 publish_domain 否 String 直播推流域名 app 否 String 流应用名称 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 limit 否 Integer 每页记录数，取值范围[1,100]，默认值10

响应示例 状态码： 200 处理成功返回。 { "record_data_list" : [ { "time" : "2020-08-18T07:00:00Z", "concurrent_count" : 20 }, { "time" : "2020-08-18T08:00:00Z", "concurrent_count" : 15 } ]} 状态码： 400 参数错误。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: publish_domain"}

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。

URI GET /v2/{project_id}/stats/record 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 publish_domain 否 String 推流域名。 start_time 否 String 起始时间。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ。非整点时间按小时取整，若start_time为2020-08-18T07:20:40Z，则实际查询起始时间为2020-08-18T07:00:00Z。若start_time为空，则默认查询最近24小时数据。 end_time 否 String 结束时间。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ。非整点时间按小时取整，若end_time为2020-08-18T08:20:40Z，则实际查询起始时间为2020-08-18T08:00:00Z。若参数为空，默认为当前时间。结束时间需大于起始时间。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 record_data_list Array of RecordData objects 采样数据列表。 表6 RecordData 参数 参数类型 描述 concurrent_count Integer 最大并发路数。 time String 采样时间，每小时内最大并发路数时间点。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ 。 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 查询直播中的流信息数据成功 { "total_page" : 1, "total_num" : 10, "offset" : 0, "limit" : 10, "request_id" : "56b9f4dc-b282-48e0-a1a9-c50ffb06b687", "streams" : [ { "publish_domain" : "push.example.huawei.com", "app" : "live", "stream" : "test", "video_codec" : "H264", "audio_codec" : "AAC", "video_frame_rate" : 15, "audio_frame_rate" : 43, "video_bitrate" : 588, "audio_bitrate" : 68, "resolution" : "640x360", "client_ip" : "192.168.0.100", "start_time" : "2006-01-02T15:04:05Z" } ]} 状态码： 400 查询直播中的流信息数据失败 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total_page Long 总页数 total_num Long 总条目数 offset Long 偏移量 limit Long 每页条目数 request_id String 请求唯一标识 streams Array of OnlineInfo objects 推流统计 表5 OnlineInfo 参数 参数类型 描述 publish_domain String 域名 app String 应用名 stream String 流名 video_codec String 视频编码方式 H264 H265 audio_codec String 音频编码方式：AAC video_frame_rate Long 视频帧率（单位：fps） audio_frame_rate Long 音频帧率（单位：fps） video_bitrate Long 视频码率（单位：Kbps） audio_bitrate Long 音频码率（单位：Kbps） resolution String 视频分辨率 client_ip String 推流设备的ip start_time String 开始推流的时间，UTC格式：2006-01-02T15:04:05Z 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v1/{project_id}/realtime/streams 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 publish_domain 是 String 推流域名 app 否 String 应用名 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 limit 否 Integer 每页记录数，取值范围[1,100]，默认值10 stream 否 String 流名，用于单流查询，携带stream参数时app不能缺省

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 history_stream_list Array of HistoryStreamInfo objects 历史流信息列表。 total Integer 总记录数。 表6 HistoryStreamInfo 参数 参数类型 描述 domain String 推流域名。 type为0表主播推流域名。 type为1表示第三方推流域名 app String 应用名称。 stream String 流名。 type Integer 推流类型，取值如下： 0：表示主播推流 1：表示第三方推流 video_codec String 视频编码格式。 audio_codec String 音频编码格式。 client_ip String 主播ip。 start_time String 采样开始时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 end_time String 采样结束时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "history_stream_list" : [ { "domain" : "example.xxx.com", "app" : "live", "stream" : "pull", "type" : 0, "video_codec" : "H264", "audio_codec" : "AAC", "client_ip" : "127.0.0.1", "start_time" : "2020-06-04T07:00:00Z", "end_time" : "2020-06-05T07:00:00Z" } ], "total" : 100} 状态码： 400 参数错误。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: domain"}

URI GET /v2/{project_id}/stats/history/streams 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 是 String 推流域名。 app 否 String 应用名称。 stream 否 String 流名称。 start_time 否 String 起始时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。最大查询跨度1天。 若参数为空，默认查询1天数据。 end_time 否 String 结束时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 若参数为空，默认为当前时间，最大查询跨度1天。结束时间需大于起始时间。 offset 否 Integer 分页编号，默认为0 limit 否 Integer 每页记录数。 取值范围：[1,100] 默认值：10。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。

响应示例 状态码： 200 处理成功返回。 { "data_series" : [ { "time" : "2020-06-04T07:00:00Z", "http_codes" : [ { "code" : 200, "count" : 750, "proportion" : 0.5211 }, { "code" : 400, "count" : 650, "proportion" : 0.4789 } ] }, { "time" : "2020-06-04T07:01:00Z", "http_codes" : [ { "code" : 200, "count" : 1000, "proportion" : 1 }, { "code" : 400, "count" : 0, "proportion" : 0 } ] } ]} 状态码： 400 参数错误。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: play_domains"}

URI GET /v2/{project_id}/stats/httpcodes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 play_domains 是 Array 播放域名列表，最多支持查询100个域名，多个域名以逗号分隔。 code 否 Array 状态码。 region 否 Array 区域列表。具体取值请参考省份名称缩写，不填写查询所有区域。 isp 否 Array 运营商列表，取值如下： CMCC ：移动 CTCC ： 电信 CUCC ：联通 OTHER ：其他 不填写查询所有运营商。 start_time 否 String 起始时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。若参数为空，默认查询最近1小时数据。 最大查询跨度1天，最大查询周期7天。 end_time 否 String 结束时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 若参数为空，默认为当前时间。结束时间需大于起始时间。 最大查询跨度1天，最大查询周期7天。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 data_series Array of HttpCodeSummary objects 基于时间轴的状态码 表6 HttpCodeSummary 参数 参数类型 描述 http_codes Array of HttpCode objects 状态码信息 time String 采样时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ 。 表7 HttpCode 参数 参数类型 描述 code Integer 状态码 count Integer 状态码出现次数 proportion Double 状态码在对应时间点中的占比，保留4位小数。 状态码： 400 表8 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。