API概览

本产品(堡垒机/2019-12-09)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(11370001915),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

堡垒机实例(仅支持V3.2.X版本使用)

API标题API概述
DescribeInstanceAttribute查询实例属性信息查询实例所有的属性信息,例如:实例ID、实例的备注信息。
DescribeInstances查询实例的列表信息调用DescribeInstances查询实例的列表信息。
ConfigInstanceSecurityGroups为指定的堡垒机实例配置安全组调用ConfigInstanceSecurityGroups为指定的堡垒机实例配置安全组。
ConfigInstanceWhiteList为堡垒机实例配置公网IP地址白名单堡垒机实例开启公网访问后,可以将指定公网IP地址加入白名单,允许公网流量访问堡垒机实例。
StartInstance启动指定堡垒机实例调用StartInstance启动指定堡垒机实例。
EnableInstancePublicAccess打开指定堡垒机实例公网访问开关调用EnableInstancePublicAccess打开指定堡垒机实例公网访问开关。
DisableInstancePublicAccess关闭实例的公网访问开关调用DisableInstancePublicAccess关闭实例的公网访问开关。
ModifyInstanceAttribute修改指定堡垒机实例的信息调用ModifyInstanceAttribute修改指定堡垒机实例的信息。
MoveResourceGroup移动堡垒机实例至指定资源组调用MoveResourceGroup移动堡垒机实例至指定资源组。

标签(仅支持V3.2.X版本使用)

API标题API概述
ListTagKeys查询堡垒机资源已绑定的标签列表查询一个资源已经绑定的标签列表。
ListTagResources查询堡垒机实例已绑定的标签列表查询一个或多个堡垒机实例已经绑定的标签列表。
UntagResources为指定堡垒机实例批量解绑并删除标签调用UntagResources为指定堡垒机实例批量解绑并删除标签。
TagResources为堡垒机实例统一创建并绑定标签为指定的堡垒机实例统一创建并绑定标签。

地域(仅支持V3.2.X版本使用)

API标题API概述
DescribeRegions查询堡垒机实例支持的阿里云地域查询堡垒机实例支持的阿里云地域。

主机(仅支持V3.2.17及以上版本使用)

API标题API概述
CreateHost在堡垒机中创建需要运维的主机在堡垒机中创建需要运维的主机。
GetHost获取指定主机的详细信息包括主机名称、来源、主机地址、协议端口等信息。
ListHosts查询指定堡垒机实例下的主机列表调用ListHosts接口查询指定堡垒机实例下的主机列表。
DeleteHost删除单个主机调用DeleteHost接口删除单个主机。
ModifyHostsPort批量修改主机指定协议的端口调用ModifyHostsPort接口批量修改主机运维协议的端口。
ModifyHostsActiveAddressType修改运维主机时使用的连接地址类型调用ModifyHostsActiveAddressType接口修改运维主机时使用的连接地址类型。
ModifyHost修改主机基本信息支持修改主机的地址、名称、操作系统类型和备注信息。

主机组(仅支持V3.2.17及以上版本使用)

API标题API概述
CreateHostGroup创建主机组调用CreateHostGroup接口创建主机组。
GetHostGroup获取指定主机组详情调用GetHostGroup接口获取指定主机组详情。
ListHostGroups获取指定堡垒机下的主机组列表调用ListHostGroups接口获取指定堡垒机下的主机组列表。
ModifyHostGroup修改主机组名称或备注信息调用ModifyHostGroup接口修改主机组名称或备注信息。
DeleteHostGroup删除单个主机组调用DeleteHostGroup接口删除单个主机组。
AddHostsToGroup批量将主机加入指定主机组批量将主机加入指定主机组。
RemoveHostsFromGroup从指定主机组中批量移除主机调用RemoveHostsFromGroup接口从指定主机组中批量移除主机。

主机账户(仅支持V3.2.17及以上版本使用)

API标题API概述
CreateHostAccount为指定主机创建主机账户调用CreateHostAccount接口为指定主机创建主机账户。
GetHostAccount获取指定主机账户详情调用GetHostAccount接口获取指定主机账户详情。
ListHostAccounts获取主机账户列表调用ListHostAccounts接口获取主机账户列表。
ModifyHostAccount修改主机账户信息调用ModifyHostAccount接口修改主机账户信息,支持修改主机账户的名称、密码和私钥信息。
DeleteHostAccount删除单个主机账户调用DeleteHostAccount接口删除单个主机账户。
ResetHostAccountCredential清除指定主机账户登录凭据清除指定主机账户登录凭据(密码或SSH私钥)。

用户(仅支持V3.2.17及以上版本使用)

API标题API概述
CreateUser创建用户调用CreateUser接口创建用户。
GetUser获取用户信息获取指定堡垒机用户的详细信息。
ListUsers获取用户详情列表调用ListUsers接口获取指定堡垒机的用户列表。
ModifyUser修改用户调用ModifyUser接口修改堡垒机用户信息。
DeleteUser删除用户调用DeleteUser接口删除单个堡垒机用户。
CreateUserPublicKey创建用户公钥创建用户公钥。
ListUserPublicKeys获取用户公钥列表查询用户名下所有的公钥列表。
DeleteUserPublicKey删除用户公钥删除用户公钥。
LockUsers批量锁定堡垒机用户调用LockUsers接口批量锁定堡垒机用户。
UnlockUsers批量解锁堡垒机用户调用UnlockUsers接口批量解锁堡垒机用户。

用户组(仅支持V3.2.17及以上版本使用)

