专属主机 DEH-华为云

专属主机 DEH-支持审计的关键操作列表

支持审计的关键操作列表云审计服务（Cloud Trace Service， CTS ），是云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。云审计支持的专属主机操作如表1所示。表1 云审计支持的专属主机操作列表操作名称资源类型事件名称创建专属主机 dedicatedHosts createDedicatedHosts 更新专属主机 dedicatedHosts updateDedicatedHosts 删除专属主机 dedicatedHosts releaseDedicatedHosts 父主题：关键操作审计

专属主机 DEH 关键操作审计

专属主机 DEH-构造请求:请求消息头

请求消息头附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。详细的公共请求消息头字段请参见表3。表3 公共请求消息头名称描述是否必选示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。否使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。是 application/json Content-Length 请求body长度，单位为Byte。否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。否如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。否使用Token认证时该字段必选。注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

专属主机 DEH

专属主机 DEH-构造请求:请求消息体（可选）

请求消息体（可选）该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 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 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": $USER_NAME, # 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "password": $PASSWORD, # 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": $DOMAIN_NAME, # 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 } } } }, "scope": { "project": { "name": $PROJECT_NAME, # 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

专属主机 DEH

专属主机 DEH-构造请求:请求URI

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。表1 URI中的参数说明参数描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。例如 IAM 服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

专属主机 DEH

专属主机 DEH-构造请求:请求方法

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。表2 HTTP方法方法说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

专属主机 DEH

专属主机 DEH-认证鉴权:AK/SK认证

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

专属主机 DEH 如何调用API

专属主机 DEH-认证鉴权:Token认证

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": $USER_NAME, # IAM用户名，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "password":$PASSWORD, # IAM用户密码，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": $DOMAIN_NAME, # IAM用户所属账号名，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 } } } }, "scope": { "project": { "name": $PROJECT_NAME, # 项目名称，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

专属主机 DEH 如何调用API

专属主机 DEH-创建用户并授权使用DeH:示例流程

示例流程图1 给用户授权DeH权限流程创建用户组并授权在IAM控制台创建用户组，并授予专属主机权限“DeH ReadOnlyAccess”。创建用户并加入用户组在IAM控制台创建用户，并将其加入1.创建用户组并授权中创建的用户组。用户登录并验证权限新创建的用户登录控制台，切换至授权区域，验证权限：在“服务列表”中选择专属主机服务，进入DeH主界面，单击右上角“购买专属主机”，如果无法购买专属主机（假设当前权限仅包含DeH ReadOnlyAccess），表示“DeH ReadOnlyAccess”已生效。在“服务列表”中选择除专属主机服务外（假设当前策略仅包含E CS Viewer）的任一服务，若提示权限不足，表示“DeH ReadOnlyAccess”已生效。

专属主机 DEH 权限管理

专属主机 DEH-修订记录

修订记录修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内容。版本日期变更说明 2024-02-19 第十一次正式发布修改完善语句，将“帐”改为“账”。 2022-01-25 第十次正式发布。专属主机支持“企业项目”功能。新增：企业项目管理。更新：购买专属主机。 2021-12-08 第九次正式发布。更新裸金属服务器使用方式：专属主机与裸金属服务器的区别？。 2021-07-16 第八次正式发布。修改： Console产品目录变更：中文“管理与部署”入口更名为“管理与监管”，英文“计算”入口更名。 2019-07-30 第七次正式发布。新增：标签管理 2019-04-15 第六次正式发布。查看专属主机、设置专属主机自动部署功能、退订专属主机资源，优化操作场景，补充操作后验证或操作结果。 2019-02-14 第五次正式发布。新增：调整专属主机资源配额 2018-11-09 第四次正式发布。新增：专属主机上云服务器迁移 2018-09-15 第三次正式发布。新增：退订专属主机资源 2018-05-30 第二次正式发布。新增：专属主机上云服务器的规格变更 2017-12-26 第一次正式发布。

专属主机 DEH

专属主机 DEH-专属主机与专属云的区别？

