华为云用户手册

参数描述 表1 ObsClientConfig 参数名称 参数类型 是否必选 描述 AccessKeyId string 可选 参数解释： 访问密钥中的AK。获取方式请参考准备访问密钥。 约束限制： 无 默认取值： 无，表示匿名用户。 SecretAccessKey string 可选 参数解释： 访问密钥中的SK。获取方式请参考准备访问密钥。 约束限制： 无 默认取值： 无，表示匿名用户。 SecurityToken string 可选，使用临时访问密钥时必选。 参数解释： 临时访问密钥中的SecurityToken。 如何获取临时访问密钥和securitytoken请参见临时访问密钥AK/SK获取。 默认取值： 无，表示匿名用户 Server string 必选 参数解释： 连接OBS的服务地址。包含协议类型、 域名 （或IP）、端口号。示例：https://your-endpoint:443。（出于安全性考虑，建议使用https协议）。 您可以从这里查看OBS当前开通的服务地址。 Timeout number 可选 参数解释： HTTP/HTTPS请求的总超时时间。 说明： 如网络状况不佳或者上传文件较大，建议增大Timeout的值。 约束限制： 无 取值范围： 0~（231-1），单位：秒。 默认取值： 300，单位：秒。 IsCname boolean 可选 参数解释： 是否通过自定义域名访问OBS服务。 约束限制： 无 取值范围： true：使用自定义域名访问OBS服务。 false：不使用自定义域名访问OBS服务。 默认取值： false

参数描述 表1 LogConfig 参数名称 参数类型 是否必选 描述 level LogLevel 必选 参数解释： 日志级别。 表2 LogLevel 常量名 原始值 说明 OFF off 关闭级别，如果设置为这个级别，日志打印功能将被关闭。 ERROR error 错误级别，如果设置为这个级别，仅打印发生异常时的错误信息。 WARN warn 告警级别，如果设置为这个级别，除了打印错误级别的信息外，还将打印一些关键事件的信息。 INFO info 信息级别，如果设置为这个级别，除了打印告警级别的信息外，还将打印HTTP/HTTPS请求的耗时时间，ObsClient接口的耗时时间等。 DEBUG debug 调试级别，如果设置为这个级别，除了打印INFO级别的信息外，还将打印每次HTTP/HTTPS请求和响应的头信息、鉴权算法计算出的stringToSign信息等。

日志级别 当系统出现问题需要定位且当前的日志无法满足要求时，可以通过修改日志的级别来获取更多的信息。SDK提供了代表日志级别的枚举常量以设置不同的日志级别，具体说明如下： 表1 LogLevel 常量名 原始值 说明 OFF off 关闭级别，如果设置为这个级别，日志打印功能将被关闭。 ERROR error 错误级别，如果设置为这个级别，仅打印发生异常时的错误信息。 WARN warn 告警级别，如果设置为这个级别，除了打印错误级别的信息外，还将打印一些关键事件的信息。 INFO info 信息级别，如果设置为这个级别，除了打印告警级别的信息外，还将打印HTTP/HTTPS请求的耗时时间，ObsClient接口的耗时时间等。 DEBUG debug 调试级别，如果设置为这个级别，除了打印INFO级别的信息外，还将打印每次HTTP/HTTPS请求和响应的头信息、鉴权算法计算出的stringToSign信息等。

并行文件系统相关接口(Harmony SDK) 并行文件系统（Parallel File System）是 对象存储服务 （Object Storage Service，OBS）提供的一种经过优化的高性能文件系统，提供毫秒级别访问时延，TB/s级别带宽和百万级别的IOPS，能够快速处理高性能计算（HPC）工作负载。 创建并行文件系统(Harmony SDK) 列举并行文件系统(Harmony SDK) 列举并行文件系统内对象(Harmony SDK) 重命名对象(Harmony SDK) 修改写对象(Harmony SDK) 截断对象(Harmony SDK)

其他使用前须知 本文档是与OBS SDK配套的参考文档，为了您能更好的使用Harmony SDK，推荐前往下载与安装SDK(Harmony SDK)下载最新版本的Harmony SDK。 请确认您已经熟悉OBS的基本概念，如桶（Bucket）、对象（Object）、访问密钥（AK和SK）、终端节点（Endpoint）和访问域名等。 使用OBS客户端进行接口调用成功后，均会返回包含响应头信息的SDK公共响应头实例（或其子类实例）。 当前各区域特性开放不一致，部分特性只在部分区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。您可以查看功能总览确认区域是否支持该功能特性，或者提交工单寻求技术支持。

请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 input CreatePostSignatureSyncInput 必选 参数解释： 生成带授权信息的表单上传参数接口入参，详见CreatePostSignatureSyncInput。 表2 CreatePostSignatureSyncInput 参数名称 参数类型 是否可选 描述 Bucket string 可选 参数解释： 桶名。 约束限制： 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。 桶命名规则如下： 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻（如：“my..bucket”）。 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。 默认取值： 无 Key string 可选 参数解释： 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径，路径中不包含桶名。 例如，您对象的访问地址为examplebucket.obs.cn-north-4. emyhuaweicloud.com/folder/test.txt 中，对象名为folder/test.txt。 取值范围： 长度大于0且不超过1024的字符串。 默认取值： 无 Expires number 可选 参数解释： 表单上传鉴权的过期时间。 取值范围： 0~（263-1），单位：秒。 默认取值： 300 FormParams object 可选 参数解释： 除key，policy，signature外，表单上传时的其他参数。 取值范围： acl、cache-control、content-type、content-disposition、content-encoding、expires。 默认取值： 无

返回结果 表3 CreateBrowserBasedSignatureOutput 参数名称 参数类型 描述 OriginPolicy string 参数解释： Policy未经过base64之前的值，仅用于校验。 示例：{"expiration":"2023-09-12T12:52:59Z","conditions":[{"content-type":"text/plain"},{"bucket":"examplebucket"},{"key":"example/objectname"},]}"。 默认取值： 无 Policy string 参数解释： 表单中的policy，已经base64之后的值。 示例：eyJleHBpcmF0aW9uIjoiMjAyMy0wOS0xMlQxMjo1Mjo1OVoiLCJjb25kaXRpb25zIjpbeyJjb250ZW50LXR5cGUiOiJ0ZXh0L3BsYWluIn0seyJidWNrZXQiOiJleGFtcGxlYnVja2V0In0seyJrZXkiOiJleGFtcGxlL29iamVjdG5hbWUifSxdfQ==。 默认取值： 无 Signature string 参数解释： 表单中的signature。 示例：g0jQr4v9VWd1Q2FOFDG6LGfV9Cw=。 默认取值： 无