API标题API概述
CreateUserGroup创建用户组调用CreateUserGroup接口创建堡垒机用户组。
GetUserGroup获取指定堡垒机用户组的详细信息调用GetUserGroup接口获取指定堡垒机用户组的详细信息。
ListUserGroups获取用户组列表调用ListUserGroups接口获取指定堡垒机下的用户组列表。
ModifyUserGroup修改用户组信息调用ModifyUserGroup接口修改用户组信息。
DeleteUserGroup删除用户组调用DeleteUserGroup接口删除单个堡垒机用户组。
AddUsersToGroup批量为用户组添加用户调用AddUsersToGroup接口将用户批量添加到用户组。
RemoveUsersFromGroup批量移除用户组内用户调用RemoveUsersFromGroup接口批量移除用户组内用户。

主机授权(仅支持V3.2.17及以上版本使用)

API标题API概述
AttachHostAccountsToUser为用户授权主机和主机账户调用AttachHostAccountsToUser接口为用户授权主机和主机账户。
ListHostsForUser查询已授权或未授权的主机列表调用ListHostsForUser接口查询指定堡垒机用户已授权或未授权的主机列表。
ListHostAccountsForUser查询已授权的主机账户列表查询指定用户在指定主机下已授权的主机账户列表。
DetachHostAccountsFromUser移除给用户授权的主机及主机账户调用DetachHostAccountsFromUser接口移除给用户授权的主机及主机账户。
DetachHostAccountsFromUserGroup移除给用户组授权的主机及主机账户调用DetachHostAccountsFromUserGroup接口移除给用户组授权的主机及主机账户。
DetachHostGroupAccountsFromUser移除用户已授权的主机组及主机账户调用DetachHostGroupAccountsFromUser接口移除用户已授权的主机组及主机账户。
AttachHostAccountsToUserGroup为用户组授权主机及主机账户调用AttachHostAccountsToUserGroup接口为用户组授权主机及主机账户。
DetachHostGroupAccountsFromUserGroup移除用户组已授权的主机组及主机账户调用DetachHostGroupAccountsFromUserGroup接口移除用户组已授权的主机组及主机账户。
AttachHostGroupAccountsToUser为用户授权主机组和主机账号调用AttachHostGroupAccountsToUser接口为用户授权主机组和主机账号。
AttachHostGroupAccountsToUserGroup为用户组授权主机组和主机账号调用AttachHostGroupAccountsToUserGroup接口为用户组授权主机组和主机账号。
ListHostAccountsForUserGroup查询已授权的主机账户列表查询指定用户组在指定主机下已授权的主机账户列表。
ListHostGroupAccountNamesForUser查询主机组中已授权的主机账户名称查询指定用户在指定主机组中已授权的主机账户名称。
ListHostGroupAccountNamesForUserGroup查询已授权的主机账户名称查询指定用户组在指定主机组中已授权的主机账户名称。
ListHostGroupsForUser查询已授权或未授权的主机组列表查询指定堡垒机用户已授权或未授权的主机组列表。
ListHostGroupsForUserGroup查询已授权或未授权的主机组列表查询指定堡垒机用户组已授权或未授权的主机组列表。
ListHostsForUserGroup查询已授权或未授权的主机列表查询指定堡垒机用户组已授权或未授权的主机列表。

资产管理(仅支持V3.2.X版本使用)

API标题API概述
CreateHostShareKey新增主机共享密钥调用CreateHostShareKey接口新增主机共享密钥。
GetHostShareKey查询主机共享密钥的详情调用GetHostShareKey接口查询主机共享密钥的详情。
ListHostShareKeys查询主机共享密钥的列表调用ListHostShareKeys接口查询主机共享密钥的列表。
ListHostAccountsForHostShareKey获取主机共享密钥关联的主机账号调用ListHostAccountsForHostShareKey接口获取主机共享密钥关联的主机账号。
ModifyHostShareKey修改主机共享密钥调用ModifyHostShareKey接口修改主机共享密钥。
AttachHostAccountsToHostShareKey关联主机账号到主机共享密钥调用AttachHostAccountsToHostShareKey接口关联主机账号到主机共享密钥。
DetachHostAccountsFromHostShareKey移除主机账号和主机共享密钥的关联调用DetachHostAccountsFromHostShareKey接口移除主机账号和主机共享密钥的关联。
DeleteHostShareKey删除主机共享密钥调用DeleteHostShareKey接口删除主机共享密钥。

系统设置(仅支持V3.2.X版本使用)

API标题API概述
GetInstanceADAuthServer查询堡垒机实例上AD认证的配置信息调用GetInstanceADAuthServer接口查询堡垒机实例上AD认证的配置信息。
ModifyInstanceADAuthServer修改堡垒机实例的AD认证服务器的配置调用ModifyInstanceADAuthServer接口修改堡垒机实例的AD认证服务器的配置。
GetInstanceTwoFactor查询堡垒机实例的双因子认证的配置信息调用GetInstanceTwoFactor接口查询堡垒机实例的双因子认证的配置信息。
ModifyInstanceTwoFactor修改堡垒机实例的双因子配置调用ModifyInstanceTwoFactor接口修改堡垒机实例的双因子配置。
ModifyInstanceLDAPAuthServer修改堡垒机实例LDAP认证服务器的配置调用ModifyInstanceLDAPAuthServer接口修改堡垒机实例LDAP认证服务器的配置。
GetInstanceLDAPAuthServer获取堡垒机实例LDAP认证的配置调用GetInstanceLDAPAuthServer接口获取堡垒机实例LDAP认证的配置。
阿里云首页 运维安全中心(堡垒机) 相关技术圈