'1.0',
'info' => [
'style' => 'RPC',
'product' => 'Yundun-bastionhost',
'version' => '2019-12-09',
],
'directories' => [
[
'id' => 267520,
'title' => '堡垒机实例(仅支持V3.2.X版本使用)',
'type' => 'directory',
'children' => [
'DescribeInstanceAttribute',
'DescribeInstances',
'ConfigInstanceSecurityGroups',
'ConfigInstanceWhiteList',
'StartInstance',
'EnableInstancePublicAccess',
'DisableInstancePublicAccess',
'ModifyInstanceAttribute',
'MoveResourceGroup',
'AddInstanceRdMember',
'ListInstanceRdMembers',
'RemoveInstanceRdMember',
],
],
[
'id' => 267533,
'title' => '标签(仅支持V3.2.X版本使用)',
'type' => 'directory',
'children' => [
'ListTagKeys',
'ListTagResources',
'UntagResources',
'TagResources',
],
],
[
'id' => 267538,
'title' => '地域(仅支持V3.2.X版本使用)',
'type' => 'directory',
'children' => [
'DescribeRegions',
],
],
[
'id' => 267540,
'title' => '主机(仅支持V3.2.17及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateHost',
'GetHost',
'ListHosts',
'DeleteHost',
'ModifyHostsPort',
'ModifyHostsActiveAddressType',
'ModifyHost',
],
],
[
'id' => 267548,
'title' => '数据库(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateDatabase',
'ModifyDatabase',
'GetDatabase',
'ListDatabases',
'DeleteDatabase',
],
],
[
'id' => 267554,
'title' => '网络域(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateNetworkDomain',
'GetNetworkDomain',
'ListNetworkDomains',
'DeleteNetworkDomain',
'ModifyNetworkDomain',
'MoveHostsToNetworkDomain',
'MoveDatabasesToNetworkDomain',
],
],
[
'id' => 267562,
'title' => '主机账户(仅支持V3.2.17及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateHostAccount',
'GetHostAccount',
'ListHostAccounts',
'ModifyHostAccount',
'DeleteHostAccount',
'ResetHostAccountCredential',
],
],
[
'id' => 267569,
'title' => '数据库账户(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateDatabaseAccount',
'ModifyDatabaseAccount',
'GetDatabaseAccount',
'ListDatabaseAccounts',
'ListDatabaseAccountsForUserGroup',
'DeleteDatabaseAccount',
],
],
[
'id' => 267576,
'title' => '用户(仅支持V3.2.17及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateUser',
'GetUser',
'ListUsers',
'ModifyUser',
'DeleteUser',
'CreateUserPublicKey',
'ListUserPublicKeys',
'ModifyUserPublicKey',
'DeleteUserPublicKey',
'LockUsers',
'UnlockUsers',
],
],
[
'id' => 267588,
'title' => '用户组(仅支持V3.2.17及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateUserGroup',
'GetUserGroup',
'ListUserGroups',
'ModifyUserGroup',
'DeleteUserGroup',
'AddUsersToGroup',
'RemoveUsersFromGroup',
],
],
[
'id' => 267596,
'title' => '资产组(仅支持V3.2.17及以上的版本使用)',
'type' => 'directory',
'children' => [
'CreateHostGroup',
'AddDatabasesToGroup',
'AddHostsToGroup',
'RemoveDatabasesFromGroup',
'DeleteHostGroup',
'RemoveHostsFromGroup',
'ModifyHostGroup',
'GetHostGroup',
'ListHostGroups',
],
],
[
'id' => 267606,
'title' => '主机授权(仅支持V3.2.17及以上版本使用)',
'type' => 'directory',
'children' => [
'AttachHostAccountsToUser',
'ListHostsForUser',
'ListHostAccountsForUser',
'DetachHostAccountsFromUser',
'DetachHostAccountsFromUserGroup',
'DetachHostGroupAccountsFromUser',
'AttachHostAccountsToUserGroup',
'DetachHostGroupAccountsFromUserGroup',
'AttachHostGroupAccountsToUser',
'AttachHostGroupAccountsToUserGroup',
'ListHostAccountsForUserGroup',
'ListHostGroupAccountNamesForUser',
'ListHostGroupAccountNamesForUserGroup',
'ListHostGroupsForUser',
'ListHostGroupsForUserGroup',
'ListHostsForUserGroup',
],
],
[
'id' => 267623,
'title' => '数据库授权(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'AttachDatabaseAccountsToUser',
'ListDatabasesForUser',
'DetachDatabaseAccountsFromUserGroup',
'ListDatabaseAccountsForUser',
'DetachDatabaseAccountsFromUser',
'AttachDatabaseAccountsToUserGroup',
'ListDatabasesForUserGroup',
],
],
[
'id' => 267631,
'title' => '运维令牌(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'ListOperationDatabases',
'ListOperationHosts',
'ListOperationHostAccounts',
'ListOperationDatabaseAccounts',
'GenerateAssetOperationToken',
'RenewAssetOperationToken',
'CreateOperationTicket',
],
],
[
'id' => 267639,
'title' => '授权规则(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'CreateRule',
'ModifyRule',
'GetRule',
'ListRules',
'EnableRule',
'DisableRule',
'DeleteRule',
],
],
[
'id' => 267647,
'title' => '控制策略(仅支持V3.2.40及以上版本使用)',
'type' => 'directory',
'children' => [
'CreatePolicy',
'ModifyPolicy',
'GetPolicy',
'ListPolicies',
'GetPolicyAssetScope',
'SetPolicyProtocolConfig',
'SetPolicyCommandConfig',
'SetPolicyIPAclConfig',
'GetPolicyUserScope',
'SetPolicyAccessTimeRangeConfig',
'SetPolicyAssetScope',
'SetPolicyUserScope',
'SetPolicyApprovalConfig',
'DeletePolicy',
],
],
[
'id' => 267662,
'title' => '审批(仅支持V3.2.37及以上版本使用)',
'type' => 'directory',
'children' => [
'ListApproveCommands',
'AcceptApproveCommand',
'RejectApproveCommand',
'ListOperationTickets',
'AcceptOperationTicket',
'RejectOperationTicket',
],
],
[
'id' => 267669,
'title' => '共享密钥(仅支持V3.2.X版本使用)',
'type' => 'directory',
'children' => [
'CreateHostShareKey',
'GetHostShareKey',
'ListHostShareKeys',
'ListHostAccountsForHostShareKey',
'ModifyHostShareKey',
'AttachHostAccountsToHostShareKey',
'DetachHostAccountsFromHostShareKey',
'DeleteHostShareKey',
],
],
[
'id' => 267678,
'title' => '系统设置(仅支持V3.2.X版本使用)',
'type' => 'directory',
'children' => [
'GetInstanceADAuthServer',
'ModifyInstanceADAuthServer',
'GetInstanceTwoFactor',
'ModifyInstanceTwoFactor',
'ModifyInstanceLDAPAuthServer',
'GetInstanceLDAPAuthServer',
'GetInstanceStoreInfo',
'CreateExportConfigJob',
'GetExportConfigJob',
],
],
[
'id' => 267688,
'title' => '其他',
'type' => 'directory',
'children' => [
'VerifyInstanceLDAPAuthServer',
'VerifyInstanceADAuthServer',
],
],
],
'components' => [
'schemas' => [],
],
'apis' => [
'DescribeInstanceAttribute' => [
'summary' => '查询实例所有的属性信息,例如:实例ID、实例的备注信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91488',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要查询的堡垒机实例所在的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要查询的堡垒机的实例的ID。'."\n"
.' > 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1ghxxxxx',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应参数。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。'."\n"
."\n\n",
'type' => 'string',
'example' => '082FAB35-6AB9-4FD5-8750-D36673548E76',
],
'InstanceAttribute' => [
'description' => '实例属性信息。',
'type' => 'object',
'properties' => [
'VpcId' => [
'description' => '实例绑定的VPC ID。',
'type' => 'string',
'example' => 'vpc-bp1c85tzgqu1bf5bxxxxx',
],
'VswitchId' => [
'description' => '实例绑定的交换机ID。',
'type' => 'string',
'example' => 'vsw-bp1xfwzzfti0kjbfxxxxx',
],
'Description' => [
'description' => '备注信息。',
'type' => 'string',
'example' => '测试API',
],
'ExpireTime' => [
'description' => '堡垒机实例的到期的时间戳。单位为毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1578326400000',
],
'ModifyPasswordModule' => [
'description' => '改密任务功能状态。'."\n"
."\n"
.'- **Enable**:开启'."\n"
.'- **Disable**:关闭',
'type' => 'string',
'example' => 'Enable',
],
'EniInstanceId' => [
'description' => '弹性网卡ID。',
'type' => 'string',
'example' => 'eni-bp1455jrzwm7moaxxxxx',
],
'InstanceId' => [
'description' => '实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1ghxxxxx',
],
'InternetEndpoint' => [
'description' => '公网域名。',
'type' => 'string',
'example' => '******lwb-public.bastionhost.aliyuncs.com',
],
'RegionId' => [
'description' => '实例所在的地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'IntranetEndpoint' => [
'description' => '内网域名。',
'type' => 'string',
'example' => '******xalwb.bastionhost.aliyuncs.com',
],
'StartTime' => [
'description' => '堡垒机实例的购买或续费的时间戳。单位为毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1577681345000',
],
'ResourceGroupId' => [
'description' => '实例所在的企业资源组的ID。',
'type' => 'string',
'example' => 'rg-aekzc427db******',
],
'NetworkProxyModule' => [
'description' => '网络域代理状态。'."\n"
.'- **Enable**:支持网络域代理模式。'."\n"
.'- **Disable**:不支持网络域代理模式。',
'type' => 'string',
'example' => 'Enable',
],
'WebTerminalModule' => [
'description' => 'Web Terminal状态。'."\n"
.'- **Enable**:支持Web远程连接。'."\n"
.'- **Disable**:不支持Web远程连接。',
'type' => 'string',
'example' => 'Enable',
],
'InstanceStatus' => [
'description' => '实例状态。取值范围:'."\n"
."\n"
.'- **PENDING**:未初始化'."\n"
.'- **CREATING**:创建中 '."\n"
.'- **RUNNING**:运行中 '."\n"
.'- **EXPIRED**:已过期 '."\n"
.'- **CREATE_FAILED**:创建失败'."\n"
.'- **UPGRADING**:变配中'."\n"
.'- **UPGRADE_FAILED**:变配失败',
'type' => 'string',
'example' => 'RUNNING',
],
'LicenseCode' => [
'description' => '许可Code。',
'type' => 'string',
'example' => 'bhah_ent_50_asset',
],
'PublicNetworkAccess' => [
'description' => '公网是否可以访问该堡垒机实例。取值:'."\n"
."\n"
.'- **true**:公网可以访问该堡垒机'."\n"
.'- **false**:公网不可访问该堡垒机',
'type' => 'boolean',
'example' => 'true',
],
'Storage' => [
'description' => '已购买堡垒机的存储总量。单位:Byte',
'type' => 'integer',
'format' => 'int64',
'example' => '2199023255552',
],
'Ports' => [
'description' => '堡垒机运维端口。',
'type' => 'array',
'items' => [
'description' => '堡垒机运维端口。',
'type' => 'object',
'properties' => [
'StandardPort' => [
'description' => '堡垒机标准端口。取值如下:'."\n"
."\n"
.'- **SSH** :60022 '."\n"
.'- **RDP** :63389'."\n"
.'- **HTTPS** :443',
'type' => 'integer',
'format' => 'int32',
'example' => '60022',
],
'CustomPort' => [
'description' => '用户自定义端口。'."\n"
."\n"
.'> 仅SSH、RDP支持修改 ,如果未自定义堡垒机运维端口,返回与标准端口一致。',
'type' => 'integer',
'format' => 'int32',
'example' => '600xx',
],
],
],
],
'PublicExportIps' => [
'description' => '堡垒机公网出口IP列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机公网出口IP。',
'type' => 'string',
'example' => '[10.162.168.xx/32]',
],
],
'PublicWhiteList' => [
'description' => '堡垒机公网白名单列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机公网白名单IP。',
'type' => 'string',
'example' => '[10.162.168.xx/32]',
],
],
'AuthorizedSecurityGroups' => [
'description' => '已授权的安全组ID列表。',
'type' => 'array',
'items' => [
'description' => '已授权的安全组ID。',
'type' => 'string',
'example' => '[sg-bp14u00sh39jvw5xxxxx]',
],
],
'PrivateExportIps' => [
'description' => '堡垒机内网出口IP列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机内网出口IP。',
'type' => 'string',
'example' => '192.168.xx.xx',
],
],
'PublicIps' => [
'description' => '堡垒机公网IP列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机公网IP。',
'type' => 'string',
'example' => '116.62.xx.xx',
],
],
'SecurityGroupIds' => [
'description' => '实例所属安全组ID列表。',
'type' => 'array',
'items' => [
'description' => '实例所属安全组ID。',
'type' => 'string',
'example' => 'sg-bp15ed6xe1yxeycg7o****',
],
],
'PrivateWhiteList' => [
'description' => '内网白名单IP列表。',
'type' => 'array',
'items' => [
'description' => '内网白名单IP。',
'type' => 'string',
'example' => '192.168.xx.xx',
],
],
'Bandwidth' => [
'description' => '堡垒机实例总带宽。',
'type' => 'string',
'example' => '30',
],
'BandwidthPackage' => [
'description' => '堡垒机扩展带宽包。',
'type' => 'string',
'example' => '5',
],
'DbOperationModule' => [
'description' => '数据库运维状态。'."\n"
.'- **Enable**:支持数据库运维。'."\n"
.'- **Disable**:不支持数据库运维。',
'type' => 'string',
'example' => 'Disable',
],
'RouterRules' => [
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'IDaaSModule' => [
'type' => 'string',
],
'SlaveVswitchId' => [
'type' => 'string',
],
'ScriptDeliverModule' => [
'type' => 'string',
],
'KmsSecretModule' => [
'type' => 'string',
],
'RDModule' => [
'type' => 'string',
],
'HSMModule' => [
'type' => 'string',
],
'WhiteListPolicies' => [
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Entry' => [
'type' => 'string',
],
'Description' => [
'type' => 'string',
],
],
],
],
'AppOperationModule' => [
'type' => 'string',
],
],
],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"082FAB35-6AB9-4FD5-8750-D36673548E76\\",\\n \\"InstanceAttribute\\": {\\n \\"VpcId\\": \\"vpc-bp1c85tzgqu1bf5bxxxxx\\",\\n \\"VswitchId\\": \\"vsw-bp1xfwzzfti0kjbfxxxxx\\",\\n \\"Description\\": \\"测试API\\",\\n \\"ExpireTime\\": 1578326400000,\\n \\"ModifyPasswordModule\\": \\"Enable\\",\\n \\"EniInstanceId\\": \\"eni-bp1455jrzwm7moaxxxxx\\",\\n \\"InstanceId\\": \\"bastionhost-cn-78v1ghxxxxx\\",\\n \\"InternetEndpoint\\": \\"******lwb-public.bastionhost.aliyuncs.com\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"IntranetEndpoint\\": \\"******xalwb.bastionhost.aliyuncs.com\\",\\n \\"StartTime\\": 1577681345000,\\n \\"ResourceGroupId\\": \\"rg-aekzc427db******\\",\\n \\"NetworkProxyModule\\": \\"Enable\\",\\n \\"WebTerminalModule\\": \\"Enable\\",\\n \\"InstanceStatus\\": \\"RUNNING\\",\\n \\"LicenseCode\\": \\"bhah_ent_50_asset\\",\\n \\"PublicNetworkAccess\\": true,\\n \\"Storage\\": 2199023255552,\\n \\"Ports\\": [\\n {\\n \\"StandardPort\\": 60022,\\n \\"CustomPort\\": 0\\n }\\n ],\\n \\"PublicExportIps\\": [\\n \\"[10.162.168.xx/32]\\"\\n ],\\n \\"PublicWhiteList\\": [\\n \\"[10.162.168.xx/32]\\"\\n ],\\n \\"AuthorizedSecurityGroups\\": [\\n \\"[sg-bp14u00sh39jvw5xxxxx]\\"\\n ],\\n \\"PrivateExportIps\\": [\\n \\"192.168.xx.xx\\"\\n ],\\n \\"PublicIps\\": [\\n \\"116.62.xx.xx\\"\\n ],\\n \\"SecurityGroupIds\\": [\\n \\"sg-bp15ed6xe1yxeycg7o****\\"\\n ],\\n \\"PrivateWhiteList\\": [\\n \\"192.168.xx.xx\\"\\n ],\\n \\"Bandwidth\\": \\"30\\",\\n \\"BandwidthPackage\\": \\"5\\",\\n \\"DbOperationModule\\": \\"Disable\\",\\n \\"RouterRules\\": [\\n \\"\\"\\n ],\\n \\"IDaaSModule\\": \\"\\",\\n \\"SlaveVswitchId\\": \\"\\",\\n \\"ScriptDeliverModule\\": \\"\\",\\n \\"KmsSecretModule\\": \\"\\",\\n \\"RDModule\\": \\"\\",\\n \\"HSMModule\\": \\"\\",\\n \\"WhiteListPolicies\\": [\\n {\\n \\"Entry\\": \\"\\",\\n \\"Description\\": \\"\\"\\n }\\n ],\\n \\"AppOperationModule\\": \\"\\"\\n }\\n}","type":"json"}]',
'title' => '查询实例属性信息',
],
'DescribeInstances' => [
'summary' => '查询实例的列表信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
'default' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '设置分页查询时,每页显示的堡垒机实例的数量。默认值为**10**,表示每页显示10条堡垒机实例信息。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '100',
'minimum' => '1',
'example' => '10',
'default' => '20',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
'default' => '1',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '实例所在的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'InstanceStatus',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的状态。取值:'."\n"
."\n"
.'- **PENDING**:未初始化'."\n"
."\n"
.'- **CREATING**:创建中 '."\n"
."\n"
.'- **RUNNING**:运行中 '."\n"
."\n"
.'- **EXPIRED**:已过期 '."\n"
."\n"
.'- **CREATE_FAILED**:创建失败'."\n"
."\n"
.'- **UPGRADING**:变配中'."\n"
."\n"
.'- **UPGRADE_FAILED**:变配失败',
'type' => 'string',
'required' => false,
'example' => 'RUNNING',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例所在的企业资源组的ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-acfm26ougi****',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '堡垒机实例的ID。',
'type' => 'array',
'items' => [
'description' => '堡垒机实例的ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'required' => false,
'example' => 'bastionhost-cn-78v1ghxxxxx',
'maxItems' => 10,
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '堡垒机实例的标签信息。',
'type' => 'array',
'items' => [
'description' => '堡垒机实例的标签信息。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '实例的标签键。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '实例的标签值。',
'type' => 'string',
'required' => false,
'example' => 'testapi',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的堡垒机实例的总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '4',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '61D36C55-AAFC-4678-8FAD-34FEF9E7182E',
],
'Instances' => [
'description' => '查询到的堡垒机实例的列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'VpcId' => [
'description' => '堡垒机实例绑定的VPC ID。',
'type' => 'string',
'example' => 'vpc-bp1c85tzgqu1bf5b****',
],
'VswitchId' => [
'description' => '堡垒机实例绑定的交换机ID。',
'type' => 'string',
'example' => 'vsw-bp1xfwzzfti0kjbf****',
],
'ImageVersion' => [
'description' => '堡垒机实例镜像的版本。',
'type' => 'string',
'example' => '3.2.41',
],
'PlanCode' => [
'description' => '堡垒机实例的规格。取值:'."\n"
."\n"
.'- **cloudbastion**:基础版'."\n"
.'- **cloudbastion_ha**:企业双擎版',
'type' => 'string',
'example' => 'cloudbastion_ha',
],
'Description' => [
'description' => '堡垒机实例的备注信息。',
'type' => 'string',
'example' => '测试API',
],
'ExpireTime' => [
'description' => '堡垒机实例的到期的时间戳。单位为毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1578326400000',
],
'Legacy' => [
'description' => '该堡垒机实例是否为旧版堡垒机实例。取值:'."\n"
."\n"
.'- **true**:表示V2和V3.1系列的堡垒机实例。'."\n"
."\n"
.'- **false**:表示V3.2系列的堡垒机实例。',
'type' => 'boolean',
'example' => 'false',
],
'InstanceId' => [
'description' => '堡垒机的实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1gh****',
],
'InternetEndpoint' => [
'description' => '堡垒机实例的公网域名。',
'type' => 'string',
'example' => '******lwb-public.bastionhost.aliyuncs.com',
],
'RegionId' => [
'description' => '堡垒机实例所在的地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'IntranetEndpoint' => [
'description' => '堡垒机实例的私网域名。',
'type' => 'string',
'example' => '******lwb.bastionhost.aliyuncs.com',
],
'StartTime' => [
'description' => '堡垒机实例的购买或续费的时间戳。单位为毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1577681345000',
],
'ResourceGroupId' => [
'description' => '堡垒机实例所在的企业资源组的ID。',
'type' => 'string',
'example' => 'g-acfm26ougi****',
],
'InstanceStatus' => [
'description' => '堡垒机实例的状态。取值:'."\n"
."\n"
.'- **PENDING**:未初始化'."\n"
."\n"
.'- **CREATING**:创建中 '."\n"
."\n"
.'- **RUNNING**:运行中 '."\n"
."\n"
.'- **EXPIRED**:已过期 '."\n"
."\n"
.'- **CREATE_FAILED**:创建失败'."\n"
."\n"
.'- **UPGRADING**:变配中'."\n"
."\n"
.'- **UPGRADE_FAILED**:变配失败',
'type' => 'string',
'example' => 'RUNNING',
],
'LicenseCode' => [
'description' => '堡垒机实例的许可Code。',
'type' => 'string',
'example' => 'bhah_ent_50_asset',
],
'PublicNetworkAccess' => [
'description' => '公网是否可以访问该堡垒机实例。取值:'."\n"
."\n"
.'- **true**:公网可以访问该堡垒机'."\n"
.'- **false**:公网不可访问该堡垒机',
'type' => 'boolean',
'example' => 'true',
],
'SlaveVswitchId' => [
'type' => 'string',
],
'BandWidth' => [
'type' => 'integer',
'format' => 'int64',
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 4,\\n \\"RequestId\\": \\"61D36C55-AAFC-4678-8FAD-34FEF9E7182E\\",\\n \\"Instances\\": [\\n {\\n \\"VpcId\\": \\"vpc-bp1c85tzgqu1bf5b****\\",\\n \\"VswitchId\\": \\"vsw-bp1xfwzzfti0kjbf****\\",\\n \\"ImageVersion\\": \\"3.2.41\\",\\n \\"PlanCode\\": \\"cloudbastion_ha\\",\\n \\"Description\\": \\"测试API\\",\\n \\"ExpireTime\\": 1578326400000,\\n \\"Legacy\\": false,\\n \\"InstanceId\\": \\"bastionhost-cn-78v1gh****\\",\\n \\"InternetEndpoint\\": \\"******lwb-public.bastionhost.aliyuncs.com\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"IntranetEndpoint\\": \\"******lwb.bastionhost.aliyuncs.com\\",\\n \\"StartTime\\": 1577681345000,\\n \\"ResourceGroupId\\": \\"g-acfm26ougi****\\",\\n \\"InstanceStatus\\": \\"RUNNING\\",\\n \\"LicenseCode\\": \\"bhah_ent_50_asset\\",\\n \\"PublicNetworkAccess\\": true,\\n \\"SlaveVswitchId\\": \\"\\",\\n \\"BandWidth\\": 0\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 4\\n 61D36C55-AAFC-4678-8FAD-34FEF9E7182E\\n \\n vpc-bp1c85tzgqu1bf5b****\\n vsw-bp1xfwzzfti0kjbf****\\n 3.0.0\\n cloudbastion_ha\\n 测试API\\n 1578326400000\\n false\\n bastionhost-cn-78v1gh****\\n drawvxalwb-public.bastionhost.aliyuncs.com\\n cn-hangzhou\\n drawvxalwb.bastionhost.aliyuncs.com\\n 1577681345000\\n g-acfm26ougi****\\n RUNNING\\n bhah_ent_50_asset\\n true\\n \\n","errorExample":""}]',
'title' => '查询实例的列表信息',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ConfigInstanceSecurityGroups' => [
'summary' => '为指定的堡垒机实例配置安全组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'Lang',
'in' => 'query',
'schema' => [
'description' => '设置请求和接收消息的语言类型,默认为**zh**。取值:'."\n"
."\n"
.'- **zh**:中文'."\n"
.'- **en**:英文',
'type' => 'string',
'required' => false,
'example' => 'zh',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AuthorizedSecurityGroups',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '已授权的安全组ID列表。',
'type' => 'array',
'items' => [
'description' => '已授权的安全组ID。N的取值范围:1~100。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'required' => true,
'example' => 'sg-bp14u00sh39jvw5****',
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'InstanceId' => [
'description' => '已配置安全组的堡垒机实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1gh****',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '0ECCC399-4D35-48A7-8379-5C6180E66235',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"InstanceId\\": \\"bastionhost-cn-78v1gh****\\",\\n \\"RequestId\\": \\"0ECCC399-4D35-48A7-8379-5C6180E66235\\"\\n}","errorExample":""},{"type":"xml","example":"\\n bastionhost-cn-78v1gh****\\n 0ECCC399-4D35-48A7-8379-5C6180E66235\\n","errorExample":""}]',
'title' => '为指定的堡垒机实例配置安全组',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ConfigInstanceWhiteList' => [
'summary' => '堡垒机实例开启公网访问后,可以将指定公网IP地址加入白名单,允许公网流量访问堡垒机实例。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91477',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要配置公网IP地址白名单的堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'WhiteList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '需要配置的IP地址白名单。',
'type' => 'array',
'items' => [
'description' => '需要配置的IP地址白名单。最多支持配置50个IP地址。如果要将多个IP地址加入白名单,多个IP之间使用半角逗号(,)隔开。',
'type' => 'string',
'required' => false,
'example' => '10.162.XX.XX,192.168.XX.XX',
],
'required' => false,
'example' => '10.162.XX.XX',
'maxItems' => 50,
],
],
[
'name' => 'WhiteListPolicies',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Entry' => [
'type' => 'string',
'required' => false,
],
'Description' => [
'type' => 'string',
'required' => false,
],
],
'required' => false,
],
'required' => false,
'maxItems' => 50,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'InstanceId' => [
'description' => '已配置公网IP地址白名单的堡垒机实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1gh****',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '47820E32-5968-45CF-982F-09CB80DC180B',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"InstanceId\\": \\"bastionhost-cn-78v1gh****\\",\\n \\"RequestId\\": \\"47820E32-5968-45CF-982F-09CB80DC180B\\"\\n}","errorExample":""},{"type":"xml","example":"\\n47820E32-5968-45CF-982F-09CB80DC180B\\nbastionhost-cn-78v1gh****\\n","errorExample":""}]',
'title' => '为堡垒机实例配置公网IP地址白名单',
'description' => '本接口用于为堡垒机实例配置公网IP地址白名单。一般情况下是默认放开所有公网IP访问堡垒机,在需要限制公网IP访问堡垒机时,使用本接口将指定公网IP地址加入白名单,对公网流量访问堡垒机实例进行限制。'."\n"
."\n"
.'本接口的单用户QPS限制为30次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'StartInstance' => [
'summary' => '启动指定堡垒机实例。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91530',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要启用的堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'VswitchId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例绑定的交换机ID。',
'type' => 'string',
'required' => false,
'example' => 'vsw-bp1xfwzzfti0kjbf****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'SecurityGroupIds',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '堡垒机实例绑定的安全组ID列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机实例绑定的安全组ID。',
'type' => 'string',
'required' => false,
'example' => 'sg-bp1aiupc4yjqgmm****',
],
'required' => true,
'example' => 'sg-bp1aiupc4yjqgmm****',
'maxItems' => 100,
],
],
[
'name' => 'ClientSecurityGroupIds',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'type' => 'array',
'items' => [
'type' => 'string',
'required' => false,
],
'required' => false,
'maxItems' => 5,
'minItems' => 1,
],
],
[
'name' => 'SlaveVswitchId',
'in' => 'query',
'schema' => [
'type' => 'string',
'required' => false,
],
],
[
'name' => 'EnablePortalPrivateAccess',
'in' => 'query',
'schema' => [
'type' => 'boolean',
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'InstanceId' => [
'description' => '已启用的堡垒机的实例ID。'."\n",
'type' => 'string',
'example' => 'bastionhost-cn-78v1gh****',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '0F85AE0A-6A87-48F3-A0C7-90B998788A36',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"InstanceId\\": \\"bastionhost-cn-78v1gh****\\",\\n \\"RequestId\\": \\"0F85AE0A-6A87-48F3-A0C7-90B998788A36\\"\\n}","errorExample":""},{"type":"xml","example":"\\n bastionhost-cn-78v1gh****\\n 0F85AE0A-6A87-48F3-A0C7-90B998788A36\\n","errorExample":""}]',
'title' => '启动指定堡垒机实例',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'EnableInstancePublicAccess' => [
'summary' => '打开指定堡垒机实例公网访问开关。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'InstanceId' => [
'description' => '已开启公网访问开关的堡垒机的实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1gh****',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'D47B5043-FDD6-4FBE-976E-5FC67A23578F',
],
],
],
],
],
'errorCodes' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"InstanceId\\": \\"bastionhost-cn-78v1gh****\\",\\n \\"RequestId\\": \\"D47B5043-FDD6-4FBE-976E-5FC67A23578F\\"\\n}","errorExample":""},{"type":"xml","example":"\\n bastionhost-cn-78v1gh****\\n D47B5043-FDD6-4FBE-976E-5FC67A23578F\\n","errorExample":""}]',
'title' => '打开指定堡垒机实例公网访问开关',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DisableInstancePublicAccess' => [
'summary' => '关闭实例的公网访问开关。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要关闭公网访问开关的堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'InstanceId' => [
'description' => '已关闭公网访问开关的堡垒机的实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1gh****',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '76FAAF15-D3A3-4099-9941-FC408D9FDB4C',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"InstanceId\\": \\"bastionhost-cn-78v1gh****\\",\\n \\"RequestId\\": \\"76FAAF15-D3A3-4099-9941-FC408D9FDB4C\\"\\n}","errorExample":""},{"type":"xml","example":"\\n bastionhost-cn-78v1gh****\\n 76FAAF15-D3A3-4099-9941-FC408D9FDB4C\\n","errorExample":""}]',
'title' => '关闭实例的公网访问开关',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyInstanceAttribute' => [
'summary' => '修改指定堡垒机实例的信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。 '."\n",
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的描述信息。'."\n"
."\n"
.'> 只能包含字母、汉字、数字、下划线(_)或短划线(-),长度不能超过30字符。',
'type' => 'string',
'required' => false,
'example' => 'Bastionhost demo',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'E07158EA-D1A3-4BAA-84DA-2FE230D03884',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E07158EA-D1A3-4BAA-84DA-2FE230D03884\\"\\n}","errorExample":""},{"type":"xml","example":"\\n E07158EA-D1A3-4BAA-84DA-2FE230D03884\\n","errorExample":""}]',
'title' => '修改指定堡垒机实例的信息',
],
'MoveResourceGroup' => [
'summary' => '移动堡垒机实例至指定资源组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'ResourceId',
'in' => 'query',
'schema' => [
'description' => '需要更换资源组的堡垒机实例ID。'."\n"
.'> 您可调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '需要移入堡垒机实例的资源组ID。'."\n"
.'> 您可调用[DescribeInstances](~~153281~~)接口获取堡垒机实例的资源组ID。',
'type' => 'string',
'required' => true,
'example' => 'rg-aekznp3oyo****',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义。固定取值为**INSTANCE**,表示堡垒机实例。',
'type' => 'string',
'required' => true,
'example' => 'INSTANCE',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '1DEEC28D-27B1-4358-B6DC-E1285AE655C5',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DEEC28D-27B1-4358-B6DC-E1285AE655C5\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1DEEC28D-27B1-4358-B6DC-E1285AE655C5\\n","errorExample":""}]',
'title' => '移动堡垒机实例至指定资源组',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddInstanceRdMember' => [
'summary' => '添加RD成员账号。',
'path' => '',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-7mz2ve7h00a',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'MemberId',
'in' => 'query',
'schema' => [
'description' => '要添加的RD成员账号UID。',
'type' => 'string',
'required' => true,
'example' => '1857311509574932',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => '响应参数。',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '4F6C075F-FC86-476E-943B-097BD4E12948',
],
],
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"4F6C075F-FC86-476E-943B-097BD4E12948\\"\\n}","type":"json"}]',
'title' => '添加RD成员账号到堡垒机实例(仅支持V3.2.48及以上版本使用)',
],
'ListInstanceRdMembers' => [
'summary' => '获取RD成员账号列表。',
'path' => '',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '请求Token,首次请求不传或者传空字符串。',
'type' => 'string',
'required' => false,
'example' => '4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****',
],
],
[
'name' => 'MaxResults',
'in' => 'query',
'schema' => [
'description' => '单次请求获取最大RD成员账号个数,取值1-100整数。不传时默认取值20。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '20',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => '响应参数。',
'type' => 'object',
'properties' => [
'Members' => [
'description' => '成员账号列表。',
'type' => 'array',
'items' => [
'description' => '成员账号列表。',
'type' => 'object',
'properties' => [
'MemberId' => [
'description' => '成员账号UID。',
'type' => 'string',
'example' => '1197234496852779',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'NextToken' => [
'description' => '下次请求Token,用于分页查询时下一次查询填写到请求参数NextToken中。若响应中该字段为空时,表示无更多数据。',
'type' => 'string',
'example' => '4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****',
],
'MaxResults' => [
'description' => '请求参数中传了有效MaxResults时返回请求时所传的值,否则返回默认值。',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
],
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Members\\": [\\n {\\n \\"MemberId\\": \\"1197234496852779\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"NextToken\\": \\"4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****\\",\\n \\"MaxResults\\": 20\\n}","type":"json"}]',
'title' => '查询指定堡垒机实例中已导入的RD成员账号列表(仅支持V3.2.48及以上版本使用)',
],
'RemoveInstanceRdMember' => [
'summary' => '移除RD成员账号。',
'path' => '',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'MemberId',
'in' => 'query',
'schema' => [
'description' => '要移除的RD成员账号UID。',
'type' => 'string',
'required' => true,
'example' => '1597141696147832',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => '返回参数。',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '将RD成员账号从堡垒机实例中移除(仅支持V3.2.48及以上版本使用)',
'description' => '移除成员账号前,需先将堡垒机中所属该成员账号的ECS、RDS、PolarDB实例资产清除。',
],
'ListTagKeys' => [
'summary' => '查询一个资源已经绑定的标签列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91513',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义。'."\n"
."\n"
.'唯一取值为INSTANCE,表示堡垒机实例。',
'type' => 'string',
'required' => true,
'example' => 'INSTANCE',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页查询时,显示的每页数据的最大条数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页查询时,显示当前页的页码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'type' => 'string',
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '50177258-E817-4D2F-A5C6-3FD7BC4806E3',
],
'PageNumber' => [
'description' => '分页查询时,显示当前页的页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '分页查询时,显示的每页数据的最大条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'TotalCount' => [
'description' => '标签的总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'TagKeys' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'TagCount' => [
'description' => '标签键的总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'TagKey' => [
'description' => '标签键名称。',
'type' => 'string',
'example' => 'key2',
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"50177258-E817-4D2F-A5C6-3FD7BC4806E3\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 5,\\n \\"TagKeys\\": [\\n {\\n \\"TagCount\\": 2,\\n \\"TagKey\\": \\"key2\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 5\\n 10\\n 50177258-E817-4D2F-A5C6-3FD7BC4806E3\\n 1\\n \\n 2\\n 1\\n \\n \\n 2\\n 1234567890按时AAAaaa\\n \\n \\n 1\\n das\\n \\n \\n 3\\n key1\\n \\n \\n 2\\n key2\\n \\n","errorExample":""}]',
'title' => '查询堡垒机资源已绑定的标签列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListTagResources' => [
'summary' => '查询一个或多个堡垒机实例已经绑定的标签列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91514',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义。'."\n"
."\n"
.'唯一取值为INSTANCE,表示堡垒机实例。',
'type' => 'string',
'required' => true,
'example' => 'INSTANCE',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '下一个查询开始的Token。',
'type' => 'string',
'required' => false,
'example' => '6EwFJmScBXFFC3nf.9Rq7HzA7APx7GWLbkZbjHrR6Pq39w',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '资源ID。',
'type' => 'array',
'items' => [
'description' => '资源ID。'."\n"
."\n"
.'N的取值范围:1~20。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机资源ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'required' => false,
'example' => 'bastionhost-cn-78v1gcxxxxx',
'maxItems' => 51,
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机实例的标签信息。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '标签键。'."\n"
."\n"
.'N的取值范围:1~20。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '标签值。'."\n"
."\n"
.'N的取值范围:1~20。',
'type' => 'string',
'required' => false,
'example' => 'testapi',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 21,
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'type' => 'string',
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '下一个查询开始的Token。',
'type' => 'string',
'example' => '4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '134D6018-EB68-4B7C-BABF-4DB09023E014',
],
'TagResources' => [
'description' => '堡垒机实例及其绑定的标签列表。'."\n"
."\n"
.'包括实例ID、资源类型、标签键和标签值信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'testapi',
],
'ResourceType' => [
'description' => '资源类型。'."\n"
."\n"
.'唯一取值为INSTANCE,表示堡垒机实例。',
'type' => 'string',
'example' => 'INSTANCE',
],
'ResourceId' => [
'description' => '实例ID。',
'type' => 'string',
'example' => 'bastionhost-cn-78v1gc****',
],
'TagKey' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'test',
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"NextToken\\": \\"4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****\\",\\n \\"RequestId\\": \\"134D6018-EB68-4B7C-BABF-4DB09023E014\\",\\n \\"TagResources\\": [\\n {\\n \\"TagValue\\": \\"testapi\\",\\n \\"ResourceType\\": \\"INSTANCE\\",\\n \\"ResourceId\\": \\"bastionhost-cn-78v1gc****\\",\\n \\"TagKey\\": \\"test\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 6EwFJmScBXFFC3nf.9Rq7HzA7APx7GWLbkZbjHrR6P****\\n 134D6018-EB68-4B7C-BABF-4DB09023E014\\n \\n bastionhost-cn-78v1gc****\\n test\\n INSTANCE\\n testapi\\n \\n","errorExample":""}]',
'title' => '查询堡垒机实例已绑定的标签列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'UntagResources' => [
'summary' => '为指定堡垒机实例批量解绑并删除标签。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91533',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要查询堡垒机实例的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义。'."\n"
."\n"
.'唯一取值为**INSTANCE**,表示堡垒机实例。',
'type' => 'string',
'required' => true,
'example' => 'INSTANCE',
],
],
[
'name' => 'All',
'in' => 'query',
'schema' => [
'description' => '设置是否删除堡垒机实例上的全部标签。'."\n"
."\n"
.'- 设置TagKey.N时,All的值只能设置为**false**,删除某个标签。'."\n"
.'- 未设置TagKey.N时,All设置为**true**,删除所有的标签。All设置为**false**,不删除标签。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '实例ID。'."\n"
."\n"
.'N的取值范围:1~20。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。'."\n"
."\n",
'type' => 'array',
'items' => [
'description' => '实例ID。'."\n"
."\n"
.'N的取值范围:1~20。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'bastionhost-cn-78v1gc****',
],
'required' => true,
'maxItems' => 51,
],
],
[
'name' => 'TagKey',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '实例的标签键。'."\n"
."\n"
.'N的取值范围:1~20。',
'type' => 'array',
'items' => [
'description' => '实例的标签键。'."\n"
."\n"
.'N的取值范围:1~20。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'required' => false,
'maxItems' => 21,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'A8A665B9-8550-4942-9DEE-73198051856B',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A8A665B9-8550-4942-9DEE-73198051856B\\"\\n}","errorExample":""},{"type":"xml","example":"\\n A8A665B9-8550-4942-9DEE-73198051856B\\n","errorExample":""}]',
'title' => '为指定堡垒机实例批量解绑并删除标签',
],
'TagResources' => [
'summary' => '为指定的堡垒机实例统一创建并绑定标签。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '需要创建并绑定标签的堡垒机实例的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义。'."\n"
."\n"
.'唯一取值为**INSTANCE** ,表示堡垒机实例。'."\n",
'type' => 'string',
'required' => true,
'example' => 'INSTANCE',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '堡垒机实例ID列表。'."\n"
."\n"
.'N的取值范围为1~20。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'array',
'items' => [
'description' => '堡垒机实例ID。',
'type' => 'string',
'required' => false,
'example' => 'bastionhost-cn-78v1gc****',
],
'required' => true,
'example' => 'bastionhost-cn-78v1gc****',
'maxItems' => 51,
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '堡垒机的标签。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '实例的标签键。'."\n"
.'N的取值范围:1~20。 '."\n"
."\n"
.'> - 该参数不允许传入空字符串。最多支持传入128个字符。'."\n"
.'> - 该参数不能以**aliyun**或**acs:**开头,不能包含**http://**或**https://**。',
'type' => 'string',
'required' => false,
'example' => 'operation',
],
'Value' => [
'description' => '实例的标签值。 '."\n"
.'N的取值范围:1~20。'."\n"
.'> - 该参数可设置为空字符串,最多支持传入128个字符。'."\n"
.'> - 该参数不能以**aliyun**或**acs:**开头,不能包含**http://**或者**https://**。',
'type' => 'string',
'required' => false,
'example' => 'operation_test',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 21,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '2F24F0A8-4C69-4E89-9392-457D107E2D4A',
],
],
],
],
],
'errorCodes' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2F24F0A8-4C69-4E89-9392-457D107E2D4A\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2F24F0A8-4C69-4E89-9392-457D107E2D4A\\n","errorExample":""}]',
'title' => '为堡垒机实例统一创建并绑定标签',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeRegions' => [
'summary' => '查询堡垒机实例支持的阿里云地域。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '91490',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'AcceptLanguage',
'in' => 'query',
'schema' => [
'description' => '设置返回结果的语言类型。取值范围:'."\n"
.'- **zh-CN**(默认值):中文'."\n"
.'- **en-US**:英文'."\n"
.'- **ja**:日文'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'zh-CN',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-shenzhen',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'B7281856-F27D-4ECE-B4F1-50511E550xxx',
],
'Regions' => [
'description' => ' '."\n"
.'堡垒机实例支持的地域信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'RegionEndpoint' => [
'description' => '地域对应的接入地址。',
'type' => 'string',
'example' => 'yundun-bastionhost.aliyuncs.com',
],
'LocalName' => [
'description' => '地域名称。',
'type' => 'string',
'example' => 'China (Hangzhou)',
],
'RegionId' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B7281856-F27D-4ECE-B4F1-50511E550xxx\\",\\n \\"Regions\\": [\\n {\\n \\"RegionEndpoint\\": \\"yundun-bastionhost.aliyuncs.com\\",\\n \\"LocalName\\": \\"China (Hangzhou)\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n B7281856-F27D-4ECE-B4F1-50511E550xxx\\n \\n cn-hangzhou\\n yundun-bastionhost.aliyuncs.com\\n 华东1(杭州)\\n \\n \\n cn-shanghai\\n yundun-bastionhost.aliyuncs.com\\n 华东2(上海)\\n \\n \\n cn-qingdao\\n yundun-bastionhost.aliyuncs.com\\n 华北1(青岛)\\n \\n \\n cn-beijing\\n yundun-bastionhost.aliyuncs.com\\n 华北2(北京)\\n \\n \\n cn-zhangjiakou\\n yundun-bastionhost.aliyuncs.com\\n 华北3(张家口)\\n \\n \\n cn-huhehaote\\n yundun-bastionhost.aliyuncs.com\\n 华北5(呼和浩特)\\n \\n \\n cn-shenzhen\\n yundun-bastionhost.aliyuncs.com\\n 华南1(深圳)\\n \\n \\n cn-chengdu\\n yundun-bastionhost.aliyuncs.com\\n 西南1(成都)\\n \\n \\n cn-hongkong\\n yundun-bastionhost.aliyuncs.com\\n 中国香港\\n \\n \\n ap-southeast-1\\n yundun-bastionhost.aliyuncs.com\\n 新加坡\\n \\n \\n ap-southeast-2\\n yundun-bastionhost.aliyuncs.com\\n 澳大利亚(悉尼)\\n \\n \\n ap-southeast-3\\n yundun-bastionhost.aliyuncs.com\\n 马来西亚(吉隆坡)\\n \\n \\n ap-southeast-5\\n yundun-bastionhost.aliyuncs.com\\n 印度尼西亚(雅加达)\\n \\n \\n ap-northeast-1\\n yundun-bastionhost.aliyuncs.com\\n 日本(东京)\\n \\n \\n ap-south-1\\n yundun-bastionhost.aliyuncs.com\\n 印度(孟买)\\n \\n \\n eu-central-1\\n yundun-bastionhost.aliyuncs.com\\n 德国(法兰克福)\\n \\n \\n eu-west-1\\n yundun-bastionhost.aliyuncs.com\\n 英国(伦敦)\\n \\n \\n us-west-1\\n yundun-bastionhost.aliyuncs.com\\n 美国(硅谷)\\n \\n \\n us-east-1\\n yundun-bastionhost.aliyuncs.com\\n 美国(弗吉尼亚)\\n \\n \\n me-east-1\\n yundun-bastionhost.aliyuncs.com\\n 阿联酋(迪拜)\\n \\n","errorExample":""}]',
'title' => '查询堡垒机实例支持的阿里云地域',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateHost' => [
'summary' => '堡垒机支持运维阿里云ECS服务器、线下IDC服务器以及其他云上服务器等不同来源的主机。在通过堡垒机运维主机之前,首先需要在堡垒机中导入主机。您可以参考本接口在堡垒机中创建需要运维的主机。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机所在堡垒机的地域ID。'."\n"
.'> Region ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostPrivateAddress',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机的私网地址,可使用域名或IP地址。'."\n"
.'> **ActiveAddressType**选择**Private**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'HostPublicAddress',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机的公网地址,可使用域名或IP地址。'."\n"
.'> **ActiveAddressType**选择**Public**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => '172.16.XX.XX',
],
],
[
'name' => 'ActiveAddressType',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机的地址类型。取值:'."\n"
.'- **Public**:公网地址'."\n"
.'- **Private**:私网地址',
'type' => 'string',
'required' => true,
'example' => 'Public',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机的名称,最多支持128字符。',
'type' => 'string',
'required' => true,
'example' => 'host01',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机的来源。取值:'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例'."\n"
.'- **Rds**:RDS专属集群主机',
'type' => 'string',
'required' => true,
'example' => 'Local',
],
],
[
'name' => 'OSType',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机的操作系统。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'required' => true,
'example' => 'Linux',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定主机的备注信息,最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'Local Host',
],
],
[
'name' => 'SourceInstanceId',
'in' => 'query',
'schema' => [
'description' => '指定新创建的ECS实例ID或专属集群主机ID。 '."\n"
.'> **Source**选择**Ecs**或**Rds**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'i-dfabfda',
],
],
[
'name' => 'InstanceRegionId',
'in' => 'query',
'schema' => [
'description' => '指定新创建的ECS实例或专属集群主机所属区域ID。 '."\n"
.'> **Source**选择**Ecs**或**Rds**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定新创建主机所属的网络域ID。'."\n"
.'> 您可以调用[ListNetworkDomains ](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'InstanceMemberId',
'in' => 'query',
'schema' => [
'title' => '主机实例所属实例成员ID',
'description' => '指定新创建的ECS实例所属的主账号ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1605494xxxx',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'HostId' => [
'description' => '新创建主机的ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'LicenseOutOfLimit',
'errorMessage' => 'The host count is out of limit.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"HostId\\": \\"1\\",\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n 1\\n","errorExample":""}]',
'title' => '在堡垒机中创建需要运维的主机',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'GetHost' => [
'summary' => '包括主机名称、来源、主机地址、协议端口等信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机所在堡垒机的区域ID。'."\n"
.'> Region ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机ID。仅支持输入一个主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Host' => [
'description' => '查询到的主机信息。',
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '主机的备注信息。',
'type' => 'string',
'example' => 'host',
],
'ActiveAddressType' => [
'description' => '主机地址类型。取值:'."\n"
.'- **Public** :公网地址'."\n"
.'- **Private** :私网地址',
'type' => 'string',
'example' => 'Public',
],
'HostPublicAddress' => [
'description' => '主机的公网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '1.1.XX.XX',
],
'HostName' => [
'description' => '主机名称。',
'type' => 'string',
'example' => 'host',
],
'Source' => [
'description' => '主机的来源。取值:'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例'."\n"
.'- **Rds**:RDS专属集群主机',
'type' => 'string',
'example' => 'Local',
],
'HostPrivateAddress' => [
'description' => '主机的私网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'OSType' => [
'description' => '主机的操作系统。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'example' => 'Linux',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'SourceInstanceState' => [
'description' => '主机状态。取值:'."\n"
.' - **Normal** :正常'."\n"
.'- **Release**: 已释放',
'type' => 'string',
'example' => 'Normal',
],
'SourceInstanceId' => [
'description' => '主机对应的ECS实例ID或专属集群主机ID。'."\n"
.'> **Source**为**Local**时,该参数返回值为空。',
'type' => 'string',
'example' => 'i-bp19ienyt0yax748****',
],
'Protocols' => [
'description' => '主机的协议信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostFingerPrint' => [
'description' => '主机指纹信息,可以唯一标识一台主机。只有通过堡垒机运维目标主机时,堡垒机才会记录主机指纹,否则返回为空。',
'type' => 'string',
'example' => 'ssh-ed25519|3e:46:5a:e1:1f:0d:39:7e:61:35:d5:fa:7b:2b:**:**',
],
'Port' => [
'description' => '主机的服务端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '22',
],
'ProtocolName' => [
'description' => '主机使用的协议名称。取值:'."\n"
.'- **SSH**'."\n"
.'- **RDP**',
'type' => 'string',
'example' => 'SSH',
],
],
],
],
'NetworkDomainId' => [
'description' => '主机所属的网络域的ID。',
'type' => 'string',
'example' => '1',
],
'PrefKex' => [
'description' => '主机首选密钥交换算法配置。当OSType为Linux时有返回值。'."\n"
."\n"
.'- **default**:默认模式'."\n"
.'- **diffie-hellman-group1-sha1**:diffie-hellman-group1-sha1算法兼容模式'."\n"
.'- **diffie-hellman-group14-sha1**:diffie-hellman-group14-sha1算法兼容模式'."\n"
.'- **diffie-hellman-group-exchange-sha1**:diffie-hellman-group-exchange-sha1算法兼容模式',
'type' => 'string',
'example' => 'default',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'HostNotFound',
'errorMessage' => 'The host is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Host\\": {\\n \\"Comment\\": \\"host\\",\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"HostPublicAddress\\": \\"1.1.XX.XX\\",\\n \\"HostName\\": \\"host\\",\\n \\"Source\\": \\"Local\\",\\n \\"HostPrivateAddress\\": \\"192.168.XX.XX\\",\\n \\"OSType\\": \\"Linux\\",\\n \\"HostId\\": \\"1\\",\\n \\"SourceInstanceState\\": \\"Normal\\",\\n \\"SourceInstanceId\\": \\"i-bp19ienyt0yax748****\\",\\n \\"Protocols\\": [\\n {\\n \\"HostFingerPrint\\": \\"ssh-ed25519|3e:46:5a:e1:1f:0d:39:7e:61:35:d5:fa:7b:2b:**:**\\",\\n \\"Port\\": 22,\\n \\"ProtocolName\\": \\"SSH\\"\\n }\\n ],\\n \\"NetworkDomainId\\": \\"1\\",\\n \\"PrefKex\\": \\"default\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n host\\n \\n SSH\\n \\n 22\\n \\n Public\\n 192.168.XX.XX\\n 1.1.XX.XX\\n Linux\\n 1\\n i-bp19ienyt0yax748****\\n host\\n Normal\\n Local\\n \\n","errorExample":""}]',
'title' => '获取指定主机的详细信息',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHosts' => [
'summary' => '查询指定堡垒机实例下的主机列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要查询主机的堡垒机实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要查询主机的堡垒机所在地域的ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '设置分页查询时,每页显示的主机信息的数量。默认值为**10**,表示每页显示10条主机信息。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'OSType',
'in' => 'query',
'schema' => [
'description' => '要查询的主机的操作系统。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'required' => false,
'example' => 'Linux',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '要查询的主机名称。不支持模糊查询,只支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'host',
],
],
[
'name' => 'HostAddress',
'in' => 'query',
'schema' => [
'description' => '要查询的主机地址,可使用域名或IP地址。不支持模糊查询,只支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '1.1.XX.XX',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '要查询主机的来源。取值:'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例'."\n"
.'- **Rds**:RDS专属集群主机',
'type' => 'string',
'required' => false,
'example' => 'Local',
],
],
[
'name' => 'SourceInstanceId',
'in' => 'query',
'schema' => [
'description' => '要查询的主机对应的ECS实例ID或专属集群主机ID。不支持模糊查询,只支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'i-bp19ienyt0yax748****',
],
],
[
'name' => 'SourceInstanceState',
'in' => 'query',
'schema' => [
'description' => '要查询的主机状态。取值:'."\n"
.' - **Normal**:正常'."\n"
.'- **Release**:已释放',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '要查询的主机所在主机组的ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取主机组ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Hosts' => [
'description' => '查询到的主机列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '主机的备注信息。',
'type' => 'string',
'example' => 'host',
],
'ActiveAddressType' => [
'description' => '主机地址类型。取值:'."\n"
.'- **Public** :公网地址'."\n"
.'- **Private** :私网地址',
'type' => 'string',
'example' => 'Public',
],
'HostPublicAddress' => [
'description' => '主机的公网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '1.1.XX.XX',
],
'HostName' => [
'description' => '主机名称。',
'type' => 'string',
'example' => 'name',
],
'HostAccountCount' => [
'description' => '主机账号数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Source' => [
'description' => '主机的来源。取值:'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例'."\n"
.'- **Rds**:RDS专属集群主机',
'type' => 'string',
'example' => 'Local',
],
'HostPrivateAddress' => [
'description' => '主机的私网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'OSType' => [
'description' => '主机的操作系统。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'example' => 'Linux',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'SourceInstanceState' => [
'description' => '主机状态。取值:'."\n"
.' - **Normal** :正常'."\n"
.'- **Release**: 已释放',
'type' => 'string',
'example' => 'Normal',
],
'SourceInstanceId' => [
'description' => '主机对应的ECS实例ID或专属集群主机ID。'."\n"
.'> **Source**为**Local**时,该参数返回值为空。',
'type' => 'string',
'example' => 'i-bp19ienyt0yax748****',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Hosts\\": [\\n {\\n \\"Comment\\": \\"host\\",\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"HostPublicAddress\\": \\"1.1.XX.XX\\",\\n \\"HostName\\": \\"name\\",\\n \\"HostAccountCount\\": 1,\\n \\"Source\\": \\"Local\\",\\n \\"HostPrivateAddress\\": \\"192.168.XX.XX\\",\\n \\"OSType\\": \\"Linux\\",\\n \\"HostId\\": \\"1\\",\\n \\"SourceInstanceState\\": \\"Normal\\",\\n \\"SourceInstanceId\\": \\"i-bp19ienyt0yax748****\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n host\\n Public\\n 1.1.XX.XX\\n name\\n 1\\n Local\\n 192.168.XX.XX\\n Linux\\n 1\\n Normal\\n i-bp19ienyt0yax748****\\n \\n","errorExample":""}]',
'title' => '查询指定堡垒机实例下的主机列表',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteHost' => [
'summary' => '删除单个主机。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的主机所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的主机所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'HostNotFound',
'errorMessage' => 'The host is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '删除单个主机',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyHostsPort' => [
'summary' => '堡垒机对于服务器的RDP和SSH协议使用的是默认端口(RDP协议默认使用3389端口,SSH协议默认使用22端口),如果您在主机中自定义了端口,可通过本接口进行修改。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要修改协议端口的主机所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要修改端口的主机所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostIds',
'in' => 'query',
'schema' => [
'description' => '要修改运维协议和端口的主机ID。该参数为JSON格式的字符串,最多可输入100个主机ID。多个主机ID之间使用半角逗号(,)隔开。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '["1","2","3"]',
],
],
[
'name' => 'ProtocolName',
'in' => 'query',
'schema' => [
'description' => '要修改端口的协议名称。取值:'."\n"
.'- **SSH**'."\n"
.'- **RDP**',
'type' => 'string',
'required' => true,
'example' => 'SSH',
],
],
[
'name' => 'Port',
'in' => 'query',
'schema' => [
'description' => '修改后的端口号。端口号为整数,取值范围:22~65535。',
'type' => 'string',
'required' => true,
'example' => '22',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口调用的结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n"
."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\nEC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n\\n 无\\n 1\\n OK\\n\\n","errorExample":""}]',
'title' => '批量修改主机指定协议的端口',
'description' => '### 使用说明'."\n"
.'本接口用于批量修改主机运维协议的端口。如果您认为使用运维协议的标准端口不安全(如SSH运维协议的标准端口为22),容易被攻击者发现并入侵,您可以使用本接口自定义运维协议的端口。'."\n"
."\n"
.'> 0~1024为堡垒机保留端口,自定义端口时请不要修改为保留端口。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyHostsActiveAddressType' => [
'summary' => '堡垒机支持公网运维和私网运维,您可以通过本接口修改运维主机时使用的连接地址类型。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要修改连接地址类型的主机所在堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw***',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要修改连接地址类型的主机所在堡垒机的区域ID。'."\n"
."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostIds',
'in' => 'query',
'schema' => [
'description' => '要修改连接地址类型的主机ID。该参数为JSON格式的字符串,最多可输入100个主机ID。'."\n"
.'您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '["1","2"]',
],
],
[
'name' => 'ActiveAddressType',
'in' => 'query',
'schema' => [
'description' => '修改后的主机连接地址的类型。取值:'."\n"
."\n"
.'- **Public**:公网'."\n"
.'- **Private**:私网'."\n",
'type' => 'string',
'required' => true,
'example' => 'Private',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。'."\n"
."\n",
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。',
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n \\n","errorExample":""}]',
'title' => '修改运维主机时使用的连接地址类型',
],
'ModifyHost' => [
'summary' => '支持修改主机的地址、名称、操作系统类型和备注信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的主机所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的主机所在堡垒机的区域ID。'."\n"
.'> Region ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostPrivateAddress',
'in' => 'query',
'schema' => [
'description' => '指定修改后主机的私网地址,可使用域名或IP地址。',
'type' => 'string',
'required' => false,
'example' => '193.168.XX.XX',
],
],
[
'name' => 'HostPublicAddress',
'in' => 'query',
'schema' => [
'description' => '指定修改后主机的公网地址,可使用域名或IP地址。',
'type' => 'string',
'required' => false,
'example' => '200.1.XX.XX',
],
],
[
'name' => 'OSType',
'in' => 'query',
'schema' => [
'description' => '指定修改后主机的操作系统类型。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'required' => false,
'example' => 'Linux',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '指定修改后主机的名称,最多支持128字符。',
'type' => 'string',
'required' => false,
'example' => 'TestHost',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定修改后主机的备注信息,最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'Host for test.',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定修改后主机所属的网络域ID。'."\n"
.'> 您可以调用[ListNetworkDomains ](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PrefKex',
'in' => 'query',
'schema' => [
'description' => '主机首选密钥交换算法配置。当OSType取值为Linux时,可以修改本参数。取值: '."\n"
."\n"
.'- **default**:默认模式'."\n"
.'- **diffie-hellman-group1-sha1**:diffie-hellman-group1-sha1算法兼容模式'."\n"
.'- **diffie-hellman-group14-sha1**:diffie-hellman-group14-sha1算法兼容模式'."\n"
.'- **diffie-hellman-group-exchange-sha1**:diffie-hellman-group-exchange-sha1算法兼容模式',
'type' => 'string',
'required' => false,
'example' => 'default',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'HostNotFound',
'errorMessage' => 'The host is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '修改主机基本信息',
'description' => '该接口支持修改本地主机、ECS主机、RDS专属集群主机的基本信息。'."\n"
.'> 如果您修改了ECS主机或RDS专属集群主机的基本信息,由于堡垒机系统会定期同步ECS主机、RDS专属集群主机的基本信息,修改结果可能会被ECS主机或RDS专属集群主机所同步的基本信息覆盖。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateDatabase' => [
'summary' => '您可以通过本接口,将MySQL、SQL Server、PostgreSQL类型的RDS和MySQL、PostgreSQL、PostgreSQL(兼容Oracle)的PolarDB以及MySQL、SQL Server、PostgreSQL、Oracle类型的自建数据库资产导入至堡垒机。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-7mz2g5hu20e',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定新创建数据库所属的网络域ID。'."\n"
.'> 您可以调用[ListNetworkDomains ](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'DatabaseType',
'in' => 'query',
'schema' => [
'description' => '数据库类型,取值如下:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'required' => true,
'example' => 'MySQL',
],
],
[
'name' => 'ActiveAddressType',
'in' => 'query',
'schema' => [
'description' => '指定新创建数据库的地址类型。取值:'."\n"
."\n"
.'- Public:公网地址'."\n"
.'- Private:私网地址',
'type' => 'string',
'required' => true,
'example' => 'Public',
],
],
[
'name' => 'DatabasePrivateAddress',
'in' => 'query',
'schema' => [
'description' => '私网地址。支持IPv4地址和域名格式。'."\n"
.'>ActiveAddressType选择Private时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'DatabasePublicAddress',
'in' => 'query',
'schema' => [
'description' => '公网地址。支持IPv4地址和域名格式。'."\n"
.'>ActiveAddressType选择Public时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'www.example.com',
],
],
[
'name' => 'DatabasePort',
'in' => 'query',
'schema' => [
'description' => '数据库的访问端口。数据库来源为**Local**,该参数为必填项。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '5433',
],
],
[
'name' => 'DatabaseName',
'in' => 'query',
'schema' => [
'description' => '新创建的数据库实例名称。数据库来源为**Local**,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'Test01',
],
],
[
'name' => 'SourceInstanceId',
'in' => 'query',
'schema' => [
'description' => '指定新创建的数据库实例ID。 '."\n"
.'> **Source**选择**Rds**或**PolarDB**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'i-bp19ienyt0yax748****',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '指定新创建数据库的来源。取值:'."\n"
.'- Local:本地数据库实例'."\n"
.'- Rds:RDS类型数据库实例'."\n"
.'- PolarDB: PolarDB类型数据库实例',
'type' => 'string',
'required' => true,
'example' => 'Local',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定新创建的数据库的备注信息。最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'cpp',
],
],
[
'name' => 'SourceInstanceRegionId',
'in' => 'query',
'schema' => [
'description' => '指定新创建的数据库实例所属地域ID。'."\n"
.'>**Source**为**Rds**或**PolarDB**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'PolarDBEndpointType',
'in' => 'query',
'schema' => [
'description' => 'Source为PolarDB时必传,表示PolarDB的Endpoint类型,取值:'."\n"
.'- Cluster:集群地址'."\n"
.'- Primary:主地址',
'type' => 'string',
'required' => false,
'example' => 'Cluster',
],
],
[
'name' => 'InstanceMemberId',
'in' => 'query',
'schema' => [
'title' => '数据库实例所属成员ID',
'description' => '指定新创建的RDS、PolarDB数据库实例所属的主账号ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1605494xxxx',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '334',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '98EDD923-236C-5A88-88E7-4979A91B9325',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'LicenseOutOfLimit',
'errorMessage' => 'The maximum number of hosts exceeds the license limit.',
],
[
'errorCode' => 'DatabaseAlreadyExists',
'errorMessage' => 'The database already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseId\\": \\"334\\",\\n \\"RequestId\\": \\"98EDD923-236C-5A88-88E7-4979A91B9325\\"\\n}","type":"json"}]',
'title' => '在堡垒机中创建需要运维的数据库',
],
'ModifyDatabase' => [
'summary' => '修改数据库基本信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的数据库所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-72137xe5n01',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的数据库所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '要修改的数据库ID。',
'type' => 'string',
'required' => true,
'example' => '11',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定修改后数据库所属的网络域的ID。'."\n"
.'> 您可以调用[ListNetworkDomains ](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '2',
],
],
[
'name' => 'ActiveAddressType',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库地址类型。取值:'."\n"
.'- **Public** :公网地址'."\n"
.'- **Private** :私网地址',
'type' => 'string',
'required' => false,
'example' => 'Public',
],
],
[
'name' => 'DatabasePrivateAddress',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库的私网地址。支持IPv4地址和域名格式。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'DatabasePublicAddress',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库的公网地址。支持IPv4地址和域名格式。',
'type' => 'string',
'required' => false,
'example' => 'www.example.com',
],
],
[
'name' => 'DatabasePort',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库端口。',
'type' => 'string',
'required' => false,
'example' => '5433',
],
],
[
'name' => 'DatabaseName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库实例名称。',
'type' => 'string',
'required' => false,
'example' => 'pgsql',
],
],
[
'name' => 'SourceInstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的数据库实例ID。 '."\n"
.'> **Source**选择**Rds**或**PolarDB**时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => 'i-wz99nexqd62z3bvuvpz5',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '修改后的数据库备注信息。',
'type' => 'string',
'required' => false,
'example' => 'tttttttt',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '162088A7-7D47-56A3-9D04-93DE7B6DBE1C',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'DatabaseAlreadyExists',
'errorMessage' => 'The database already exists.',
],
],
404 => [
[
'errorCode' => 'DatabaseNotFound',
'errorMessage' => 'The database is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"162088A7-7D47-56A3-9D04-93DE7B6DBE1C\\"\\n}","type":"json"}]',
'title' => '修改数据库基本信息',
],
'GetDatabase' => [
'summary' => '获取指定数据库的详细信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-wwo36qbv601',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '需要查询的数据库ID。'."\n"
.'> 您可以调用[ListDatabases ](~~2758822~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '21',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Database' => [
'description' => '查询到的数据库实例详细信息。',
'type' => 'object',
'properties' => [
'ActiveAddressType' => [
'description' => '数据库实例地址类型。取值:'."\n"
."\n"
.'- Public :公网地址'."\n"
.'- Private :私网地址',
'type' => 'string',
'example' => 'Public',
],
'Comment' => [
'description' => '数据库实例备注。',
'type' => 'string',
'example' => 'comment',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '22',
],
'DatabaseName' => [
'description' => '数据库实例名称。',
'type' => 'string',
'example' => 'test',
],
'DatabasePort' => [
'description' => '数据库的端口。',
'type' => 'integer',
'format' => 'int64',
'example' => '3306',
],
'DatabasePrivateAddress' => [
'description' => '数据库实例的私网地址。',
'type' => 'string',
'example' => 'rm-bp1zq******',
],
'DatabasePublicAddress' => [
'description' => '数据库实例的公网地址。',
'type' => 'string',
'example' => 'rm-uf65******',
],
'DatabaseType' => [
'description' => '数据库类型。取值:'."\n"
.'- **mysql**'."\n"
.'- **sqlserver**'."\n"
.'- **postgresql**'."\n"
.'- **oracle**',
'type' => 'string',
'example' => 'MySQL',
],
'NetworkDomainId' => [
'description' => '数据库所属的网络域的ID。',
'type' => 'string',
'example' => '45',
],
'Source' => [
'description' => '指定新创建数据库实例的来源。取值:'."\n"
."\n"
.'- **Local**:本地数据库实例'."\n"
.'- **Rds**:RDS类型数据库实例'."\n"
.'- **PolarDB**: PolarDB类型数据库实例',
'type' => 'string',
'example' => 'Local',
],
'SourceInstanceId' => [
'description' => '数据库对应的RDS实例ID或PolarDB实例ID。'."\n"
.'> **Source**为**Local**时,该参数返回值为空。',
'type' => 'string',
'example' => 'i-wz9527ob0e0nftcsffke',
],
'SourceInstanceRegionId' => [
'description' => '数据库对应的RDS实例或PolarDB实例所在的区域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'SourceInstanceState' => [
'description' => '数据库实例状态。取值:'."\n"
.' - **Normal**:正常'."\n"
.'- **Release**:已释放',
'type' => 'string',
'example' => 'Normal',
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。'."\n",
'type' => 'string',
'example' => '4D72B883-9D15-5B05-B987-DFD10EB1FFB4',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'DatabaseNotFound',
'errorMessage' => 'The database is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Database\\": {\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseId\\": \\"22\\",\\n \\"DatabaseName\\": \\"test\\",\\n \\"DatabasePort\\": 3306,\\n \\"DatabasePrivateAddress\\": \\"rm-bp1zq******\\",\\n \\"DatabasePublicAddress\\": \\"rm-uf65******\\",\\n \\"DatabaseType\\": \\"MySQL\\",\\n \\"NetworkDomainId\\": \\"45\\",\\n \\"Source\\": \\"Local\\",\\n \\"SourceInstanceId\\": \\"i-wz9527ob0e0nftcsffke\\",\\n \\"SourceInstanceRegionId\\": \\"cn-hangzhou\\",\\n \\"SourceInstanceState\\": \\"Normal\\"\\n },\\n \\"RequestId\\": \\"4D72B883-9D15-5B05-B987-DFD10EB1FFB4\\"\\n}","type":"json"}]',
'title' => '获取指定数据库的详细信息',
],
'ListDatabases' => [
'summary' => '查询指定堡垒机实例下的数据库列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-7mz28f5tk0o',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的堡垒机所在的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseType',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库类型,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'required' => false,
'example' => 'MySQL',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库所属的网络域ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '指定要查询数据库的来源。取值:'."\n"
."\n"
.'- **Local**:本地数据库实例'."\n"
.'- **Rds**:RDS类型数据库实例'."\n"
.'- **PolarDB**: PolarDB类型数据库实例',
'type' => 'string',
'required' => false,
'example' => 'Local',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Databases' => [
'description' => '查询到的数据库列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ActiveAddressType' => [
'description' => '数据库地址类型。取值:'."\n"
.'- **Public** :公网地址'."\n"
.'- **Private** :私网地址',
'type' => 'string',
'example' => 'Public',
],
'Comment' => [
'description' => '数据库的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '9',
],
'DatabaseName' => [
'description' => '数据库实例名称。',
'type' => 'string',
'example' => 'MySQL0',
],
'DatabasePort' => [
'description' => '数据库的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '3306',
],
'DatabasePrivateAddress' => [
'description' => '数据库的私网地址,可为域名或ip地址。',
'type' => 'string',
'example' => 'rm-wz973w7******',
],
'DatabasePublicAddress' => [
'description' => '数据库的公网地址,可为域名或ip地址。',
'type' => 'string',
'example' => 'rm-uf65n2******',
],
'DatabaseType' => [
'description' => '数据库类型,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'example' => 'MySQL',
],
'NetworkDomainId' => [
'description' => '数据库所属的网络域的ID。',
'type' => 'string',
'example' => '8',
],
'Source' => [
'description' => '数据库的来源。取值:'."\n"
."\n"
.'- **Local**:本地数据库实例'."\n"
.'- **Rds**:RDS类型数据库实例'."\n"
.'- **PolarDB**: PolarDB类型数据库实例',
'type' => 'string',
'example' => 'Local',
],
'SourceInstanceId' => [
'description' => '数据库对应的RDS实例ID或PolarDB实例ID。'."\n"
.'> **Source**为**Local**时,该参数返回值为空。',
'type' => 'string',
'example' => 'i-wz9ejupczf41******',
],
'SourceInstanceRegionId' => [
'description' => '数据库对应的RDS实例或PolarDB实例所在地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'SourceInstanceState' => [
'description' => '数据库实例状态。取值:'."\n"
.' - **Normal** :正常'."\n"
.'- **Release**: 已释放',
'type' => 'string',
'example' => 'Normal',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的数据库总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '4',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Databases\\": [\\n {\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseId\\": \\"9\\",\\n \\"DatabaseName\\": \\"MySQL0\\",\\n \\"DatabasePort\\": 3306,\\n \\"DatabasePrivateAddress\\": \\"rm-wz973w7******\\",\\n \\"DatabasePublicAddress\\": \\"rm-uf65n2******\\",\\n \\"DatabaseType\\": \\"MySQL\\",\\n \\"NetworkDomainId\\": \\"8\\",\\n \\"Source\\": \\"Local\\",\\n \\"SourceInstanceId\\": \\"i-wz9ejupczf41******\\",\\n \\"SourceInstanceRegionId\\": \\"cn-hangzhou\\",\\n \\"SourceInstanceState\\": \\"Normal\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 4\\n}","type":"json"}]',
'title' => '查询指定堡垒机实例下的数据库列表',
],
'DeleteDatabase' => [
'summary' => '删除单个数据库实例。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的数据库实例所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1ghxxxxx',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的数据库实例ID。'."\n"
.'> 您可以调用[ListDatabases ](~~2758822~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '11',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '81500666-d7f5-4143-8329-0223cc738105',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'DatabaseNotFound',
'errorMessage' => 'The database is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"81500666-d7f5-4143-8329-0223cc738105\\"\\n}","type":"json"}]',
'title' => '删除单个数据库实例',
],
'CreateNetworkDomain' => [
'summary' => '如果您想统一运维分布在不同网络环境中或与堡垒机所在专有网络(VPC)网络不互通的资产,推荐使用堡垒机的网络域功能。您可以为这些资产配置一台代理服务器,然后在堡垒机中创建网络域并添加代理服务器,将资产加入该网络域后即可通过堡垒机运维资产。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要创建网络域的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-lbj3bw4ma02',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要创建网络域的堡垒机的地域ID。'."\n"
.'> 区域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainName',
'in' => 'query',
'schema' => [
'description' => '指定要创建的网络域名称,最大128字符。',
'type' => 'string',
'required' => true,
'example' => 'SSH Proxy',
],
],
[
'name' => 'NetworkDomainType',
'in' => 'query',
'schema' => [
'description' => '指定要创建的网络域类型。取值:'."\n"
.'- Direct:直连,表示堡垒机直接和资产网络连通,不经过中间代理服务器。'."\n"
.'- Proxy:代理,资产所在网络与堡垒机网络不通的情况下,可以通过代理服务器转发网络请求,实现对不同网络环境下的资产进行运维。',
'type' => 'string',
'required' => true,
'example' => 'Proxy',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '网络域的备注。最多500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
[
'name' => 'Proxies',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '代理服务器信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'User' => [
'description' => '代理服务器主机账户。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
'Address' => [
'description' => '代理服务器地址。',
'type' => 'string',
'required' => false,
'example' => '47.104.**.**',
],
'ProxyType' => [
'description' => '代理方式。取值:'."\n"
.'- SSHProxy:SSH代理'."\n"
.'- HTTPProxy:HTTP代理'."\n"
.'- Socks5Proxy:Socks代理',
'type' => 'string',
'required' => false,
'example' => 'SSHProxy',
],
'NodeType' => [
'description' => '代理服务器节点。取值:'."\n"
."\n"
.'- Master:主代理服务器'."\n"
.'- Slave:备代理服务器',
'type' => 'string',
'required' => false,
'example' => 'Master',
],
'Password' => [
'description' => 'Base64处理后的代理服务器账户的密码。',
'type' => 'string',
'required' => false,
'example' => 'UWdi******Ng==',
],
'Port' => [
'description' => '代理服务器端口。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '22',
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NetworkDomainId' => [
'description' => '网络域ID。',
'type' => 'string',
'example' => '31',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'A2873E9C-A7EA-5735-845C-65D3792623D2',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'NetworkDomainAlreadyExists',
'errorMessage' => 'The network domain already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NetworkDomainId\\": \\"31\\",\\n \\"RequestId\\": \\"A2873E9C-A7EA-5735-845C-65D3792623D2\\"\\n}","type":"json"}]',
'title' => '创建网络域',
],
'GetNetworkDomain' => [
'summary' => '获取指定网络域详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-i7m2btk6g48',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的网络域ID。'."\n"
.'> 您可以调用[ListNetworkDomains](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'CheckProxyState',
'in' => 'query',
'schema' => [
'type' => 'string',
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NetworkDomain' => [
'description' => '网络域的详细信息。',
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '网络域的备注。',
'type' => 'string',
'example' => 'comment',
],
'Default' => [
'description' => '是否为内置网络域。'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否',
'type' => 'boolean',
'example' => 'false',
],
'NetworkDomainId' => [
'description' => '网络域ID。',
'type' => 'string',
'example' => '2',
],
'NetworkDomainName' => [
'description' => '网络域名称。',
'type' => 'string',
'example' => 'SSH Proxy',
],
'NetworkDomainType' => [
'description' => '网络域类型。取值:'."\n"
.'- Direct:直连'."\n"
.'- Proxy:代理',
'type' => 'string',
'example' => 'Proxy',
],
'Proxies' => [
'description' => '代理服务器信息。',
'type' => 'array',
'items' => [
'description' => '代理服务器信息。',
'type' => 'object',
'properties' => [
'ProxyType' => [
'description' => '代理方式。取值:'."\n"
.'- SSHProxy:SSH代理'."\n"
.'- HTTPProxy:HTTP代理'."\n"
.'- Socks5Proxy:Socks代理',
'type' => 'string',
'example' => 'HTTPProxy',
],
'NodeType' => [
'description' => '代理服务器节点。取值:'."\n"
."\n"
.'- Master:主代理服务器'."\n"
.'- Slave:备代理服务器',
'type' => 'string',
'example' => 'Master',
],
'Address' => [
'description' => '代理服务器地址。',
'type' => 'string',
'example' => '47.102.**.**',
],
'Port' => [
'description' => '代理服务器端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '22',
],
'User' => [
'description' => '代理服务器账户名。',
'type' => 'string',
'example' => 'root',
],
'HasPassword' => [
'description' => '代理服务器是否设置密码。取值:'."\n"
.'- **true**:设置密码'."\n"
.'- **false**:未设置密码',
'type' => 'boolean',
'example' => 'true',
],
'ProxyState' => [
'description' => '代理服务器状态。'."\n"
.'- **Available**:可用'."\n"
.'- **Unavailable**:不可用',
'type' => 'string',
'example' => 'Unavailable',
],
'ProxyStateErrorCode' => [
'description' => '代理服务器状态错误码。'."\n"
."\n"
.'- CHECK_PWD_FAILED:密码错误,验密失败'."\n"
.'- CHECK_PWD_TIMEOUT:验密超时'."\n"
.'- CHECK_PWD_NETWORK_ERR:网络错误'."\n"
.'- UNEXPECTED:未知错误',
'type' => 'string',
'example' => 'CHECK_PWD_TIMEOUT',
],
],
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。'."\n",
'type' => 'string',
'example' => '05F59944-2E24-595C-B21A-8C9955E60FAF',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'NetworkDomainNotFound',
'errorMessage' => 'The network domain is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NetworkDomain\\": {\\n \\"Comment\\": \\"comment\\",\\n \\"Default\\": false,\\n \\"NetworkDomainId\\": \\"2\\",\\n \\"NetworkDomainName\\": \\"SSH Proxy\\",\\n \\"NetworkDomainType\\": \\"Proxy\\",\\n \\"Proxies\\": [\\n {\\n \\"ProxyType\\": \\"HTTPProxy\\",\\n \\"NodeType\\": \\"Master\\",\\n \\"Address\\": \\"47.102.**.**\\",\\n \\"Port\\": 22,\\n \\"User\\": \\"root\\",\\n \\"HasPassword\\": true,\\n \\"ProxyState\\": \\"Unavailable\\",\\n \\"ProxyStateErrorCode\\": \\"CHECK_PWD_TIMEOUT\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"05F59944-2E24-595C-B21A-8C9955E60FAF\\"\\n}","type":"json"}]',
'title' => '获取指定网络域详情',
],
'ListNetworkDomains' => [
'summary' => '获取指定堡垒机下的网络域列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-tl329pvu70x',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'NetworkDomainName',
'in' => 'query',
'schema' => [
'description' => '网络域名称。',
'type' => 'string',
'required' => false,
'example' => 'SSH Proxy',
],
],
[
'name' => 'NetworkDomainType',
'in' => 'query',
'schema' => [
'description' => '网络域类型。取值:'."\n"
."\n"
.'- **Direct**:直连'."\n"
.'- **Proxy**:代理',
'type' => 'string',
'required' => false,
'example' => 'Proxy',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NetworkDomains' => [
'description' => '查询到的网络域列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '网络域的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'Default' => [
'description' => '是否为内置网络域。'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否',
'type' => 'boolean',
'example' => 'true',
],
'NetworkDomainId' => [
'description' => '网络域的ID。',
'type' => 'string',
'example' => '2',
],
'NetworkDomainName' => [
'description' => '网络域名称。',
'type' => 'string',
'example' => 'test',
],
'NetworkDomainType' => [
'description' => '网络域类型。取值:'."\n"
."\n"
.'- **Direct**:直连'."\n"
.'- **Proxy**:代理',
'type' => 'string',
'example' => 'Proxy',
],
'ProxiesState' => [
'description' => '代理服务器信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'NodeType' => [
'description' => '代理服务器节点。取值:'."\n"
."\n"
.'- **Master**:主代理服务器'."\n"
.'- **Slave**:备代理服务器',
'type' => 'string',
'example' => 'Master',
],
'ProxyState' => [
'description' => '代理服务器状态。'."\n"
."\n"
.'- **Available**:可用'."\n"
.'- **Unavailable**:不可用',
'type' => 'string',
'example' => 'Available',
],
],
],
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的网络域总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '5',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NetworkDomains\\": [\\n {\\n \\"Comment\\": \\"comment\\",\\n \\"Default\\": true,\\n \\"NetworkDomainId\\": \\"2\\",\\n \\"NetworkDomainName\\": \\"test\\",\\n \\"NetworkDomainType\\": \\"Proxy\\",\\n \\"ProxiesState\\": [\\n {\\n \\"NodeType\\": \\"Master\\",\\n \\"ProxyState\\": \\"Available\\"\\n }\\n ]\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 5\\n}","type":"json"}]',
'title' => '获取指定堡垒机下网络域列表',
],
'DeleteNetworkDomain' => [
'summary' => '删除单个网络域。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的网络域所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost_std_intl-sg-uq833e2dz02',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的网络域所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '要删除的网络域ID。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '66B9D942-E3C8-5068-A479-5A7B7BF3DE35',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'NetworkDomainNotFound',
'errorMessage' => 'The network domain is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66B9D942-E3C8-5068-A479-5A7B7BF3DE35\\"\\n}","type":"json"}]',
'title' => '删除单个网络域',
],
'ModifyNetworkDomain' => [
'summary' => '修改网络域基本信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要修改的网络域所在堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-x0r3hyr3f09',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的网络域所在堡垒机的区域ID。'."\n"
.'> Region ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的网络域ID。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'NetworkDomainName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的网络域名称。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'NetworkDomainType',
'in' => 'query',
'schema' => [
'description' => '指定修改后的网络域类型。取值:'."\n"
."\n"
.'- **Direct**:直连'."\n"
.'- **Proxy**:代理',
'type' => 'string',
'required' => false,
'example' => 'Proxy',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '修改后的网络域备注信息。',
'type' => 'string',
'required' => false,
'example' => 'xxx',
],
],
[
'name' => 'Proxies',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '网络域中的代理服务器信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'User' => [
'description' => '修改后的代理服务器的账户名。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'NodeType' => [
'description' => '要修改的代理服务器节点。取值:'."\n"
."\n"
.'- **Master**:主代理服务器'."\n"
.'- **Slave**:备代理服务器',
'type' => 'string',
'required' => false,
'example' => 'Slave',
],
'ProxyType' => [
'description' => '修改后的代理方式。取值:'."\n"
."\n"
.'- **SSHProxy**:SSH代理'."\n"
.'- **HTTPProxy**:HTTP代理'."\n"
.'- **Socks5Proxy**:Socks代理',
'type' => 'string',
'required' => false,
'example' => 'HTTPProxy',
],
'Address' => [
'description' => '修改后的代理服务器地址。',
'type' => 'string',
'required' => false,
'example' => '114.21**.**',
],
'Password' => [
'description' => '修改后的代理服务器账户的密码。',
'type' => 'string',
'required' => false,
'example' => '***',
],
'Port' => [
'description' => '修改后的代理服务器端口。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '22',
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'ED49CD1E-3510-5E5C-9133-E2067B656501',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'NetworkDomainAlreadyExists',
'errorMessage' => 'The network domain already exists.',
],
],
404 => [
[
'errorCode' => 'NetworkDomainNotFound',
'errorMessage' => 'The network domain is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"ED49CD1E-3510-5E5C-9133-E2067B656501\\"\\n}","type":"json"}]',
'title' => '修改网络域基本信息',
],
'MoveHostsToNetworkDomain' => [
'summary' => '批量将主机移入指定网络域。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-uax2zmx8005',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定要移入的网络域ID。'."\n"
.'> 您可以调用[ListNetworkDomains](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'HostIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '指定要移入网络域的主机ID。',
'type' => 'array',
'items' => [
'description' => '主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1,2',
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'F9B9E190-9C8E-5FEE-B963-7E9F1FD7FB4E',
],
'Results' => [
'description' => '接口的调用结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。'."\n"
."\n"
.'> LICENSE_OUT_OF_LIMIT 表示当前版本许可没有开启网络域功能。',
'type' => 'string',
'example' => 'OK',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F9B9E190-9C8E-5FEE-B963-7E9F1FD7FB4E\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"HostId\\": \\"1\\",\\n \\"Message\\": \\"None\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '批量将主机移入指定网络域',
],
'MoveDatabasesToNetworkDomain' => [
'summary' => '批量将数据库移入指定网络域。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostKFH6IG',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zpr3h2zo60l',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定要移入的网络域ID。'."\n"
.'> 您可以调用[ListNetworkDomains](~~2758827~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'DatabaseIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '指定要移入网络域的数据库实例ID。',
'type' => 'array',
'items' => [
'description' => '数据库实例ID。'."\n"
.'> 您可以调用[ListDatabases ](~~2758822~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1,2',
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'E5B1BC32-72B2-5BFD-BF75-5D38261264D1',
],
'Results' => [
'description' => '接口调用的结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。'."\n"
."\n"
.'> LICENSE_OUT_OF_LIMIT 表示当前版本许可没有开启网络域功能。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '45',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E5B1BC32-72B2-5BFD-BF75-5D38261264D1\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseId\\": \\"45\\",\\n \\"Message\\": \\"None\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '批量将数据库移入指定网络域',
],
'CreateHostAccount' => [
'summary' => '在堡垒机中新建主机后,您可以为其创建相应的主机账户,即将您主机已有的账户托管至堡垒机。创建主机账户后,运维人员即可使用该账户通过堡垒机登录主机进行运维。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要创建主机账户的主机所在堡垒机的实例ID。'."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。'."\n",
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要创建主机账户的主机所在堡垒机的地域ID。'."\n"
."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要创建主机账户的主机ID。'."\n"
."\n"
.'> 可通过调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'ProtocolName',
'in' => 'query',
'schema' => [
'description' => '指定新建主机账户的协议名称。'."\n"
.'
取值:'."\n"
.'- SSH'."\n"
.'- RDP',
'type' => 'string',
'required' => true,
'example' => 'SSH',
],
],
[
'name' => 'HostAccountName',
'in' => 'query',
'schema' => [
'description' => '指定新建主机账户的名称,最长支持128字符。',
'type' => 'string',
'required' => true,
'example' => 'accountname',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '指定新建主机账户的密码。',
'type' => 'string',
'required' => false,
'example' => '123456',
],
],
[
'name' => 'PrivateKey',
'in' => 'query',
'schema' => [
'description' => '指定新建主机账户的私钥,即使用Base64编码后的字符串。'."\n"
."\n"
.'> 主机账户协议ProtocolName为SSH时,该参数生效。ProtocolName为RDP时,无需配置该参数。支持同时为主机账户配置密码和私钥。在连接资产时,堡垒机会优先使用私钥进行连接。',
'type' => 'string',
'required' => false,
'example' => 'LS0tLS1******RCBSU0tLQ==',
],
],
[
'name' => 'PassPhrase',
'in' => 'query',
'schema' => [
'description' => '定新建主机账户的私钥口令。'."\n"
."\n"
.'> 主机账户协议ProtocolName为SSH时,您可以配置该参数。ProtocolName为RDP时,无需配置该参数。',
'type' => 'string',
'required' => false,
'example' => '123456',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PrivilegeType',
'in' => 'query',
'schema' => [
'description' => '账户权限类型,不填时默认为Normal'."\n"
.'- **Privileged**:特权账户'."\n"
.'- **Normal**:普通账户'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
[
'name' => 'RotationMode',
'in' => 'query',
'schema' => [
'description' => '账户改密模式,不填时默认为Self'."\n"
.'- **Privileged**:使用特权账户改密'."\n"
.'- **Self**:不使用特权账户改密'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'required' => false,
'example' => 'Self',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'HostAccountAlreadyExists',
'errorMessage' => 'The host account already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"HostAccountId\\": \\"1\\",\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '为指定主机创建主机账户',
],
'GetHostAccount' => [
'summary' => '获取指定主机账户详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户所在堡垒机的实例ID。'."\n"
.'>您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户所在堡垒机的区域ID。'."\n"
.'>区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostAccountId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户ID。'."\n"
.'> 您可以调用[ListHostAccounts](~~204372~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostAccount' => [
'description' => '查询到的主机账户详细信息。',
'type' => 'object',
'properties' => [
'HasPassword' => [
'description' => '主机账户是否设置密码。取值:'."\n"
."\n"
.'- **true**:已设置密码。'."\n"
.'- **false**:未设置密码。',
'type' => 'boolean',
'example' => 'true',
],
'PrivateKeyFingerprint' => [
'description' => '私钥的指纹信息。',
'type' => 'string',
'example' => 'fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**',
],
'ProtocolName' => [
'description' => '主机账户的协议名称。取值:'."\n"
."\n"
.'- **SSH**'."\n"
.'- **RDP**',
'type' => 'string',
'example' => 'SSH',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'abc',
],
'HostAccountId' => [
'description' => '主机账户ID。'."\n"
."\n",
'type' => 'string',
'example' => '1',
],
'HostId' => [
'description' => '主机账户所属主机的ID。'."\n"
."\n",
'type' => 'string',
'example' => '1',
],
'HostShareKeyId' => [
'description' => '主机共享密钥ID。',
'type' => 'string',
'example' => '1',
],
'RotationMode' => [
'description' => '账户改密模式。'."\n"
.'- **Privileged**:使用特权账户改密'."\n"
.'- **Self**:不使用特权账户改密'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'example' => 'Privileged',
],
'HostShareKeyName' => [
'description' => '主机共享密钥名称。',
'type' => 'string',
'example' => 'name',
],
'PrivilegeType' => [
'description' => '账户权限类型。'."\n"
.'- **Privileged**:特权账户'."\n"
.'- **Normal**:普通账户'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'example' => 'Normal',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostAccountNotFound',
'errorMessage' => 'The host account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostAccount\\": {\\n \\"HasPassword\\": true,\\n \\"PrivateKeyFingerprint\\": \\"fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**\\",\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"HostAccountName\\": \\"abc\\",\\n \\"HostAccountId\\": \\"1\\",\\n \\"HostId\\": \\"1\\",\\n \\"HostShareKeyId\\": \\"1\\",\\n \\"RotationMode\\": \\"Privileged\\",\\n \\"HostShareKeyName\\": \\"name\\",\\n \\"PrivilegeType\\": \\"Normal\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n abc\\n SSH\\n fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**\\n 1\\n true\\n 1\\n \\n","errorExample":""}]',
'title' => '获取指定主机账户详情',
],
'ListHostAccounts' => [
'summary' => '获取主机账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机所在堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机所在堡垒机的地域ID。'."\n"
."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要查询主机账户的主机ID。'."\n"
."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。'."\n"
.'
PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户名称。最多支持128字符,仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'abc',
],
],
[
'name' => 'ProtocolName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户的协议名称。'."\n"
.'
取值:'."\n"
.'- SSH'."\n"
.'- RDP',
'type' => 'string',
'required' => false,
'example' => 'SSH',
],
],
[
'name' => 'HostIds',
'in' => 'query',
'schema' => [
'description' => '指定要查询主机账户的主机ID数组。'."\n"
.'> 当HostId参数有值且不为0时,将忽略本参数。仅当HostId参数取值为0时,本参数有效。',
'type' => 'string',
'required' => false,
'example' => '["2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机账户总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。'."\n"
."\n",
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostAccounts' => [
'description' => '查询到的主机账户列表。'."\n"
."\n",
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HasPassword' => [
'description' => '当前主机账户是否设置了密码。
取值:'."\n"
."\n"
.'- **true**:已设置密码。'."\n"
.'- **false**:未设置密码。',
'type' => 'boolean',
'example' => 'true',
],
'PrivateKeyFingerprint' => [
'description' => '主机账户的私钥指纹信息。',
'type' => 'string',
'example' => 'fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**',
],
'ProtocolName' => [
'description' => '主机账户的协议名称。'."\n"
.'
取值:'."\n"
."\n"
.'- SSH'."\n"
.'- RDP',
'type' => 'string',
'example' => 'SSH',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'abc',
],
'HostAccountId' => [
'description' => '主机账户ID。'."\n"
."\n",
'type' => 'string',
'example' => '1',
],
'HostId' => [
'description' => '主机ID。'."\n"
."\n",
'type' => 'string',
'example' => '1',
],
'HostShareKeyId' => [
'description' => '主机共享密钥ID。 ',
'type' => 'string',
'example' => '1',
],
'RotationMode' => [
'description' => '账户改密模式。'."\n"
.'- **Privileged**:使用特权账户改密'."\n"
.'- **Self**:不使用特权账户改密'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'example' => 'Privileged',
],
'HostShareKeyName' => [
'description' => '主机共享密钥名称。',
'type' => 'string',
'example' => 'name',
],
'PrivilegeType' => [
'description' => '账户权限类型。'."\n"
.'- **Privileged**:特权账户'."\n"
.'- **Normal**:普通账户'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'example' => 'Normal',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostAccounts\\": [\\n {\\n \\"HasPassword\\": true,\\n \\"PrivateKeyFingerprint\\": \\"fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**\\",\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"HostAccountName\\": \\"abc\\",\\n \\"HostAccountId\\": \\"1\\",\\n \\"HostId\\": \\"1\\",\\n \\"HostShareKeyId\\": \\"1\\",\\n \\"RotationMode\\": \\"Privileged\\",\\n \\"HostShareKeyName\\": \\"name\\",\\n \\"PrivilegeType\\": \\"Normal\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n true\\n fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**\\n SSH\\n abc\\n 1\\n 1\\n 1\\n name\\n \\n","errorExample":""}]',
'title' => '获取主机账户列表',
],
'ModifyHostAccount' => [
'summary' => '修改主机账户信息,支持修改主机账户的名称、密码和私钥信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的主机账户所在堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户所在堡垒机的区域ID。'."\n"
."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostAccountId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的主机账户ID。'."\n"
."\n"
.'> 您可以调用[ListHostAccounts](~~204372~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostAccountName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的主机账户名称,最多支持128字符。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'abc',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '指定修改后的主机账户密码。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '123456',
],
],
[
'name' => 'PrivateKey',
'in' => 'query',
'schema' => [
'description' => '指定修改后的主机账户私钥,私钥为使用Base64编码后的字符串。'."\n"
."\n"
.'> 主机账户协议为SSH时,该参数生效。主机账户协议为RDP时,无需配置该参数。您可以调用[GetHostAccount](~~204391~~)接口查询主机账户使用的协议。支持同时为主机账户配置密码和私钥。在连接资产时,堡垒机会优先使用私钥进行连接。',
'type' => 'string',
'required' => false,
'example' => '-----BEGIN RSA PRIVATE KEY-----'."\n"
.'......'."\n"
.'-----END RSA PRIVATE KEY-----'."\n",
],
],
[
'name' => 'PassPhrase',
'in' => 'query',
'schema' => [
'description' => '指定修改后的主机账户的私钥口令。'."\n"
."\n"
.'> 主机账户协议为SSH时,该参数生效。主机账户协议为RDP时,无需配置该参数。',
'type' => 'string',
'required' => false,
'example' => '123456',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥ID。'."\n"
.'> 此ID可通过调用[ListHostShareKeys](~~462973~~)接口获取。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PrivilegeType',
'in' => 'query',
'schema' => [
'description' => '账户权限类型,取值:'."\n"
.'- **Privileged**:特权账户'."\n"
.'- **Normal**:普通账户'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
[
'name' => 'RotationMode',
'in' => 'query',
'schema' => [
'description' => '账户改密模式,取值:'."\n"
.'- **Privileged**:使用特权账户改密'."\n"
.'- **Self**:不使用特权账户改密'."\n"
.'>仅支持V3.2.47及以上的版本使用。',
'type' => 'string',
'required' => false,
'example' => 'Self',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。'."\n"
."\n",
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostAccountNotFound',
'errorMessage' => 'The host account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '修改主机账户信息',
],
'DeleteHostAccount' => [
'summary' => '删除单个主机账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要删除的主机账户所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要查询的主机账户所在堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostAccountId',
'in' => 'query',
'schema' => [
'description' => '要删除的主机账户的ID。'."\n"
.'> 您可以调用[ListHostAccounts](~~204372~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostAccountNotFound',
'errorMessage' => 'The host account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '删除单个主机账户',
'description' => '### 使用说明'."\n"
.'本接口用于删除单个主机账户。如果某个主机的账号不再使用,您可以调用本接口删除已在堡垒机上配置的该主机的主机账户。'."\n"
."\n"
.'> 删除主机账户后,通过堡垒机登录该主机时需要自行输入该主机的主机账户和密码。'."\n"
."\n\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ResetHostAccountCredential' => [
'summary' => '清除指定主机账户登录凭据(密码或SSH私钥)。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要清除登录凭据的主机账户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-rp640dg****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要清除登录凭据的主机账户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostAccountId',
'in' => 'query',
'schema' => [
'description' => '指定要清除登录凭据的主机账户ID。'."\n"
.'> 您可以调用[ListHostAccounts](~~204372~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'CredentialType',
'in' => 'query',
'schema' => [
'description' => '指定要清除的登录凭据类型。取值:'."\n"
.'- **Password**:密码'."\n"
.'- **PrivateKey**:SSH私钥',
'type' => 'string',
'required' => true,
'example' => 'Password',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostAccountNotFound',
'errorMessage' => 'The host account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\r\\n","errorExample":""}]',
'title' => '清除指定主机账户登录凭据',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateDatabaseAccount' => [
'summary' => '数据库创建成功后,您可以为其新建数据库账户。创建成功后,运维员可以使用该账号登录并运维数据库。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要新建数据库账户的堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-5yd34ol020a',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要新建数据库账户的堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '指定要创建账户的数据库实例ID。'."\n"
.'> 您可以调用[ListDatabaseAccounts](~~2758839~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'DatabaseAccountName',
'in' => 'query',
'schema' => [
'description' => '指定新创建数据库账户的名称。最多支持128字符。',
'type' => 'string',
'required' => true,
'example' => 'root',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '指定新建数据库账户的密码。',
'type' => 'string',
'required' => false,
'example' => 'MCQ******',
],
],
[
'name' => 'DatabaseSchema',
'in' => 'query',
'schema' => [
'description' => '数据库名。当DatabaseId对应的Database为Postgres和Oracle时,DatabaseSchema为必填。',
'type' => 'string',
'required' => false,
'example' => 'orcl',
],
],
[
'name' => 'LoginAttribute',
'in' => 'query',
'schema' => [
'description' => '登录属性,Oracle类型数据库必须指定,取值:'."\n"
.'- SERVICENAME'."\n"
.'- SID',
'type' => 'string',
'required' => false,
'example' => 'SID',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '40',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'B07C465D-B09F-54DD-8FEC-90788BEABAFC',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'DatabaseAccountAlreadyExists',
'errorMessage' => 'The database account already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseAccountId\\": \\"40\\",\\n \\"RequestId\\": \\"B07C465D-B09F-54DD-8FEC-90788BEABAFC\\"\\n}","type":"json"}]',
'title' => '为指定数据库实例创建数据库账户',
],
'ModifyDatabaseAccount' => [
'summary' => '修改数据库账户基本信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的数据库账户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zpr2zyqx603',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的数据库账户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DatabaseAccountId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的数据库账户ID。'."\n"
.'> 您可以调用[ListDatabaseAccounts](~~2758839~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库账户密码。',
'type' => 'string',
'required' => false,
'example' => '14SZ!******',
],
],
[
'name' => 'DatabaseAccountName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库账户名称,最多支持128字符。',
'type' => 'string',
'required' => false,
'example' => 'aaa',
],
],
[
'name' => 'DatabaseSchema',
'in' => 'query',
'schema' => [
'description' => '指定修改后的数据库名。当DatabaseId对应的Database为Postgres和Oracle时,DatabaseSchema为必填。',
'type' => 'string',
'required' => false,
'example' => 'orcl',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '850FA4B4-5BD2-5269-903E-3B7E07E6C975',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'DatabaseAccountAlreadyExists',
'errorMessage' => 'The database account already exists.',
],
],
404 => [
[
'errorCode' => 'DatabaseAccountNotFound',
'errorMessage' => 'The database account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"850FA4B4-5BD2-5269-903E-3B7E07E6C975\\"\\n}","type":"json"}]',
'title' => '修改数据库账户基本信息',
],
'GetDatabaseAccount' => [
'summary' => '获取指定数据库账户详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-i7m2d7zrw11',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-beijing',
],
],
[
'name' => 'DatabaseAccountId',
'in' => 'query',
'schema' => [
'description' => '要查询的数据库账户ID。'."\n"
.'> 您可以调用[ListDatabaseAccounts](~~2758839~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '9',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseAccount' => [
'description' => '查询到的数据库账号信息。',
'type' => 'object',
'properties' => [
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '9',
],
'DatabaseAccountName' => [
'description' => '数据库账户名称。',
'type' => 'string',
'example' => 'uac',
],
'DatabaseSchema' => [
'description' => '数据库名。当数据库为Postgres和Oracle时,DatabaseSchema有返回值。',
'type' => 'string',
'example' => 'orcl',
],
'HasPassword' => [
'description' => '当前数据库账户是否设置了密码。
取值:'."\n"
."\n"
.'- true:已设置密码。'."\n"
.'- false:未设置密码。',
'type' => 'boolean',
'example' => 'true',
],
'LoginAttribute' => [
'description' => '登录属性,Oracle类型数据库有返回值:'."\n"
.'- SERVICENAME'."\n"
.'- SID',
'type' => 'string',
'example' => 'SID',
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'FA06D274-8D0A-59FB-8B7E-584C0EEBBFFF',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'DatabaseAccountNotFound',
'errorMessage' => 'The database account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseAccount\\": {\\n \\"DatabaseAccountId\\": \\"9\\",\\n \\"DatabaseAccountName\\": \\"uac\\",\\n \\"DatabaseSchema\\": \\"orcl\\",\\n \\"HasPassword\\": true,\\n \\"LoginAttribute\\": \\"SID\\"\\n },\\n \\"RequestId\\": \\"FA06D274-8D0A-59FB-8B7E-584C0EEBBFFF\\"\\n}","type":"json"}]',
'title' => '获取指定数据库账户详情',
],
'ListDatabaseAccounts' => [
'summary' => '获取数据库账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-7mz2za0ro06',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '指定要查询数据库账户的数据库实例ID。'."\n"
.'> 您可以调用[ListDatabases](~~2758822~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '3',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库账户名称。最多支持128字符,仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseAccounts' => [
'description' => '查询到的数据库账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '59',
],
'DatabaseAccountName' => [
'description' => '数据库账户名。',
'type' => 'string',
'example' => 'test',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '4',
],
'DatabaseSchema' => [
'description' => '数据库名。当DatabaseId对应的Database为Postgres和Oracle时,DatabaseSchema有返回值。',
'type' => 'string',
'example' => 'orcl',
],
'HasPassword' => [
'description' => '数据库账户是否设置密码。取值:'."\n"
."\n"
.'- **true**:已设置密码。'."\n"
.'- **false**:未设置密码。',
'type' => 'string',
'example' => 'true',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '4F6C075F-FC86-476E-943B-097BD4E12948',
],
'TotalCount' => [
'description' => '查询到的数据库账户总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '10',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseAccounts\\": [\\n {\\n \\"DatabaseAccountId\\": \\"59\\",\\n \\"DatabaseAccountName\\": \\"test\\",\\n \\"DatabaseId\\": \\"4\\",\\n \\"DatabaseSchema\\": \\"orcl\\",\\n \\"HasPassword\\": \\"true\\"\\n }\\n ],\\n \\"RequestId\\": \\"4F6C075F-FC86-476E-943B-097BD4E12948\\",\\n \\"TotalCount\\": 10\\n}","type":"json"}]',
'title' => '获取数据库账户列表',
],
'ListDatabaseAccountsForUserGroup' => [
'summary' => '查询用户组已授权和未授权的数据库账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-pe334a03o0h',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权数据库账户列表的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '指定要查询数据库账户的数据库实例ID。'."\n"
.'> 您可以调用[ListDatabaseAccounts](~~2758839~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '36',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库账户名称。最多支持128字符,仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseAccounts' => [
'description' => '查询到的数据库账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '4',
],
'DatabaseAccountName' => [
'description' => '数据库账户名。',
'type' => 'string',
'example' => 'root',
],
'DatabaseId' => [
'description' => '数据库账号所属数据库实例ID。',
'type' => 'string',
'example' => '11',
],
'IsAuthorized' => [
'description' => '数据库账户是否授权给当前用户。取值:'."\n"
.'- **true**:已授权'."\n"
.'- **false**:未授权',
'type' => 'boolean',
'example' => 'true',
],
'ProtocolName' => [
'description' => '数据库账户的协议名称。取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'example' => 'MySQL',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的数据库账户总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '10',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseAccounts\\": [\\n {\\n \\"DatabaseAccountId\\": \\"4\\",\\n \\"DatabaseAccountName\\": \\"root\\",\\n \\"DatabaseId\\": \\"11\\",\\n \\"IsAuthorized\\": true,\\n \\"ProtocolName\\": \\"MySQL\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 10\\n}","type":"json"}]',
'title' => '查询用户组已授权和未授权的数据库账户列表',
],
'DeleteDatabaseAccount' => [
'summary' => '删除单个数据库账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的数据库账户所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的数据库账户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DatabaseAccountId',
'in' => 'query',
'schema' => [
'description' => '要删除的数据库账户ID。'."\n"
.'> 您可以调用[ListDatabaseAccounts](~~2758839~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '9',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '81500666-d7f5-4143-8329-0223cc738105',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'DatabaseAccountNotFound',
'errorMessage' => 'The database account is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"81500666-d7f5-4143-8329-0223cc738105\\"\\n}","type":"json"}]',
'title' => '删除单个数据库账户',
],
'CreateUser' => [
'summary' => '创建用户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要新建用户的堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的堡垒机的地域ID。'."\n"
.'>地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的来源。取值:'."\n"
."\n"
.'- **Local**:本地用户'."\n"
.'- **Ram**:RAM用户'."\n"
.'- **AD**:AD用户'."\n"
.'- **LDAP**:LDAP用户'."\n"
.'- **IDaaS-EIAM**:IDaaS用户',
'type' => 'string',
'required' => true,
'example' => 'Local',
],
],
[
'name' => 'UserName',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的登录名称。该参数只能由字母、数字、下划线(_)组成,最多支持128字符。',
'type' => 'string',
'required' => true,
'example' => 'abc_def',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的登录密码。 至少8位,至少包含大小写字母、数字、特殊符号,最多支持128字符。'."\n"
.'> 新创建用户来源为本地用户(即Source取值为Local)时,该参数为必填项。',
'type' => 'string',
'required' => false,
'example' => '213****',
],
],
[
'name' => 'DisplayName',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的显示姓名。最多支持128字符。'."\n"
.'> 未填写则默认采用登录名作为显示姓名。',
'type' => 'string',
'required' => false,
'example' => 'Bob',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的备注信息。最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
[
'name' => 'Email',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的邮箱。'."\n"
.'> - 当TwoFactorStatus为“Enable”,且TwoFactorMethods为“email”时,或当TwoFactorStatus为“Global”,且全局双因子配置中TwoFactorMethods为“email”时,该参数为必填。'."\n"
.'> - 您可以调用[GetInstanceTwoFactor](~~462968~~)接口获取全局双因子配置',
'type' => 'string',
'required' => false,
'example' => 'username@example.com',
],
],
[
'name' => 'Mobile',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的手机号码。'."\n"
.'> - 当TwoFactorStatus为“Enable”,且TwoFactorMethods为“sms”或“dingtalk”时,或当TwoFactorStatus为“Global”,且全局双因子配置中TwoFactorMethods为“sms”或“dingtalk”时,该参数为必填。'."\n"
.'> - 您可以调用[GetInstanceTwoFactor](~~462968~~)接口获取全局双因子配置',
'type' => 'string',
'required' => false,
'example' => '1359999****',
],
],
[
'name' => 'SourceUserId',
'in' => 'query',
'schema' => [
'description' => '要新建的用户的唯一标识。'."\n"
.'>- 该参数是堡垒机用户对应的RAM用户和IDaaS用户的唯一标识。新创建用户来源为RAM用户或IDaaS用户(即Source取值为Ram或IDaaS-EIAM)时,该参数为必填项。您可以调用访问控制的[ListUsers](~~28684~~)接口从返回数据UserId获取RAM用户该参数。可以调用EIAM云身份服务的[ListUsers](~~427814~~)接口从返回数据UserId获取IDaaS用户该参数'."\n"
.'> - 新创建用户来源为AD或LDAP时,该参数为必填项,取值为用户的DN。',
'type' => 'string',
'required' => false,
'example' => '122748924538****',
],
],
[
'name' => 'MobileCountryCode',
'in' => 'query',
'schema' => [
'description' => '要新建的用户手机号的国际域名。默认值为CN,取值:'."\n"
."\n"
.'- **CN**:中国内地(+86)'."\n"
.'- **HK**:中国香港(+852)'."\n"
.'- **MO**:中国澳门(+853)'."\n"
.'- **TW**:中国台湾(+886)'."\n"
.'- **RU**:俄罗斯(+7)'."\n"
.'- **SG**:新加坡(+65)'."\n"
.'- **MY**:马来西亚(+60)'."\n"
.'- **ID**:印度尼西亚(+62)'."\n"
.'- **DE**:德国(+49)'."\n"
.'- **AU**:澳大利亚(+61)'."\n"
.'- **US**:美国(+1)'."\n"
.'- **AE**:迪拜(+971)'."\n"
.'- **JP**:日本(+81)'."\n"
.'- **GB**:英国(+44)'."\n"
.'- **IN**:印度(+91)'."\n"
.'- **KR**:韩国(+82)'."\n"
.'- **PH**:菲律宾(+63)'."\n"
.'- **CH**:瑞士(+41)'."\n"
.'- **SE**:瑞典(+46)'."\n"
.'- **SA**:沙特(+966)',
'type' => 'string',
'required' => false,
'example' => 'CN',
],
],
[
'name' => 'EffectiveStartTime',
'in' => 'query',
'schema' => [
'title' => '开始生效时间戳,单位秒',
'description' => '用户有效期开始时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1669630029',
],
],
[
'name' => 'EffectiveEndTime',
'in' => 'query',
'schema' => [
'title' => '有效期结束时间戳。单位秒',
'description' => '用户有效期结束时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1672502400',
],
],
[
'name' => 'NeedResetPassword',
'in' => 'query',
'schema' => [
'title' => '下次登录是否需要重置密码',
'description' => '下次登录是否需要重置密码。取值:'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否'."\n"
."\n"
.'> 未填时默认为false。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'TwoFactorStatus',
'in' => 'query',
'schema' => [
'description' => '用户双因子状态,取值:'."\n"
."\n"
.'- **Global**:遵循全局设定'."\n"
.'- **Disable**:关闭双因子'."\n"
.'- **Enable**:开启双因子,遵循单个用户设定'."\n"
."\n"
.'> 未填时默认为Global。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
],
],
[
'name' => 'TwoFactorMethods',
'in' => 'query',
'schema' => [
'description' => '打开双因子认证方式的数组,目前最多支持一个,取值:'."\n"
."\n"
.'- **sms**:短信'."\n"
.'- **email**:邮件'."\n"
.'- **dingtalk**:钉钉'."\n"
.'- **totp**:OTP令牌'."\n"
.'- **gmusbkey**:国密USBKEY'."\n"
.'>当TwoFactorStatus为“Enable”时,至少指定一种。',
'type' => 'string',
'required' => false,
'example' => '["sms"]',
],
],
[
'name' => 'LanguageStatus',
'in' => 'query',
'schema' => [
'description' => '消息通知语言设置。'."\n"
.'- **Global**:遵循全局'."\n"
.'- **Custom**:自定义'."\n"
."\n"
.'> 未填时默认为Global。',
'type' => 'string',
'required' => false,
'example' => 'Custom',
],
],
[
'name' => 'Language',
'in' => 'query',
'schema' => [
'description' => '当LanguageStatus为Custom 时,Language为必填。'."\n"
.'取值:'."\n"
.'- **zh-cn**:简体中文'."\n"
.'- **en**:英文',
'type' => 'string',
'required' => false,
'example' => 'en',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'UserId' => [
'description' => '新建的用户的ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'UserAlreadyExists',
'errorMessage' => 'The user already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"UserId\\": \\"1\\",\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n 1\\n","errorExample":""}]',
'title' => '创建用户',
'description' => '本接口用于创建堡垒机的用户,支持添加本地用户、RAM用户、AD用户和LDAP用户。堡垒机管理员为运维员创建登录堡垒机的账户(即新建用户)后,运维员才能使用该账户登录堡垒机运维已授权的主机。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
],
'GetUser' => [
'summary' => '获取指定堡垒机用户的详细信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'User' => [
'description' => '查询到的用户详细信息。',
'type' => 'object',
'properties' => [
'DisplayName' => [
'description' => '用户的显示姓名。',
'type' => 'string',
'example' => 'Bob',
],
'Comment' => [
'description' => '用户备注信息。',
'type' => 'string',
'example' => 'commet',
],
'Email' => [
'description' => '用户的邮箱地址。',
'type' => 'string',
'example' => '1099**@qq.com',
],
'Mobile' => [
'description' => '用户的手机号码。',
'type' => 'string',
'example' => '1359999****',
],
'MobileCountryCode' => [
'description' => '用户手机号码的国际域名。取值:'."\n"
.'- **CN**:中国内地(+86)'."\n"
.'- **HK**:中国香港(+852)'."\n"
.'- **MO**:中国澳门(+853)'."\n"
.'- **TW**:中国台湾(+886)'."\n"
.'- **RU**:俄罗斯(+7)'."\n"
.'- **SG**:新加坡(+65)'."\n"
.'- **MY**:马来西亚(+60)'."\n"
.'- **ID**:印度尼西亚(+62)'."\n"
.'- **DE**:德国(+49)'."\n"
.'- **AU**:澳大利亚(+61)'."\n"
.'- **US**:美国(+1)'."\n"
.'- **AE**:迪拜(+971)'."\n"
.'- **JP**:日本(+81)'."\n"
.'- **GB**:英国(+44)'."\n"
.'- **IN**:印度(+91)'."\n"
.'- **KR**:韩国(+82)'."\n"
.'- **PH**:菲律宾(+63)'."\n"
.'- **CH**:瑞士(+41)'."\n"
.'- **SE**:瑞典(+46)',
'type' => 'string',
'example' => 'CN',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
'Source' => [
'description' => '用户的来源。取值:'."\n"
.'- **Local**:本地用户'."\n"
.'- **Ram**:RAM用户',
'type' => 'string',
'example' => 'Local',
],
'UserName' => [
'description' => '用户的登录名称。',
'type' => 'string',
'example' => 'abcabc_def',
],
'SourceUserId' => [
'description' => '用户的唯一标识。'."\n"
.'> 该参数是堡垒机用户对应的RAM用户的唯一标识。用户来源为RAM用户(即**Source**取值为**Ram**)时,返回该参数。用户来源为本地用户(即**Source**取值为**Local**)时,该参数返回值为空。',
'type' => 'string',
'example' => '122748924538****',
],
'UserState' => [
'description' => '用户状态组。',
'type' => 'array',
'items' => [
'description' => '用户的状态。取值:'."\n"
.'- **Normal**:正常状态'."\n"
.'- **Frozen**:被锁定状态'."\n"
.'- **Expired**:已过期状态',
'type' => 'string',
'example' => '["Normal"]',
],
],
'EffectiveStartTime' => [
'description' => '用户有效期开始时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'example' => '1669630029',
],
'EffectiveEndTime' => [
'description' => '用户有效期结束时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'example' => '1672502400',
],
'NeedResetPassword' => [
'description' => '下次登录是否需要重置密码。取值:'."\n"
.'- **true**:是'."\n"
.'- **false**:否',
'type' => 'boolean',
'example' => 'true',
],
'TwoFactorMethods' => [
'description' => '打开的双因子认证方式的数组',
'type' => 'array',
'items' => [
'description' => '打开双因子认证方式的数组,目前最多支持一个,取值:'."\n"
."\n"
.'- **sms**:短信'."\n"
.'- **email**:邮件'."\n"
.'- **dingtalk**:钉钉'."\n"
.'- **totp OTP**:令牌',
'type' => 'string',
'example' => '['."\n"
.' "sms"'."\n"
.']',
],
],
'TwoFactorStatus' => [
'description' => '用户双因子状态,取值:'."\n"
."\n"
.'- **Global**:遵循全局设定'."\n"
.'- **Disable**:关闭双因子'."\n"
.'- **Enable**:开启双因子,遵循单个用户设定',
'type' => 'string',
'example' => 'Enable',
],
'LanguageStatus' => [
'description' => '消息通知语言设置。'."\n"
."\n"
.'- **Global**:遵循全局'."\n"
.'- **Custom**:自定义',
'type' => 'string',
'example' => 'Custom',
],
'Language' => [
'description' => '当LanguageStatus为Custom 时,Language为必填。 取值:'."\n"
."\n"
.'- **zh-cn**:简体中文'."\n"
.'- **en**:英文',
'type' => 'string',
'example' => 'en',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'UserNotFound',
'errorMessage' => 'The user is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"User\\": {\\n \\"DisplayName\\": \\"Bob\\",\\n \\"Comment\\": \\"commet\\",\\n \\"Email\\": \\"1099**@qq.com\\",\\n \\"Mobile\\": \\"1359999****\\",\\n \\"MobileCountryCode\\": \\"CN\\",\\n \\"UserId\\": \\"1\\",\\n \\"Source\\": \\"Local\\",\\n \\"UserName\\": \\"abcabc_def\\",\\n \\"SourceUserId\\": \\"122748924538****\\",\\n \\"UserState\\": [\\n \\"[\\\\\\"Normal\\\\\\"]\\"\\n ],\\n \\"EffectiveStartTime\\": 1669630029,\\n \\"EffectiveEndTime\\": 1672502400,\\n \\"NeedResetPassword\\": true,\\n \\"TwoFactorMethods\\": [\\n \\"[\\\\n \\\\\\"sms\\\\\\"\\\\n]\\"\\n ],\\n \\"TwoFactorStatus\\": \\"Enable\\",\\n \\"LanguageStatus\\": \\"Custom\\",\\n \\"Language\\": \\"en\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n \\n commet\\n 1099**@qq.com\\n abcabc_def\\n 1\\n 122748924538****\\n Bob\\n CN\\n 1359999****\\n Local\\n Normal\\n \\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '获取用户信息',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListUsers' => [
'summary' => '获取指定堡垒机的用户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询用户列表的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询用户列表的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'UserName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户登录名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'abc',
],
],
[
'name' => 'DisplayName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户显示姓名。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'testuser',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户的来源。取值:'."\n"
.'- **Local**:本地用户'."\n"
.'- **Ram**:RAM用户'."\n"
.'- **AD**:AD用户'."\n"
.'- **LDAP**:LDAP用户',
'type' => 'string',
'required' => false,
'example' => 'Local',
],
],
[
'name' => 'Mobile',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户的手机号码。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '1359999****',
],
],
[
'name' => 'UserState',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户状态。取值:'."\n"
.'- **Normal**:正常状态'."\n"
.'- **Frozen**:被锁定状态'."\n"
.'- **Expired**:已过期状态',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
[
'name' => 'SourceUserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户的唯一标识。仅支持精确查询。'."\n"
.'> 该参数是堡垒机用户对应的RAM用户的唯一标识。新创建用户来源为RAM用户(即**Source**取值为**Ram**)时,该参数生效。您可以调用访问控制的[ListUsers](~~28684~~)接口从返回数据**UserId**获取该参数。',
'type' => 'string',
'required' => false,
'example' => '122748924538****',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的用户总数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Users' => [
'description' => '查询到的用户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DisplayName' => [
'description' => '用户的显示姓名。',
'type' => 'string',
'example' => 'Bob',
],
'Email' => [
'description' => '用户的邮箱地址。',
'type' => 'string',
'example' => '1099**@qq.com',
],
'Comment' => [
'description' => '用户备注信息。',
'type' => 'string',
'example' => 'comment',
],
'MobileCountryCode' => [
'description' => '用户手机号码的国际域名。取值:'."\n"
.'- **CN**:中国内地(+86)'."\n"
.'- **HK**:中国香港(+852)'."\n"
.'- **MO**:中国澳门(+853)'."\n"
.'- **TW**:中国台湾(+886)'."\n"
.'- **RU**:俄罗斯(+7)'."\n"
.'- **SG**:新加坡(+65)'."\n"
.'- **MY**:马来西亚(+60)'."\n"
.'- **ID**:印度尼西亚(+62)'."\n"
.'- **DE**:德国(+49)'."\n"
.'- **AU**:澳大利亚(+61)'."\n"
.'- **US**:美国(+1)'."\n"
.'- **AE**:迪拜(+971)'."\n"
.'- **JP**:日本(+81)'."\n"
.'- **GB**:英国(+44)'."\n"
.'- **IN**:印度(+91)'."\n"
.'- **KR**:韩国(+82)'."\n"
.'- **PH**:菲律宾(+63)'."\n"
.'- **CH**:瑞士(+41)'."\n"
.'- **SE**:瑞典(+46)',
'type' => 'string',
'example' => 'CN',
],
'Mobile' => [
'description' => '用户的手机号码。',
'type' => 'string',
'example' => '1359999****',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
'Source' => [
'description' => '用户的来源。取值:'."\n"
.'- **Local**:本地用户'."\n"
.'- **Ram**:RAM用户'."\n"
.'- **AD**:AD用户'."\n"
.'- **LDAP**:LDAP用户',
'type' => 'string',
'example' => 'Local',
],
'UserName' => [
'description' => '用户的登录名称。',
'type' => 'string',
'example' => 'abc_def',
],
'SourceUserId' => [
'description' => '用户的唯一标识。'."\n"
.'> 该参数是堡垒机用户对应的RAM用户的唯一标识。用户来源为RAM用户(即**Source**取值为**Ram**)时,返回该参数。用户来源为本地用户(即**Source**取值为**Local**)时,该参数返回值为空。',
'type' => 'string',
'example' => '122748924538****',
],
'UserState' => [
'description' => '用户状态组。',
'type' => 'array',
'items' => [
'description' => '用户的状态。取值:'."\n"
.'- **Normal**:正常状态'."\n"
.'- **Frozen**:被锁定状态'."\n"
.'- **Expired**:已过期状态',
'type' => 'string',
'example' => '["Normal"]',
],
],
'EffectiveStartTime' => [
'title' => '',
'description' => '用户有效期开始时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'example' => '1669630029',
],
'EffectiveEndTime' => [
'description' => '用户有效期结束时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'example' => '1672502400',
],
'NeedResetPassword' => [
'description' => '下次登录是否需要重置密码。取值:'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否',
'type' => 'boolean',
'example' => 'true',
],
'TwoFactorStatus' => [
'description' => '用户双因子状态,取值:'."\n"
."\n"
.'- **Global**:遵循全局设定'."\n"
.'- **Disable**:关闭双因子'."\n"
.'- **Enable**:开启双因子,遵循单个用户设定',
'type' => 'string',
'example' => 'Enable',
],
'TwoFactorMethods' => [
'description' => '打开的双因子认证方式的数组',
'type' => 'array',
'items' => [
'description' => '打开双因子认证方式的数组,目前最多支持一个,取值:'."\n"
."\n"
.'- **sms**:短信'."\n"
.'- **email**:邮件'."\n"
.'- **dingtalk**:钉钉'."\n"
.'- **totp**:OTP令牌'."\n"
.'- **gmusbkey**:国密USBKEY',
'type' => 'string',
'example' => '['."\n"
.' "sms"'."\n"
.']',
],
],
'LanguageStatus' => [
'description' => '消息通知语言设置'."\n"
."\n"
.'- **Global**:遵循全局'."\n"
.'- **Custom**:自定义',
'type' => 'string',
'example' => 'Custom',
],
'Language' => [
'description' => '当LanguageStatus为Custom 时,Language为必填。 取值:'."\n"
."\n"
.'- **zh-cn**:简体中文'."\n"
.'- **en**:英文',
'type' => 'string',
'example' => 'en',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Users\\": [\\n {\\n \\"DisplayName\\": \\"Bob\\",\\n \\"Email\\": \\"1099**@qq.com\\",\\n \\"Comment\\": \\"comment\\",\\n \\"MobileCountryCode\\": \\"CN\\",\\n \\"Mobile\\": \\"1359999****\\",\\n \\"UserId\\": \\"1\\",\\n \\"Source\\": \\"Local\\",\\n \\"UserName\\": \\"abc_def\\",\\n \\"SourceUserId\\": \\"122748924538****\\",\\n \\"UserState\\": [\\n \\"[\\\\\\"Normal\\\\\\"]\\"\\n ],\\n \\"EffectiveStartTime\\": 1669630029,\\n \\"EffectiveEndTime\\": 1672502400,\\n \\"NeedResetPassword\\": true,\\n \\"TwoFactorStatus\\": \\"Enable\\",\\n \\"TwoFactorMethods\\": [\\n \\"[\\\\n \\\\\\"sms\\\\\\"\\\\n]\\"\\n ],\\n \\"LanguageStatus\\": \\"Custom\\",\\n \\"Language\\": \\"en\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n comment\\n abc_def\\n 1099**@qq.com\\n 1\\n 122748924538****\\n CN\\n Bob\\n 1359999****\\n Local\\n Normal\\n \\n","errorExample":""}]',
'title' => '获取用户详情列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyUser' => [
'summary' => '修改堡垒机用户信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户信息的堡垒机实例ID。'."\n"
.'>您可以调用[describeinstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户信息的堡垒机的地域ID。'."\n"
.'>地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户信息的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户密码。至少8位,至少包含大小写字母、数字、特殊符号,最多支持128字符。'."\n"
.'> 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => '321****',
],
],
[
'name' => 'DisplayName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户显示姓名。最多支持128字符。'."\n"
.'> 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => 'Bob',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户备注信息。最多支持500字符。'."\n"
.'> 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
[
'name' => 'Email',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户的邮箱。'."\n"
.'> - 当TwoFactorStatus为“Enable”,且TwoFactorMethods为“email”时,或当TwoFactorStatus为“Global”,且全局双因子配置中TwoFactorMethods为“email”时,该参数为必填。'."\n"
.'> - 您可以调用[GetInstanceTwoFactor](~~462968~~)接口获取全局双因子配置。'."\n"
.'> - 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => 'username@example.com',
],
],
[
'name' => 'Mobile',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户手机号码。'."\n"
.'> - 当TwoFactorStatus为“Enable”,且TwoFactorMethods为“sms”或“dingtalk”时,或当TwoFactorStatus为“Global”,且全局双因子配置中TwoFactorMethods为“sms”或“dingtalk”时,该参数为必填。'."\n"
.'> - 您可以调用[GetInstanceTwoFactor](~~462968~~)接口获取全局双因子配置。'."\n"
.'> - 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => '1358888****',
],
],
[
'name' => 'MobileCountryCode',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户手机号的国际域名。取值:'."\n"
.'- **CN**:中国内地(+86)'."\n"
.'- **HK**:中国香港(+852)'."\n"
.'- **MO**:中国澳门(+853)'."\n"
.'- **TW**:中国台湾(+886)'."\n"
.'- **RU**:俄罗斯(+7)'."\n"
.'- **SG**:新加坡(+65)'."\n"
.'- **MY**:马来西亚(+60)'."\n"
.'- **ID**:印度尼西亚(+62)'."\n"
.'- **DE**:德国(+49)'."\n"
.'- **AU**:澳大利亚(+61)'."\n"
.'- **US**:美国(+1)'."\n"
.'- **AE**:迪拜(+971)'."\n"
.'- **JP**:日本(+81)'."\n"
.'- **GB**:英国(+44)'."\n"
.'- **IN**:印度(+91)'."\n"
.'- **KR**:韩国(+82)'."\n"
.'- **PH**:菲律宾(+63)'."\n"
.'- **CH**:瑞士(+41)'."\n"
.'- **SE**:瑞典(+46)'."\n"
.'- **SA**:沙特(+966)',
'type' => 'string',
'required' => false,
'example' => 'CN',
],
],
[
'name' => 'EffectiveStartTime',
'in' => 'query',
'schema' => [
'title' => '用户开始生效时间戳,单位秒',
'description' => '用户有效期开始时间(秒,时间戳格式)'."\n"
.'> 未填则表示不做修改。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1669630029',
],
],
[
'name' => 'EffectiveEndTime',
'in' => 'query',
'schema' => [
'title' => '用户结束生效时间戳,单位秒',
'description' => '用户有效期结束时间(秒,时间戳格式)'."\n"
.'> 未填则表示不做修改。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1672502400',
],
],
[
'name' => 'NeedResetPassword',
'in' => 'query',
'schema' => [
'title' => '用户下次登录强制修改密码',
'description' => '下次登录是否需要重置密码。取值:'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否'."\n"
."\n"
.'> 未填则表示不做修改。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'TwoFactorStatus',
'in' => 'query',
'schema' => [
'description' => '用户双因子状态,取值:'."\n"
."\n"
.'- **Global**:遵循全局设定'."\n"
.'- **Disable**:关闭双因子'."\n"
.'- **Enable**:开启双因子,遵循单个用户设定'."\n"
."\n"
.'> 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
],
],
[
'name' => 'TwoFactorMethods',
'in' => 'query',
'schema' => [
'description' => '打开双因子认证方式的数组,目前最多支持一个,取值:'."\n"
."\n"
.'- **sms**:短信'."\n"
.'- **email**:邮件'."\n"
.'- **dingtalk**:钉钉'."\n"
.'- **totp**:OTP令牌'."\n"
.'- **gmusbkey**:国密USBKEY'."\n"
.'> 当TwoFactorStatus为“Enable”时,至少指定一种。',
'type' => 'string',
'required' => false,
'example' => '['."\n"
.' "sms"'."\n"
.']',
],
],
[
'name' => 'LanguageStatus',
'in' => 'query',
'schema' => [
'description' => '消息通知语言设置。'."\n"
."\n"
.'- **Global**:遵循全局'."\n"
.'- **Custom**:自定义'."\n"
."\n"
.'> 未填则表示不做修改。',
'type' => 'string',
'required' => false,
'example' => 'Custom',
],
],
[
'name' => 'Language',
'in' => 'query',
'schema' => [
'description' => '当LanguageStatus为Custom 时,Language为必填。 取值:'."\n"
."\n"
.'- **zh-cn**:简体中文'."\n"
.'- **en**:英文',
'type' => 'string',
'required' => false,
'example' => 'en',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'UserNotFound',
'errorMessage' => 'The user is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '修改用户',
],
'DeleteUser' => [
'summary' => '删除单个堡垒机用户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的用户所在堡垒机的实例ID。'."\n"
.'>您可以调用[describeinstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的用户所在堡垒机的地域ID。'."\n"
.'>地域id和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。'."\n"
."\n\n",
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'UserNotFound',
'errorMessage' => 'The user is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '删除用户',
],
'CreateUserPublicKey' => [
'summary' => '您可以创建用户公钥后将公钥托管至堡垒机,运维员即可使用私钥通过运维客户端登录堡垒机。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定需创建用户公钥的用户所在的堡垒机的区域id。'."\n"
.'>区域id和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定新创建用户公钥的堡垒机实例id。'."\n"
.'>您可以调用[listinstances](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定新创建用户公钥的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PublicKeyName',
'in' => 'query',
'schema' => [
'description' => '用户公钥名称。',
'type' => 'string',
'required' => true,
'example' => 'KeyName',
],
],
[
'name' => 'PublicKey',
'in' => 'query',
'schema' => [
'description' => '用户公钥。采用Base64编码。',
'type' => 'string',
'required' => true,
'example' => 'c3NoLWVkMjU1MTkgQUFBQUMzTnphQzFsWkRJMU5URTVBQUFBSUxGQnQxUUpyT3IxK2hTTGRkbERMZUx4WGRIZ3hBalBxWHJIbWNFNWxqSk8gbm93Y29kZXJAbm93Y29kZXJkZU1hY0Jvb2stUHJvLmxvY2Fs',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '用户公钥的备注信息。最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'PublicKeyId' => [
'description' => '用户的公钥ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '5EAB922E-F476-5DFA-9290-313C608E724B',
],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PublicKeyId\\": \\"1\\",\\n \\"RequestId\\": \\"5EAB922E-F476-5DFA-9290-313C608E724B\\"\\n}","type":"json"}]',
'title' => '创建用户公钥',
'description' => '本接口用于创建堡垒机的用户的用户公钥。',
],
'ListUserPublicKeys' => [
'summary' => '查询用户名下所有的公钥列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '需要查询公钥的用户所在堡垒机的实例id。'."\n"
.'>您可以调用[describeinstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****'."\n",
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '用户的堡垒机的区域id。'."\n"
.'>区域id和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '50',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询公钥的用户ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'PublicKeys' => [
'description' => '用户公钥列表。',
'type' => 'array',
'items' => [
'description' => '用户公钥列表。',
'type' => 'object',
'properties' => [
'FingerPrint' => [
'description' => '公钥指纹。',
'type' => 'string',
'example' => 'd8:7d:b6:27:70:2d:07:fb:c6:b6:66:0a:86:7b:0f:9a',
],
'PublicKeyId' => [
'description' => '公钥ID。',
'type' => 'string',
'example' => '1',
],
'PublicKeyName' => [
'description' => '公钥名称。',
'type' => 'string',
'example' => 'Keyname',
],
'UserId' => [
'description' => '公钥所属用户的用户ID。',
'type' => 'string',
'example' => '1',
],
'Comment' => [
'description' => '公钥备注信息。',
'type' => 'string',
'example' => 'comment',
],
],
],
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '公钥总数。',
'type' => 'integer',
'format' => 'int64',
'example' => '5',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PublicKeys\\": [\\n {\\n \\"FingerPrint\\": \\"d8:7d:b6:27:70:2d:07:fb:c6:b6:66:0a:86:7b:0f:9a\\",\\n \\"PublicKeyId\\": \\"1\\",\\n \\"PublicKeyName\\": \\"Keyname\\",\\n \\"UserId\\": \\"1\\",\\n \\"Comment\\": \\"comment\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 5\\n}","type":"json"}]',
'title' => '获取用户公钥列表',
],
'ModifyUserPublicKey' => [
'summary' => '修改用户公钥信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户公钥的堡垒机的实例id。'."\n"
.'>您可以调用[describeinstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-nif23******',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户公钥的堡垒机所在的区域id。'."\n"
.'>区域id和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PublicKeyId',
'in' => 'query',
'schema' => [
'description' => '需要修改的用户公钥id。'."\n"
.'> 您可以调用[ListUserPublicKeys](~~477555~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'PublicKeyName',
'in' => 'query',
'schema' => [
'description' => '指定要修改的公钥名称。最多支持128字符。',
'type' => 'string',
'required' => false,
'example' => 'name',
],
],
[
'name' => 'PublicKey',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户公钥。'."\n"
.'> 使用Base64编码。',
'type' => 'string',
'required' => false,
'example' => 'c3NoLWVkMjU1MTkgQUFBQUMzTnphQzFsWkRJMU5URTVBQUFBSUhVcjY4UENFYWFzZjFYRVpNYTVsMlNBQytHV3FpeXVsRVpndkV4dmlPM28gcm9vdEA5NjBkMmNhOTcwYjU=',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户组备注信息。最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'AAB631FB-ABD0-5783-99F3-F29573B129E4',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"AAB631FB-ABD0-5783-99F3-F29573B129E4\\"\\n}","type":"json"}]',
'title' => '修改用户公钥',
],
'DeleteUserPublicKey' => [
'summary' => '删除用户公钥。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除公钥的用户所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PublicKeyId',
'in' => 'query',
'schema' => [
'description' => '公钥ID。'."\n"
.'> 您可以调用[ListUserPublicKeys](~~477555~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '11',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '删除用户公钥',
'description' => '本接口用于删除堡垒机用户的用户公钥。',
],
'LockUsers' => [
'summary' => '批量锁定堡垒机用户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要锁定的用户所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要锁定的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'schema' => [
'description' => '要锁定的用户ID。该参数为JSON格式的字符串,最多支持添加100个用户ID,多个ID之间使用半角逗号(,)隔开。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取用户ID。',
'type' => 'string',
'required' => true,
'example' => ' ["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n"
."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"UserId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n \\n","errorExample":""}]',
'title' => '批量锁定堡垒机用户',
'description' => '### 使用说明'."\n"
.'本接口用于批量锁定堡垒机用户。如果某个用户在一段时间内无需使用堡垒机进行运维操作,您可以使用本接口锁定该用户,被锁定的用户将无法登录服务器进行运维操作。如果后续需要解锁该用户,您可使用[UnlockUsers](~~204590~~)接口来解锁。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'UnlockUsers' => [
'summary' => '批量解锁堡垒机用户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostE6GSFF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要解锁的用户所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要解锁的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'schema' => [
'description' => '要解锁的用户ID。该参数为JSON格式的字符串,最多支持设置100个用户ID,多个ID之间使用半角逗号(,)隔开。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取用户ID。',
'type' => 'string',
'required' => true,
'example' => '["1","2"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"UserId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n \\n","errorExample":""}]',
'title' => '批量解锁堡垒机用户',
'description' => '本接口是在使用了[LockUsers](~~204591~~)接口锁定了堡垒机用户之后,需要解锁堡垒机用户时使用。用户被解锁之后即可使用堡垒机进行运维操作。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateUserGroup' => [
'summary' => '创建堡垒机用户组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要新建用户组的堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要新建用户组的堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupName',
'in' => 'query',
'schema' => [
'description' => '要新建的用户组的名称。最多支持128字符。',
'type' => 'string',
'required' => true,
'example' => 'group',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '新建的用户组的备注信息。最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'UserGroupId' => [
'description' => '新建的用户组的ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'UserGroupAlreadyExists',
'errorMessage' => 'The user group already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"UserGroupId\\": \\"1\\",\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n 1\\n","errorExample":""}]',
'title' => '创建用户组',
'description' => '本接口用于为堡垒机创建用户组。堡垒机管理员可使用本接口创建用户组,然后使用[AddUsersToGroup](~~204600~~)接口为该用户组批量添加用户。将用户添加到同一个用户组,可实现对堡垒机用户的统一授权和管理。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'GetUserGroup' => [
'summary' => '获取指定堡垒机用户组的详细信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询用户组详情的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询用户组详情的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'UserGroup' => [
'description' => '查询到的用户组详细信息。',
'type' => 'object',
'properties' => [
'UserGroupName' => [
'description' => '用户组名称。',
'type' => 'string',
'example' => 'UserGroup01',
],
'Comment' => [
'description' => '用户组备注信息。',
'type' => 'string',
'example' => 'comment',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'UserGroupNotFound',
'errorMessage' => 'The user group is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"UserGroup\\": {\\n \\"UserGroupName\\": \\"UserGroup01\\",\\n \\"Comment\\": \\"comment\\",\\n \\"UserGroupId\\": \\"1\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n comment\\n UserGroup01\\n 1\\n \\n","errorExample":""}]',
'title' => '获取指定堡垒机用户组的详细信息',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListUserGroups' => [
'summary' => '获取指定堡垒机下的用户组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询用户组列表的堡垒机实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询用户组列表的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'UserGroupName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'TestGroup01',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的用户组总数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'UserGroups' => [
'description' => '查询到的用户组列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'UserGroupName' => [
'description' => '用户组名称。',
'type' => 'string',
'example' => 'TestGroup01',
],
'MemberCount' => [
'description' => '用户组内的用户数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '6',
],
'Comment' => [
'description' => '用户组备注信息。',
'type' => 'string',
'example' => 'comment',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"UserGroups\\": [\\n {\\n \\"UserGroupName\\": \\"TestGroup01\\",\\n \\"MemberCount\\": 6,\\n \\"Comment\\": \\"comment\\",\\n \\"UserGroupId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n comment\\n TestGroup01\\n 1\\n 5\\n \\n","errorExample":""}]',
'title' => '获取用户组列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~315526~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyUserGroup' => [
'summary' => '修改用户组信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户组信息的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改用户组信息的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'UserGroupName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户组名称。最多支持128字符。',
'type' => 'string',
'required' => false,
'example' => 'TestUserGroup',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定修改后的用户组备注信息。最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'UserGroupNotFound',
'errorMessage' => 'The user group is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '修改用户组信息',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteUserGroup' => [
'summary' => '删除单个堡垒机用户组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除用户组的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要删除用户组的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'UserGroupNotFound',
'errorMessage' => 'The user group is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\r\\n","errorExample":""}]',
'title' => '删除用户组',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddUsersToGroup' => [
'summary' => '将用户批量添加到用户组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要添加用户的用户组所在的堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要添加用户的用户组所在的堡垒机实例的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '要添加用户的用户组的ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'schema' => [
'description' => '要添加到用户组的用户ID。该参数为JSON格式的字符串,最多支持设置100个用户ID,多个ID之间使用半角逗号(,)隔开。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取用户ID。',
'type' => 'string',
'required' => true,
'example' => ' ["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口调用的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n"
."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"UserGroupId\\": \\"1\\",\\n \\"UserId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n OK\\n 1\\n 1\\n \\n","errorExample":""}]',
'title' => '批量为用户组添加用户',
'description' => '### 使用说明'."\n"
.'本接口用于将用户批量添加到用户组。在使用[CreateUserGroup](~~204596~~)接口创建用户组之后,您可以使用本接口将多个用户加入到该用户组,对这些用户进行批量授权和管理。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveUsersFromGroup' => [
'summary' => '批量移除用户组内用户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要移除用户的用户组所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要移除用户的用户组所在堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '要移除用户的用户组的ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'schema' => [
'description' => '要移除的用户的ID。以该参数为JSON格式的字符串,最多支持设置100个用户ID,多个ID之间使用半角逗号(,)隔开。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取用户ID。',
'type' => 'string',
'required' => true,
'example' => '["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n"
."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'UserGroupId' => [
'description' => '用户组的ID。',
'type' => 'string',
'example' => '1',
],
'UserId' => [
'description' => '用户的ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"UserGroupId\\": \\"1\\",\\n \\"UserId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n OK\\n 1\\n 1\\n \\n","errorExample":""}]',
'title' => '批量移除用户组内用户',
'description' => '### 使用说明'."\n"
.'本接口用于批量移除用户组内的用户。当用户离职或转岗您要回收用户权限,或者用户切换用户组时,可使用本接口将涉及权限变动的用户从用户组内批量移除。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateHostGroup' => [
'summary' => '您可以按照业务需要创建不同的资产组,然后将同一类型的资产添加到资产组,实现对资产的分类管理和批量操作。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定新建资产组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定新建资产组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupName',
'in' => 'query',
'schema' => [
'description' => '指定新建的资产组名称,最多支持128字符。',
'type' => 'string',
'required' => true,
'example' => 'HostGroup01',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定新建资产组的备注信息,最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'Local host group',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '新创建的资产组ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'HostGroupAlreadyExists',
'errorMessage' => 'The host group already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"HostGroupId\\": \\"1\\",\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '创建资产组',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddDatabasesToGroup' => [
'summary' => '批量将数据库实例加入指定资产组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '要加入数据库的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'DatabaseIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '数据库ID组成的数组。',
'type' => 'array',
'items' => [
'description' => '要加入资产组的数据库ID。最多支持添加100个。'."\n"
.'您可以调用[ListDatabases](~~2758822~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '返回结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示加入成功;其他错误码表示加入失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseId' => [
'description' => '数据库实例 ID。',
'type' => 'string',
'example' => '9',
],
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'example' => '1',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseId\\": \\"9\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"Message\\": \\"None\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '批量将数据库实例加入指定资产组',
],
'AddHostsToGroup' => [
'summary' => '批量将主机加入指定资产组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要加入主机的资产组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要加入主机的资产组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '要加入主机的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostIds',
'in' => 'query',
'schema' => [
'description' => '要加入资产组的主机ID。该参数为JSON格式的字符串,最多支持添加100个主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取主机ID。',
'type' => 'string',
'required' => true,
'example' => '["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '81500666-d7f5-4143-8329-0223cc738105',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'description' => '接口的调用结果。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'example' => '1',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"81500666-d7f5-4143-8329-0223cc738105\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 81500666-d7f5-4143-8329-0223cc738105\\n \\n 1\\n 1\\n OK\\n \\n","errorExample":""}]',
'title' => '批量将主机加入指定资产组',
'description' => '本接口用于批量将主机加入到指定的主机组当中。通过将多个主机加入到一个主机组,您可以集中管理这些主机,并进行批量授权。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveDatabasesFromGroup' => [
'summary' => '从指定资产组中批量移除数据库。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要移除数据库的资产组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1ghxxxxx',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要移除数据库的资产组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要移除数据库的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'DatabaseIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '要移除的数据库ID。',
'type' => 'array',
'items' => [
'description' => '要移除的数据库ID。该参数为JSON格式的字符串,最多支持输入100个数据库ID。'."\n"
.'> 可调用[ListHostGroups](~~475822~~)接口获取资产组下的资产列表。',
'type' => 'string',
'required' => false,
'example' => '["1","2","3"]'."\n",
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码,OK表示成功,其他表示错误。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '20',
],
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'example' => '1',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseId\\": \\"20\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"Message\\": \\"None\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '从指定资产组中批量移除数据库',
],
'DeleteHostGroup' => [
'summary' => '删除单个资产组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要删除的资产组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要删除的资产组所在堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '要删除的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostGroupNotFound',
'errorMessage' => 'The host group is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '删除单个资产组',
'description' => '本接口用于删除单个主机组。当堡垒机上某个主机组内的所有主机不在需要通过堡垒机运维时,您可以使用本接口删除该主机组。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveHostsFromGroup' => [
'summary' => '从指定资产组中批量移除主机。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要移除主机的资产组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要移除主机的资产组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '要移除主机的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostIds',
'in' => 'query',
'schema' => [
'description' => '要移除的主机ID。该参数为JSON格式的字符串,最多支持输入100个主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取主机ID。',
'type' => 'string',
'required' => true,
'example' => '["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'example' => '1',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n 1\\n \\n 1\\n OK\\n \\n","errorExample":""}]',
'title' => '从指定资产组中批量移除主机',
'description' => '本接口用于从资产组中批量移除主机。如果部分主机不再需要通过资产组统一管理,您可以将这部分主机使用本接口从资产组中移除。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyHostGroup' => [
'summary' => '修改资产组名称或备注信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的资产组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的资产组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroupName',
'in' => 'query',
'schema' => [
'description' => '指定修改后的资产组名称,最多支持128字符。',
'type' => 'string',
'required' => false,
'example' => 'Group01',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定修改后的资产组备注信息,最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostGroupNotFound',
'errorMessage' => 'The host group is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '修改资产组名称或备注信息',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'GetHostGroup' => [
'summary' => '获取指定资产组详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的资产组所在的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的资产组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的资产组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostGroup' => [
'description' => '查询到的资产组详细信息。',
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'example' => '1',
],
'Comment' => [
'description' => '资产组的备注信息。',
'type' => 'string',
'example' => 'Comment',
],
'HostGroupName' => [
'description' => '资产组名称。',
'type' => 'string',
'example' => 'Group1',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostGroupNotFound',
'errorMessage' => 'The host group is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostGroup\\": {\\n \\"HostGroupId\\": \\"1\\",\\n \\"Comment\\": \\"Comment\\",\\n \\"HostGroupName\\": \\"Group1\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n 备注\\n 1\\n 主机组1\\n \\n","errorExample":""}]',
'title' => '获取指定资产组详情',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostGroups' => [
'summary' => '获取指定堡垒机下的资产组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~462953~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时每页显示的数据最大条数。pagesize参数最大取值为100。每页默认显示的数据条数为20条,pagesize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议pagesize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostGroupName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的资产组名称,不支持模糊查询,只支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'HostGroup1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的资产组总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '请求ID',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostGroups' => [
'description' => '查询到的资产组列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'MemberCount' => [
'description' => '资产组内的主机数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'HostGroupId' => [
'description' => '资产组id。',
'type' => 'string',
'example' => '1',
],
'Comment' => [
'description' => '资产组的备注信息。',
'type' => 'string',
'example' => 'Comment',
],
'HostGroupName' => [
'description' => '资产组名称。',
'type' => 'string',
'example' => 'HostGroup1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostGroups\\": [\\n {\\n \\"MemberCount\\": 1,\\n \\"HostGroupId\\": \\"1\\",\\n \\"Comment\\": \\"Comment\\",\\n \\"HostGroupName\\": \\"HostGroup1\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '获取指定堡垒机下的资产组列表',
],
'AttachHostAccountsToUser' => [
'summary' => '当您新建用户之后,您需要为该用户授权资产。授权后该用户才可以使用堡垒机运维已授权的资产。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机和主机账户的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机和主机账户的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机和主机账户的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Hosts',
'in' => 'query',
'schema' => [
'description' => '要为用户授权的主机ID和主机账户ID。最多支持设置10个主机ID,每个主机最多支持设置9个主机账户ID。您可以不设置主机账户ID,不设置主机账户ID表示仅为用户授权主机。该参数的具体结构请参考请求参数列表下的Hosts参数结构说明。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取主机ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户ID。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostId":"1"}, {"HostId":"2","HostAccountIds":["1","2","3"]}, {"HostId":"3","HostAccountIds":["4","5","6"]}, {"HostId":"4","HostAccountIds":["9","8","7"]} ]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口调用的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口调用的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
."\n"
.' > 请检查请求参数,确保参数正确后重新调用接口。'."\n"
."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
."\n"
.' > 请检查该堡垒机实例的ID是否存在,主机是否存在,主机ID是否填写正确,然后重新调用接口。'."\n"
."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
'HostAccounts' => [
'description' => '为用户授权主机账户操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户授权主机账户操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostId\\": \\"1\\",\\n \\"UserId\\": \\"1\\",\\n \\"HostAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountId\\": \\"1\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n 1\\n \\n \\n \\n \\n OK\\n 1\\n \\n \\n","errorExample":""}]',
'title' => '为用户授权主机和主机账户',
'requestParamsDescription' => 'Hosts参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostId | string |1 |主机ID。|'."\n"
.'| HostAccountIds | array[string] |["9","8","7"]|主机账户ID。该参数为JSON格式的字符串,最多可设置10个主机账户ID。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
."\n"
.'```'."\n"
.'['."\n"
.'{"HostId":"1"},'."\n"
.'{"HostId":"2","HostAccountIds":["1","2","3",...]},'."\n"
.'{"HostId":"3","HostAccountIds":["4","5","6",...]},'."\n"
.'{"HostId":"4","HostAccountIds":["9","8","7",...]}'."\n"
.']```',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostsForUser' => [
'summary' => '查询指定堡垒机用户已授权或未授权的主机列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Mode',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机列表的模式。取值:'."\n"
.'- **Authorized**:已授权(默认)'."\n"
.'- **Unauthorized**:未授权',
'type' => 'string',
'required' => false,
'example' => 'Authorized',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostAddress',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机地址,可使用域名或IP地址。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'abc',
],
],
[
'name' => 'OSType',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机的操作系统类型。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'required' => false,
'example' => 'Linux',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE ',
],
'Hosts' => [
'description' => '查询到的主机列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '主机的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'ActiveAddressType' => [
'description' => '主机的地址类型。取值:'."\n"
.'- **Public**:公网地址'."\n"
.'- **Private**:私网地址',
'type' => 'string',
'example' => 'Public',
],
'HostPublicAddress' => [
'description' => '主机的公网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '10.158.XX.XX',
],
'HostName' => [
'description' => '主机名称。',
'type' => 'string',
'example' => 'host01',
],
'HostPrivateAddress' => [
'description' => '主机的私网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'OSType' => [
'description' => '主机的操作系统类型。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'example' => 'Linux',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE \\",\\n \\"Hosts\\": [\\n {\\n \\"Comment\\": \\"comment\\",\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"HostPublicAddress\\": \\"10.158.XX.XX\\",\\n \\"HostName\\": \\"host01\\",\\n \\"HostPrivateAddress\\": \\"192.168.XX.XX\\",\\n \\"OSType\\": \\"Linux\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n \\n comment\\n Public\\n 192.168.XX.XX\\n 10.158.XX.XX\\n Linux\\n 1\\n host01\\n \\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE \\n","errorExample":""}]',
'title' => '查询指定用户已授权或未授权的主机列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostAccountsForUser' => [
'summary' => '查询指定用户在指定主机下已授权和未授权的主机账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权主机账户列表的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权主机账户列表的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权主机账户列表的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户的主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户名称。支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机账户总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE ',
],
'HostAccounts' => [
'description' => '查询到的主机账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'root',
],
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
'IsAuthorized' => [
'description' => '主机账户是否授权给当前用户。取值:'."\n"
.'- **true**:已授权'."\n"
.'- **false**:未授权'."\n",
'type' => 'boolean',
'example' => 'true',
],
'ProtocolName' => [
'description' => '主机账户的协议名称。取值:'."\n"
.'- **SSH**'."\n"
.'- **RDP**',
'type' => 'string',
'example' => 'SSH',
],
'HostId' => [
'description' => '主机账户所在主机的ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE \\",\\n \\"HostAccounts\\": [\\n {\\n \\"HostAccountName\\": \\"root\\",\\n \\"HostAccountId\\": \\"1\\",\\n \\"IsAuthorized\\": true,\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE \\n \\n root\\n SSH\\n 1\\n true\\n 1\\n \\n","errorExample":""}]',
'title' => '查询指定用户已授权和未授权的主机账户列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DetachHostAccountsFromUser' => [
'summary' => '移除给用户授权的主机及主机账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权主机和主机账户的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权主机和主机账户的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权主机和主机账户的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Hosts',
'in' => 'query',
'schema' => [
'description' => '指定要为用户移除授权的主机ID和主机账户ID。最多支持设置10个主机ID,每个主机最多支持设置10个主机账户ID。您可以不设置主机账户ID,不设置主机账户ID表示为用户移除授权主机和该主机的所有授权主机账户。该参数的具体结构请参考请求参数列表下的Hosts参数结构说明。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取主机ID,调用[ListHostAccountsForUser](~~466581~~)接口获取目标主机已授权的主机账户ID。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostId":"1"}, {"HostId":"2","HostAccountIds":["1","2","3"]}, {"HostId":"3","HostAccountIds":["4","5","6"]}, {"HostId":"4","HostAccountIds":["9","8","7"]} ]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
'HostAccounts' => [
'description' => '为用户移除授权主机账户操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户移除授权主机账户操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostId\\": \\"1\\",\\n \\"UserId\\": \\"1\\",\\n \\"HostAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountId\\": \\"1\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n 1\\n \\n \\n \\n \\n OK\\n 1\\n \\n \\n","errorExample":""}]',
'title' => '移除给用户授权的主机及主机账户',
'requestParamsDescription' => 'Hosts参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostId | string |1 |主机ID。|'."\n"
.'| HostAccountIds | array[string] |["9","8","7"]|主机账户ID。该参数为JSON格式的字符串,最多可设置10个主机账户ID。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"HostId":"1"},'."\n"
.'{"HostId":"2","HostAccountIds":["1","2","3",...]},'."\n"
.'{"HostId":"3","HostAccountIds":["4","5","6",...]},'."\n"
.'{"HostId":"4","HostAccountIds":["9","8","7",...]}'."\n"
.']'."\n"
.'```'."\n"
.'调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DetachHostAccountsFromUserGroup' => [
'summary' => '移除给用户组授权的主机及主机账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权主机和主机账户的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权主机和主机账户的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权主机和主机账户的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Hosts',
'in' => 'query',
'schema' => [
'description' => '指定要为用户组移除授权的主机ID和主机账户ID。 '."\n"
.'最多支持设置10个主机ID,每个主机最多支持设置10个主机账户ID。您可以不设置主机账户ID,不设置主机账户ID表示为用户组移除授权主机和该主机的所有授权主机账户。该参数的具体结构请参考请求参数列表下的Hosts参数结构说明。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取主机ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户ID。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostId":"1"}, {"HostId":"2","HostAccountIds":["1","2","3",...]}, {"HostId":"3","HostAccountIds":["4","5","6"]}, {"HostId":"4","HostAccountIds":["9","8","7"]} ]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
'HostAccounts' => [
'description' => '为用户组移除授权主机账户操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户组移除授权主机账户操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostId\\": \\"1\\",\\n \\"UserGroupId\\": \\"1\\",\\n \\"HostAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountId\\": \\"1\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n 1\\n \\n \\n \\n \\n OK\\n 1\\n \\n \\n","errorExample":""}]',
'title' => '移除给用户组授权的主机及主机账户',
'requestParamsDescription' => 'Hosts参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostId | string |1 |主机ID。|'."\n"
.'| HostAccountIds | array[string] |["9","8","7"]|主机账户ID。该参数为JSON格式的字符串,最多可设置10个主机账户ID。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
."\n"
.'```'."\n"
.'['."\n"
.'{"HostId":"1"},'."\n"
.'{"HostId":"2","HostAccountIds":["1","2","3",...]},'."\n"
.'{"HostId":"3","HostAccountIds":["4","5","6",...]},'."\n"
.'{"HostId":"4","HostAccountIds":["9","8","7",...]}'."\n"
.']```',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DetachHostGroupAccountsFromUser' => [
'summary' => '移除用户已授权的主机组及主机账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要移除主机组和主机账户授权的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要移除主机组和主机账户授权的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要移除主机组和主机账户授权的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'schema' => [
'description' => '指定要为用户移除授权的主机组ID和主机账户名称。最多支持设置10个主机组ID,每个主机组最多支持设置10个主机账户名称。您可以不设置主机账户名称,不设置主机账户名称表示为用户移除主机组和该主机组下所有主机账户的授权。该参数的具体结构请参考请求参数列表下的HostGroups参数结构说明。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取主机组ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户名称。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostGroupId":"1"}, {"HostGroupId":"2","HostAccountNames":["root","111","abc"]}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostGroupId' => [
'description' => '主机组ID。',
'type' => 'string',
'example' => '1',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
'HostAccountNames' => [
'description' => '为用户移除主机账户授权操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户移除主机账户授权操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'root',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"UserId\\": \\"1\\",\\n \\"HostAccountNames\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountName\\": \\"root\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n 1\\n \\n OK\\n 1\\n \\n \\n \\n root\\n \\n OK\\n \\n \\n","errorExample":""}]',
'title' => '移除用户已授权的主机组及主机账户',
'requestParamsDescription' => 'HostGroups参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostGroupId | string |1 |主机组ID。|'."\n"
.'| HostAccountNames | array[string] |["root","111","abc"]|主机账户名称。该参数为JSON格式的字符串,最多可设置10个主机账户名称。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"HostGroupId":"1"}, '."\n"
.'{"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"4","HostAccountNames":["root","111","abc"]} '."\n"
.']'."\n"
.'```'."\n"
.'调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AttachHostAccountsToUserGroup' => [
'summary' => '为用户组授权主机及主机账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机和主机账户的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机和主机账户的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机和主机账户的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Hosts',
'in' => 'query',
'schema' => [
'description' => '指定要为用户组授权的主机ID和主机账户ID。最多支持设置10个主机ID,每个主机最多支持设置10个主机账户ID。您可以不设置主机账户ID,不设置主机账户ID表示仅为用户组授权主机。该参数的具体结构请参考请求参数列表下的Hosts参数结构说明。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取主机ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户ID。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostId":"1"}, {"HostId":"2","HostAccountIds":["1","2","3",...]}, {"HostId":"3","HostAccountIds":["4","5","6",...]}, {"HostId":"4","HostAccountIds":["9","8","7",...]} ... ]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
'HostAccounts' => [
'description' => '为用户组授权主机账户操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户组授权主机账户操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostId\\": \\"1\\",\\n \\"UserGroupId\\": \\"1\\",\\n \\"HostAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountId\\": \\"1\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n 1\\n \\n \\n \\n \\n OK\\n 1\\n \\n \\n","errorExample":""}]',
'title' => '为用户组授权主机及主机账户',
'description' => '为用户组授权主机和主机账户后,该用户组内的用户都可以访问已授权的主机。',
'requestParamsDescription' => 'Hosts参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostId | string |1 |主机ID。|'."\n"
.'| HostAccountIds | array[string] |["9","8","7"]|主机账户ID。该参数为JSON格式的字符串,最多可设置10个主机账户ID。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"HostId":"1"},'."\n"
.'{"HostId":"2","HostAccountIds":["1","2","3",...]},'."\n"
.'{"HostId":"3","HostAccountIds":["4","5","6",...]},'."\n"
.'{"HostId":"4","HostAccountIds":["9","8","7",...]}'."\n"
.']'."\n"
.'```'."\n"
.'调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DetachHostGroupAccountsFromUserGroup' => [
'summary' => '移除用户组已授权的主机组及主机账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要移除主机组和主机账户授权的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要移除主机组和主机账户授权的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要移除主机组和主机账户授权的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'schema' => [
'description' => '指定要为用户组移除授权的主机组ID和主机账户名称。最多支持设置10个主机组ID,每个主机组最多支持设置10个主机账户名称。您可以不设置主机账户名称,不设置主机账户名称表示为用户组移除主机组和该主机组下所有主机账户的授权。该参数的具体结构请参考请求参数列表下的HostGroups参数结构说明。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取主机组ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户名称。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostGroupId":"1"}, {"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"4","HostAccountNames":["root","111","abc"]}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostGroupId' => [
'description' => '主机组ID。',
'type' => 'string',
'example' => '1',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
'HostAccountNames' => [
'description' => '为用户组移除主机账户授权操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户组移除主机账户授权操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'root',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"UserGroupId\\": \\"1\\",\\n \\"HostAccountNames\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountName\\": \\"root\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n 1\\n \\n \\n \\n root\\n \\n OK\\n \\n \\n","errorExample":""}]',
'title' => '移除用户组已授权的主机组及主机账户',
'requestParamsDescription' => 'HostGroups参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostGroupId | string |1 |主机组ID。|'."\n"
.'| HostAccountNames | array[string] |["root","111","abc"]|主机账户名称。该参数为JSON格式的字符串,最多可设置10个主机账户名称。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"HostGroupId":"1"}, '."\n"
.'{"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"4","HostAccountNames":["root","111","abc"]} '."\n"
.']'."\n"
.'```'."\n"
.'调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AttachHostGroupAccountsToUser' => [
'summary' => '为用户授权主机组和主机账号。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机组和主机账户的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机组和主机账户的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机组和主机账户的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'schema' => [
'description' => '指定要为用户授权的主机组ID和主机账户名称。最多支持设置10个主机组ID,每个主机组最多支持设置10个主机账户名称。您可以不设置主机账户名称,不设置主机账户名称表示仅为用户授权主机组。该参数的具体结构请参考请求参数列表下的HostGroups参数结构说明。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取主机组ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户名称。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostGroupId":"1"}, {"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"4","HostAccountNames":["root","111","abc"]} ]',
'pattern' => '^[^\';<>=|\\(\\)]+$',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostGroupId' => [
'description' => '主机组ID。',
'type' => 'string',
'example' => '1',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
'HostAccountNames' => [
'description' => '为用户授权主机账户名称操作的返回结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户授权主机账户名称操作的返回结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'root',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"UserId\\": \\"1\\",\\n \\"HostAccountNames\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountName\\": \\"root\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n 1\\n \\n OK\\n 1\\n \\n \\n \\n root\\n \\n OK\\n \\n \\n","errorExample":""}]',
'title' => '为用户授权主机组和主机账号',
'requestParamsDescription' => 'HostGroups参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostGroupId | string |1 |主机组ID。|'."\n"
.'| HostAccountNames | array[string] |["root","111","abc"]|主机账户名称。该参数为JSON格式的字符串,最多可设置10个主机账户名称。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"HostGroupId":"1"}, '."\n"
.'{"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"4","HostAccountNames":["root","111","abc"]} '."\n"
.']'."\n"
.'```'."\n"
.'调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AttachHostGroupAccountsToUserGroup' => [
'summary' => '为用户组授权主机组和主机账号。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机组和主机账户的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机组和主机账户的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要授权主机组和主机账户的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'schema' => [
'description' => '指定要为用户组授权的主机组ID和主机账户名称。最多支持设置10个主机组ID,每个主机组最多支持设置10个主机账户名称。您可以不设置主机账户名称,不设置主机账户名称表示仅为用户组授权主机组。该参数的具体结构请参考请求参数列表下的HostGroups参数结构说明。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取主机组ID,调用[ListHostAccounts](~~204372~~)接口获取主机账户名称。',
'type' => 'string',
'required' => true,
'example' => '[ {"HostGroupId":"1"}, {"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, {"HostGroupId":"4","HostAccountNames":["root","111","abc"]}]',
'pattern' => '^[^\';<>=|\\(\\)]+$',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '接口的调用结果信息。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostGroupId' => [
'description' => '主机组ID。',
'type' => 'string',
'example' => '1',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
'HostAccountNames' => [
'description' => '为用户组授权主机账户名称操作返回的结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '为用户组授权主机账户名称操作返回的结果。取值:'."\n"
.'- **OK**:操作成功。'."\n"
.'- **UNEXPECTED**:未知错误。'."\n"
.'- **INVALID_ARGUMENT**:请求参数设置错误。'."\n"
.'- **OBJECT_NOT_FOUND**:操作的对象不存在。'."\n"
.'- **OBJECT_AlREADY_EXISTS** :操作的对象已存在。'."\n",
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => 'None',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'abc',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostGroupId\\": \\"1\\",\\n \\"UserGroupId\\": \\"1\\",\\n \\"HostAccountNames\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"None\\",\\n \\"HostAccountName\\": \\"abc\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n \\n 1\\n OK\\n 1\\n \\n \\n \\n abc\\n \\n OK\\n \\n \\n","errorExample":""}]',
'title' => '为用户组授权主机组和主机账号',
'requestParamsDescription' => 'HostGroups参数结构说明'."\n"
.'| 字段 | 类型 | 示例值 |描述 |'."\n"
.'| --- | --- | --- |--- |'."\n"
.'| HostGroupId | string |1 |主机组ID。|'."\n"
.'| HostAccountNames | array[string] |["root","111","abc"]|主机账户名称。该参数为JSON格式的字符串,最多可设置10个主机账户名称。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"HostGroupId":"1"}, '."\n"
.'{"HostGroupId":"2","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"3","HostAccountNames":["root","111","abc"]}, '."\n"
.'{"HostGroupId":"4","HostAccountNames":["root","111","abc"]} '."\n"
.']'."\n"
.'```'."\n"
.'调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostAccountsForUserGroup' => [
'summary' => '查询指定用户组在指定主机下已授权和未授权的主机账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权主机账户列表的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权主机账户列表的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权主机账户列表的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户的主机ID。'."\n"
.'> 您可以调用[ListHosts](~~200665~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户名称。支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机账户总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostAccounts' => [
'description' => '查询到的主机账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'host1',
],
'HostAccountId' => [
'description' => '主机账户ID。',
'type' => 'string',
'example' => '1',
],
'IsAuthorized' => [
'description' => '主机账户是否授权给当前用户组。取值:'."\n"
.'- **true**:已授权'."\n"
.'- **false**:未授权'."\n",
'type' => 'boolean',
'example' => 'true',
],
'ProtocolName' => [
'description' => '主机账户的协议名称。取值:'."\n"
.'- **SSH**'."\n"
.'- **RDP**',
'type' => 'string',
'example' => 'SSH',
],
'HostId' => [
'description' => '主机账户所在主机的ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostAccounts\\": [\\n {\\n \\"HostAccountName\\": \\"host1\\",\\n \\"HostAccountId\\": \\"1\\",\\n \\"IsAuthorized\\": true,\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n host1\\n SSH\\n true\\n 1\\n 1\\n \\n","errorExample":""}]',
'title' => '查询指定用户组已授权和未授权的主机账户列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostGroupAccountNamesForUser' => [
'summary' => '查询指定用户在指定主机组中已授权的主机账户名称。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostAccountNames' => [
'description' => '查询到的主机账户名称列表。',
'type' => 'array',
'items' => [
'description' => '查询到的主机账户名称。',
'type' => 'string',
'example' => 'abc',
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostAccountNames\\": [\\n \\"abc\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n abc\\n","errorExample":""}]',
'title' => '查询主机组中已授权的主机账户名称',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostGroupAccountNamesForUserGroup' => [
'summary' => '查询指定用户组在指定主机组中已授权的主机账户名称。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'HostGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机组ID。'."\n"
.'> 您可以调用[ListHostGroups](~~201307~~)接口获取该参数。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostAccountNames' => [
'description' => '查询到的主机账户名称。',
'type' => 'array',
'items' => [
'description' => '查询到的主机账户名称。',
'type' => 'string',
'example' => '["root","abc"]',
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostAccountNames\\": [\\n \\"[\\\\\\"root\\\\\\",\\\\\\"abc\\\\\\"]\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n root\\n abc\\n","errorExample":""}]',
'title' => '查询已授权的主机账户名称',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostGroupsForUser' => [
'summary' => '查询指定堡垒机用户已授权或未授权的主机组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostN06FHS',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Mode',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机组列表的模式。取值:'."\n"
.'- **Authorized**:已授权(默认)'."\n"
.'- **Unauthorized**:未授权',
'type' => 'string',
'required' => false,
'example' => 'Authorized',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostGroupName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机组名称。最多支持128字符,仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'group',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机组总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostGroups' => [
'description' => '查询到的主机组列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '主机组ID。',
'type' => 'string',
'example' => '1',
],
'Comment' => [
'description' => '主机组的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'HostGroupName' => [
'description' => '主机组名称。',
'type' => 'string',
'example' => 'group',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostGroups\\": [\\n {\\n \\"HostGroupId\\": \\"1\\",\\n \\"Comment\\": \\"comment\\",\\n \\"HostGroupName\\": \\"group\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n comment\\n 1\\n group\\n \\n","errorExample":""}]',
'title' => '查询指定用户已授权或未授权的主机组列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostGroupsForUserGroup' => [
'summary' => '查询指定堡垒机用户组已授权或未授权的主机组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost8REEA2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Mode',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机组列表的模式。取值:'."\n"
.'- **Authorized**:已授权(默认)'."\n"
.'- **Unauthorized**:未授权',
'type' => 'string',
'required' => false,
'example' => 'Authorized',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostGroupName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机组名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'group',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机组总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostGroups' => [
'description' => '查询到的主机组列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '主机组ID。',
'type' => 'string',
'example' => '1',
],
'Comment' => [
'description' => '主机组的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'HostGroupName' => [
'description' => '主机组名称。',
'type' => 'string',
'example' => 'group',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostGroups\\": [\\n {\\n \\"HostGroupId\\": \\"1\\",\\n \\"Comment\\": \\"comment\\",\\n \\"HostGroupName\\": \\"group\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n comment\\n 1\\n group\\n \\n","errorExample":""}]',
'title' => '查询指定用户组已授权或未授权的主机组列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListHostsForUserGroup' => [
'summary' => '查询指定堡垒机用户组已授权或未授权的主机列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostQ6EM52',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询授权主机列表的用户组所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询授权主机列表的用户组所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Mode',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机列表的模式。取值:'."\n"
.'- **Authorized**:已授权(默认)'."\n"
.'- **Unauthorized**:未授权',
'type' => 'string',
'required' => false,
'example' => 'Authorized',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要查询授权主机列表的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。'."\n",
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostAddress',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机地址,可使用域名或IP地址。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'abc',
],
],
[
'name' => 'OSType',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机的操作系统类型。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'required' => false,
'example' => 'Linux',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TotalCount' => [
'description' => '查询到的主机总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Hosts' => [
'description' => '查询到的主机列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '主机的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'ActiveAddressType' => [
'description' => '主机的地址类型。取值:'."\n"
.'- **Public**:公网地址'."\n"
.'- **Private**:私网地址',
'type' => 'string',
'example' => 'Public',
],
'HostPublicAddress' => [
'description' => '主机的公网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '10.158.XX.XX',
],
'HostName' => [
'description' => '主机名称。',
'type' => 'string',
'example' => 'host1',
],
'HostPrivateAddress' => [
'description' => '主机的私网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'OSType' => [
'description' => '主机的操作系统类型。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'example' => 'Linux',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 10,\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Hosts\\": [\\n {\\n \\"Comment\\": \\"comment\\",\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"HostPublicAddress\\": \\"10.158.XX.XX\\",\\n \\"HostName\\": \\"host1\\",\\n \\"HostPrivateAddress\\": \\"192.168.XX.XX\\",\\n \\"OSType\\": \\"Linux\\",\\n \\"HostId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n \\n comment\\n Public\\n 192.168.XX.XX\\n 10.158.XX.XX\\n Linux\\n 1\\n host1\\n \\n 10\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '查询指定用户组已授权或未授权的主机列表',
'requestParamsDescription' => '调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见[公共参数](~~148139~~)。'."\n"
.'调用API的请求格式,请参见本文示例中的请求示例。'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AttachDatabaseAccountsToUser' => [
'summary' => '为用户授权数据库及数据库账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要授权数据库和数据库账户的用户所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-wwo36qbv601',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '要授权的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '数据库对象数组。'."\n"
.'> 最大数据库数10个,数据库账号数10个。允许不传账号,不传账号则代表授权到数据库。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '要授权的数据库实例 ID。',
'type' => 'string',
'required' => false,
'example' => '22',
],
'DatabaseAccountIds' => [
'description' => '数据库账户ID数组。',
'type' => 'array',
'items' => [
'description' => '数据库账户ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '23120B8E-8737-50BD-A3A3-902A7821F04D',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示授权成功;其他错误码表示授权失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccounts' => [
'description' => '数据库账号信息的列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为OK时,表示授权成功;其他错误码表示授权失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '6',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'success',
],
],
],
],
'DatabaseId' => [
'description' => '数据库实例 ID。',
'type' => 'string',
'example' => '22',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"23120B8E-8737-50BD-A3A3-902A7821F04D\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccountId\\": \\"6\\",\\n \\"Message\\": \\"success\\"\\n }\\n ],\\n \\"DatabaseId\\": \\"22\\",\\n \\"Message\\": \\"None\\",\\n \\"UserId\\": \\"1\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '为用户授权数据库及数据库账户',
'requestParamsDescription' => '入参数据结构'."\n"
."\n"
.'Database对象数组'."\n"
."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'| --- | --- | --- |'."\n"
.'| DatabaseId | string |数据库ID。|'."\n"
.'| DatabaseAccountIds | array[string] | 账号ID数组。最多10个 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
."\n"
.'```'."\n"
.'['."\n"
.'{"DatabaseId":"1"} // 只授权数据库'."\n"
.'{"DatabaseId":"2","DatabaseAccountIds":["1","2","3",...]}, // 授权数据库,且授权账号'."\n"
.'{"DatabaseId":"5","DatabaseAccountIds":[]} // 不支持'."\n"
.']'."\n"
.'```',
],
'ListDatabasesForUser' => [
'summary' => '查询用户已授权的数据库列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-tl32swayw7o',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '要查询已授权数据库的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseName',
'in' => 'query',
'schema' => [
'description' => '要查询的数据库实例名称。',
'type' => 'string',
'required' => false,
'example' => 'MySQL-8.0',
],
],
[
'name' => 'DatabaseAddress',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库地址。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '47.101.**.**',
],
],
[
'name' => 'DatabaseType',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库类型,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'required' => false,
'example' => 'MySQL',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权数据库列表的网络域ID。',
'type' => 'string',
'required' => false,
'example' => '5',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Databases' => [
'description' => '查询到的数据库列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ActiveAddressType' => [
'description' => '数据库地址类型。取值:'."\n"
.'- **Public** :公网地址'."\n"
.'- **Private** :私网地址',
'type' => 'string',
'example' => 'Private',
],
'Comment' => [
'description' => '数据库实例的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '36',
],
'DatabaseName' => [
'description' => '数据库实例名称。',
'type' => 'string',
'example' => 'MySQL56',
],
'DatabasePort' => [
'description' => '数据库的端口。',
'type' => 'integer',
'format' => 'int64',
'example' => '3306',
],
'DatabasePrivateAddress' => [
'description' => '数据库的私网地址,可为域名或IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'DatabasePublicAddress' => [
'description' => '数据库的公网地址,可为域名或IP地址。',
'type' => 'string',
'example' => 'www.example.com',
],
'DatabaseType' => [
'description' => '数据库类型,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'example' => 'MySQL',
],
'NetworkDomainId' => [
'description' => '数据库所属的网络域的ID。',
'type' => 'string',
'example' => '2',
],
'Source' => [
'description' => '数据库的来源。取值:'."\n"
."\n"
.'- **Local**:本地数据库实例'."\n"
.'- **Rds**:RDS类型数据库实例'."\n"
.'- **PolarDB**: PolarDB类型数据库实例',
'type' => 'string',
'example' => 'Local',
],
'SourceInstanceId' => [
'description' => '数据库对应的RDS实例ID或PolarDB实例ID。'."\n"
.'> **Source**为**Local**时,该参数返回值为空。',
'type' => 'string',
'example' => 'i-wz9fv2hwux78x9******',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'A8A665B9-8550-4942-9DEE-73198051856B',
],
'TotalCount' => [
'description' => '查询到的数据库总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '15',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Databases\\": [\\n {\\n \\"ActiveAddressType\\": \\"Private\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseId\\": \\"36\\",\\n \\"DatabaseName\\": \\"MySQL56\\",\\n \\"DatabasePort\\": 3306,\\n \\"DatabasePrivateAddress\\": \\"192.168.XX.XX\\",\\n \\"DatabasePublicAddress\\": \\"www.example.com\\",\\n \\"DatabaseType\\": \\"MySQL\\",\\n \\"NetworkDomainId\\": \\"2\\",\\n \\"Source\\": \\"Local\\",\\n \\"SourceInstanceId\\": \\"i-wz9fv2hwux78x9******\\"\\n }\\n ],\\n \\"RequestId\\": \\"A8A665B9-8550-4942-9DEE-73198051856B\\",\\n \\"TotalCount\\": 15\\n}","type":"json"}]',
'title' => '查询用户已授权的数据库列表',
],
'DetachDatabaseAccountsFromUserGroup' => [
'summary' => '移除给用户组授权的数据库及数据库账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-7mz2v120f0y',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权数据库和数据库账户的用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '要移除授权的数据库信息。',
'type' => 'array',
'items' => [
'description' => '最多支持设置10个数据库实例ID,每个数据库实例最多支持设置10个数据库账户ID。您可以不设置数据库账户ID,不设置数据库账户ID表示为用户移除授权数据库实例和该数据库实例的所有授权数据库账户。',
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '指定要移除授权的数据库实例ID。',
'type' => 'string',
'required' => false,
'example' => '4',
],
'DatabaseAccountIds' => [
'description' => '要移除授权的数据库账户ID。',
'type' => 'array',
'items' => [
'description' => '指定要移除授权的数据库账户ID。',
'type' => 'string',
'required' => false,
'example' => '["1","2","3"]',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'AC528ED1-C302-56E5-9CB5-ADA625D64FF9',
],
'Results' => [
'description' => '返回结果信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示移除成功;其他错误码表示移除失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccounts' => [
'description' => '数据库账户信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示移除成功;其他错误码表示移除失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccountId' => [
'description' => '移除授权的数据库账户ID。',
'type' => 'string',
'example' => '5',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
],
],
],
'DatabaseId' => [
'description' => '移除授权的数据库ID。',
'type' => 'string',
'example' => '27',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '3',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"AC528ED1-C302-56E5-9CB5-ADA625D64FF9\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccountId\\": \\"5\\",\\n \\"Message\\": \\"None\\"\\n }\\n ],\\n \\"DatabaseId\\": \\"27\\",\\n \\"Message\\": \\"None\\",\\n \\"UserGroupId\\": \\"3\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '移除给用户组授权的数据库及数据库账户',
'requestParamsDescription' => '入参数据结构'."\n"
."\n"
.'Database对象数组'."\n"
."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'| --- | --- | --- |'."\n"
.'| DatabaseId | string | 数据库实例ID |'."\n"
.'| DatabaseAccountIds | array[string] | 数据库账户ID数组。该参数为JSON格式的字符串,最多可设置10个数据库账户ID。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"DatabaseId":"1"} // 取消数据库授权,并且删除账号授权'."\n"
.'{"DatabaseId":"2","DatabaseAccountIds":["1","2","3",...]}, // 只取消账号授权'."\n"
.'{"DatabaseId":"5","DatabaseAccountIds":[]} // 不支持'."\n"
.'...'."\n"
.']'."\n"
.'```',
],
'ListDatabaseAccountsForUser' => [
'summary' => '查询用户已授权和未授权的数据库账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zz42zoqql01',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要查询已授权数据库账户列表的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库账户的数据库ID。',
'type' => 'string',
'required' => true,
'example' => '89',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库账户名称。最多支持128字符,仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseAccounts' => [
'description' => '查询到的数据库账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '6',
],
'DatabaseAccountName' => [
'description' => '数据库账户名。',
'type' => 'string',
'example' => 'test',
],
'DatabaseId' => [
'description' => '数据库账号所属数据库实例ID。',
'type' => 'string',
'example' => '70',
],
'IsAuthorized' => [
'description' => '数据库账户是否授权给当前用户。取值:'."\n"
.'- **true**:已授权'."\n"
.'- **false**:未授权',
'type' => 'boolean',
'example' => 'true',
],
'ProtocolName' => [
'description' => '数据库账户的协议名称。取值:'."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'example' => 'MySQL',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '00E3701B-3616-55FE-93EC-E7CF5480B654',
],
'TotalCount' => [
'description' => '查询到的数据库账户总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseAccounts\\": [\\n {\\n \\"DatabaseAccountId\\": \\"6\\",\\n \\"DatabaseAccountName\\": \\"test\\",\\n \\"DatabaseId\\": \\"70\\",\\n \\"IsAuthorized\\": true,\\n \\"ProtocolName\\": \\"MySQL\\"\\n }\\n ],\\n \\"RequestId\\": \\"00E3701B-3616-55FE-93EC-E7CF5480B654\\",\\n \\"TotalCount\\": 3\\n}","type":"json"}]',
'title' => '查询指定用户已授权和未授权的数据库账户列表',
],
'DetachDatabaseAccountsFromUser' => [
'summary' => '移除给用户授权的数据库及数据库账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 可通过调用DescribeInstances接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-pe335ipfk01',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'UserId',
'in' => 'query',
'schema' => [
'description' => '指定要移除授权数据库和数据库账户的用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '数据库实例列表。',
'type' => 'array',
'items' => [
'description' => '最多支持设置10个数据库实例ID,每个数据库实例最多支持设置10个数据库账户ID。您可以不设置数据库账户ID,不设置数据库账户ID表示为用户移除授权数据库实例和该数据库实例的所有授权数据库账户。',
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '指定要移除授权的数据库实例ID。',
'type' => 'string',
'required' => false,
'example' => '8',
],
'DatabaseAccountIds' => [
'description' => '数据库账户ID数组。',
'type' => 'array',
'items' => [
'description' => '指定要移除授权的数据库账户ID。',
'type' => 'string',
'required' => false,
'example' => '["1","2","3"]',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '79D7E114-CB52-5695-AB15-12776C308387',
],
'Results' => [
'description' => '接口调用的结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示移除成功;其他错误码表示移除失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccounts' => [
'description' => '数据库账号信息的列表。',
'type' => 'array',
'items' => [
'description' => '数据库账号信息的列表。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为OK时,表示移除成功;其他错误码表示移除失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccountId' => [
'description' => '移除授权的数据库账户ID。',
'type' => 'string',
'example' => '9',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
],
],
],
'DatabaseId' => [
'description' => '移除授权的数据库ID。',
'type' => 'string',
'example' => '4',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'None',
],
'UserId' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"79D7E114-CB52-5695-AB15-12776C308387\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccountId\\": \\"9\\",\\n \\"Message\\": \\"None\\"\\n }\\n ],\\n \\"DatabaseId\\": \\"4\\",\\n \\"Message\\": \\"None\\",\\n \\"UserId\\": \\"1\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '移除给用户授权的数据库及数据库账户',
'requestParamsDescription' => '入参数据结构'."\n"
."\n"
.'Database对象数组'."\n"
."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'| --- | --- | --- |'."\n"
.'| DatabaseId | string | 数据库实例ID |'."\n"
.'| DatabaseAccountIds | array[string] | 数据库账户ID数组。该参数为JSON格式的字符串,最多可设置10个数据库账户ID。 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
.'``` '."\n"
.'['."\n"
.'{"DatabaseId":"1"} // 取消数据库授权,并且删除账号授权'."\n"
.'{"DatabaseId":"2","DatabaseAccountIds":["1","2","3",...]}, // 只取消账号授权'."\n"
.'{"DatabaseId":"5","DatabaseAccountIds":[]} // 不支持'."\n"
.'...'."\n"
.']'."\n"
.'```',
],
'AttachDatabaseAccountsToUserGroup' => [
'summary' => '为用户组授权数据库及数据库账户。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zvp282aly06',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '要添加授权的用户组ID。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '数据库对象数组。'."\n"
.'>最大数据库数10个,数据库账号数10个。允许不传账号,不传账号则代表授权到数据库。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '要授权的数据库实例 ID。',
'type' => 'string',
'required' => false,
'example' => '58',
],
'DatabaseAccountIds' => [
'description' => '数据库账户ID数组。',
'type' => 'array',
'items' => [
'description' => '数据库账户ID。',
'type' => 'string',
'required' => false,
'example' => '["1","2","3"]',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '5D0EB759-CB0A-537D-A2CC-13A9854FA08D',
],
'Results' => [
'description' => '接口的调用结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为OK时,表示授权成功;其他错误码表示授权失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccounts' => [
'description' => '数据库账号信息的列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为OK时,表示授权成功;其他错误码表示授权失败。',
'type' => 'string',
'example' => 'OK',
],
'DatabaseAccountId' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '8',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'NULL',
],
],
],
],
'DatabaseId' => [
'description' => '数据库实例 ID。',
'type' => 'string',
'example' => '2',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'NULL',
],
'UserGroupId' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"5D0EB759-CB0A-537D-A2CC-13A9854FA08D\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccounts\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"DatabaseAccountId\\": \\"8\\",\\n \\"Message\\": \\"NULL\\"\\n }\\n ],\\n \\"DatabaseId\\": \\"2\\",\\n \\"Message\\": \\"NULL\\",\\n \\"UserGroupId\\": \\"1\\"\\n }\\n ]\\n}","type":"json"}]',
'title' => '为用户组授权数据库及数据库账户',
'requestParamsDescription' => '入参数据结构'."\n"
."\n"
.'Database对象数组'."\n"
."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'| --- | --- | --- |'."\n"
.'| DatabaseId | string |数据库ID。|'."\n"
.'| DatabaseAccountIds | array[string] | 账号ID数组。最多10个 |'."\n"
."\n"
.'以下是该参数的取值示例。'."\n"
."\n"
.'```'."\n"
.'['."\n"
.'{"DatabaseId":"1"} // 只授权数据库'."\n"
.'{"DatabaseId":"2","DatabaseAccountIds":["1","2","3",...]}, // 授权数据库,且授权账号'."\n"
.'{"DatabaseId":"5","DatabaseAccountIds":[]} // 不支持'."\n"
.']'."\n"
.'```',
],
'ListDatabasesForUserGroup' => [
'summary' => '查询用户组已授权的数据库列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostXV4JIF',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-7mz2ve7h00a',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'UserGroupId',
'in' => 'query',
'schema' => [
'description' => '要查询已授权数据库的用户组ID。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseName',
'in' => 'query',
'schema' => [
'description' => '要查询的数据库实例名称。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'DatabaseAddress',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库地址。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '47.101.**.**'."\n",
],
],
[
'name' => 'DatabaseType',
'in' => 'query',
'schema' => [
'description' => '指定要查询的数据库类型,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'required' => false,
'example' => 'MySQL',
],
],
[
'name' => 'NetworkDomainId',
'in' => 'query',
'schema' => [
'description' => '网络域ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Databases' => [
'description' => '查询到的数据库列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ActiveAddressType' => [
'description' => '数据库地址类型。取值:'."\n"
.'- **Public** :公网地址'."\n"
.'- **Private** :私网地址',
'type' => 'string',
'example' => 'Private',
],
'Comment' => [
'description' => '数据库实例的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'DatabaseAccountCount' => [
'description' => '查询到的数据库账户总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '2',
],
'DatabaseId' => [
'description' => '数据库账号所属数据库实例ID。',
'type' => 'string',
'example' => '2',
],
'DatabaseName' => [
'description' => '数据库实例名称。',
'type' => 'string',
'example' => 'MySQL0',
],
'DatabasePort' => [
'description' => '数据库的端口。',
'type' => 'integer',
'format' => 'int64',
'example' => '3306',
],
'DatabasePrivateAddress' => [
'description' => '数据库的私网地址,可为域名或ip地址。',
'type' => 'string',
'example' => 'rm-bp1******',
],
'DatabasePublicAddress' => [
'description' => '数据库的公网地址,可为域名或ip地址。',
'type' => 'string',
'example' => 'rm-uf65******',
],
'DatabaseType' => [
'description' => '数据库类型,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'example' => 'MySQL',
],
'NetworkDomainId' => [
'description' => '数据库所属的网络域的ID。',
'type' => 'string',
'example' => '5',
],
'Source' => [
'description' => '数据库的来源。取值:'."\n"
."\n"
.'- **Local**:本地数据库实例'."\n"
.'- **Rds**:RDS类型数据库实例'."\n"
.'- **PolarDB**: PolarDB类型数据库实例',
'type' => 'string',
'example' => 'Local',
],
'SourceInstanceId' => [
'description' => '数据库对应的RDS实例ID或PolarDB实例ID。'."\n"
.'> **Source**为**Local**时,该参数返回值为空。',
'type' => 'string',
'example' => 'i-wz9c7mjxywmdmqk7q6e4',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的数据库总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '15',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Databases\\": [\\n {\\n \\"ActiveAddressType\\": \\"Private\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseAccountCount\\": 2,\\n \\"DatabaseId\\": \\"2\\",\\n \\"DatabaseName\\": \\"MySQL0\\",\\n \\"DatabasePort\\": 3306,\\n \\"DatabasePrivateAddress\\": \\"rm-bp1******\\",\\n \\"DatabasePublicAddress\\": \\"rm-uf65******\\",\\n \\"DatabaseType\\": \\"MySQL\\",\\n \\"NetworkDomainId\\": \\"5\\",\\n \\"Source\\": \\"Local\\",\\n \\"SourceInstanceId\\": \\"i-wz9c7mjxywmdmqk7q6e4\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 15\\n}","type":"json"}]',
'title' => '查询用户组已授权的数据库列表',
],
'ListOperationDatabases' => [
'summary' => '获取当前RAM用户已授权的数据库列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostEW7NXQ',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-tl32wdd',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseType',
'in' => 'query',
'schema' => [
'description' => '数据库类型,取值如下:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **SQLServer**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**',
'type' => 'string',
'required' => false,
'example' => 'MySQL',
],
],
[
'name' => 'DatabaseName',
'in' => 'query',
'schema' => [
'description' => '数据库实例名称。精确搜索。',
'type' => 'string',
'required' => false,
'example' => 'aaa',
],
],
[
'name' => 'DatabaseAddress',
'in' => 'query',
'schema' => [
'description' => '数据库实例地址。',
'type' => 'string',
'required' => false,
'example' => '10.167.XX.XX',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '数据库实例的来源。取值:'."\n"
.'- **Local**:本地数据库'."\n"
.'- **Rds**:RDS数据库'."\n"
.'- **PolarDB**:PolarDB数据库',
'type' => 'string',
'required' => false,
'example' => 'Local',
],
],
[
'name' => 'SourceInstanceId',
'in' => 'query',
'schema' => [
'description' => 'RDS数据库实例ID,精确搜索。',
'type' => 'string',
'required' => false,
'example' => 'i-bp19ienyt0yax748****',
],
],
[
'name' => 'SourceInstanceState',
'in' => 'query',
'schema' => [
'description' => '按实例状态过滤'."\n"
."\n"
.'- **Normal**:正常'."\n"
.'- **RemoteRelease** :已释放',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Databases' => [
'description' => '数据库实例列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ActiveAddressType' => [
'description' => '数据库的地址类型。取值:'."\n"
.'- **Public**:公网地址有效'."\n"
.'- **Private**:私网地址有效',
'type' => 'string',
'example' => 'Private',
],
'Comment' => [
'description' => '数据库实例的备注信息。',
'type' => 'string',
'example' => 'cpp',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '26',
],
'DatabaseName' => [
'description' => '数据库实例名称。',
'type' => 'string',
'example' => 'zDatabase',
],
'DatabasePort' => [
'description' => '数据库的端口。',
'type' => 'integer',
'format' => 'int64',
'example' => '3306',
],
'DatabasePrivateAddress' => [
'description' => '数据库私网地址。',
'type' => 'string',
'example' => 'rm-b******9b.mysql.rds.aliyuncs.com',
],
'DatabasePublicAddress' => [
'description' => '数据库公网地址。',
'type' => 'string',
'example' => 'rm-uf******p45.mysql.rds.aliyuncs.com',
],
'DatabaseType' => [
'description' => '数据库类型,取值:'."\n"
.'- **MySQL**'."\n"
.'- **PostgreSQL**'."\n"
.'- **Oracle**'."\n"
.'- **SQLServer**',
'type' => 'string',
'example' => 'MySQL',
],
'Source' => [
'description' => '数据库实例的来源。'."\n"
.'- **Local**:本地主机'."\n"
.'- **Rds**:RDS数据库'."\n"
.'- **PolarDB**:PolarDB数据库',
'type' => 'string',
'example' => 'Local',
],
'SourceInstanceId' => [
'description' => 'RDS实例ID。',
'type' => 'string',
'example' => 'i-wz9225bhipya******',
],
'SourceInstanceRegionId' => [
'description' => 'RDS的源实例地域ID。',
'type' => 'string',
'example' => 'cn-shanghai',
],
'SourceInstanceState' => [
'description' => '数据库实例的状态:'."\n"
.' - **Normal**:正常'."\n"
.'- **Release**:已释放',
'type' => 'string',
'example' => 'Normal',
],
],
],
],
'RequestId' => [
'description' => '唯一请求ID。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的数据库总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '15',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Databases\\": [\\n {\\n \\"ActiveAddressType\\": \\"Private\\",\\n \\"Comment\\": \\"cpp\\",\\n \\"DatabaseId\\": \\"26\\",\\n \\"DatabaseName\\": \\"zDatabase\\",\\n \\"DatabasePort\\": 3306,\\n \\"DatabasePrivateAddress\\": \\"rm-b******9b.mysql.rds.aliyuncs.com\\",\\n \\"DatabasePublicAddress\\": \\"rm-uf******p45.mysql.rds.aliyuncs.com\\",\\n \\"DatabaseType\\": \\"MySQL\\",\\n \\"Source\\": \\"Local\\",\\n \\"SourceInstanceId\\": \\"i-wz9225bhipya******\\",\\n \\"SourceInstanceRegionId\\": \\"cn-shanghai\\",\\n \\"SourceInstanceState\\": \\"Normal\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 15\\n}","type":"json"}]',
'title' => '获取当前RAM用户已授权的数据库列表',
],
'ListOperationHosts' => [
'summary' => '获取当前RAM用户已授权的主机列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostHPIB1A',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-09k22avmw0q',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'OSType',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机的操作系统。取值:'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'required' => false,
'example' => 'Linux',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机名称。不支持模糊查询,只支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'abc',
],
],
[
'name' => 'HostAddress',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机地址,可使用域名或IP地址。不支持模糊查询,只支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '10.162.XX.XX',
],
],
[
'name' => 'Source',
'in' => 'query',
'schema' => [
'description' => '指定要查询主机的来源。取值:'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例',
'type' => 'string',
'required' => false,
'example' => 'Local',
],
],
[
'name' => 'SourceInstanceId',
'in' => 'query',
'schema' => [
'description' => 'ECS实例ID。精确搜索。',
'type' => 'string',
'required' => false,
'example' => 'i-bp19ienyt0yax748****',
],
],
[
'name' => 'SourceInstanceState',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机状态。取值:'."\n"
.' - **Normal**:正常'."\n"
.'- **Release**:已释放',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Hosts' => [
'description' => '查询到的主机列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ActiveAddressType' => [
'description' => '主机地址类型。'."\n"
.'- **Public** :公网地址有效'."\n"
.'- **Private** :私网地址有效',
'type' => 'string',
'example' => 'Public',
],
'Comment' => [
'description' => '主机的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'HostName' => [
'description' => '主机名称。',
'type' => 'string',
'example' => 'host1',
],
'HostPrivateAddress' => [
'description' => '主机的私网地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'HostPublicAddress' => [
'description' => '主机的公网地址。',
'type' => 'string',
'example' => '10.158.XX.XX',
],
'OSType' => [
'description' => '主机的操作系统。'."\n"
.'- **Linux**'."\n"
.'- **Windows**',
'type' => 'string',
'example' => 'Linux',
],
'Source' => [
'description' => '主机的来源。'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例',
'type' => 'string',
'example' => 'Local',
],
'SourceInstanceId' => [
'description' => 'ECS实例ID。',
'type' => 'string',
'example' => 'i-bp19ienyt0yax748****',
],
'SourceInstanceState' => [
'description' => '主机状态。'."\n"
.' - **Normal** :正常'."\n"
.'- **Release**: 已释放',
'type' => 'string',
'example' => 'Normal',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '4F6C075F-FC86-476E-943B-097BD4E12948',
],
'TotalCount' => [
'description' => '查询到的主机总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '5',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Hosts\\": [\\n {\\n \\"ActiveAddressType\\": \\"Public\\",\\n \\"Comment\\": \\"comment\\",\\n \\"HostId\\": \\"1\\",\\n \\"HostName\\": \\"host1\\",\\n \\"HostPrivateAddress\\": \\"192.168.XX.XX\\",\\n \\"HostPublicAddress\\": \\"10.158.XX.XX\\",\\n \\"OSType\\": \\"Linux\\",\\n \\"Source\\": \\"Local\\",\\n \\"SourceInstanceId\\": \\"i-bp19ienyt0yax748****\\",\\n \\"SourceInstanceState\\": \\"Normal\\"\\n }\\n ],\\n \\"RequestId\\": \\"4F6C075F-FC86-476E-943B-097BD4E12948\\",\\n \\"TotalCount\\": 5\\n}","type":"json"}]',
'title' => '获取当前RAM用户已授权的主机列表',
],
'ListOperationHostAccounts' => [
'summary' => '获取当前RAM用户已授权的主机账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostHPIB1A',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostId',
'in' => 'query',
'schema' => [
'description' => '指定要查询主机账户的主机ID。'."\n"
.'> 您可以调用[ListOperationHosts](~~2758857~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'HostAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的主机账户名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'HostAccounts' => [
'description' => '查询到的主机账户列表。'."\n"
."\n",
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HasPassword' => [
'description' => '当前主机账户是否设置了密码。'."\n"
."\n"
.'- **true**:已设置密码。'."\n"
.'- **false**:未设置密码。',
'type' => 'boolean',
'example' => 'true',
],
'HostAccountId' => [
'description' => '主机账户ID。 ',
'type' => 'string',
'example' => '1',
],
'HostAccountName' => [
'description' => '主机账户名称。',
'type' => 'string',
'example' => 'root',
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
'HostShareKeyId' => [
'description' => '主机共享密钥ID。 ',
'type' => 'string',
'example' => '3',
],
'PrivateKeyFingerprint' => [
'description' => '主机账户的私钥指纹信息。',
'type' => 'string',
'example' => 'fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**',
],
'ProtocolName' => [
'description' => '主机账户的协议名称。'."\n"
.'- **SSH**'."\n"
.'- **RDP**',
'type' => 'string',
'example' => 'SSH',
],
'SSHConfig' => [
'description' => 'SSH账户运维权限。',
'type' => 'object',
'properties' => [
'EnableSFTPChannel' => [
'description' => '该账户是否开启SFTP通道。',
'type' => 'boolean',
],
'EnableSSHChannel' => [
'description' => '该账户是否开启SSH通道。',
'type' => 'boolean',
],
],
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的主机账户总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HostAccounts\\": [\\n {\\n \\"HasPassword\\": true,\\n \\"HostAccountId\\": \\"1\\",\\n \\"HostAccountName\\": \\"root\\",\\n \\"HostId\\": \\"1\\",\\n \\"HostShareKeyId\\": \\"3\\",\\n \\"PrivateKeyFingerprint\\": \\"fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**\\",\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"SSHConfig\\": {\\n \\"EnableSFTPChannel\\": true,\\n \\"EnableSSHChannel\\": true\\n }\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 1\\n}","type":"json"}]',
'title' => '获取当前RAM用户已授权的主机账户列表',
],
'ListOperationDatabaseAccounts' => [
'summary' => '获取当前RAM用户已授权的数据库账户列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostEW7NXQ',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-2r42t9cvf0i',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'DatabaseId',
'in' => 'query',
'schema' => [
'description' => '数据库实例ID。'."\n"
.'> 您可以调用[ListOperationDatabases](~~2758856~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '56',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。'."\n"
.'
PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'DatabaseAccountName',
'in' => 'query',
'schema' => [
'description' => '数据库账号名称。精确匹配。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DatabaseAccounts' => [
'description' => '查询到的数据库账户列表。',
'type' => 'array',
'items' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'DBName' => [
'description' => 'PostgreSQL和Oracle对应的数据库名。',
'type' => 'string',
'example' => 'xe',
],
'DatabaseAccountId' => [
'description' => '数据库账号ID。',
'type' => 'string',
'example' => '3',
],
'DatabaseAccountName' => [
'description' => '数据库账号名称。',
'type' => 'string',
'example' => 'system',
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '2',
],
'HasPassword' => [
'description' => '数据库主机账户是否设置密码。',
'type' => 'string',
'example' => 'true',
],
'LoginAttribute' => [
'description' => '登录属性,Oracle类型数据库有返回值:'."\n"
."\n"
.'- **SERVICENAME**'."\n"
.'- **SID**',
'type' => 'string',
'example' => 'SID',
],
'ProtocolName' => [
'description' => '数据库账户的协议名称。',
'type' => 'string',
'example' => 'MySQL',
],
],
],
],
'RequestId' => [
'description' => '本次请求的ID。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的可运维数据库账户总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '5',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DatabaseAccounts\\": [\\n {\\n \\"DBName\\": \\"xe\\",\\n \\"DatabaseAccountId\\": \\"3\\",\\n \\"DatabaseAccountName\\": \\"system\\",\\n \\"DatabaseId\\": \\"2\\",\\n \\"HasPassword\\": \\"true\\",\\n \\"LoginAttribute\\": \\"SID\\",\\n \\"ProtocolName\\": \\"MySQL\\"\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 5\\n}","type":"json"}]',
'title' => '获取当前RAM用户已授权的数据库账户列表',
],
'GenerateAssetOperationToken' => [
'summary' => '您可以通过该接口申请主机或数据库运维令牌,并通过运维令牌运维资产。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'high',
'chargeType' => 'free',
'abilityTreeCode' => '204184',
'abilityTreeNodes' => [
'FEATUREbastionhostHPIB1A',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要申请运维令牌操作所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AssetType',
'in' => 'query',
'schema' => [
'description' => '指定要申请令牌的资产类型。取值:'."\n"
.'- **Host**:主机。'."\n"
.'- **Database**:数据库。',
'type' => 'string',
'required' => true,
'example' => 'Host',
],
],
[
'name' => 'AssetId',
'in' => 'query',
'schema' => [
'description' => '需要申请运维令牌的资产ID。',
'type' => 'string',
'required' => true,
'example' => '11',
],
],
[
'name' => 'AssetAccountId',
'in' => 'query',
'schema' => [
'description' => '申请运维令牌的资产账户ID。'."\n"
.'> AssetAccountId和AssetAccountName需要至少指定一个,当同时指定时,优先使用AssetAccountId。',
'type' => 'string',
'required' => false,
'example' => '2',
],
],
[
'name' => 'AssetAccountName',
'in' => 'query',
'schema' => [
'description' => '主机账号名,当为自定义账号时,填写真实账户名。'."\n"
."\n"
.'> 当AssetAccountId和AssetAccountName同时指定时,优先使用AssetAccountId。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
],
[
'name' => 'AssetAccountPassword',
'in' => 'query',
'schema' => [
'description' => 'base64后的密码。当为自定义账号申请运维令牌时必填。',
'type' => 'string',
'required' => false,
'example' => 'dGVzdHBhc3N3b3Jk',
],
],
[
'name' => 'AssetAccountProtocolName',
'in' => 'query',
'schema' => [
'description' => '协议名称。取值:'."\n"
."\n"
.'- **SSH**'."\n"
.'- **RDP**'."\n"
.'- **Oracle**'."\n"
.'- **PostgreSQL**'."\n"
.'- **MySQL**'."\n"
.'- **SQLServer**',
'type' => 'string',
'required' => false,
'example' => 'SSH',
],
],
[
'name' => 'OperationMode',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '运维登录方式。取值:'."\n"
.'- **WebToken**:获取运维令牌。'."\n"
.'- **Sso**:本地客户端登录。'."\n"
.'> 仅支持V3.2.44及以上版本使用,为空时默认取值为WebToken。',
'type' => 'string',
'required' => false,
'example' => 'Sso',
'default' => 'WebToken',
'enum' => [
'Sso',
'WebToken',
'WebTerminal',
],
],
],
[
'name' => 'LoginAttribute',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '登录属性,当OperationMode为Sso且账户为Oracle类型自定义账户时必须指定,取值:'."\n"
.'- **SERVICENAME**'."\n"
.'- **SID**'."\n"
.'> 仅支持V3.2.44及以上版本使用。',
'type' => 'string',
'required' => false,
'example' => 'SID',
'enum' => [
'SID',
'SERVICENAME',
],
],
],
[
'name' => 'DatabaseSchema',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => [
'description' => '数据库名。当OperationMode为Sso且AssetAccountProtocolName为PostgreSQL或Oracle,且为自定义账户时,DatabaseSchema为必填。'."\n"
.'> 仅支持V3.2.44及以上版本使用。',
'type' => 'string',
'required' => false,
'example' => 'orcl',
],
],
[
'name' => 'SsoClient',
'in' => 'query',
'schema' => [
'description' => 'linux资产运维需打开的本地客户端类型。当OperationMode为Sso且资产协议为SSH时必传。取值:'."\n"
.'- **ssh**:打开SSH协议客户端,以SSH权限进行运维。'."\n"
.'- **sftp**:打开SFTP协议客户端,以SFTP权限进行运维。'."\n"
.'> 仅支持V3.2.44及以上版本使用。',
'type' => 'string',
'required' => false,
'example' => 'ssh',
'enum' => [
'ssh',
'sftp',
],
],
],
[
'name' => 'OperationNote',
'in' => 'query',
'schema' => [
'description' => '登录备注。当管理员在控制策略中开启了登录备注时为必填。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AssetOperationToken' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'CountLeft' => [
'description' => '运维令牌剩余可使用的次数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
'ExpireTime' => [
'description' => '运维令牌过期时间。时间戳格式。',
'type' => 'integer',
'format' => 'int64',
'example' => '1709110797',
],
'HasCountLimit' => [
'description' => '是否有使用次数限制.',
'type' => 'boolean',
'example' => 'true',
],
'MaxRenewCount' => [
'description' => '最大续期次数,0表示不可续期。',
'type' => 'integer',
'format' => 'int64',
'example' => '10',
],
'RenewCount' => [
'description' => '已经续期的次数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
'Token' => [
'description' => '申请的运维令牌。',
'type' => 'string',
'example' => 'NmYyMmEzNmMwYzljNGY******',
],
'TokenId' => [
'description' => '运维令牌ID。',
'type' => 'string',
'example' => '1',
],
'SsoUrl' => [
'description' => '单点登录链接。',
'type' => 'string',
'example' => 'sso://eyJOT0RFX0NPTU1PTiI6eyJNb2R******',
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"AssetOperationToken\\": {\\n \\"CountLeft\\": 1,\\n \\"ExpireTime\\": 1709110797,\\n \\"HasCountLimit\\": true,\\n \\"MaxRenewCount\\": 10,\\n \\"RenewCount\\": 1,\\n \\"Token\\": \\"NmYyMmEzNmMwYzljNGY******\\",\\n \\"TokenId\\": \\"1\\",\\n \\"SsoUrl\\": \\"sso://eyJOT0RFX0NPTU1PTiI6eyJNb2R******\\"\\n },\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '申请运维令牌',
],
'RenewAssetOperationToken' => [
'summary' => '您可以通过该接口续期运维令牌,单次可将运维令牌续期1小时。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostHPIB1A',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'TokenId',
'in' => 'query',
'schema' => [
'description' => '要续期的运维令牌ID。'."\n"
.'> 您可以调用[GenerateAssetOperationToken](~~2758861~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => 'NmYyMmEzNmMwYzljNGYxMjh******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '续期运维令牌',
],
'CreateOperationTicket' => [
'summary' => '管理员配置控制策略时开启了运维审批时,运维人员需要先创建运维申请且管理员审批通过后才能进行运维。',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '245215',
'abilityTreeNodes' => [
'FEATUREbastionhostHPIB1A',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AssetId',
'in' => 'query',
'schema' => [
'description' => '需要申请运维的资产ID。'."\n"
.'> 您可以调用[ListOperationDatabases](~~2758856~~)和[ListOperationHosts](~~2758857~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'ProtocolName',
'in' => 'query',
'schema' => [
'description' => '指定要申请运维的协议名称。取值:'."\n"
.'- SSH'."\n"
.'- RDP'."\n"
.'- MySQL'."\n"
.'- PostgreSQL'."\n"
.'- Oracle'."\n"
.'- SQLServer',
'type' => 'string',
'required' => true,
'example' => 'SSH',
],
],
[
'name' => 'AssetAccountName',
'in' => 'query',
'schema' => [
'description' => '指定要申请运维的资产账户登录名。',
'type' => 'string',
'required' => true,
'example' => 'root',
],
],
[
'name' => 'IsOneTimeEffect',
'in' => 'query',
'schema' => [
'description' => '申请登录次数。取值:'."\n"
.'- **true**:在有效期内仅登录一次。'."\n"
.'- **false**:在有效期内不限制登录次数。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'EffectStartTime',
'in' => 'query',
'schema' => [
'description' => '申请登录的有效期开始时间。(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1685600242',
],
],
[
'name' => 'EffectEndTime',
'in' => 'query',
'schema' => [
'description' => '申请登录的有效期结束时间。(秒,时间戳格式)'."\n"
.'> 申请登录的有效期结束时间需要晚于申请登录的有效期开始时间',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1679393152',
],
],
[
'name' => 'ApproveComment',
'in' => 'query',
'schema' => [
'description' => '申请单备注。',
'type' => 'string',
'required' => true,
'example' => 'Comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'OperationTicketId' => [
'description' => '运维申请单ID。',
'type' => 'string',
'example' => '2',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '0ECCC399-4D35-48A7-8379-5C6180E66235',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"OperationTicketId\\": \\"2\\",\\n \\"RequestId\\": \\"0ECCC399-4D35-48A7-8379-5C6180E66235\\"\\n}","type":"json"}]',
'title' => '创建运维申请(仅支持V3.2.44及以上版本使用)',
],
'CreateRule' => [
'summary' => '通过创建授权规则,按需求为多个用户批量授权资产,以及设置这些用户访问资产的有效期。授权规则功能不仅可以提升管理用户和资产的效率,还可以对用户访问资产的时间加以控制。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-5yd2ymfsa0e',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '授权规则名称。最大128字符。',
'type' => 'string',
'required' => true,
'example' => 'rule',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '授权规则备注。最大500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
[
'name' => 'EffectiveStartTime',
'in' => 'query',
'schema' => [
'description' => '授权规则有效期开始时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1669630029',
],
],
[
'name' => 'EffectiveEndTime',
'in' => 'query',
'schema' => [
'description' => '授权规则有效期结束时间(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1672502400',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '用户ID数组。',
'type' => 'array',
'items' => [
'description' => '用户ID。'."\n"
.'> 您可以调用[ListUsers](~~204522~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
[
'name' => 'UserGroupIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '用户组ID数组。',
'type' => 'array',
'items' => [
'description' => '用户组ID。'."\n"
.'> 您可以调用[ListUserGroups](~~204509~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
[
'name' => 'Hosts',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '主机信息。',
'type' => 'array',
'items' => [
'description' => '要授权的主机ID与主机账户ID。',
'type' => 'object',
'properties' => [
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'HostAccountIds' => [
'description' => '主机账户ID数组。',
'type' => 'array',
'items' => [
'description' => '主机账户ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '数据库信息。',
'type' => 'array',
'items' => [
'description' => '要授权的数据库实例ID与数据库账户ID。',
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'DatabaseAccountIds' => [
'description' => '数据库账户ID数组。',
'type' => 'array',
'items' => [
'description' => '数据库账户ID。',
'type' => 'string',
'required' => false,
'example' => '4',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '要授权的资产组信息。',
'type' => 'array',
'items' => [
'description' => '要授权的资产组。',
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'required' => false,
'example' => '3',
],
'HostAccountNames' => [
'description' => '资产账户名数组。',
'type' => 'array',
'items' => [
'description' => '资产账户名。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'BFA818E3-0A53-51F4-8DB5-AF2A62A6D042',
],
'RuleId' => [
'description' => '授权规则ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'RuleAlreadyExists',
'errorMessage' => 'The rule already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"BFA818E3-0A53-51F4-8DB5-AF2A62A6D042\\",\\n \\"RuleId\\": \\"1\\"\\n}","type":"json"}]',
'title' => '创建授权规则',
'requestParamsDescription' => '### Hosts 数组'."\n"
.'#### Host结构'."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'|---|---|---|'."\n"
.'| HostId | string | 主机ID |'."\n"
.'| HostAccountIds | array[string] | 主机账号ID数组 |'."\n"
."\n"
.'### HostGroups 数组'."\n"
.'#### HostGroup结构'."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'|---|---|---|'."\n"
.'| HostGroupId | string | 主机组ID |'."\n"
.'| HostAccountNames | array[string] | 主机账号名数组 |'."\n"
."\n"
.'#### AssetGroup结构'."\n"
.'| 字段 | 类型 | 描述 |'."\n"
.'|---|---|---|'."\n"
.'| AssetGroupId | string | 资产组ID |'."\n"
.'| AssetAccountNames | array[string] | 资产账号名数组 |',
],
'ModifyRule' => [
'summary' => '修改授权规则基本信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要修改的授权规则所在堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zmb2y9ydw08',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要修改授权规则所在的堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '要修改的授权规则ID。',
'type' => 'string',
'required' => true,
'example' => '68',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '修改后的授权规则名称。长度为1~128个字符,不能以特殊字符开头,只可包含特殊字符中的半角句号()、下划线(_)、短划线(-)、半角单引号(\')以及空格。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '指定修改后授权规则的备注信息,最多支持500字符。',
'type' => 'string',
'required' => false,
'example' => 'TEST',
],
],
[
'name' => 'EffectiveStartTime',
'in' => 'query',
'schema' => [
'description' => '修改后授权规则有效期开始时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1669630029',
],
],
[
'name' => 'EffectiveEndTime',
'in' => 'query',
'schema' => [
'description' => '修改后授权规则有效期结束时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1672502400',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '修改后授权规则关联的用户ID列表。',
'type' => 'array',
'items' => [
'description' => '修改后授权规则关联的用户ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
[
'name' => 'UserGroupIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '修改后授权规则关联的用户组ID列表。',
'type' => 'array',
'items' => [
'description' => '修改后授权规则关联的用户组ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
[
'name' => 'Hosts',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '修改后授权规则关联的主机ID与主机账户ID数组。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'HostAccountIds' => [
'description' => '主机账户ID列表。',
'type' => 'array',
'items' => [
'description' => '主机账户ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '修改后授权的数据库实例和数据库账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'DatabaseAccountIds' => [
'description' => '数据库账户ID列表。',
'type' => 'array',
'items' => [
'description' => '数据库账户ID。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '修改后授权的资产组和账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'required' => false,
'example' => '1'."\n",
],
'HostAccountNames' => [
'description' => '资产账户名列表。',
'type' => 'array',
'items' => [
'description' => '资产账户名。',
'type' => 'string',
'required' => false,
'example' => 'root',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '67EB57AD-5C83-537B-B2A1-6082798965F0',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'RuleAlreadyExists',
'errorMessage' => 'The rule already exists.',
],
],
404 => [
[
'errorCode' => 'RuleNotFound',
'errorMessage' => 'The rule is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"67EB57AD-5C83-537B-B2A1-6082798965F0\\"\\n}","type":"json"}]',
'title' => '修改授权规则基本信息',
],
'GetRule' => [
'summary' => '获取指定授权规则详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-wwo35essw07',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-beijing',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的授权规则ID。'."\n"
.'> 您可以调用[ListRules](~~2758868~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '18',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Rule' => [
'description' => '授权规则信息。',
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '授权规则备注。',
'type' => 'string',
'example' => 'comment',
],
'Databases' => [
'description' => '已授权的数据库信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseAccounts' => [
'description' => '已授权数据库账户信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseAccountId' => [
'description' => '已授权的数据库账户ID。',
'type' => 'string',
'example' => '5',
],
],
],
],
'DatabaseId' => [
'description' => '已授权的数据库实例ID。',
'type' => 'string',
'example' => '2',
],
],
],
],
'EffectiveEndTime' => [
'description' => '授权规则有效期结束时间(秒,时间戳格式)。',
'type' => 'string',
'example' => '1698720972',
],
'EffectiveStartTime' => [
'description' => '授权规则有效期开始时间(秒,时间戳格式)。',
'type' => 'string',
'example' => '1687140883',
],
'HostGroups' => [
'description' => '已授权的资产组列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccountNames' => [
'description' => '已授权资产账户信息。',
'type' => 'array',
'items' => [
'description' => '资产组中已授权的账户名。',
'type' => 'string',
'example' => 'root',
],
],
'HostGroupId' => [
'description' => '已授权的资产组ID。',
'type' => 'string',
'example' => '7',
],
],
],
],
'Hosts' => [
'description' => '已授权的主机信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccounts' => [
'description' => '已授权的主机账户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccountId' => [
'description' => '已授权的主机账户ID。',
'type' => 'string',
'example' => '9',
],
],
],
],
'HostId' => [
'description' => '已授权的主机ID。',
'type' => 'string',
'example' => '52',
],
],
],
],
'RuleId' => [
'description' => '授权规则ID。',
'type' => 'string',
'example' => '3',
],
'RuleName' => [
'description' => '授权规则名称。',
'type' => 'string',
'example' => 'rule',
],
'UserGroups' => [
'description' => '已授权的用户组列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'UserGroupId' => [
'description' => '已授权的用户组ID。',
'type' => 'string',
'example' => '2',
],
],
],
],
'Users' => [
'description' => '已授权的用户列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'UserId' => [
'description' => '已授权的用户ID。',
'type' => 'string',
'example' => '3',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'RuleNotFound',
'errorMessage' => 'The rule is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Rule\\": {\\n \\"Comment\\": \\"comment\\",\\n \\"Databases\\": [\\n {\\n \\"DatabaseAccounts\\": [\\n {\\n \\"DatabaseAccountId\\": \\"5\\"\\n }\\n ],\\n \\"DatabaseId\\": \\"2\\"\\n }\\n ],\\n \\"EffectiveEndTime\\": \\"1698720972\\",\\n \\"EffectiveStartTime\\": \\"1687140883\\",\\n \\"HostGroups\\": [\\n {\\n \\"HostAccountNames\\": [\\n \\"root\\"\\n ],\\n \\"HostGroupId\\": \\"7\\"\\n }\\n ],\\n \\"Hosts\\": [\\n {\\n \\"HostAccounts\\": [\\n {\\n \\"HostAccountId\\": \\"9\\"\\n }\\n ],\\n \\"HostId\\": \\"52\\"\\n }\\n ],\\n \\"RuleId\\": \\"3\\",\\n \\"RuleName\\": \\"rule\\",\\n \\"UserGroups\\": [\\n {\\n \\"UserGroupId\\": \\"2\\"\\n }\\n ],\\n \\"Users\\": [\\n {\\n \\"UserId\\": \\"3\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '获取指定授权规则详情',
],
'ListRules' => [
'summary' => '获取指定堡垒机下授权规则列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-5yd34ol020a',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的授权规则名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => 'rule',
],
],
[
'name' => 'RuleState',
'in' => 'query',
'schema' => [
'description' => '指定要查询的授权规则状态。'."\n"
.'- **Enabled**:正常'."\n"
.'- **Disabled**:已禁用',
'type' => 'string',
'required' => false,
'example' => 'Enabled',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Rules' => [
'description' => '查询到的授权规则列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '授权规则的备注信息。',
'type' => 'string',
'example' => 'comment',
],
'EffectiveEndTime' => [
'description' => '授权规则有效期结束时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'example' => '1709258400',
],
'EffectiveStartTime' => [
'description' => '授权规则有效期开始时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'example' => '1685499134',
],
'RuleId' => [
'description' => '授权规则ID。',
'type' => 'string',
'example' => '13',
],
'RuleName' => [
'description' => '授权规则名称。',
'type' => 'string',
'example' => 'rule',
],
'RuleState' => [
'description' => '授权规则状态。'."\n"
.'- **Enabled**:正常'."\n"
.'- **Disabled**:已禁用',
'type' => 'string',
'example' => 'Enabled',
],
],
],
],
'TotalCount' => [
'description' => '查询到的授权规则总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Rules\\": [\\n {\\n \\"Comment\\": \\"comment\\",\\n \\"EffectiveEndTime\\": 1709258400,\\n \\"EffectiveStartTime\\": 1685499134,\\n \\"RuleId\\": \\"13\\",\\n \\"RuleName\\": \\"rule\\",\\n \\"RuleState\\": \\"Enabled\\"\\n }\\n ],\\n \\"TotalCount\\": 1\\n}","type":"json"}]',
'title' => '获取指定堡垒机下授权规则列表',
],
'EnableRule' => [
'summary' => '启用授权规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1ghxxxxx',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '要启用的授权规则ID。'."\n"
.'> 您可以调用[ListRules](~~2758868~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '4F6C075F-FC86-476E-943B-097BD4E12948',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'RuleNotFound',
'errorMessage' => 'The rule is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"4F6C075F-FC86-476E-943B-097BD4E12948\\"\\n}","type":"json"}]',
'title' => '启用授权规则',
],
'DisableRule' => [
'summary' => '禁用授权规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1gh****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'>地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '要禁用的授权规则ID。'."\n"
.'> 您可以调用[ListRules](~~2758868~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '98DBE5C2-7D7A-5393-9E5A-71074336D33B',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'RuleNotFound',
'errorMessage' => 'The rule is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"98DBE5C2-7D7A-5393-9E5A-71074336D33B\\"\\n}","type":"json"}]',
'title' => '禁用授权规则',
],
'DeleteRule' => [
'summary' => '删除单个授权规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost19BKK2',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要删除的授权规则所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要删除授权规则的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '要删除的授权规则ID。'."\n"
.'> 您可以调用[ListRules](~~2758868~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '5',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'RuleNotFound',
'errorMessage' => 'The rule is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '删除单个授权规则',
],
'CreatePolicy' => [
'summary' => '通过设置命令控制、命令审批、协议控制、访问控制策略等,对运维行为进行管控,有效防止用户进行高危命令操作或误操作,以保障运维安全。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要新建控制策略的堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-20p364c1w0g',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定需创建控制策略所在的堡垒机的地域ID。'."\n"
.'>地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-shanghai',
],
],
[
'name' => 'PolicyName',
'in' => 'query',
'schema' => [
'description' => '指定控制策略名称。最大128字符。',
'type' => 'string',
'required' => true,
'example' => 'policytest',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '控制策略的备注。最大500字符。',
'type' => 'string',
'required' => false,
'example' => 'comment',
],
],
[
'name' => 'Priority',
'in' => 'query',
'schema' => [
'description' => '控制策略的优先级。'."\n"
."\n"
.'- 优先级可设置范围:1~100。默认值为1,即最高优先级。'."\n"
.'- 不同控制策略可以设置相同的优先级。多个控制策略的优先级相同时,最新创建的策略优先级最高。在一条策略中,若命令控制和命令审批里设置有相同的命令,则优先级从高到低是拒绝、允许、审批。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'PolicyId' => [
'description' => '控制策略ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '7E68165E-1191-5CC2-B54B-5EF7390A5400',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'PolicyAlreadyExists',
'errorMessage' => 'The policy already exists.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PolicyId\\": \\"1\\",\\n \\"RequestId\\": \\"7E68165E-1191-5CC2-B54B-5EF7390A5400\\"\\n}","type":"json"}]',
'title' => '创建控制策略',
],
'ModifyPolicy' => [
'summary' => '修改控制策略基本信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的控制策略所在堡垒机的实例id。'."\n"
.'>您可以调用[describeinstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-09k1u8mv501',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的控制策略所在堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的控制策略的ID。',
'type' => 'string',
'required' => true,
'example' => '7',
],
],
[
'name' => 'PolicyName',
'in' => 'query',
'schema' => [
'description' => '修改后的控制策略名称。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '修改后的控制策略备注。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'Priority',
'in' => 'query',
'schema' => [
'description' => '指定修改后的控制策略的优先级,1~100,数字越小优先级越高。默认 1。',
'type' => 'string',
'required' => false,
'example' => '3',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'A34F9731-A4EA-5D1D-8445-BAEF782BFFE6',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
[
'errorCode' => 'PolicyAlreadyExists',
'errorMessage' => 'The policy already exists.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A34F9731-A4EA-5D1D-8445-BAEF782BFFE6\\"\\n}","type":"json"}]',
'title' => '修改控制策略基本信息',
],
'GetPolicy' => [
'summary' => '获取指定控制策略详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zvp2d3syb0g',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略ID。'."\n"
.'> 您可以调用[ListPolicies ](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Policy' => [
'description' => '控制策略详细信息。',
'type' => 'object',
'properties' => [
'AccessTimeRangeConfig' => [
'description' => '登录时段限制详情。',
'type' => 'object',
'properties' => [
'EffectiveTime' => [
'description' => '允许登录的时段详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Days' => [
'description' => '允许登录的日期。',
'type' => 'array',
'items' => [
'description' => '允许登录的星期日期。'."\n"
."\n"
.'- **1**:周一'."\n"
.'- **2**:周二'."\n"
.'- **3**:周三'."\n"
.'- **4**:周四'."\n"
.'- **5**:周五'."\n"
.'- **6**:周六'."\n"
.'- **7**:周日',
'type' => 'string',
'example' => '[2]',
],
],
'Hours' => [
'description' => '允许登录的时间。',
'type' => 'array',
'items' => [
'description' => '每天允许登录的时间。取值:'."\n"
."\n"
.'- **0**:0:00到1:00。'."\n"
.'- **1**:1:00到2:00。'."\n"
.'- **2**:2:00到3:00。'."\n"
.'- **3**:3:00到4:00。'."\n"
.'- **4**:4:00到5:00。'."\n"
.'- **5**:5:00到6:00。'."\n"
.'- **6**:6:00到7:00。'."\n"
.'- **7**:7:00到8:00。'."\n"
.'- **8**:8:00到9:00。'."\n"
.'- **9**:9:00到10:00。'."\n"
.'- **10**:10:00到11:00。'."\n"
.'- **11**:11:00到12:00。'."\n"
.'- **12**:12:00到13:00。'."\n"
.'- **13**:13:00到14:00。'."\n"
.'- **14**:14:00到15:00。'."\n"
.'- **15**:15:00到16:00。'."\n"
.'- **16**:16:00到17:00。'."\n"
.'- **17**:17:00到18:00。'."\n"
.'- **18**:18:00到19:00。'."\n"
.'- **19**:19:00到20:00。'."\n"
.'- **20**:20:00到21:00。'."\n"
.'- **21**:21:00到22:00。'."\n"
.'- **22**:22:00到23:00。'."\n"
.'- **23**:23:00到0:00。',
'type' => 'string',
'example' => '[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]',
],
],
],
],
],
],
],
'CommandConfig' => [
'description' => '命令策略详情。',
'type' => 'object',
'properties' => [
'Approval' => [
'description' => '命令审批配置详情。',
'type' => 'object',
'properties' => [
'Commands' => [
'description' => '命令列表数组。',
'type' => 'array',
'items' => [
'description' => '已配置需要审批的命令详情。',
'type' => 'string',
'example' => 'ls',
],
],
],
],
'Deny' => [
'description' => '命令控制配置详情。',
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '命令控制类型。取值:'."\n"
."\n"
.'- white:白名单模式。'."\n"
.'- black:黑名单模式。',
'type' => 'string',
'example' => 'black',
],
'Commands' => [
'description' => '命令列表数组。',
'type' => 'array',
'items' => [
'description' => '命令详情。',
'type' => 'string',
'example' => 'ls',
],
],
],
],
],
],
'Comment' => [
'description' => '控制策略的备注。',
'type' => 'string',
'example' => 'comment',
],
'IPAclConfig' => [
'description' => '来源IP限制配置详情。',
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '来源IP限制模式。取值:'."\n"
."\n"
.'- white:白名单模式。'."\n"
.'- black:黑名单模式。',
'type' => 'string',
'example' => 'black',
],
'IPs' => [
'description' => '限制登录的IP信息。',
'type' => 'array',
'items' => [
'description' => '限制的IP列表。',
'type' => 'string',
'example' => '[10.10.**.**]',
],
],
],
],
'PolicyName' => [
'description' => '控制策略名称。',
'type' => 'string',
'example' => 'test',
],
'PolicyId' => [
'description' => '控制策略ID。',
'type' => 'string',
'example' => '3',
],
'Priority' => [
'description' => '控制策略的优先级,数字越小优先级越高。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
'ProtocolConfig' => [
'description' => '协议控制详情。',
'type' => 'object',
'properties' => [
'RDP' => [
'description' => 'RDP选项配置详情。',
'type' => 'object',
'properties' => [
'ClipboardDownload' => [
'description' => '粘贴板下载配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'ClipboardUpload' => [
'description' => '粘贴板上传配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'DiskRedirection' => [
'description' => '驱动器/打印机映射配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'RecordKeyboard' => [
'description' => '键盘记录配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
],
],
'SSH' => [
'description' => 'SSH和SFTP选项配置详情。',
'type' => 'object',
'properties' => [
'ExecCommand' => [
'description' => '远程执行命令配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPChannel' => [
'description' => 'SFTP通道配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPDownloadFile' => [
'description' => 'SFTP选项文件下载配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPMkdir' => [
'description' => 'SFTP选项创建文件夹配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPRemoveFile' => [
'description' => 'SFTP选项删除文件配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPRenameFile' => [
'description' => 'SFTP选项文件重命名配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPRmdir' => [
'description' => 'SFTP选项删除文件夹配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SFTPUploadFile' => [
'description' => 'SFTP选项文件上传配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'SSHChannel' => [
'description' => 'SSH通道配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
'X11Forwarding' => [
'description' => 'X11转发配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用',
'type' => 'string',
'example' => 'Enable',
],
],
],
],
],
'ApprovalConfig' => [
'description' => '运维审批配置详情。',
'type' => 'object',
'properties' => [
'SwitchStatus' => [
'description' => '控制策略中的运维审批配置。取值:'."\n"
."\n"
.'- **On**:开启运维审批'."\n"
.'- **Off**:关闭运维审批',
'type' => 'string',
'example' => 'Off',
],
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '0D29F2C0-8B4B-5861-9474-F3F23D25594B',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Policy\\": {\\n \\"AccessTimeRangeConfig\\": {\\n \\"EffectiveTime\\": [\\n {\\n \\"Days\\": [\\n \\"[2]\\"\\n ],\\n \\"Hours\\": [\\n \\"[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]\\"\\n ]\\n }\\n ]\\n },\\n \\"CommandConfig\\": {\\n \\"Approval\\": {\\n \\"Commands\\": [\\n \\"ls\\"\\n ]\\n },\\n \\"Deny\\": {\\n \\"AclType\\": \\"black\\",\\n \\"Commands\\": [\\n \\"ls\\"\\n ]\\n }\\n },\\n \\"Comment\\": \\"comment\\",\\n \\"IPAclConfig\\": {\\n \\"AclType\\": \\"black\\",\\n \\"IPs\\": [\\n \\"[10.10.**.**]\\"\\n ]\\n },\\n \\"PolicyName\\": \\"test\\",\\n \\"PolicyId\\": \\"3\\",\\n \\"Priority\\": 1,\\n \\"ProtocolConfig\\": {\\n \\"RDP\\": {\\n \\"ClipboardDownload\\": \\"Enable\\",\\n \\"ClipboardUpload\\": \\"Enable\\",\\n \\"DiskRedirection\\": \\"Enable\\",\\n \\"RecordKeyboard\\": \\"Enable\\"\\n },\\n \\"SSH\\": {\\n \\"ExecCommand\\": \\"Enable\\",\\n \\"SFTPChannel\\": \\"Enable\\",\\n \\"SFTPDownloadFile\\": \\"Enable\\",\\n \\"SFTPMkdir\\": \\"Enable\\",\\n \\"SFTPRemoveFile\\": \\"Enable\\",\\n \\"SFTPRenameFile\\": \\"Enable\\",\\n \\"SFTPRmdir\\": \\"Enable\\",\\n \\"SFTPUploadFile\\": \\"Enable\\",\\n \\"SSHChannel\\": \\"Enable\\",\\n \\"X11Forwarding\\": \\"Enable\\"\\n }\\n },\\n \\"ApprovalConfig\\": {\\n \\"SwitchStatus\\": \\"Off\\"\\n }\\n },\\n \\"RequestId\\": \\"0D29F2C0-8B4B-5861-9474-F3F23D25594B\\"\\n}","type":"json"}]',
'title' => '获取指定控制策略详情',
],
'ListPolicies' => [
'summary' => '获取控制策略列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-5yd393wzk08',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为100。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'PolicyName',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略名称。仅支持精确查询。',
'type' => 'string',
'required' => false,
'example' => '123',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Policies' => [
'description' => '控制策略列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Comment' => [
'description' => '控制策略备注。',
'type' => 'string',
'example' => 'Comment ',
],
'PolicyId' => [
'description' => '控制策略ID。',
'type' => 'string',
'example' => '2',
],
'PolicyName' => [
'description' => '控制策略名称。',
'type' => 'string',
'example' => 'test',
],
'Priority' => [
'description' => '控制策略的优先级,数字越小优先级越高。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的控制策略总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '10',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Policies\\": [\\n {\\n \\"Comment\\": \\"Comment\\\\t\\",\\n \\"PolicyId\\": \\"2\\",\\n \\"PolicyName\\": \\"test\\",\\n \\"Priority\\": 1\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 10\\n}","type":"json"}]',
'title' => '获取控制策略列表',
],
'GetPolicyAssetScope' => [
'summary' => '获取指定控制策略生效资产范围。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '控制策略ID。'."\n"
."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '7',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AssetScope' => [
'description' => '控制策略生效的资产范围。',
'type' => 'object',
'properties' => [
'Databases' => [
'description' => '控制策略生效的数据库资产列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AccountScopeType' => [
'description' => '控制策略生效的数据库账户范围。取值:'."\n"
."\n"
.'- **All**:针对数据库中的所有账户生效'."\n"
.'- **AccountId**:针对数据库中指定的账户生效',
'type' => 'string',
'example' => 'AccountId',
],
'DatabaseAccountIds' => [
'description' => '控制策略生效的数据库账户ID列表。',
'type' => 'array',
'items' => [
'description' => '数据库账户ID。',
'type' => 'string',
'example' => '3'."\n",
],
],
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'example' => '17',
],
],
],
],
'HostGroups' => [
'description' => '控制策略生效的资产组范围。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AccountNames' => [
'description' => '控制策略生效的资产账户范围。',
'type' => 'array',
'items' => [
'description' => '资产账户名。',
'type' => 'string',
'example' => 'root',
],
],
'AccountScopeType' => [
'description' => '控制策略生效的资产账户范围。取值:'."\n"
."\n"
.'- **All**:针对资产组中的所有账户生效'."\n"
.'- **AccountName**:针对资产组中指定的账户生效',
'type' => 'string',
'example' => 'All',
],
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'example' => '4',
],
],
],
],
'Hosts' => [
'description' => '控制策略生效的主机范围。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AccountScopeType' => [
'description' => '控制策略生效的主机账户范围。取值:'."\n"
."\n"
.'- **All**:针对主机中的所有账户生效'."\n"
.'- **AccountId**:针对主机中指定的账户生效',
'type' => 'string',
'example' => 'All',
],
'HostAccountIds' => [
'description' => '控制策略生效的主机账户范围。',
'type' => 'array',
'items' => [
'description' => '主机账户ID列表。',
'type' => 'string',
'example' => '3',
],
],
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
'ScopeType' => [
'description' => '控制策略生效的资产范围。'."\n"
."\n"
.'> - 返回**All**时表示控制策略针对所有资产生效。'."\n"
.'> - 返回空值表示策略对指定资产生效,具体生效范围为Databases、HostGroups和Hosts的返回值。',
'type' => 'string',
'example' => 'All',
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"AssetScope\\": {\\n \\"Databases\\": [\\n {\\n \\"AccountScopeType\\": \\"AccountId\\",\\n \\"DatabaseAccountIds\\": [\\n \\"3\\\\n\\"\\n ],\\n \\"DatabaseId\\": \\"17\\"\\n }\\n ],\\n \\"HostGroups\\": [\\n {\\n \\"AccountNames\\": [\\n \\"root\\"\\n ],\\n \\"AccountScopeType\\": \\"All\\",\\n \\"HostGroupId\\": \\"4\\"\\n }\\n ],\\n \\"Hosts\\": [\\n {\\n \\"AccountScopeType\\": \\"All\\",\\n \\"HostAccountIds\\": [\\n \\"3\\"\\n ],\\n \\"HostId\\": \\"1\\"\\n }\\n ],\\n \\"ScopeType\\": \\"All\\"\\n },\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => ' 获取指定控制策略生效资产范围',
],
'SetPolicyProtocolConfig' => [
'summary' => '配置控制策略的RDP选项、SSH选项以及SFTP选项。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的控制策略的ID。'."\n"
."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '61',
],
],
[
'name' => 'ProtocolConfig',
'in' => 'query',
'style' => 'json',
'schema' => [
'description' => '协议控制配置。',
'type' => 'object',
'properties' => [
'RDP' => [
'description' => 'RDP选项配置详情。',
'type' => 'object',
'properties' => [
'RecordKeyboard' => [
'description' => '键盘记录配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'DiskRedirection' => [
'description' => '驱动器/打印机映射配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'ClipboardDownload' => [
'description' => '粘贴板下载配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'ClipboardUpload' => [
'description' => '粘贴板上传配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'DiskRedirectionUpload' => [
'title' => '允许磁盘上传',
'type' => 'string',
'required' => false,
'enum' => [
'Enable',
'Disable',
],
'example' => 'Enable',
],
'DiskRedirectionDownload' => [
'title' => '允许磁盘下载',
'type' => 'string',
'required' => false,
'enum' => [
'Enable',
'Disable',
],
'example' => 'Enable',
],
],
'required' => false,
],
'SSH' => [
'description' => 'SSH和SFTP选项配置详情。',
'type' => 'object',
'properties' => [
'X11Forwarding' => [
'description' => 'X11转发配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPChannel' => [
'description' => 'SFTP通道配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
."\n"
.'> - 不填则默认设置为 Disable。'."\n"
.'> - SSH通道和SFTP通道必须至少有一项为Enable。'."\n"
.'> - 如果您为主机账户开启仅开启SFTP权限,请勿在控制策略里为该账户禁用SSH通道及SFTP通道,否则将无法通过堡垒机使用该主机账户访问目标服务器。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SSHChannel' => [
'description' => 'SSH通道配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
."\n"
.'> - 不填则默认设置为 Disable。'."\n"
.'> - SSH通道和SFTP通道必须至少有一项为Enable。SSH通道设置为Disable后,将无法通过SSH权限登录资产账户,请谨慎配置。'."\n"
.'> - 如果您为主机账户开启仅开启SFTP权限,请勿在控制策略里为该账户禁用SSH通道及SFTP通道,否则将无法通过堡垒机使用该主机账户访问目标服务器。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'ExecCommand' => [
'description' => '远程执行命令配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPUploadFile' => [
'description' => 'SFTP选项文件上传配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPDownloadFile' => [
'description' => 'SFTP选项文件下载配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPRemoveFile' => [
'description' => 'SFTP选项删除文件配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPRenameFile' => [
'description' => 'SFTP选项文件重命名配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPMkdir' => [
'description' => 'SFTP选项创建文件夹配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'SFTPRmdir' => [
'description' => 'SFTP选项删除文件夹配置。取值:'."\n"
."\n"
.'- Enable:启用'."\n"
.'- Disable:禁用'."\n"
.'> 不填则默认设置为 Disable。',
'type' => 'string',
'required' => false,
'example' => 'Enable',
'enum' => [
'Enable',
'Disable',
],
],
'AllowDirectTcp' => [
'title' => '允许 TCP 直连',
'type' => 'string',
'required' => false,
'enum' => [
'Enable',
'Disable',
],
'example' => 'Enable',
],
'AllowTcpForwarding' => [
'title' => '允许 TCP 转发',
'type' => 'string',
'required' => false,
'enum' => [
'Enable',
'Disable',
],
'example' => 'Enable',
],
],
'required' => false,
],
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '81500666-d7f5-4143-8329-0223cc738105',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"81500666-d7f5-4143-8329-0223cc738105\\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的协议控制配置',
],
'SetPolicyCommandConfig' => [
'summary' => '配置在指定策略生效用户和主机中,允许或禁止执行的命令,以及需要审批的命令。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-78v1ghxxxxx',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定需要修改的控制策略ID。'."\n"
."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '45',
],
],
[
'name' => 'CommandConfig',
'in' => 'query',
'style' => 'json',
'schema' => [
'description' => '命令控制配置。'."\n"
."\n"
.'> 仅适用于Linux主机。',
'type' => 'object',
'properties' => [
'Deny' => [
'description' => '命令控制配置。',
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '命令控制类型。取值:'."\n"
."\n"
.'- **black**:黑名单模式'."\n"
.'- **white**:白名单模式',
'type' => 'string',
'required' => true,
'example' => 'white',
'enum' => [
'black',
'white',
],
],
'Commands' => [
'description' => '命令列表。'."\n"
."\n"
.'> AclType 设置为 white 时,Commands 为必填。',
'type' => 'array',
'items' => [
'description' => '需要控制的命令列表。',
'type' => 'string',
'required' => true,
'example' => '["mkdir"]',
],
'required' => false,
],
],
'required' => true,
],
'Approval' => [
'description' => '命令审批配置。'."\n"
."\n"
.'> 命令审批对命令控制(白名单或黑名单)以外的命令生效。命令控制策略生效的优先级高于命令审批。',
'type' => 'object',
'properties' => [
'Commands' => [
'description' => '需要审批的命令列表。',
'type' => 'array',
'items' => [
'description' => '需要审批的命令列表。',
'type' => 'string',
'required' => false,
'example' => '["mkdir"]',
],
'required' => false,
],
],
'required' => false,
],
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '4F6C075F-FC86-476E-943B-097BD4E12948',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"4F6C075F-FC86-476E-943B-097BD4E12948\\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的命令控制配置',
],
'SetPolicyIPAclConfig' => [
'summary' => '配置来源IP是否可以访问当前策略生效的主机。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定需要修改的控制策略ID。'."\n"
."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '3',
],
],
[
'name' => 'IPAclConfig',
'in' => 'query',
'style' => 'json',
'schema' => [
'description' => '来源IP限制配置。',
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '来源IP限制模式。取值:'."\n"
."\n"
.'- **black**:黑名单模式'."\n"
.'- **white**:白名单模式',
'type' => 'string',
'required' => true,
'enumValueTitles' => [],
'example' => 'white',
'enum' => [
'black',
'white',
],
],
'IPs' => [
'description' => '来源IP限制列表。'."\n"
."\n"
.'> - AclType 设置为 white 时,IPs列表内容必填。'."\n"
.'> - AclType 设置为black 但暂不需要设置来源IP黑名单时,IPs请传空列表。',
'type' => 'array',
'items' => [
'description' => '来源IP限制列表。',
'type' => 'string',
'required' => true,
'example' => '1.1.1.1',
'pattern' => '^((25[0-5]|2[0-4]\\d|((1\\d{2})|([1-9]?\\d)))\\.){3}(25[0-5]|2[0-4]\\d|((1\\d{2})|([1-9]?\\d)))(\\s?-\\s?((25[0-5]|2[0-4]\\d|((1\\d{2})|([1-9]?\\d)))\\.){3}(25[0-5]|2[0-4]\\d|((1\\d{2})|([1-9]?\\d))))?$',
],
'required' => true,
],
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的访问控制配置',
],
'GetPolicyUserScope' => [
'summary' => '获取指定控制策略生效用户范围。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastion-xxxx-xx',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略所在堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定要查询的控制策略ID。'."\n"
."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'UserScope' => [
'description' => '控制策略生效的用户范围。',
'type' => 'object',
'properties' => [
'ScopeType' => [
'description' => '控制策略生效的用户范围。'."\n"
."\n"
.'> - 返回 **All** 时表示策略针对所有用户生效。'."\n"
.'> - 返回空值表示策略对指定用户生效,具体生效范围为UserGroupIds和UserIds的返回值。',
'type' => 'string',
'example' => 'All',
],
'UserGroupIds' => [
'description' => '控制策略生效的用户组范围。',
'type' => 'array',
'items' => [
'description' => '用户组ID。',
'type' => 'string',
'example' => '["1", "2", "3"]',
],
],
'UserIds' => [
'description' => '控制策略生效的用户范围。',
'type' => 'array',
'items' => [
'description' => '用户ID。',
'type' => 'string',
'example' => '["1", "2", "3"]',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"UserScope\\": {\\n \\"ScopeType\\": \\"All\\",\\n \\"UserGroupIds\\": [\\n \\"[\\\\\\"1\\\\\\", \\\\\\"2\\\\\\", \\\\\\"3\\\\\\"]\\"\\n ],\\n \\"UserIds\\": [\\n \\"[\\\\\\"1\\\\\\", \\\\\\"2\\\\\\", \\\\\\"3\\\\\\"]\\"\\n ]\\n }\\n}","type":"json"}]',
'title' => '获取指定控制策略生效用户范围',
],
'SetPolicyAccessTimeRangeConfig' => [
'summary' => '设置指定控制策略的登录时段限制配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '控制策略ID。'."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '13',
],
],
[
'name' => 'AccessTimeRangeConfig',
'in' => 'query',
'style' => 'json',
'schema' => [
'description' => '登录时段限制配置。',
'type' => 'object',
'properties' => [
'EffectiveTime' => [
'description' => '允许登录的时段详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Days' => [
'description' => '允许登录的星期日期。',
'type' => 'array',
'items' => [
'description' => '允许登录的星期日期。'."\n"
."\n"
.'- **1**:周一'."\n"
.'- **2**:周二'."\n"
.'- **3**:周三'."\n"
.'- **4**:周四'."\n"
.'- **5**:周五'."\n"
.'- **6**:周六'."\n"
.'- **7**:周日',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '[7]',
],
'required' => false,
],
'Hours' => [
'description' => '每天允许登录的时间。',
'type' => 'array',
'items' => [
'description' => '每天允许登录的时间。取值:'."\n"
."\n"
.'- **0**:0:00到1:00。'."\n"
.'- **1**:1:00到2:00。'."\n"
.'- **2**:2:00到3:00。'."\n"
.'- **3**:3:00到4:00。'."\n"
.'- **4**:4:00到5:00。'."\n"
.'- **5**:5:00到6:00。'."\n"
.'- **6**:6:00到7:00。'."\n"
.'- **7**:7:00到8:00。'."\n"
.'- **8**:8:00到9:00。'."\n"
.'- **9**:9:00到10:00。'."\n"
.'- **10**:10:00到11:00。'."\n"
.'- **11**:11:00到12:00。'."\n"
.'- **12**:12:00到13:00。'."\n"
.'- **13**:13:00到14:00。'."\n"
.'- **14**:14:00到15:00。'."\n"
.'- **15**:15:00到16:00。'."\n"
.'- **16**:16:00到17:00。'."\n"
.'- **17**:17:00到18:00。'."\n"
.'- **18**:18:00到19:00。'."\n"
.'- **19**:19:00到20:00。'."\n"
.'- **20**:20:00到21:00。'."\n"
.'- **21**:21:00到22:00。'."\n"
.'- **22**:22:00到23:00。'."\n"
.'- **23**:23:00到0:00。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '[9, 14]',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的登录时段限制配置',
],
'SetPolicyAssetScope' => [
'summary' => '设置指定控制策略的资产生效范围。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定要修改的控制策略的ID。'."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '7',
],
],
[
'name' => 'ScopeType',
'in' => 'query',
'schema' => [
'description' => '控制策略生效的资产范围。取值:'."\n"
.'- **All**:针对所有资产生效'."\n"
.'- **Host**:针对已选择的主机生效'."\n"
.'- **Database**:针对已选择的数据库生效'."\n"
.'- **HostGroup**:针对已选择的资产组生效',
'type' => 'string',
'required' => true,
'example' => 'All',
],
],
[
'name' => 'Hosts',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '控制策略生效的主机范围。'."\n"
."\n"
.'> 当ScopeType为 Host 时必填。最多500 个。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostId' => [
'description' => '主机ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'AccountScopeType' => [
'description' => '控制策略生效的主机账户范围。取值:'."\n"
."\n"
.'- **All**:针对主机中的所有账户生效'."\n"
.'- **AccountId**:针对主机中指定的账户生效',
'type' => 'string',
'required' => false,
'example' => 'All',
],
'HostAccountIds' => [
'description' => '控制策略生效的主机账户范围。'."\n"
."\n"
.'> 当AccountScopeType为 AccountId 时必填',
'type' => 'array',
'items' => [
'description' => '主机账户ID列表。',
'type' => 'string',
'required' => false,
'example' => '["96"]',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
[
'name' => 'Databases',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '控制策略生效的数据库资产范围。'."\n"
."\n"
.'> 当ScopeType为 Database 时必填。最多500 个。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DatabaseId' => [
'description' => '数据库实例ID。',
'type' => 'string',
'required' => false,
'example' => '3',
],
'AccountScopeType' => [
'description' => '控制策略生效的数据库账户范围。取值:'."\n"
."\n"
.'- **All**:针对数据库中的所有账户生效'."\n"
.'- **AccountId**:针对数据库中指定的账户生效',
'type' => 'string',
'required' => false,
'example' => 'AccountId',
],
'DatabaseAccountIds' => [
'description' => '控制策略生效的数据库账户范围。'."\n"
."\n"
.'> 当AccountScopeType为 AccountId 时必填',
'type' => 'array',
'items' => [
'description' => '数据库账户ID列表。',
'type' => 'string',
'required' => false,
'example' => '["3"]',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
[
'name' => 'HostGroups',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '控制策略生效的资产组范围。'."\n"
."\n"
.'> 当ScopeType为 HostGroup 时必填。最多100 个。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostGroupId' => [
'description' => '资产组ID。',
'type' => 'string',
'required' => false,
'example' => '86',
],
'AccountScopeType' => [
'description' => '控制策略生效的资产账户范围。取值:'."\n"
."\n"
.'- **All**:针对资产组中的所有账户生效'."\n"
.'- **AccountName**:针对资产组中指定的账户生效',
'type' => 'string',
'required' => false,
'example' => 'All',
],
'AccountNames' => [
'description' => '控制策略生效的资产账户范围。'."\n"
."\n"
.'> 当AccountScopeType为 AccountNames 时必填',
'type' => 'array',
'items' => [
'description' => '资产账户名。',
'type' => 'string',
'required' => false,
'example' => '["root", "admin"]',
'minLength' => 1,
'pattern' => '^\\S+$',
],
'required' => false,
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '5EAB922E-F476-5DFA-9290-313C608E724B',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"5EAB922E-F476-5DFA-9290-313C608E724B\\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的资产生效范围',
],
'SetPolicyUserScope' => [
'summary' => '设置指定控制策略的用户生效范围。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '需要修改的控制策略ID。'."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'ScopeType',
'in' => 'query',
'schema' => [
'description' => '控制策略生效的用户范围。取值:'."\n"
."\n"
.'- **All**:策略针对所有用户生效'."\n"
.'- **User**:策略针对已选择的用户生效'."\n"
.'- **UserGroup**:策略针对已选择的用户组生效',
'type' => 'string',
'required' => true,
'example' => 'All',
],
],
[
'name' => 'UserIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '控制策略生效的用户范围。'."\n"
."\n"
.'>当ScopeType为 User 时必填,最多500 个。',
'type' => 'array',
'items' => [
'description' => '用户ID。',
'type' => 'string',
'required' => false,
'example' => '["1", "2", "3"]',
],
'required' => false,
],
],
[
'name' => 'UserGroupIds',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '控制策略生效的用户组范围。'."\n"
."\n"
.'>当ScopeType为 UserGroup 时必填,最多100 个。',
'type' => 'array',
'items' => [
'description' => '用户组ID。',
'type' => 'string',
'required' => false,
'example' => '["1", "2", "3"]',
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE ',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE \\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的用户生效范围',
],
'SetPolicyApprovalConfig' => [
'summary' => '设置指定控制策略的运维审批配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 可通过调用DescribeInstances接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '指定需要修改的控制策略ID。'."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '7',
],
],
[
'name' => 'ApprovalConfig',
'in' => 'query',
'allowEmptyValue' => false,
'style' => 'json',
'schema' => [
'description' => '控制策略中的运维审批配置。',
'type' => 'object',
'properties' => [
'SwitchStatus' => [
'description' => '控制策略中的运维审批配置。取值:'."\n"
."\n"
.'- **On**:开启运维审批'."\n"
.'- **Off**:关闭运维审批',
'type' => 'string',
'required' => true,
'example' => 'On',
'enum' => [
'Off',
'On',
],
],
],
'required' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '设置指定控制策略的运维审批配置',
],
'DeletePolicy' => [
'summary' => '删除单个控制策略。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostW2TGHR',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要删除的控制策略所在堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PolicyId',
'in' => 'query',
'schema' => [
'description' => '要删除的控制策略ID。'."\n"
.'> 您可以调用[ListPolicies](~~2758876~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'PolicyNotFound',
'errorMessage' => 'The policy is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '删除单个控制策略',
],
'ListApproveCommands' => [
'summary' => '获取需要审批的命令列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost1WGNM5',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-zvp2xvysf08',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-beijing',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为1000。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => true,
'example' => '20',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'ApproveCommands' => [
'description' => '命令列表。',
'type' => 'array',
'items' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'ApproveCommandId' => [
'description' => '待审批的命令ID。',
'type' => 'string',
'example' => '1',
],
'AssetAccountName' => [
'description' => '运维的资产账户名。',
'type' => 'string',
'example' => 'root',
],
'AssetIp' => [
'description' => '运维的资产IP。',
'type' => 'string',
'example' => '10.167.XX.XX',
],
'AssetName' => [
'description' => '运维的资产名称。',
'type' => 'string',
'example' => 'poros-test',
],
'ClientIp' => [
'description' => '提交申请的来源IP。',
'type' => 'string',
'example' => '172.18.XX.XX',
],
'ClientUser' => [
'description' => '提交申请的堡垒机用户。',
'type' => 'string',
'example' => 'test',
],
'Command' => [
'description' => '待审批的命令。',
'type' => 'string',
'example' => '/bin/bash',
],
'CreateTime' => [
'description' => '提交申请的时间。(秒,时间戳格式)',
'type' => 'string',
'example' => '1679393152',
],
'ProtocolName' => [
'description' => '运维的协议名。',
'type' => 'string',
'example' => 'SSH',
],
'SessionId' => [
'description' => '触发审批的运维的会话ID。',
'type' => 'string',
'example' => '95f873ab64a76d5b0000000000004d5e',
],
'State' => [
'description' => '审批状态。'."\n"
.' **Wait**:待审批',
'type' => 'string',
'example' => 'Wait',
],
],
],
],
'RequestId' => [
'description' => '接口请求的唯一ID标识。',
'type' => 'string',
'example' => 'E3EF7711-766D-5888-997B-EFBA76809229',
],
'TotalCount' => [
'description' => '待审批的命令总数。',
'type' => 'integer',
'format' => 'int64',
'example' => '15',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"ApproveCommands\\": [\\n {\\n \\"ApproveCommandId\\": \\"1\\",\\n \\"AssetAccountName\\": \\"root\\",\\n \\"AssetIp\\": \\"10.167.XX.XX\\",\\n \\"AssetName\\": \\"poros-test\\",\\n \\"ClientIp\\": \\"172.18.XX.XX\\",\\n \\"ClientUser\\": \\"test\\",\\n \\"Command\\": \\"/bin/bash\\",\\n \\"CreateTime\\": \\"1679393152\\",\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"SessionId\\": \\"95f873ab64a76d5b0000000000004d5e\\",\\n \\"State\\": \\"Wait\\"\\n }\\n ],\\n \\"RequestId\\": \\"E3EF7711-766D-5888-997B-EFBA76809229\\",\\n \\"TotalCount\\": 15\\n}","type":"json"}]',
'title' => '获取需要审批的命令列表',
'description' => '本接口用于管理员获取需要审批的命令列表。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'AcceptApproveCommand' => [
'summary' => '如果运维员执行了配置在命令审批控制策略中的命令,管理员会在堡垒机控制台收到该命令的审批,只有管理员审批允许后该命令才能正常执行,审批拒绝后该命令不可执行。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost1WGNM5',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 可通过调用DescribeInstances接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'CommandId',
'in' => 'query',
'schema' => [
'description' => '需要允许执行的命令ID。'."\n"
.'> 您可以通过接口[ListApproveCommands](~~2584310~~)查询所有需要审批的CommandId。',
'type' => 'string',
'required' => true,
'example' => '7',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '允许单个命令',
'description' => '本接口用于管理员审批允许运维员的命令执行申请。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'RejectApproveCommand' => [
'summary' => '如果运维员执行了配置在命令审批控制策略中的命令,管理员会在堡垒机控制台收到该命令的审批,只有管理员审批允许后该命令才能正常执行,审批拒绝后该命令不可执行。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost1WGNM5',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'CommandId',
'in' => 'query',
'schema' => [
'description' => '需要审批拒绝的命令ID。'."\n"
.'> 您可以通过接口[ListApproveCommands](~~2584310~~)查询所有需要审批的CommandId。',
'type' => 'string',
'required' => true,
'example' => '574',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '拒绝单个命令',
'description' => '本接口用于管理员审批拒绝运维员的命令执行申请。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'ListOperationTickets' => [
'summary' => '获取需要审批的运维申请列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '188191',
'abilityTreeNodes' => [
'FEATUREbastionhost1WGNM5',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,当前页的页码。默认值为**1**。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '指定分页查询时,每页显示的数据最大条数。 '."\n"
.'PageSize参数最大取值为1000。每页默认显示的数据条数为20条,PageSize参数值为空时,将默认返回20条数据。'."\n"
.'> 建议PageSize取值不要为空。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
[
'name' => 'AssetAddress',
'in' => 'query',
'schema' => [
'description' => '精确搜索待审批的运维资产地址。',
'type' => 'string',
'required' => false,
'example' => '10.167.XX.XX',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'OperationTickets' => [
'description' => '待审批的运维申请列表。',
'type' => 'array',
'items' => [
'description' => '响应数据。',
'type' => 'object',
'properties' => [
'ApplyUserId' => [
'description' => '运维申请人ID。',
'type' => 'string',
'example' => '1',
],
'ApplyUsername' => [
'description' => '运维申请人用户名。',
'type' => 'string',
'example' => 'test',
],
'AssetAccountId' => [
'description' => '申请运维的资产账户ID。',
'type' => 'string',
'example' => '1',
],
'AssetAccountName' => [
'description' => '申请运维的资产账户登录名。',
'type' => 'string',
'example' => 'root',
],
'AssetAddress' => [
'description' => '申请运维的资产地址。',
'type' => 'string',
'example' => '10.167.XX.XX',
],
'AssetId' => [
'description' => '申请运维的资产ID。',
'type' => 'string',
'example' => '2',
],
'AssetName' => [
'description' => '申请运维的资产名称。',
'type' => 'string',
'example' => 'poros-test',
],
'AssetNetworkDomainId' => [
'description' => '申请运维的资产所属的网络域ID。',
'type' => 'string',
'example' => '2',
],
'AssetOs' => [
'description' => '申请运维的资产操作系统类型。',
'type' => 'string',
'example' => 'Linux',
],
'AssetSource' => [
'description' => '申请运维的资产所属资产源的名称。取值:'."\n"
.'- **Local**:本地主机'."\n"
.'- **Ecs**:ECS实例'."\n"
.'- **Rds**:RDS实例'."\n"
.'- 第三方资产源名称',
'type' => 'string',
'example' => 'Local',
],
'AssetSourceInstanceId' => [
'description' => '申请运维的资产所属资产源的ID。',
'type' => 'string',
'example' => '1',
],
'CreatedTime' => [
'description' => '提交申请的时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'example' => '1669965908',
],
'OperationTicketId' => [
'description' => '需要审批的运维申请单的ID。',
'type' => 'string',
'example' => '1',
],
'ProtocolName' => [
'description' => '申请运维的协议名称。',
'type' => 'string',
'example' => 'SSH',
],
'State' => [
'description' => '审批状态。取值:'."\n"
."\n"
.'- Normal:待审批',
'type' => 'string',
'example' => 'Normal',
],
'ApproveComment' => [
'description' => '运维人员申请运维时填写的备注。',
'type' => 'string',
'example' => '申请运维',
],
'EffectStartTime' => [
'description' => '运维人员填写的申请可以运维的开始时间。(秒,时间戳格式)'."\n"
.'> 返回为0时表示运维人员在申请时未填写时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '1685600242',
],
'EffectEndTime' => [
'description' => '运维人员填写的申请可以运维的结束时间。(秒,时间戳格式)'."\n"
.'> 返回为0时表示运维人员在申请时未填写时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '1679393152',
],
'EffectCount' => [
'description' => '运维人员申请的登录的次数限制。取值:'."\n"
."\n"
.'- **0**:不限制登录次数,运维员在有效期内可以无限次数登录。'."\n"
.'- **1**:运维员在有效期内只允许登录一次。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
],
],
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '待审批的运维申请单总数。',
'type' => 'integer',
'format' => 'int64',
'example' => '20',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"OperationTickets\\": [\\n {\\n \\"ApplyUserId\\": \\"1\\",\\n \\"ApplyUsername\\": \\"test\\",\\n \\"AssetAccountId\\": \\"1\\",\\n \\"AssetAccountName\\": \\"root\\",\\n \\"AssetAddress\\": \\"10.167.XX.XX\\",\\n \\"AssetId\\": \\"2\\",\\n \\"AssetName\\": \\"poros-test\\",\\n \\"AssetNetworkDomainId\\": \\"2\\",\\n \\"AssetOs\\": \\"Linux\\",\\n \\"AssetSource\\": \\"Local\\",\\n \\"AssetSourceInstanceId\\": \\"1\\",\\n \\"CreatedTime\\": 1669965908,\\n \\"OperationTicketId\\": \\"1\\",\\n \\"ProtocolName\\": \\"SSH\\",\\n \\"State\\": \\"Normal\\",\\n \\"ApproveComment\\": \\"申请运维\\",\\n \\"EffectStartTime\\": 1685600242,\\n \\"EffectEndTime\\": 1679393152,\\n \\"EffectCount\\": 0\\n }\\n ],\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 20\\n}","type":"json"}]',
'title' => '获取需要审批的运维申请列表',
'description' => '本接口用于管理员获取需要审批的运维申请列表。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'AcceptOperationTicket' => [
'summary' => '如果管理员配置控制策略时开启了运维审批,则运维员登录资产时,需要申请运维且管理员审批通过后才能进行运维。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '188193',
'abilityTreeNodes' => [
'FEATUREbastionhost1WGNM5',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'OperationTicketId',
'in' => 'query',
'schema' => [
'description' => '需要允许的运维申请的ID。'."\n"
.'> 您可以通过接口[ListOperationTickets](~~2584313~~)查询所有需要审批的OperationTicketId。',
'type' => 'string',
'required' => true,
'example' => '1',
],
],
[
'name' => 'EffectCount',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => [
'description' => '允许登录的次数限制。取值:'."\n"
."\n"
.'- **0**:不限制登录次数,运维员在有效期内可以无限次数登录。'."\n"
."\n"
.'- **1**:运维员在有效期内只允许登录一次。'."\n"
.'> - 数据库资产运维审批的登录次数限制只能设置为不限制登录次数。 '."\n"
.'> - 传空字符串时默认为不限制登录次数。',
'type' => 'string',
'required' => false,
'example' => '1',
'enum' => [
'1',
'0',
],
],
],
[
'name' => 'EffectStartTime',
'in' => 'query',
'schema' => [
'description' => '允许登录的有效期开始时间(秒,时间戳格式)。',
'type' => 'string',
'required' => false,
'example' => '1685600242',
],
],
[
'name' => 'EffectEndTime',
'in' => 'query',
'schema' => [
'description' => '允许登录的有效期结束时间(秒,时间戳格式)。',
'type' => 'string',
'required' => false,
'example' => '1679393152',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '审批备注。',
'type' => 'string',
'required' => false,
'example' => 'Comment',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '允许运维申请',
'description' => '本接口用于管理员审批允许运维员的运维申请。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'RejectOperationTicket' => [
'summary' => '如果管理员配置控制策略时开启了运维审批,则运维员登录资产时,需要申请运维且管理员审批通过后才能进行运维。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '188192',
'abilityTreeNodes' => [
'FEATUREbastionhost1WGNM5',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'OperationTicketId',
'in' => 'query',
'schema' => [
'description' => '需要拒绝的运维申请的ID。'."\n"
.'> 您可以通过接口[ListOperationTickets](~~2584313~~)查询所有需要审批的OperationTicketId。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
[
'name' => 'Comment',
'in' => 'query',
'schema' => [
'description' => '审批备注。',
'type' => 'string',
'required' => false,
'example' => 'Reject',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '拒绝运维申请',
'description' => '本接口用于管理员审批拒绝运维员的运维申请。'."\n"
."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'CreateHostShareKey' => [
'summary' => '堡垒机的共享密钥功能可以将用于登录主机的私钥托管在堡垒机中。托管后的私钥可以被共享到多个主机账户中,从而提高主机账户的管理效率。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。 '."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。 '."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyName',
'in' => 'query',
'schema' => [
'description' => '要新增的主机共享密钥名称。最大长度128字符。',
'type' => 'string',
'required' => true,
'example' => 'name',
],
],
[
'name' => 'PrivateKey',
'in' => 'query',
'schema' => [
'description' => '私钥(Base64编码后的字符串)。'."\n"
.'> 支持输入使用ssh-keygen命令生成的RSA密钥和Ed25519密钥。',
'type' => 'string',
'required' => true,
'example' => 'LBYTnpR3Jmd2hMbmNBMGRmdWV2RW5oVXpCUmp3VkM0dGoKa0J2QlNRSHU2bytrMFBudlZvdlMzdGlBbXo5NkRzdUJDcDFFZVFJREFRQUJBb0lCQUNPZGNjK0lGUnNJd3VkYQpjT3VOSm5SK1BxWnlNZGVIaWFOcDc4SUxFd2NLZDNMZmlUWlYxc0d2Q21uTW0vQ3ZiS2NrZ0U1VjZxQVExRGZQCnI******',
],
],
[
'name' => 'PassPhrase',
'in' => 'query',
'schema' => [
'description' => '私钥口令(Base64编码后的字符串)。',
'type' => 'string',
'required' => false,
'example' => 'MTIzN******',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostShareKeyId' => [
'description' => '主机共享密钥的ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '10235',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'HostShareKeyAlreadyExists',
'errorMessage' => 'The host share key already exists. ',
],
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostShareKeyId\\": 10235\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n 10235\\n","errorExample":""}]',
'title' => '新增主机共享密钥',
],
'GetHostShareKey' => [
'summary' => '查询主机共享密钥的详情。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '要查询的主机共享密钥的ID。'."\n"
.'> 您可以调用[ListHostShareKeys](~~462973~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '10427',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostShareKey' => [
'description' => '共享密钥的详情。'."\n",
'type' => 'object',
'properties' => [
'HostShareKeyId' => [
'description' => '主机共享密钥ID。',
'type' => 'string',
'example' => '10427',
],
'HostShareKeyName' => [
'description' => '主机共享密钥的名称。',
'type' => 'string',
'example' => 'name',
],
'LastModifyKeyAt' => [
'description' => '主机共享密钥上次修改的时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'example' => '1644287246',
],
'PrivateKeyFingerPrint' => [
'description' => '私钥的指纹。',
'type' => 'string',
'example' => 'aa:10:f5:21:7f:8b:3e:86:b0:8b:f0:******',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
404 => [
[
'errorCode' => 'HostShareKeyNotFound',
'errorMessage' => 'The host share key is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostShareKey\\": {\\n \\"HostShareKeyId\\": \\"10427\\",\\n \\"HostShareKeyName\\": \\"name\\",\\n \\"LastModifyKeyAt\\": 1644287246,\\n \\"PrivateKeyFingerPrint\\": \\"aa:10:f5:21:7f:8b:3e:86:b0:8b:f0:******\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n 10427\\n name\\n 1644287246\\n ***\\n \\n","errorExample":""}]',
'title' => '查询主机共享密钥的详情',
],
'ListHostShareKeys' => [
'summary' => '查询主机共享密钥的列表。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'>Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '设置分页查询时,每页显示的主机共享密钥的数量。默认值为**20**,表示每页显示20条主机共享密钥。',
'type' => 'string',
'required' => false,
'example' => '20',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'TotalCount' => [
'description' => '查询到的主机共享密钥的总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '10',
],
'HostShareKeys' => [
'description' => '主机共享密钥的列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccountCount' => [
'description' => '关联主机账号的数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
'LastModifyKeyAt' => [
'description' => '密钥上次修改的时间(秒,时间戳格式)。',
'type' => 'integer',
'format' => 'int64',
'example' => '1644806406',
],
'HostShareKeyName' => [
'description' => '主机共享密钥的名称。',
'type' => 'string',
'example' => 'name',
],
'PrivateKeyFingerPrint' => [
'description' => '私钥的指纹。',
'type' => 'string',
'example' => 'aa:10:f5:21:7f:8b:3e:86:b0:8b:f0:e0******',
],
'HostShareKeyId' => [
'description' => '共享密钥的ID。',
'type' => 'string',
'example' => '10247',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"TotalCount\\": 10,\\n \\"HostShareKeys\\": [\\n {\\n \\"HostAccountCount\\": 1,\\n \\"LastModifyKeyAt\\": 1644806406,\\n \\"HostShareKeyName\\": \\"name\\",\\n \\"PrivateKeyFingerPrint\\": \\"aa:10:f5:21:7f:8b:3e:86:b0:8b:f0:e0******\\",\\n \\"HostShareKeyId\\": \\"10247\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n 10\\n \\n 1\\n 1644806406\\n name\\n ****\\n 10247\\n \\n","errorExample":""}]',
'title' => '查询主机共享密钥的列表',
],
'ListHostAccountsForHostShareKey' => [
'summary' => '获取主机共享密钥关联的主机账号。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥的ID。'."\n"
.'> 您可以调用[ListHostShareKeys](~~462973~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '1124',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '设置从返回结果的第几页开始显示查询结果。默认值为**1**,表示从第1页开始显示。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '设置分页查询时,每页显示的主机共享密钥关联的主机账号的数量。默认值为**10**,表示每页显示10条主机共享密钥关联的主机账号。',
'type' => 'string',
'required' => false,
'example' => '10',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'HostAccounts' => [
'description' => '主机共享密钥关联的主机账号的列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HostAccountName' => [
'description' => '主机账号的名称。',
'type' => 'string',
'example' => 'root1234',
],
'HostId' => [
'description' => '主机的ID。',
'type' => 'string',
'example' => '1113',
],
'HostsAccountId' => [
'description' => '主机账号的ID。',
'type' => 'string',
'example' => '1235',
],
'ProtocolName' => [
'description' => '运维协议的名称。',
'type' => 'string',
'example' => 'SSH',
],
],
],
],
'TotalCount' => [
'description' => '主机共享密钥关联的主机账号的总数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '5',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'HostShareKeyNotFound',
'errorMessage' => 'The host share key is not found.',
],
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"HostAccounts\\": [\\n {\\n \\"HostAccountName\\": \\"root1234\\",\\n \\"HostId\\": \\"1113\\",\\n \\"HostsAccountId\\": \\"1235\\",\\n \\"ProtocolName\\": \\"SSH\\"\\n }\\n ],\\n \\"TotalCount\\": 5\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n root1234\\n 1113\\n 1235\\n SSH\\n \\n 5\\n","errorExample":""}]',
'title' => '获取主机共享密钥关联的主机账号',
],
'ModifyHostShareKey' => [
'summary' => '修改主机共享密钥。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。 '."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '要修改的主机共享密钥的ID。',
'type' => 'string',
'required' => true,
'example' => '10247',
],
],
[
'name' => 'HostShareKeyName',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥的名称。',
'type' => 'string',
'required' => false,
'example' => 'name',
],
],
[
'name' => 'PrivateKey',
'in' => 'query',
'schema' => [
'description' => '私钥(Base64编码后的字符串)。'."\n"
.'> 支持输入使用ssh-keygen命令生成的RSA密钥和Ed25519密钥。',
'type' => 'string',
'required' => false,
'example' => 'LBYTnpR3Jmd2hMbmNBMGRmdWV2RW5oVXpCUmp3VkM0dGoKa0J2QlNRSHU2bytrMFBudlZvdlMzdGlBbXo5NkRzdUJDcDFFZVFJREFRQUJBb0lCQUNPZGNjK0lGUnNJd3VkYQpjT3VOSm5SK1BxWnlNZGVIaWFOcDc4SUxFd2NLZDNMZmlUWlYxc0d2Q21uTW0vQ3ZiS2NrZ0U1VjZxQVExRGZQCnI******',
],
],
[
'name' => 'PassPhrase',
'in' => 'query',
'schema' => [
'description' => '私钥口令(Base64编码后的字符串)。',
'type' => 'string',
'required' => false,
'example' => 'MTIzN******'."\n",
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '修改主机共享密钥',
],
'AttachHostAccountsToHostShareKey' => [
'summary' => '关联主机账号到主机共享密钥。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥的ID。'."\n"
.'> 此参数为必传参数。您可以调用[ListHostShareKeys](~~462973~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '10267',
],
],
[
'name' => 'HostAccountIds',
'in' => 'query',
'schema' => [
'description' => '主机账号的ID列表。'."\n"
.'> 此参数为必传参数。您可以调用[ListHostAccounts](~~462937~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口调用的结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示关联成功;其他错误码表示关联失败。',
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The host account does not exist',
],
'HostShareKeyId' => [
'description' => '主机共享密钥的ID。'."\n"
."\n",
'type' => 'string',
'example' => '10267',
],
'HostAccountId' => [
'description' => '主机账号的ID。',
'type' => 'string',
'example' => '1201',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"The host account does not exist\\",\\n \\"HostShareKeyId\\": \\"10267\\",\\n \\"HostAccountId\\": \\"1201\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n OK\\n The host account does not exist\\n 10267\\n 1201\\n \\n","errorExample":""}]',
'title' => '关联主机账号到主机共享密钥',
],
'DetachHostAccountsFromHostShareKey' => [
'summary' => '移除主机账号和主机共享密钥的关联。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥的ID。'."\n"
.'> 您可以调用[ListHostShareKeys](~~462973~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '11',
],
],
[
'name' => 'HostAccountIds',
'in' => 'query',
'schema' => [
'description' => '主机账号ID列表。'."\n"
.'> 您可以调用[ListHostAccountsForHostShareKey](~~462975~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => '["1","2","3"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Results' => [
'description' => '接口调用的结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '错误码。错误码为**OK**时,表示移除成功;其他错误码表示移除失败。',
'type' => 'string',
'example' => 'OK',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The host account does not exist',
],
'HostShareKeyId' => [
'description' => '主机共享密钥的ID。',
'type' => 'string',
'example' => '11',
],
'HostAccountId' => [
'description' => '主机账号的ID。',
'type' => 'string',
'example' => '12407',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Results\\": [\\n {\\n \\"Code\\": \\"OK\\",\\n \\"Message\\": \\"The host account does not exist\\",\\n \\"HostShareKeyId\\": \\"11\\",\\n \\"HostAccountId\\": \\"12407\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n OK\\n The host account does not exist\\n 11\\n 12407\\n \\n","errorExample":""}]',
'title' => '移除主机账号和主机共享密钥的关联',
],
'DeleteHostShareKey' => [
'summary' => '删除主机共享密钥。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhost4PMV5G',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'HostShareKeyId',
'in' => 'query',
'schema' => [
'description' => '主机共享密钥的ID。'."\n"
."\n"
.'> 此参数为必传参数。您可以调用[ListHostShareKeys](~~462973~~)接口获取该参数。',
'type' => 'string',
'required' => false,
'example' => '11206',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n","errorExample":""}]',
'title' => '删除主机共享密钥',
],
'GetInstanceADAuthServer' => [
'summary' => '查询堡垒机实例上AD认证的配置信息。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要查询的堡垒机实例的ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要查询的堡垒机实例的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '89398CFB-4EB6-4C7E-BB3C-EF213AC8FA50',
],
'AD' => [
'description' => 'AD认证的配置信息。',
'type' => 'object',
'properties' => [
'Account' => [
'description' => '服务器账号的DN。',
'type' => 'string',
'example' => 'cn=Manager,dc=test,dc=com',
],
'BaseDN' => [
'description' => '连接AD服务器的BASE DN。',
'type' => 'string',
'example' => 'dc=test,dc=com',
],
'Domain' => [
'description' => 'AD服务器上的域。',
'type' => 'string',
'example' => 'domain',
],
'EmailMapping' => [
'description' => "\n"
.'AD服务器上对应的用户邮箱的字段名称。',
'type' => 'string',
'example' => 'emailAttr',
],
'Filter' => [
'description' => '用户的筛选条件。',
'type' => 'string',
'example' => '(&(objectClass=top))',
],
'IsSSL' => [
'description' => '是否支持SSL。取值:'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否',
'type' => 'boolean',
'example' => 'true',
],
'MobileMapping' => [
'description' => 'AD服务器上对应的用户手机号的字段名称。',
'type' => 'string',
'example' => 'mobileAttr',
],
'NameMapping' => [
'description' => 'AD服务器上对应的用户名称的字段名称。',
'type' => 'string',
'example' => 'nameAttr',
],
'HasPassword' => [
'description' => '是否设置密码。取值:'."\n"
.'- **true**:设置密码'."\n"
.'- **false**:未设置密码',
'type' => 'boolean',
'example' => 'true',
],
'Port' => [
'description' => '服务器的端口。 ',
'type' => 'integer',
'format' => 'int64',
'example' => '389',
],
'Server' => [
'description' => '服务器的地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'StandbyServer' => [
'description' => '备用服务器的地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"89398CFB-4EB6-4C7E-BB3C-EF213AC8FA50\\",\\n \\"AD\\": {\\n \\"Account\\": \\"cn=Manager,dc=test,dc=com\\",\\n \\"BaseDN\\": \\"dc=test,dc=com\\",\\n \\"Domain\\": \\"domain\\",\\n \\"EmailMapping\\": \\"emailAttr\\",\\n \\"Filter\\": \\"(&(objectClass=top))\\",\\n \\"IsSSL\\": true,\\n \\"MobileMapping\\": \\"mobileAttr\\",\\n \\"NameMapping\\": \\"nameAttr\\",\\n \\"HasPassword\\": true,\\n \\"Port\\": 389,\\n \\"Server\\": \\"192.168.XX.XX\\",\\n \\"StandbyServer\\": \\"192.168.XX.XX\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 89398CFB-4EB6-4C7E-BB3C-EF213AC8FA50\\n \\n cn=Manager,dc=test,dc=com\\n dc=test,dc=com\\n domain\\n emailAttr\\n (&(objectClass=top))\\n true\\n mobileAttr\\n nameAttr\\n true\\n 389\\n 192.168.XX.XX\\n 192.168.XX.XX\\n \\n","errorExample":""}]',
'title' => '查询堡垒机实例上AD认证的配置信息',
'description' => '### 使用说明'."\n"
.'本接口用于查询堡垒机实例上AD认证的配置信息。通过堡垒机的AD认证功能,可以将AD服务器的用户同步到堡垒机。同步成功后,用户可通过堡垒机运维服务器。'."\n"
."\n\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'ModifyInstanceADAuthServer' => [
'summary' => '修改堡垒机实例的AD认证服务器的配置。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'>您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Server',
'in' => 'query',
'schema' => [
'description' => '服务器的地址。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'StandbyServer',
'in' => 'query',
'schema' => [
'description' => '备用服务器的地址。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'Port',
'in' => 'query',
'schema' => [
'description' => '访问服务器的端口。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '389',
],
],
[
'name' => 'IsSSL',
'in' => 'query',
'schema' => [
'description' => '是否支持SSL。取值:'."\n"
."\n"
.'- **true**:支持'."\n"
.'- **false**:不支持'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => 'true',
],
],
[
'name' => 'BaseDN',
'in' => 'query',
'schema' => [
'description' => '基准域名(Base DN)。',
'type' => 'string',
'required' => true,
'example' => 'dc=test,dc=com',
],
],
[
'name' => 'Domain',
'in' => 'query',
'schema' => [
'description' => 'AD服务器上的域。',
'type' => 'string',
'required' => true,
'example' => 'domain',
],
],
[
'name' => 'Account',
'in' => 'query',
'schema' => [
'description' => '服务器的账号。',
'type' => 'string',
'required' => true,
'example' => 'cn=Manager,dc=test,dc=com',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '服务器账号的密码。',
'type' => 'string',
'required' => false,
'example' => '******',
],
],
[
'name' => 'Filter',
'in' => 'query',
'schema' => [
'description' => '用户的筛选条件。',
'type' => 'string',
'required' => false,
'example' => '(objectClass=top)',
],
],
[
'name' => 'NameMapping',
'in' => 'query',
'schema' => [
'description' => '用户名称对应服务器的属性名。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'nameAttr',
],
],
[
'name' => 'EmailMapping',
'in' => 'query',
'schema' => [
'description' => '用户邮箱对应服务器的属性名。',
'type' => 'string',
'required' => false,
'example' => 'emailAttr',
],
],
[
'name' => 'MobileMapping',
'in' => 'query',
'schema' => [
'description' => '用户手机号对应服务器的属性名。',
'type' => 'string',
'required' => false,
'example' => 'mobileAttr',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'C9E97677-BD74-584B-AFCE-948C2A70BB82',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C9E97677-BD74-584B-AFCE-948C2A70BB82\\"\\n}","errorExample":""},{"type":"xml","example":"\\n C9E97677-BD74-584B-AFCE-948C2A70BB82\\n","errorExample":""}]',
'title' => '修改堡垒机实例的AD认证服务器的配置',
],
'GetInstanceTwoFactor' => [
'summary' => '查询堡垒机实例的双因子认证的配置信息。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '要查询的堡垒机实例的ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '要查询的堡垒机实例的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。'."\n",
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
'Config' => [
'description' => '双因子认证的配置信息。',
'type' => 'object',
'properties' => [
'EnableTwoFactor' => [
'description' => '是否开启了双因子。取值:'."\n"
."\n"
.'- **true**:是'."\n"
.'- **false**:否',
'type' => 'boolean',
'example' => 'true',
],
'TwoFactorMethods' => [
'description' => '已配置的双因子认证方式列表。',
'type' => 'array',
'items' => [
'description' => '开启双因子认证时验证码的发送方式。取值:'."\n"
."\n"
.'- **sms**:短信'."\n"
.'- **email**:邮件'."\n"
.'- **dingtalk** 钉钉工作通知'."\n"
.'- **totp**:手机OTP令牌'."\n"
.'- **gmusbkey**:国密USBKEY',
'type' => 'string',
'example' => 'sms',
],
],
'SkipTwoFactorTime' => [
'description' => '双因子认证成功后,后续登录堡垒机时跳过双因子认证的时间。取值范围为`[0,168]`,单位为小时。'."\n"
."\n"
.'> 0表示不跳过,即每次登录堡垒机都需要双因子认证。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\",\\n \\"Config\\": {\\n \\"EnableTwoFactor\\": true,\\n \\"TwoFactorMethods\\": [\\n \\"sms\\"\\n ],\\n \\"SkipTwoFactorTime\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\n \\n true\\n sms\\n 1\\n zh-cn\\n \\n","errorExample":""}]',
'title' => '查询堡垒机实例的双因子认证的配置信息',
'description' => '本接口用于查询堡垒机实例的双因子认证的配置信息。双因子认证是在本地用户登录堡垒机时发送验证码,对用户身份进行二次认证,可以有效降低账户泄露等情况带来的安全风险。'."\n"
."\n"
.'### QPS限制'."\n"
.'本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。',
],
'ModifyInstanceTwoFactor' => [
'summary' => '修改堡垒机实例的双因子配置。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'EnableTwoFactor',
'in' => 'query',
'schema' => [
'description' => '是否开启双因子。取值:'."\n"
."\n"
.'- **true**:开启'."\n"
.'- **false**:不开启',
'type' => 'string',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'TwoFactorMethods',
'in' => 'query',
'schema' => [
'description' => '双因子验证码发送方式。当EnableTwoFactor为true时,至少要指定一种方式。取值:'."\n"
."\n"
.'- **sms**:短信'."\n"
.'- **email**:邮箱'."\n"
.'- **dingtalk**:钉钉工作通知'."\n"
.'- **totp**:手机OTP令牌'."\n"
.'- **gmusbkey**:国密USBKEY',
'type' => 'string',
'required' => false,
'example' => '["sms"]',
],
],
[
'name' => 'SkipTwoFactorTime',
'in' => 'query',
'schema' => [
'description' => '双因子认证成功后,后续登录堡垒机时跳过双因子认证的时间,取值范围为0~168,单位(小时)。0表示不跳过,每次都需要双因子认证。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '9CE1A352-15E9-5EB4-B589-87A8DEECB20D',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9CE1A352-15E9-5EB4-B589-87A8DEECB20D\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9CE1A352-15E9-5EB4-B589-87A8DEECB20D\\n","errorExample":""}]',
'title' => '修改堡垒机实例的双因子配置',
],
'ModifyInstanceLDAPAuthServer' => [
'summary' => '修改堡垒机实例LDAP认证服务器的配置。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Server',
'in' => 'query',
'schema' => [
'description' => '服务器的地址。',
'type' => 'string',
'required' => true,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'StandbyServer',
'in' => 'query',
'schema' => [
'description' => '备用服务器的地址。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'Port',
'in' => 'query',
'schema' => [
'description' => '访问服务器的端口。',
'type' => 'string',
'required' => true,
'example' => '389',
],
],
[
'name' => 'IsSSL',
'in' => 'query',
'schema' => [
'description' => '是否支持SSL。取值:'."\n"
."\n"
.'- **true**:支持'."\n"
.'- **false**:不支持',
'type' => 'string',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'BaseDN',
'in' => 'query',
'schema' => [
'description' => '基准域名(Base DN)。',
'type' => 'string',
'required' => true,
'example' => 'dc=test,dc=com',
],
],
[
'name' => 'Account',
'in' => 'query',
'schema' => [
'description' => '服务器的账号。',
'type' => 'string',
'required' => true,
'example' => 'cn=Manager,dc=test,dc=com',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '服务器账号的密码。添加LDAP认证服务器时为必填。修改LDAP认证服务器信息时,不填则表示保留当前密码。',
'type' => 'string',
'required' => false,
'example' => '******',
],
],
[
'name' => 'Filter',
'in' => 'query',
'schema' => [
'description' => '用户的筛选条件。',
'type' => 'string',
'required' => false,
'example' => '(objectClass=top)',
],
],
[
'name' => 'LoginNameMapping',
'in' => 'query',
'schema' => [
'description' => '用户登录名对应服务器的属性名。',
'type' => 'string',
'required' => false,
'example' => 'userNameAttr',
],
],
[
'name' => 'NameMapping',
'in' => 'query',
'schema' => [
'description' => '用户名称对应服务器的属性名。',
'type' => 'string',
'required' => false,
'example' => 'nameAttr',
],
],
[
'name' => 'EmailMapping',
'in' => 'query',
'schema' => [
'description' => '用户邮箱对应服务器的属性名。',
'type' => 'string',
'required' => false,
'example' => 'emailAttr',
],
],
[
'name' => 'MobileMapping',
'in' => 'query',
'schema' => [
'description' => '用户手机号对应服务器的属性名。',
'type' => 'string',
'required' => false,
'example' => 'mobileAttr',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '8F1085E3-F048-5F34-B650-F145216E4AA4',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8F1085E3-F048-5F34-B650-F145216E4AA4\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 8F1085E3-F048-5F34-B650-F145216E4AA4\\n","errorExample":""}]',
'title' => '修改堡垒机实例LDAP认证服务器的配置',
],
'GetInstanceLDAPAuthServer' => [
'summary' => '获取堡垒机实例LDAP认证的配置。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '1C60E741-102D-5E8F-9710-B06D3F0183FE',
],
'LDAP' => [
'description' => 'LDAP认证的配置信息。',
'type' => 'object',
'properties' => [
'Account' => [
'description' => '服务器的账号。',
'type' => 'string',
'example' => 'cn=Manager,dc=test,dc=com',
],
'BaseDN' => [
'description' => '基准域名(Base DN)。',
'type' => 'string',
'example' => 'dc=test,dc=com',
],
'EmailMapping' => [
'description' => '用户邮箱对应的服务器的属性名。',
'type' => 'string',
'example' => 'emailAttr',
],
'Filter' => [
'description' => '用户的筛选条件。',
'type' => 'string',
'example' => '(&(objectClass=top))',
],
'IsSSL' => [
'description' => '是否支持SSL。取值:'."\n"
."\n"
.'- **true**:支持'."\n"
.'- **false**:不支持',
'type' => 'boolean',
'example' => 'true',
],
'LoginNameMapping' => [
'description' => '用户登录名对应服务器属性名。',
'type' => 'string',
'example' => 'userNameAttr',
],
'MobileMapping' => [
'description' => '用户手机号对应的服务器的属性名。',
'type' => 'string',
'example' => 'mobileAttr',
],
'NameMapping' => [
'description' => '用户名称对应的服务器的属性名。',
'type' => 'string',
'example' => 'nameAttr',
],
'HasPassword' => [
'description' => '是否设置密码。取值:'."\n"
."\n"
.'- **true**:设置密码'."\n"
.'- **false**:未设置密码',
'type' => 'string',
'example' => 'true',
],
'Port' => [
'description' => '访问服务器的端口。',
'type' => 'integer',
'format' => 'int64',
'example' => '389',
],
'Server' => [
'description' => '服务器的地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'StandbyServer' => [
'description' => '备用服务器的地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1C60E741-102D-5E8F-9710-B06D3F0183FE\\",\\n \\"LDAP\\": {\\n \\"Account\\": \\"cn=Manager,dc=test,dc=com\\",\\n \\"BaseDN\\": \\"dc=test,dc=com\\",\\n \\"EmailMapping\\": \\"emailAttr\\",\\n \\"Filter\\": \\"(&(objectClass=top))\\",\\n \\"IsSSL\\": true,\\n \\"LoginNameMapping\\": \\"userNameAttr\\",\\n \\"MobileMapping\\": \\"mobileAttr\\",\\n \\"NameMapping\\": \\"nameAttr\\",\\n \\"HasPassword\\": \\"true\\",\\n \\"Port\\": 389,\\n \\"Server\\": \\"192.168.XX.XX\\",\\n \\"StandbyServer\\": \\"192.168.XX.XX\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1C60E741-102D-5E8F-9710-B06D3F0183FE\\n \\n cn=Manager,dc=test,dc=com\\n dc=test,dc=com\\n emailAttr\\n (&(objectClass=top))\\n true\\n userNameAttr\\n mobileAttr\\n nameAttr\\n true\\n 389\\n 192.168.XX.XX\\n 192.168.XX.XX\\n \\n","errorExample":""}]',
'title' => '获取堡垒机实例LDAP认证的配置',
],
'GetInstanceStoreInfo' => [
'summary' => '查询堡垒机实例存储空间的使用情况。',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '245216',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> 地域ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Max' => [
'description' => '当前堡垒机实例存储空间最大容量。单位:Byte',
'type' => 'integer',
'format' => 'int64',
'example' => '102400',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '5EAB922E-F476-5DFA-9290-313C608E724B',
],
'Usage' => [
'description' => '当前堡垒机实例存储空间已使用容量。单位:Byte',
'type' => 'integer',
'format' => 'int64',
'example' => '1024',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Max\\": 102400,\\n \\"RequestId\\": \\"5EAB922E-F476-5DFA-9290-313C608E724B\\",\\n \\"Usage\\": 1024\\n}","type":"json"}]',
'title' => '查询实例存储状态信息(仅支持V3.2.44及以上版本使用)',
],
'CreateExportConfigJob' => [
'summary' => '创建配置备份导出任务。一个堡垒机实例只能同时存在一个正在运行的配置备份导出任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '245225',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
."\n"
.'> 可通过调用[DescribeInstances](~~153281~~)接口获取堡垒机实例ID。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '需要导出配置备份的堡垒机的区域ID。'."\n"
.'> 区域ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'JobId' => [
'description' => '配置备份导出任务ID。'."\n"
.'> 调用GetExportConfigJob接口可获取本次任务详情,请记好任务ID。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => 'EC9BF0F4-8983-491A-BC8C-1B4DD94976DE',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"JobId\\": \\"1\\",\\n \\"RequestId\\": \\"EC9BF0F4-8983-491A-BC8C-1B4DD94976DE\\"\\n}","type":"json"}]',
'title' => '创建配置备份导出任务(仅支持V3.2.44及以上版本使用)',
],
'GetExportConfigJob' => [
'summary' => 'null',
'methods' => [
'post',
'get',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '245226',
'abilityTreeNodes' => [
'FEATUREbastionhostJYERXM',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。'."\n"
.'> 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的地域ID。'."\n"
.'> Region ID和地域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'JobId',
'in' => 'query',
'schema' => [
'description' => '配置备份导出任务ID。'."\n"
.'> 该参数为调用CreateExportConfigJob接口创建配置备份导出任务成功后的返回参数JobId。',
'type' => 'string',
'required' => true,
'example' => '2',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'DownloadUrl' => [
'description' => '配置备份文件下载链接。',
'type' => 'string',
'example' => 'https://bastionhost-cn-hangzhou-164***.oss-cn-hangzhou.aliyuncs.com/bastionhost-cn-2******',
],
'JobId' => [
'description' => '配置备份导出任务ID。',
'type' => 'string',
'example' => '2',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'message',
],
'RequestId' => [
'description' => '阿里云为该请求生成的唯一标识符。',
'type' => 'string',
'example' => '98DBE5C2-7D7A-5393-9E5A-71074336D33B',
],
'Status' => [
'description' => '配置备份导出任务状态。',
'type' => 'string',
'example' => 'Success',
],
'ExpireTime' => [
'description' => '配置备份下载链接过期时间。(秒,时间戳格式)',
'type' => 'integer',
'format' => 'int64',
'example' => '1679393152',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DownloadUrl\\": \\"https://bastionhost-cn-hangzhou-164***.oss-cn-hangzhou.aliyuncs.com/bastionhost-cn-2******\\",\\n \\"JobId\\": \\"2\\",\\n \\"Message\\": \\"message\\",\\n \\"RequestId\\": \\"98DBE5C2-7D7A-5393-9E5A-71074336D33B\\",\\n \\"Status\\": \\"Success\\",\\n \\"ExpireTime\\": 1679393152\\n}","type":"json"}]',
'title' => '获取配置备份导出任务详情(仅支持V3.2.44及以上版本使用)',
],
'VerifyInstanceLDAPAuthServer' => [
'summary' => '验证实例LDAP服务配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。 Region ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Server',
'in' => 'query',
'schema' => [
'description' => '服务器的地址。',
'type' => 'string',
'required' => true,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'StandbyServer',
'in' => 'query',
'schema' => [
'description' => '备用服务器的地址。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'Port',
'in' => 'query',
'schema' => [
'description' => '访问服务器的端口。',
'type' => 'string',
'required' => true,
'example' => '389',
],
],
[
'name' => 'IsSSL',
'in' => 'query',
'schema' => [
'description' => '是否支持SSL。取值:'."\n"
."\n"
.'- **true**:支持'."\n"
.'- **false**:不支持',
'type' => 'string',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'BaseDN',
'in' => 'query',
'schema' => [
'description' => '基准域名(Base DN)。',
'type' => 'string',
'required' => true,
'example' => 'dc=test,dc=com',
],
],
[
'name' => 'Account',
'in' => 'query',
'schema' => [
'description' => '服务器的账号。',
'type' => 'string',
'required' => true,
'example' => 'cn=Manager,dc=test,dc=com',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '服务器账号的密码。',
'type' => 'string',
'required' => false,
'example' => '******',
],
],
[
'name' => 'Filter',
'in' => 'query',
'schema' => [
'description' => '用户的筛选条件。',
'type' => 'string',
'required' => false,
'example' => '(objectClass=top)',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => 'C9E97677-BD74-584B-AFCE-948C2A70BB83',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C9E97677-BD74-584B-AFCE-948C2A70BB83\\"\\n}","errorExample":""},{"type":"xml","example":"\\n C9E97677-BD74-584B-AFCE-948C2A70BB83\\n","errorExample":""}]',
'title' => '验证实例LDAP服务配置',
],
'VerifyInstanceADAuthServer' => [
'summary' => '验证实例AD服务配置。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREbastionhostOF2U94',
],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的实例ID。 您可以调用[DescribeInstances](~~153281~~)接口获取该参数。',
'type' => 'string',
'required' => true,
'example' => 'bastionhost-cn-st220aw****',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '堡垒机的区域ID。 Region ID和区域名称的对应关系,请参见[地域和可用区](~~40654~~)。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Server',
'in' => 'query',
'schema' => [
'description' => '服务器的地址。',
'type' => 'string',
'required' => true,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'StandbyServer',
'in' => 'query',
'schema' => [
'description' => '备用服务器的地址。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'Port',
'in' => 'query',
'schema' => [
'description' => '端口。',
'type' => 'string',
'required' => true,
'example' => '389',
],
],
[
'name' => 'IsSSL',
'in' => 'query',
'schema' => [
'description' => '是否支持SSL。取值:'."\n"
."\n"
.'- **true**:支持'."\n"
.'- **false**:不支持',
'type' => 'string',
'required' => true,
'example' => 'true',
],
],
[
'name' => 'BaseDN',
'in' => 'query',
'schema' => [
'description' => '基准域名(Base DN)。',
'type' => 'string',
'required' => true,
'example' => 'dc=test,dc=com',
],
],
[
'name' => 'Domain',
'in' => 'query',
'schema' => [
'description' => 'AD服务器上的域。',
'type' => 'string',
'required' => true,
'example' => 'domain',
],
],
[
'name' => 'Account',
'in' => 'query',
'schema' => [
'description' => '服务器的账号。',
'type' => 'string',
'required' => true,
'example' => 'cn=Manager,dc=test,dc=com',
],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => [
'description' => '服务器账号的密码。',
'type' => 'string',
'required' => true,
'example' => '******',
],
],
[
'name' => 'Filter',
'in' => 'query',
'schema' => [
'description' => '用户的筛选条件。',
'type' => 'string',
'required' => false,
'example' => '(objectClass=top)',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '8F1085E3-F048-5F34-B650-F145216E4AA5',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The argument is invalid.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'An unknown error occurred.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8F1085E3-F048-5F34-B650-F145216E4AA5\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 8F1085E3-F048-5F34-B650-F145216E4AA5\\n","errorExample":""}]',
'title' => '验证实例AD服务配置',
],
],
'endpoints' => [
[
'regionId' => 'cn-qingdao',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-beijing',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-zhangjiakou',
'endpoint' => 'bastionhost.cn-zhangjiakou.aliyuncs.com',
],
[
'regionId' => 'cn-zhengzhou-jva',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-huhehaote',
'endpoint' => 'bastionhost.cn-huhehaote.aliyuncs.com',
],
[
'regionId' => 'cn-wulanchabu',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-hangzhou',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-shanghai',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-shenzhen',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-heyuan',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-guangzhou',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-chengdu',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-hongkong',
'endpoint' => 'bastionhost.cn-hongkong.aliyuncs.com',
],
[
'regionId' => 'ap-northeast-1',
'endpoint' => 'bastionhost.ap-northeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-northeast-2',
'endpoint' => 'bastionhost.ap-northeast-2.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-1',
'endpoint' => 'bastionhost.ap-southeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-2',
'endpoint' => 'bastionhost.ap-southeast-2.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-3',
'endpoint' => 'bastionhost.ap-southeast-3.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-5',
'endpoint' => 'bastionhost.ap-southeast-5.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-6',
'endpoint' => 'bastionhost.ap-southeast-6.aliyuncs.com',
],
[
'regionId' => 'us-east-1',
'endpoint' => 'bastionhost.us-east-1.aliyuncs.com',
],
[
'regionId' => 'us-west-1',
'endpoint' => 'bastionhost.us-west-1.aliyuncs.com',
],
[
'regionId' => 'eu-west-1',
'endpoint' => 'bastionhost.eu-west-1.aliyuncs.com',
],
[
'regionId' => 'eu-central-1',
'endpoint' => 'bastionhost.eu-central-1.aliyuncs.com',
],
[
'regionId' => 'ap-south-1',
'endpoint' => 'bastionhost.ap-south-1.aliyuncs.com',
],
[
'regionId' => 'me-east-1',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-shanghai-finance-1',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-shenzhen-finance-1',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-beijing-finance-1',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
[
'regionId' => 'cn-north-2-gov-1',
'endpoint' => 'yundun-bastionhost.aliyuncs.com',
],
],
];