常见的Content-Type 常见的Content-Type（MIME）列表如下： 表1 常见的Content-Type（MIME）列表 文件扩展名 Content-Type(Mime-Type) 文件扩展名 Content-Type(Mime-Type) .*（二进制流，未知的文件类型） application/octet-stream .tif image/tiff .a11 application/x-a11 .acp audio/x-mei-aac .ai application/postscript .aif audio/aiff .aifc audio/aiff .aiff audio/aiff .anv application/x-anv .apk application/vnd.android.package-archive .asa text/asa .asf video/x-ms-asf .asp text/asp .asx video/x-ms-asf .au audio/basic .avi video/avi .awf application/vnd.adobe.workflow .biz text/xml .bmp application/x-bmp .bot application/x-bot .c4t application/x-c4t .c90 application/x-c90 .cal application/x-cals .cat application/vnd.ms-pki.seccat .cdf application/x-netcdf .cdr application/x-cdr .cel application/x-cel .cer application/x-x509-ca-cert .cg4 application/x-g4 .cgm application/x-cgm .cit application/x-cit .class java/ .cml text/xml .cmp application/x-cmp .cmx application/x-cmx .cot application/x-cot .crl application/pkix-crl .crt application/x-x509-ca-cert .csi application/x-csi .css text/css .csv text/csv .cut application/x-cut .dbf application/x-dbf .dbm application/x-dbm .dbx application/x-dbx .dcd text/xml .dcx application/x-dcx .der application/x-x509-ca-cert .dgn application/x-dgn .dib application/x-dib .dll application/x-msdownload .doc application/msword .docx application/vnd.openxmlformats-officedocument.wordprocessingml.document .dot application/msword .dotx application/vnd.openxmlformats-officedocument.wordprocessingml.template .drw application/x-drw .dtd text/xml .dwf Model/vnd.dwf .dwf application/x-dwf .dwg application/x-dwg .dxb application/x-dxb .dxf application/x-dxf .edn application/vnd.adobe.edn .emf application/x-emf .eml message/rfc822 .ent text/xml .epi application/x-epi .eps application/x-ps .eps application/postscript .etd application/x-ebx .exe application/x-msdownload .fax image/fax .fdf application/vnd.fdf .fif application/fractals .fo text/xml .frm application/x-frm .g4 application/x-g4 .gbr application/x-gbr . application/x- .gif image/gif .gl2 application/x-gl2 .gp4 application/x-gp4 .hgl application/x-hgl .hmr application/x-hmr .hpg application/x-hpgl .hpl application/x-hpl .hqx application/mac-binhex40 .hrf application/x-hrf .hta application/hta .htc text/x-component .htm text/html .html text/html .htt text/webviewhtml .htx text/html .icb application/x-icb .ico image/x-icon .ico application/x-ico .iff application/x-iff .ig4 application/x-g4 .igs application/x-igs .iii application/x-iphone .img application/x-img .ins application/x-internet-signup .ipa application/vnd.iphone .isp application/x-internet-signup .IVF video/x-ivf .java java/* .jfif image/jpeg .jpe image/jpeg .jpe application/x-jpe .jpeg image/jpeg .jpg image/jpeg .jpg application/x-jpg .js application/x-javascript .jsp text/html .la1 audio/x-liquid-file .lar application/x-laplayer-reg .latex application/x-latex .lavs audio/x-liquid-secure .lbm application/x-lbm .lmsff audio/x-la-lms .ls application/x-javascript .ltr application/x-ltr .m1v video/x-mpeg .m2v video/x-mpeg .m3u audio/mpegurl .m4e video/mpeg4 .mac application/x-mac .man application/x-troff-man .math text/xml .mdb application/msaccess .mdb application/x-mdb .mfp application/x-shockwave-flash .mht message/rfc822 .mhtml message/rfc822 .mi application/x-mi .mid audio/mid .midi audio/mid .mil application/x-mil .mml text/xml .mnd audio/x-musicnet-download .mns audio/x-musicnet-stream .mocha application/x-javascript .mov video/quicktime .movie video/x-sgi-movie mp1 audio/mp1 .mp2 audio/mp2 .mp2v video/mpeg .mp3 audio/mp3 .mp4 video/mp4 .mpa video/x-mpg .mpd application/vnd.ms-project .mpe video/x-mpeg .mpeg video/mpg .mpg video/mpg .mpga audio/rn-mpeg .mpp application/vnd.ms-project .mps video/x-mpeg .mpt application/vnd.ms-project .mpv video/mpg .mpv2 video/mpeg .mpw application/vnd.ms-project .mpx application/vnd.ms-project .mtx text/xml .mxp application/x-mmxp .net image/pnetvue .nrf application/x-nrf .nws message/rfc822 .odc text/x-ms-odc .out application/x-out .p10 application/pkcs10 .p12 application/x-pkcs12 .p7b application/x-pkcs7-certificates .p7c application/pkcs7-mime .p7m application/pkcs7-mime .p7r application/x-pkcs7-certreqresp .p7s application/pkcs7-signature .pc5 application/x-pc5 .pci application/x-pci .pcl application/x-pcl .pcx application/x-pcx .pdf application/pdf .pdb chemical/x-pdb .pdx application/vnd.adobe.pdx .pfx application/x-pkcs12 .pgl application/x-pgl .pic application/x-pic .pko application/vnd.ms-pki.pko .pl application/x-perl .plg text/html .pls audio/scpls .plt application/x-plt .png image/png .png application/x-png .pot application/vnd.ms-powerpoint .potx application/vnd.openxmlformats-officedocument.presentationml.template .ppa application/vnd.ms-powerpoint .ppm application/x-ppm .pps application/vnd.ms-powerpoint .ppsx application/vnd.openxmlformats-officedocument.presentationml.slideshow .ppt application/vnd.ms-powerpoint .ppt application/x-ppt . pptx application/vnd.openxmlformats-officedocument.presentationml.presentation .pr application/x-pr .prf application/pics-rules .prn application/x-prn .prt application/x-prt .ps application/x-ps .ps application/postscript .ptn application/x-ptn .pwz application/vnd.ms-powerpoint .r3t text/vnd.rn-realtext3d .ra audio/vnd.rn-realaudio .ram audio/x-pn-realaudio .ras application/x-ras .rat application/rat-file .rdf text/xml .rec application/vnd.rn-recording .red application/x-red .rgb application/x-rgb .rjs application/vnd.rn-realsystem-rjs .rjt application/vnd.rn-realsystem-rjt .rlc application/x-rlc .rle application/x-rle .rm application/vnd.rn-realmedia .rmf application/vnd.adobe.rmf .rmi audio/mid .rmj application/vnd.rn-realsystem-rmj .rmm audio/x-pn-realaudio .rmp application/vnd.rn-rn_music_package .rms application/vnd.rn-realmedia-secure .rmvb application/vnd.rn-realmedia-vbr .rmx application/vnd.rn-realsystem-rmx .rnx application/vnd.rn-realplayer .rp image/vnd.rn-realpix .rpm audio/x-pn-realaudio-plugin .rsml application/vnd.rn-rsml .rt text/vnd.rn-realtext .rtf application/msword .rtf application/x-rtf .rv video/vnd.rn-realvideo .sam application/x-sam .sat application/x-sat .sdp application/sdp .sdw application/x-sdw .sis application/vnd.symbian.install .sisx application/vnd.symbian.install .sit application/x-stuffit .slb application/x-slb .sld application/x-sld .sldx application/vnd.openxmlformats-officedocument.presentationml.slide .slk drawing/x-slk .smi application/smil .smil application/smil .smk application/x-smk .snd audio/basic .sol text/plain .sor text/plain .spc application/x-pkcs7-certificates .spl application/futuresplash .spp text/xml .ssm application/streamingmedia .sst application/vnd.ms-pki.certstore .stl application/vnd.ms-pki.stl .stm text/html .sty application/x-sty .svg image/svg+xml .swf application/x-shockwave-flash .tdf application/x-tdf .tg4 application/x-tg4 .tga application/x-tga .tif image/tiff .tif application/x-tif .tiff image/tiff .tld text/xml .top drawing/x-top .torrent application/x-bittorrent .tsd text/xml .txt text/plain .uin application/x-icq .uls text/iuls .vcf text/x-vcard .vda application/x-vda .vdx application/vnd.visio .vml text/xml .vpg application/x-vpeg005 .vsd application/vnd.visio .vsd application/x-vsd .vss application/vnd.visio .vst application/vnd.visio .vst application/x-vst .vsw application/vnd.visio .vsx application/vnd.visio .vtx application/vnd.visio .vxml text/xml .wav audio/wav .wax audio/x-ms-wax .wb1 application/x-wb1 .wb2 application/x-wb2 .wb3 application/x-wb3 .wbmp image/vnd.wap.wbmp .wiz application/msword .wk3 application/x-wk3 .wk4 application/x-wk4 .wkq application/x-wkq .wks application/x-wks .wm video/x-ms-wm .wma audio/x-ms-wma .wmd application/x-ms-wmd .wmf application/x-wmf .wml text/vnd.wap.wml .wmv video/x-ms-wmv .wmx video/x-ms-wmx .wmz application/x-ms-wmz .wp6 application/x-wp6 .wpd application/x-wpd .wpg application/x-wpg .wpl application/vnd.ms-wpl .wq1 application/x-wq1 .wr1 application/x-wr1 .wri application/x-wri .wrk application/x-wrk .ws application/x-ws .ws2 application/x-ws .wsc text/scriptlet .wsdl text/xml .wvx video/x-ms-wvx .xap application/x-silverlight-app .x_b application/x-x_b .xdp application/vnd.adobe.xdp .xdr text/xml .xfd application/vnd.adobe.xfd .xfdf application/vnd.adobe.xfdf .xhtml text/html .xls application/vnd.ms-excel .xls application/x-xls .xlsx application/vnd.openxmlformats-officedocument.spreadsheetml.sheet .xltx application/vnd.openxmlformats-officedocument.spreadsheetml.template .xlw application/x-xlw .xml text/xml .xpl audio/scpls .xq text/xml .xql text/xml .xquery text/xml .xsd text/xml .xsl text/xml .xslt text/xml .xwd application/x-xwd .x_t application/x-x_t .yaml text/vnd.yaml .yml text/vnd.yml .webp image/webp .tar application/x-tar .zip application/zip

Harmony SDK接口概览(Harmony SDK) 表1总结了OBS Harmony SDK所有接口的描述与使用方式、方法定义及参数说明等内容。 表1 Harmony SDK API 接口名 定义方法 功能描述 创建桶 ObsClient.createBucket 在当前账号按照用户指定的桶名创建一个新桶，接口支持根据用户诉求，在创建桶的同时配置桶的存储类别、区域及桶的访问权限等参数。 获取桶列表 ObsClient.listBuckets 列举当前账号所有地域下符合指定条件的桶。返回结果以桶名的字典序排序。 判断桶是否存在 ObsClient.headBucket 判断指定桶名的桶是否存在，返回的结果中HTTP状态码为200表明桶存在，否则返回404表明桶不存在。 删除桶 ObsClient.deleteBucket 桶为空时，用户可以删除桶，以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。 列举桶内对象 ObsClient.listObjects 列举指定桶内的部分或所有对象的描述信息。还可以通过设置前缀、数量、起始位置等参数，返回符合筛选条件的对象信息。返回结果以对象名的字典序排序。 列举桶内多版本对象 ObsClient.listVersions 列举指定桶内的部分或所有多版本对象的描述信息。还可以通过设置前缀、数量、起始位置等参数，返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。 获取桶元数据 ObsClient.getBucketMetadata 获取指定桶的相关信息，包括指定桶的存储类别、区域位置、跨域资源共享（CORS）规则、冗余策略等信息。 获取桶区域位置 ObsClient.getBucketLocation 获取指定桶所在的区域位置。 获取桶存量信息 ObsClient.getBucketStorageInfo 获取桶的存量信息，包括桶已使用的空间大小以及桶包含的对象个数。 设置桶配额 ObsClient.setBucketQuota 设置桶的配额限制来控制桶内允许上传的对象总容量，超过设置的对象容量后，上传对象会失败。 获取桶配额 ObsClient.getBucketQuota 获取桶的配额值，0代表配额没有上限。 设置桶存储类型 ObsClient.setBucketStoragePolicy 设置指定桶的存储类别。设置桶的存储类别后，如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类别，则该对象的存储类别默认与桶的存储类别保持一致。 获取桶存储类型 ObsClient.getBucketStoragePolicy 获取桶的存储类型。 设置桶ACL ObsClient.setBucketAcl 设置指定桶的ACL策略。 获取桶ACL ObsClient.getBucketAcl 获取指定桶的ACL策略。 设置桶日志管理配置 ObsClient.setBucketLoggingConfiguration 为指定桶打开桶日志功能，并配置日志存放的目标桶。桶日志功能开启后，桶的每次操作将会产生一条日志，并将多条日志打包成一个日志文件。日志文件存放到开启日志功能的桶中，也可以存放到其他您有权限的桶中，但需要和开启日志功能的桶在同一个region中。您还可以根据需要配置日志文件的访问权限，以及日志文件的文件名前缀。 获取桶日志管理配置 ObsClient.getBucketLoggingConfiguration 获取桶的访问日志配置。 设置桶策略 ObsClient.setBucketPolicy 配置桶的策略，如果桶已经存在一个策略，那么当前请求中的策略将完全覆盖桶中现存的策略。 获取桶策略 ObsClient.getBucketPolicy 获取桶的策略配置。 删除桶策略 ObsClient.deleteBucketPolicy 删除指定桶的桶策略。无论桶的策略本身是否存在，删除成功后系统都直接返回“204 No Content”的结果。 设置桶的生命周期配置 ObsClient.setBucketLifecycleConfiguration 配置桶的生命周期规则，实现定时转换桶中对象的存储类型，以及定时删除桶中对象的功能。 获取桶的生命周期配置 ObsClient.getBucketLifecycleConfiguration 获取桶的生命周期规则。 删除桶的生命周期配置 ObsClient.deleteBucketLifecycleConfiguration 删除桶所有的生命周期规则。 设置桶的Website 配置 ObsClient.setBucketWebsiteConfiguration 设置桶的Website配置。 获取桶的Website 配置 ObsClient.getBucketWebsiteConfiguration 获取桶的Website配置。 删除桶的Website 配置 ObsClient.deleteBucketWebsiteConfiguration 删除指定桶的Website配置。 设置桶的多版本状态 ObsClient.setBucketVersioning 为指定桶设置多版本状态。在一个桶中保留对象的多个版本，可方便地检索和还原各个版本，在意外操作或应用程序故障时快速恢复数据。 获取桶的多版本状态 ObsClient.getBucketVersioning 获取桶的多版本状态。 设置桶的CORS 配置 ObsClient.setBucketCors 设置桶的跨域资源共享规则，以允许客户端浏览器进行跨域请求。 获取桶的CORS 配置 ObsClient.getBucketCors 获取指定桶的跨域资源共享规则。 删除桶的CORS 配置 ObsClient.deleteBucketCors 删除指定桶的跨域资源共享规则。 设置桶标签 ObsClient.setBucketTagging 为桶添加标签，该桶上所有请求产生的计费话单里都会带上这些标签，从而可以针对话单报表做分类筛选，进行更详细的成本分析。 获取桶标签 ObsClient.getBucketTagging 获取指定桶的标签。 删除桶标签 ObsClient.deleteBucketTagging 删除指定桶的标签。 上传对象 ObsClient.putObject 上传对象到指定桶中。 追加上传(Harmony SDK) ObsClient.appendObject 对同一个对象追加数据内容。 下载对象 ObsClient.getObject 下载指定桶中的对象。 复制对象 ObsClient.copyObject 为指定桶中的对象创建一个副本。在单次操作中，可以创建最大5GB的对象副本。 删除对象 ObsClient.deleteObject 根据需要删除指定桶中的对象，节省空间和成本。 批量删除对象 ObsClient.deleteObjects 根据需要批量删除指定桶中的多个对象，节省空间和成本。 批量删除对象用于将一个桶内的部分对象一次性删除，删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。 获取对象元数据 ObsClient.getObjectMetadata 对指定桶中的对象发送HEAD请求，获取对象的元数据信息。 设置对象元数据 ObsClient.setObjectMetadata 对指定桶中的对象的元数据信息。 设置对象ACL ObsClient.setObjectAcl 在上传对象时设置权限控制策略，也可以通过ACL操作API接口对已存在的对象更改ACL 。 获取对象ACL ObsClient.getObjectAcl 过接口获取指定桶中对象的ACL访问权限，返回信息包含指定对象的权限控制列表信息。 初始化分传段任务 ObsClient.initiateMultipartUpload 过接口获取指定桶中对象的ACL访问权限，返回信息包含指定对象的权限控制列表信息。 上传段 ObsClient.uploadPart 初始化分段上传任务后，通过分段上传任务的ID，上传段到指定桶中。 复制段 ObsClient.copyPart 初始化分段上传任务后，通过分段上传任务的ID，复制段到指定桶中。 列举已上传的段 ObsClient.listParts 通过分段上传任务的ID，列举指定桶中已上传的段。 列举分段上传任务 ObsClient.listMultipartUploads 列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。 合并段 ObsClient.completeMultipartUpload 通过分段上传任务的ID和对应已上传的段信息（包括PartNumber和ETag），合并成一个完整的对象。 取消分段上传任务 ObsClient.abortMultipartUpload 通过分段上传任务的ID，取消指定桶中的分段上传任务。 恢复归档存储对象 ObsClient.restoreObject 如果要下载归档存储对象，需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持标准恢复、快速恢复。 生成带授权信息的URL ObsClient.createSignedUrl 通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL，可将该URL提供给其他用户进行临时访问。在生成URL时，您需要指定URL的有效期来限制访客用户的访问时长。 如果您想授予其他用户对桶或对象临时进行其他操作的权限（例如上传或下载对象），则需要生成带对应请求的URL后（例如使用生成PUT请求的URL上传对象），将该URL提供给其他用户。 生成带授权信息的表单上传参数 ObsClient.createPostSignatureSync 生成用于鉴权的请求参数，以进行基于浏览器的POST表单上传。

参数描述 表1 返回结果 参数类型 描述 Response 说明： 该接口返回是一个Promise类型，需要使用Promise、async/await语法处理。 参数解释： 接口返回信息，详见Response。 表2 Response 参数名称 参数类型 描述 CommonMsg ICommonMsg 参数解释： 接口调用完成后的公共信息，详见ICommonMsg。 InterfaceResult T 说明： T表示泛型，请参见具体接口章节的详细描述。 参数解释： 操作成功后的结果数据，详见T。 约束限制： 当Status大于300时为空。 表3 ICommonMsg 参数名称 参数类型 描述 Status number 参数解释： OBS服务端返回的HTTP状态码。 取值范围： 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 Code string 参数解释： OBS服务端返回的错误码。 Message string 参数解释： OBS服务端返回的错误描述。 HostId string 参数解释： OBS服务端返回的请求服务端ID。 RequestId string 参数解释： OBS服务端返回的请求ID。 Id2 string 参数解释： OBS服务端返回的请求ID2。 Indicator string 参数解释： OBS服务端返回的详细错误码。

人员管理概述 人员管理为云运维中心提供了统一的人员数据管理。您可以在人员管理页面管理当前租户下的用户，人员管理中的用户从 IAM 同步，人员管理页面的数据作为云运维中心的用户基础数据，供创建待办、定时运维、通知管理、事件中心等多个功能模块使用。 人员管理页面可以手动选择需要的用户进行编辑、删除、请求订阅。 对已添加的用户在编辑时，若填写了手机号、邮箱、企业微信、钉钉、飞书等通讯方式，系统后台会为其创建对应的订阅方式，以便于满足后续 消息通知 的需要。 在人员管理页面可通过用户信息字段颜色区分当前是否存在订阅，灰色：用户未订阅或订阅但未确认订阅；黑色：用户已订阅且已确认订阅。 父主题： 人员管理

镜像与武器版本支持声明 COC混沌演练新增了裸金属服务器（BMS）和Flexus应用服务器 L实例 （H CSS ）两种攻击对象，并提供了相应的资源类武器和网络类武器供用户演练使用。通过集成武器模块和功能，用户可以更准确地模拟真实环境故障，及早发现系统可用性等问题，持续提升应用韧性。 以下是BMS、H CS S各镜像版本与支持的探针类武器声明： CentOS 6.10镜像及以下版本，因系统缺少探针包运行所必要的共享库（GLIBC_2.14和GLIBCXX_3.4.15）不支持探针类武器。 BMS各镜像版本支持的探针类武器如表1所示。 表1 裸金属服务器镜像与武器兼容性列表 武器 支持的镜像版本 资源类武器 CPU使用率加压 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 内存使用率加压 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 磁盘使用率加压 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 磁盘IO加压 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 进程号耗尽 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 杀进程/持续杀进程 CentOS 7.4、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网络类武器 网络延迟 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网络丢包 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网络错包 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网络包重复 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网络包乱序 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网络中断 CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 网卡down CentOS 7.3、CentOS 7.9、Ubuntu16、Ubuntu 1804、EulerOS 2.3 HCSS各镜像版本支持的探针类武器如表2所示。 表2 Flexus应用服务器L实例镜像与武器兼容性列表 武器 支持的镜像版本 资源类武器 CPU使用率加压 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 内存使用率加压 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 磁盘使用率加压 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 磁盘IO加压 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 进程号耗尽 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 杀进程/持续杀进程 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网络类武器 网络延迟 CentOS 7.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网络丢包 CentOS 7.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网络错包 CentOS 7.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网络包重复 CentOS 7.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网络包乱序 CentOS 7.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网络中断 CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0 网卡down CentOS 7.2、CentOS 8.2、Ubuntu 16.04、Ubuntu 22.04、EulerOS 2.0、Debian 8.2、Debian 11.1.0

问题流程 问题被创建后状态为“未受理”，未受理状态可对问题单受理、驳回或转发责任人。 问题受理后状态为“定位出方案中”，定位出方案中状态可对问题单填写问题定位结果信息、转发责任人、升降级和挂起。 问题单挂起后需要创建单人审核，审批通过后状态为“挂起”，挂起后问题单可手动解除挂起或到达设定的解除挂起时间自动解除挂起。 问题填写定位结果时，若选择需要变更，问题单状态为“待现网实施”，待现网实施页面需要关联变更单，变更单有回填结果，才能流转至下个步骤。 无需变更的问题或需要变更的问题已有变更结果，问题状态为“待验证”，创建人确认问题是否解决或未解决，未解决可进行驳回。 图1 问题管理操作流程 父主题： 问题管理

自动化执行参数示例说明 参数值、Region ID、和目标实例填写格式为${}，需要通过该表达式解析对应的值，相关示例如下： 参考示例： 告警信息如下： { "alarmId": "al1696664837170EWbvx24kW", "alarmName": "alarm-4z39coctest1007", ...... "URL": "https://console.ulanqab.huawei.com/ces/?region=cn-north-7#/alarms/detail?alarmId=al16849986549022X5Vp4pxr", "additional": { "dimension": "instance_id:29d99a09-2d15-4ced-8723-6e94ae1c1472", ...... }, ...... } 1. 如果要获取当前告警信息里面的alarmId的值，表达式写成如下形式： ${currentAlarm.alarmId} 2. 如果要从additional.dimension字符串里面获取instance_id的uuid，表达式写成如下形式： ${string.substring(currentAlarm.additional.dimension, string.indexOf(currentAlarm.additional.dimension, 'instance_id:') + 12)} 或者 ${string.substring(currentAlarm.additional.dimension, 12)} 3. 如果要从URL字符串里面获取cn-north-7这个region ID，表达式写成如下形式： ${string.substring(currentAlarm.URL, string.indexOf(currentAlarm.URL, 'region=') + 7, string.indexOf(currentAlarm.URL, '#/alarms'))} 表达式里面的"currentAlarm."是个固定前缀，意思是从当前告警的数据里面获取。

事件流程 事件被创建后状态为“未受理”状态，未受理状态下可进行“转发”、“驳回”、“受理”等操作。 事件单被驳回后为“被驳回”状态，创建人可关闭事件或更新事件信息后重新提交。 事件单被受理后为“已受理”状态，已受理状态下可进行“事件处理”、“升降级”、“添加备注”、“启动warroom”等操作。 事件单被处理后，进入“已解决待验证”状态，已解决待验证状态下可进行“验证”操作，验证通过后事件单进入“已完成”状态，验证不通过后，重新进入“已受理”状态。 若需要增加事件级暂停功能，可参考基础配置-事件流程 图1 事件流程图 父主题： 事件管理

获取帐号密码 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“帐号管理”，进入“帐号管理”页面。 选择“帐号管理”页签，可通过资源视角和应用视角来管理主机。资源视角针对购买的所有主机实例，应用视角针对购买的并已绑定应用的主机。 图1 帐号管理概览 若用户只想托管（只保存作用，不改密）主机帐号密码，可通过“导入帐号”的形式，下载Excel模板填写资源相关信息，确认信息无误后上传。 图2 导入托管帐号 1、导入形式的ECS资源帐号密码不参与纳管改密，若想对导入的帐号进行自动纳管，可以编辑全局基线或者创建帐号基线来添加对应帐号，则系统会对这些主机帐号密码进行立即纳管。 2、导入形式的DCS、RDS和DMS资源不参与纳管改密，帐号密码无法完成自动纳管改密。 若用户在OS上新增了主机帐号，在帐号管理页面勾选对应主机后，可通过“同步帐号”按钮一键同步新增的OS帐号。注意：若想新增的帐号参与纳管改密，还需在帐号基线中配置该帐号。 图3 同步OS帐号 当前帐号管理只支持单个主机的帐号密码查询，成功“获取帐号密码”的前提是主机帐号“改密状态”为“成功”或“改密失败原因”为“导入的帐号不参与改密”，可在“操作”列单击“查看帐号密码”确认资源改密状态。若“改密状态”为“失败”，需要先根据反馈的改密失败原因进行相关处理。 ECS主机改密条件： 1、主机资源状态为“运行中” 2、主机的UniAgent状态为“运行中” 3、主机OS上的帐号与所绑定的帐号基线中的帐号一致 增量的ECS主机改密条件： 1、改密策略已开启 已纳管的主机定期改密条件： 1、已绑定改密任务 图4 主机改密详情 用户可在资源视角/应用视角下通过条件搜索需要提权的资源，在“操作”列单击“查看帐号密码”后“获取帐号密码”。 图5 获取帐号密码 若资源视角下，主机改密详情无数据，优先确认主机是否挂组件。若主机已挂组件，请先确认是否已绑定组件基线或者组件维度的自动纳管策略为开启状态；若主机未挂组件，请先确认全局维度的自动纳管策略是否为开启状态。

配置改密区域 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“帐号管理”，进入“帐号管理”页面。 选择“帐号改密”页签下“改密任务”页签，配置需要开启定期改密的区域。单击“选择区域”，勾选需要配置的区域至右选框后，单击“确定”。配置好之后可在“操作”列单击“查看任务详情”查看配置区域的改密任务，也可根据业务需求进行删除。 图1 配置改密任务 至此全部配置工作完成，可至“帐号管理”页签“查询帐号密码”。

开启改密策略 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“帐号管理”，进入“帐号管理”页面。 选择“帐号改密”页签下“改密策略”页签，根据业务需要，进行纳管策略设置，来确保新增的主机实例也能被自动纳管。 图1 开启改密策略 未绑定组件的增量主机实例实现自动纳管，打开“全局维度”按钮即可；已绑定组件的增量主机实例实现自动纳管，点击“组件维度”页签下“选择组件”按钮，通过搜索应用或组件名称，“确定”提交即可。 图2 选择组件

配置密钥 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“帐号管理”，进入“帐号管理”页面。 在页面右上角点击“密钥管理”按钮，或者通过“帐号管理流程引导”标签下方的“配置密钥”下“立即配置”按钮。 图1 配置密钥 进入“密钥管理”页面，单击“绑定密钥”，右滑出现选择密钥页面，选择需要绑定的密钥。若当前无可用密钥，单击“新建密钥”，跳转DEW服务创建密钥，新建后刷新表格即可选择。单击“确定”。 图2 绑定密钥 在“确认绑定”弹框中，提示绑定的密钥一经使用则不支持更新密钥，单击“确认”。 图3 确认绑定提示 确认绑定风险后，则密钥创建和配置相关工作即完成，若有更新密钥的需求，单击“更新”。 图4 完成密钥绑定

特殊字符含义 表2 Cron表达式特殊字符含义 字符 含义 示例 * 表示匹配域的任意值 在分这个域使用 *，即表示每分钟都会触发事件。 ? 表示匹配域的任意值，但只能用在日期和星期两个域，因为这两个域会相互影响。 要在每月的 20 号触发调度，不管每个月的 20 号是星期几，则只能使用如下写法：13 13 15 20 * ?。其中，因为日期域已经指定了 20 号，最后一位星期域只能用 ?，不能使用 *。如果最后一位使用 *，则表示不管星期几都会触发，与日期域的 20 号相斥，此时表达式不正确。 - 表示起止范围 在小时这个域使用 8-10，表示从 8时到 10 时每小时触发一次。 / 表示起始时间开始触发，然后每隔固定时间触发一次 在小时这个域中使用，“*/3”等同于“每3个小时”，即“0,3,6,9,12,15,18,21”小时触发。 L 表示最后，只能出现在日和星期两个域 在星期这个域使用 5L，意味着在最后的一个星期四触发。

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“作业管理”，进入“作业管理”页面。 图1 作业管理页面 选择“自定义作业”页签，单击“创建作业”，进入“创建作业”页面。 图2 单击创建作业 填写作业基本信息，包含作业名称，企业项目，描述和标签。可按照标签管理中的步骤创建标签，填写完成后单击“下一步”。 图3 填写作业基本信息 选择作业模板，如果没有合适的模板，选择“自定义”，单击“下一步”。 图4 选择作业模板 进行作业编排，单击“添加任务”，选择基本信息，点击，选择“执行命令”。 图5 添加任务 填写任务名称，操作描述。 图6 添加基本信息 单击“输入”，按需选择commandType (命令类型) ：SHELL、PYTHON或BAT。设置executeUser (命令执行用户)、timeout (命令执行超时时长（秒）) 、successRate (成功率阈值（%）) 、commandContent (命令内容) 和commandParams (命令入参) 。 图7 添加输入信息 单击“异常处理”，配置执行出现错误后的行为：终止整个作业或执行下一个步骤。 图8 添加异常处理信息 单击“确定”，完成当前原子动作的配置。

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“作业管理”，进入“作业管理”页面。 图1 作业管理页面 选择“自定义作业”页签，单击“创建作业”，进入“创建作业”页面。 图2 单击创建作业 填写作业基本信息，包含作业名称，企业项目，描述和标签。可按照标签管理中的步骤创建标签，填写完成后单击“下一步”。 图3 填写作业基本信息 选择作业模板，如果没有合适的模板，选择“自定义”，单击“下一步”。 图4 选择作业模板 进行作业编排，单击“添加任务”，选择基本信息，点击，选择“等待API结果”。 图5 添加任务 填写任务名称，操作描述。 图6 添加基本信息 单击“输入”，按需选择service(产品短名)、apiName(api名称)，如选择云数据库的ShowBackupPolicy(查询自动备份策略)OpenAPI，显示具体的OpenAPI定义。 填写“propertySelector (检查资源属性) ”，指定需要作为判定条件的响应字段。按需配置判断条件： stopRetryValues (终止任务等待及API重试标识) ：终止当前原子动作等待的标识； desiredValues (期望匹配成功标识) ：期望值，当propertySelector与当前值相同时，认为当前原子动作执行成功； notDesiredValues (期望非匹配成功标识) ：期望非匹配值，当propertySelector与当前值相同时，认为当前原子动作执行失败。 图7 添加输入信息 单击“输出”，按需配置输出内容，如将接口响应的backup_policy作为String类型的参数，命名为outputValue。如无需要，则无需添加参数。 图8 添加输出信息 单击“异常处理”，配置执行出现错误后的行为：终止整个作业或执行下一个步骤。 图9 添加异常处理信息 单击“确定”，完成当前原子动作的配置。

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“作业管理”，进入“作业管理”页面。 图1 作业管理页面 选择“自定义作业”页签，单击“创建作业”，进入“创建作业”页面。 图2 单击创建作业 填写作业基本信息，包含作业名称，企业项目，描述和标签。可按照标签管理中的步骤创建标签，填写完成后单击“下一步”。 图3 填写作业基本信息 选择作业模板，如果没有合适的模板，选择“自定义”，单击“下一步”。 图4 选择作业模板 进行作业编排，单击“添加任务”，选择基本信息，单击，选择“执行API”。 图5 添加任务 填写任务名称，操作描述。 图6 填写基本信息 单击“输入”，按需选择service(产品短名)、apiName(api名称)，如选择云数据库的ListSlowLogsNew(查询数据库慢日志)OpenAPI，显示具体的OpenAPI定义。 填写所需OpenAPI参数内容。 图7 添加输入信息 单击“输出”，按需配置输出内容，如将接口响应的slow_log_list作为String类型的参数，命名为outputValue。如无需要，则无需添加参数。 图8 添加输出信息 单击“异常处理”，配置执行出现错误后的行为：终止整个作业或执行下一个步骤。 图9 添加异常处理 单击“确定”，完成当前原子动作的配置。

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“作业管理”，进入“作业管理”页面。 图1 作业管理页面 在“作业管理”页面，选择“自定义作业”页签，选中需要执行的作业，单击“执行”。 图2 选择需要执行的作业 选择作业版本号，并检查作业步骤是否符合预期。 图3 检查作业步骤 选择执行类型。 “执行类型”分为两种：单账号执行/跨账号跨区域执行 图4 执行类型 选择填入“IAM权限委托”，IAM权限委托将用于runbook执行过程中，通过委托切换对应身份，然后执行作业。 图5 填IAM权限委托 若选择的是跨账号跨区域执行类型，则需要填入对应的执行规则。 当前跨账号执行，不支持BMS的API调用，不支持脚本的跨账号执行。 使用该功能，需要提前加入到组织中并提前配置好委托权限，并填入对应的委托名称。 图6 执行账号及区域 字段说明： 执行账号：即租户账号名，可以通过我的凭证页面查看。 图7 查看账号名 执行区域：执行的目标对象所在的区域 委托名称：IAM中委托对象的名称 图8 获取委托名称 项目ID：IAM中的项目概念，执行的目标对象所在的项目的ID 图9 查看项目 图10 获取项目ID 填写执行基本信息，包含执行描述和标签。可按照标签管理中的步骤创建标签。 图11 填写执行基本信息 选择作业在目标实例的执行模式，分为“所有步骤一致”和“每个步骤独立”两种。 表1 目标实例模式说明 目标 说明 所有步骤一致 本作业涉及的所有步骤将按顺序在目标实例执行 每个步骤独立 自定义配置，配置时可选择指定步骤仅在指定目标实例执行 图12 选择所有步骤一致 图13 选择每个步骤独立 单击“+添加实例”，选择待执行实例的区域，根据实例名称、UniAgent状态等条件筛选并选中目标实例，单击“确定”。 图14 选择目标实例 选择作业执行的“分批策略”。 自动分批：用户选择的待执行机器，会根据默认规则，分成多批。 手动分批：用户可以根据自身需要，将待执行的机器，分成若干批，控制机器所在的批次。 不分批：用户所有待执行的机器会全部在同一批次。 图15 选择分批策略 单击“提交”，执行自定义作业，将跳转到作业工单详情页面。在工单详情页面查看作业和各批次的执行情况。 单击“强制结束”，将结束本次作业的所有执行任务。结束本次作业工单，当前不会回调结束对应的脚步工单/补丁工单等子工单。 单击“结束所有批次”，将结束当前步骤所有批次的执行任务。 结束所有批次，指不再继续调用下一个批次，但是脚本执行中的实例，是不会进行中止执行的。 通过UniAgent下发执行的脚本，处于运行中的状态，是无法中止执行的，只能等待执行完成。 图16 作业工单详情

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“作业管理”，进入“作业管理”页面。 图1 作业管理页面 选择“自定义作业”页签，单击“创建作业”，进入“创建作业”页面。 图2 单击创建作业 填写作业基本信息，包含作业名称，企业项目，描述和标签。可按照标签管理中的步骤创建标签，填写完成后单击“下一步”。 图3 填写作业基本信息 选择作业模板，如果没有合适的模板，选择“自定义”，单击“下一步”。 图4 选择作业模板 进行作业编排，作业编排由全局参数、作业步骤组成。 图5 作业编排 单击“+添加参数”，添加全局参数，配置后单击“完成”。 全局参数支持自定义、从参数仓库获取两种。选择自定义时需要自行填写参数名称、默认值和参数描述；从参数仓库获取时需要选择参数所在区域、参数名称和参数联动模式。 图6 选择自定义并添加全局参数 图7 从参数仓库获取并添加全局参数 表1 参数联动模式说明表 参数联动模式 说明 所有环境使用当前参数值 作业执行时使用该参数，参数值为创建作业添加参数时该参数基本信息中显示的参数值 使用对应环境最新参数值 作业执行时使用该参数，参数值为实时从参数仓库中获取的最新参数值 单击，在步骤间添加新步骤。 图8 新增步骤 单击步骤名称或者，可以修改步骤名称。 图9 修改步骤名称 对于已添加的作业步骤，单击，删除不需要的步骤。 图10 删除步骤 单击“+添加任务”，为步骤添加任务。任务添加完成后，单击“完成”。所有任务添加完成后，单击“确定”。 图11 添加任务 单击“+操作类型”，设置当前任务的操作类型，操作类型分为云服务API、控制、自定义脚本三种。 云服务API：包含ECS相关操作原子、执行API和等待API调用结果。ECS操作详见：ECS操作。 控制：包含审批、暂停和睡眠。 自定义脚本：支持选择自定义脚本类型和执行命令。自定义脚本创建后，会自动注册一条自定义原子记录。 图12 选择操作类型 根据选择的操作类型，填写名称、操作描述等基本信息，参数信息和异常处理策略，填写完成后单击“完成”。 图13 填写基本信息 图14 填写输入 图15 填写异常处理 作业编排完成后，根据操作风险，确定作业的风险等级，选择“审核人配置”和“通知渠道”后，单击“提交”。 设置作业入库人工审核策略，风险等级为“高”的作业默认开启人工审批。 在“审核人配置”行选择“排班”，则指定当前排班中的用户为审批人；选择“个人”，则指定某些用户为审批人。 选择“通知渠道”，审核请求将通过指定渠道通知到审核人。 图16 更多配置