专属主机与专属云的区别？场景方面专属云可以配套专属分布式存储、专属企业存储、专属裸金属服务器等专属服务，提供完整的资源隔离方案。专属主机则只能提供计算隔离主机，使用更灵活，适合对计算资源隔离、使用灵活性有要求的客户。功能方面专属云需要独立开通专属云账号，专属云资源和公共ECS属于不同VPC，虚拟机不能相互迁移。专属主机上创建的虚拟机和公共ECS属于同一VPC，虚拟机可以相互冷迁移。父主题：专属主机类

专属主机 DEH 专属主机类

专属主机 DEH-修订记录

修订记录版本日期变更说明 2024-04-15 第十一次正式发布。修改构造请求、认证鉴权、返回结果，将token请求体中用户名密码修改为变量，增加安全性。 2023-12-11 第十次正式发布。修改查询专属主机列表、查询专属主机详情，修正响应示例中"released_at"的取值。 2023-11-04 第九次正式发布。修改 API中的章节统一优化章节结构。查询专属主机列表、查询专属主机详情、查询可用的专属主机类型、查询租户的专属主机配额，更新响应示例。查询专属主机上的云服务器，更新响应示例中“tenant_id”参数的取值。 2023-08-18 第八次正式发布。更新：查询专属主机列表，删除released_at参数。 2023-06-15 第七次正式发布。更新：查询专属主机列表、更新专属主机属性、批量添加专属主机标签、批量删除专属主机标签、按标签查询专属主机列表，增加请求示例描述。 2023-02-08 第六次正式发布。更新：查询专属主机上的云服务器，修改addresses的参数类型。 2022-11-18 第五次正式发布。更新：查询专属主机上的云服务器，优化addresses字段结构。批量删除专属主机标签，修正value参数的取值。 2022-11-08 第四次正式发布。更新：查询专属主机详情、查询专属主机上的云服务器、查询可用的专属主机类型、批量添加专属主机标签、批量删除专属主机标签、查询指定专属主机标签、按标签查询专属主机列表、查询租户的专属主机配额，优化请求参数和响应参数表格说明；优化描述。 2022-10-25 第三次正式发布。更新：查询专属主机列表，修改响应示例。查询专属主机上的云服务器，优化描述。更新专属主机属性，优化描述。 2022-03-18 第二次正式发布。更新：每个接口新增调试接口的链接：API。 2022-01-25 第一次正式发布。

专属主机 DEH

专属主机 DEH-查询指定专属主机标签:URI

URI GET /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags 参数说明请参见表1。表1 参数说明参数参数类型是否必选描述 project_id String 是项目ID。 dedicated_host_id String 是专属主机ID。可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。

专属主机 DEH

专属主机 DEH-查询指定API版本信息:响应消息

响应消息表2 响应参数参数参数类型描述 version Object 专属主机指定API版本信息。表3 version字段数据结构说明参数参数类型描述 id String API版本ID。 links Array of objects API的url地址。 min_version String 若该版本API支持微版本，则为支持的最小微版本号；如果不支持微版本，则为空。 status String API版本状态： CURRENT：表示该版本为主推版本。 SUPPORTED：表示为老版本，但是现在还在继续支持。 DEPRECATED：表示为废弃版本，存在后续删除的可能。 updated String API版本更新时间。 version String 若该版本API支持微版本，则为支持的最大微版本号；如果不支持微版本，则为空。表4 links字段数据结构说明参数参数类型描述 href String API的url地址。 rel String API的url地址依赖。

专属主机 DEH

专属主机 DEH-查询指定API版本信息:响应示例

响应示例 { "version": { "id": "v1.0", "links": [ { "href": "https//deh.xxx.com/v1.0/", "rel": "self" } ], "min_version": "", "status": "SUPPORTED", "updated": "2016-12-01T11:33:21Z", "version": "" } }

专属主机 DEH

专属主机 DEH-批量删除专属主机标签:请求示例

请求示例批量删除专属主机标签，键为key1对应的值为value1，键为key2对应的值为value2。 POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }

专属主机 DEH

云服务器内容精选

专属主机 DEH

7*24

备案

专业服务

退订

建议反馈

售前咨询热线