操作步骤 登录COC。 在左侧菜单栏选择“资源运维”，单击“自动化运维”，在“日常运维”模块选择“作业管理”，进入“作业管理”页面。 图1 进入作业管理页面 选择“公共作业”页签，单击“所有作业”，选择需要执行的公共作业，单击“执行”。 图2 选择并执行公共作业 填写执行基本信息，包含执行描述和标签。可按照标签管理中的步骤创建标签。 图3 填写执行基本信息 选择公共作业执行的“目标实例模式”，分为“所有步骤一致”和“每个步骤独立”两种。 表1 目标实例模式说明 目标 说明 所有步骤一致 所有步骤在所有目标实例执行 每个步骤独立 自定义配置，可选择指定步骤仅在指定目标实例执行 图4 选择所有步骤一致 图5 选择每个步骤独立 单击“+添加实例”，选择待执行实例的区域，根据实例名称、UniAgent状态等条件筛选并选中目标实例，单击“提交”。 图6 选择目标实例 选择“分批策略”： 自动分批：用户选择的待执行机器，会根据默认规则，分成多批。 手动分批：用户可以根据自身需要，将待执行的机器，分成若干批，控制机器所在的批次。 不分批：用户所有待执行的机器会全部在同一批次。 图7 选择分批策略 单击“提交”，执行公共作业，将跳转到作业工单详情页面。在工单详情页面查看作业和各批次的执行情况。 单击“强制结束”，将结束本次作业的所有执行任务。 单击“结束所有批次”，将结束当前步骤所有批次的执行任务。 图8 作业工单详情

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“脚本管理”，进入“脚本管理”页面，选择“公共脚本”页签，选择脚本并单击“执行”。 图1 选择要执行的公共脚本 填写脚本执行相关信息。相关参数由公共脚本决定，用户无法修改。填入执行用户及执行超时时间，默认用户为root，超时时间为300秒。 脚本参数支持手动输入和参数仓库两种（清理磁盘暂不支持）。手动输入时需要用自行填写参数值；从参数中心选择时，需要选择参数所在区域、参数名称和参数联动模式。 图2 手动输入脚本参数 图3 参数仓库选择脚本参数 表1 参数联动模式说明表 参数联动模式 说明 使用对应环境最新参数值 脚本执行时使用该参数，参数值为实时从参数仓库对应区域中获取的最新参数值 单击“+添加实例”，选择脚本执行目标实例，可根据名称、弹性公网IP、资源状态等条件进行过滤。 图4 选择目标实例 选择“分批策略”。 自动分批：用户选择的待执行机器，会根据默认规则，分成多批。 手动分批：用户可以根据自身需要，将待执行的机器，分成若干批，控制机器所在的批次。 不分批：用户所有待执行的机器会全部在同一批次。 图5 选择分批策略 设置“熔断策略”。 熔断策略：用户可以设置执行的成功率，当执行失败的机器数量到达根据成功率计算出的失败数量，工单状态会变为异常，并停止执行。 图6 设置熔断阈值 单击“提交”执行脚本。 图7 “提交”按钮

操作步骤 登录COC。 在左侧菜单栏选择“自动化运维”，在“日常运维”模块单击“脚本管理”，进入“脚本管理”页面，选择“自定义脚本”页签，单击“创建脚本”。 图1 单击“创建脚本” 填写脚本基本信息，确认脚本风险等级，并选择脚本归属的企业项目。 图2 填写信息 填写脚本内容，可选择脚本类型为shell脚本、python脚本或者bat脚本，并对脚本内容进行高危命令校验。 脚本内容首行自动添加的解释器，例如#!/usr/bin/python需要用户的机器让有python的软链接，若缺乏软链接，需要用户自行修改解释器，适配为机器可执行的解释器。 图3 录入脚本内容 单击“校验高危命令”，可对脚本内容进行高危检测。 校验范围：检测涉及的高危命令范围，可点击“高危命令说明”查看校验的规则列表。 校验规则：在校验范围内，通过正则匹配方式对脚本内容进行高危命令匹配。 校验结果：通过正则校验结果返回脚本内容是否高危，即：低风险、高风险。 高危命令校验结果仅作为脚本风险等级的定级参考，工具不强制拦截脚本风险等级与高危命令校验结果一致性，请按实际业务影响进行评估。 图4 校验高危命令 填写脚本入参，可勾选“敏感参数”对参数进行加密。 图5 填写脚本入参 敏感参数：脱敏展示，存储时会加密存储。 入库人工审核，风险等级为“高”的脚本默认开启。 图6 选择审批人和通知审批人渠道 单击“提交”创建自定义脚本。 图7 点击“提交”

操作步骤 登录COC。 在左侧菜单栏中选择“资源运维”，选择 “资源批量操作”，在“批量BMS操作”模块中单击“重装操作系统”，进入“重装操作系统”页面。 在“重装操作系统”页面，选择“添加实例”。 图1 选择实例 选择“分批策略”。 自动分批：用户选择的待执行机器，会根据默认规则，自动分成多批次。 手动分批：用户可以根据自身需要，手动创建若干批次，然后手动将机器分配到各批次中。 不分批：用户所有待执行的机器会全部在同一批次。 输入“熔断策略”。 用户可以设置执行的成功率，当执行失败的机器数量到达根据成功率计算出的失败数量，工单状态会变为异常，并停止执行。 成功率取值范围0~100，可以精确到小数点后一位。 输入登录凭证。 登录凭证： 密码：用户可使用云服务器原密码或重新设置密码，请输入并牢记密码。 密钥对：用户可以选择 密钥对管理 中对应的密钥对。 创建后设置：用户在登录云服务器前，需要先通过重置密码的方式设置密码。 单击“提交”。 图2 重装展示操作页 在“确认执行”弹框中，单击“确定”。 图3 确定执行 查看执行结果。 图4 查询执行结果 执行结果为“异常”时，可以通过点击“重试”或“批次重试”尝试重新执行失败的任务或批次。也可以点击“取消”或“批次取消”，跳过异常的任务或批次。 图5 取消或者重试

操作步骤 登录COC。 在左侧菜单栏中选择“资源运维”，选择 “资源批量操作”，在“批量BMS操作”模块中单击“批量重启”，进入“批量重启”页面。 在“批量重启”页面，选择“添加实例”。 图1 选择实例 选择“分批策略”。 自动分批：用户选择的待执行机器，会根据默认规则，自动分成多批次。 手动分批：用户可以根据自身需要，手动创建若干批次，然后手动将机器分配到各批次中。 不分批：用户所有待执行的机器会全部在同一批次。 输入“熔断策略”。 用户可以设置执行的成功率，当执行失败的机器数量到达根据成功率计算出的失败数量，工单状态会变为异常，并停止执行。 成功率取值范围0~100，可以精确到小数点后一位。 单击“提交”。 图2 重启展示操作页 在“确认执行”弹框中，单击“确定”。 图3 确认执行 查看执行结果。 图4 查看结果 执行结果为“异常”时，可以通过点击“重试”或“批次重试”尝试重新执行失败的任务或批次。也可以点击“取消”或“批次取消”，跳过异常的任务或批次。 图5 取消或者重试