'1.0',
'info' => [
'style' => 'RPC',
'product' => 'Slb',
'version' => '2014-05-15',
],
'directories' => [
[
'id' => 68272,
'title' => '资源',
'type' => 'directory',
'children' => [
'DescribeAvailableResource',
],
],
[
'id' => 68274,
'title' => '地域与可用区',
'type' => 'directory',
'children' => [
'DescribeRegions',
'DescribeZones',
],
],
[
'id' => 68277,
'title' => '实例',
'type' => 'directory',
'children' => [
'CreateLoadBalancer',
'DeleteLoadBalancer',
'ModifyLoadBalancerInstanceSpec',
'ModifyLoadBalancerInternetSpec',
'ModifyLoadBalancerPayType',
'SetLoadBalancerDeleteProtection',
'SetLoadBalancerModificationProtection',
'SetLoadBalancerName',
'SetLoadBalancerStatus',
'ModifyLoadBalancerInstanceChargeType',
'DescribeLoadBalancerAttribute',
'DescribeLoadBalancers',
],
],
[
'id' => 68332,
'title' => '监听',
'type' => 'directory',
'children' => [
'DeleteLoadBalancerListener',
'StartLoadBalancerListener',
'StopLoadBalancerListener',
'DescribeLoadBalancerListeners',
],
],
[
'id' => 183721,
'title' => 'TCP监听',
'type' => 'directory',
'children' => [
'CreateLoadBalancerTCPListener',
'SetLoadBalancerTCPListenerAttribute',
'DescribeLoadBalancerTCPListenerAttribute',
],
],
[
'id' => 183722,
'title' => 'UDP监听',
'type' => 'directory',
'children' => [
'CreateLoadBalancerUDPListener',
'SetLoadBalancerUDPListenerAttribute',
'DescribeLoadBalancerUDPListenerAttribute',
],
],
[
'id' => 183723,
'title' => 'HTTP监听',
'type' => 'directory',
'children' => [
'CreateLoadBalancerHTTPListener',
'SetLoadBalancerHTTPListenerAttribute',
'DescribeLoadBalancerHTTPListenerAttribute',
],
],
[
'id' => 183724,
'title' => 'HTTPS监听',
'type' => 'directory',
'children' => [
'CreateLoadBalancerHTTPSListener',
'SetLoadBalancerHTTPSListenerAttribute',
'DescribeLoadBalancerHTTPSListenerAttribute',
],
],
[
'id' => 68289,
'title' => '转发规则',
'type' => 'directory',
'children' => [
'CreateRules',
'SetRule',
'DeleteRules',
'DescribeRuleAttribute',
'DescribeRules',
],
],
[
'id' => 183725,
'title' => '默认服务器组',
'type' => 'directory',
'children' => [
'AddBackendServers',
'DescribeHealthStatus',
'RemoveBackendServers',
'SetBackendServers',
],
],
[
'id' => 68320,
'title' => '虚拟服务器组',
'type' => 'directory',
'children' => [
'CreateVServerGroup',
'DeleteVServerGroup',
'SetVServerGroupAttribute',
'DescribeVServerGroups',
'DescribeVServerGroupAttribute',
'AddVServerGroupBackendServers',
'ModifyVServerGroupBackendServers',
'RemoveVServerGroupBackendServers',
],
],
[
'id' => 68310,
'title' => '主备服务器组',
'type' => 'directory',
'children' => [
'CreateMasterSlaveServerGroup',
'DeleteMasterSlaveServerGroup',
'DescribeMasterSlaveServerGroupAttribute',
'DescribeMasterSlaveServerGroups',
],
],
[
'id' => 68359,
'title' => '证书',
'type' => 'directory',
'children' => [
'DeleteCACertificate',
'DeleteServerCertificate',
'SetCACertificateName',
'SetServerCertificateName',
'DescribeCACertificates',
'DescribeServerCertificates',
'UploadCACertificate',
'UploadServerCertificate',
],
],
[
'id' => 68293,
'title' => '扩展域名',
'type' => 'directory',
'children' => [
'CreateDomainExtension',
'SetDomainExtensionAttribute',
'DeleteDomainExtension',
'DescribeDomainExtensionAttribute',
'DescribeDomainExtensions',
],
],
[
'id' => 183697,
'title' => '安全策略',
'type' => 'directory',
'children' => [
'CreateTLSCipherPolicy',
'DeleteTLSCipherPolicy',
'SetTLSCipherPolicyAttribute',
'ListTLSCipherPolicies',
],
],
[
'id' => 68298,
'title' => '访问控制',
'type' => 'directory',
'children' => [
'CreateAccessControlList',
'AddAccessControlListEntry',
'DeleteAccessControlList',
'SetAccessControlListAttribute',
'DescribeAccessControlListAttribute',
'DescribeAccessControlLists',
'RemoveAccessControlListEntry',
],
],
[
'id' => 68329,
'title' => '访问控制(旧版)',
'type' => 'directory',
'children' => [
'SetListenerAccessControlStatus',
'RemoveListenerWhiteListItem',
'AddListenerWhiteListItem',
'DescribeListenerAccessControlAttribute',
],
],
[
'id' => 68352,
'title' => '标签',
'type' => 'directory',
'children' => [
'AddTags',
'DescribeTags',
'ListTagResources',
'TagResources',
'UntagResources',
'RemoveTags',
],
],
[
'id' => 177279,
'title' => '访问日志',
'type' => 'directory',
'children' => [
'DeleteAccessLogsDownloadAttribute',
'SetAccessLogsDownloadAttribute',
'DescribeAccessLogsDownloadAttribute',
],
],
[
'id' => 179251,
'title' => '秒级监控',
'type' => 'directory',
'children' => [
'EnableHighDefinationMonitor',
'ModifyHighDefinationMonitor',
'DescribeHighDefinationMonitor',
],
],
[
'id' => 183120,
'title' => '资源组',
'type' => 'directory',
'children' => [
'MoveResourceGroup',
],
],
],
'components' => [
'schemas' => [],
],
'apis' => [
'DescribeAvailableResource' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'none',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-shanghai',
],
],
[
'name' => 'AddressType',
'in' => 'query',
'schema' => [
'description' => '网络类型。'."\n"
."\n"
.'取值:'."\n"
."\n"
.'- **vpc**:专有网络的私网负载均衡实例。'."\n"
.'- **classic_internet**:公网负载均衡实例。'."\n"
.'- **classic_intranet**:经典网络的私网负载均衡实例。',
'type' => 'string',
'required' => false,
'example' => 'vpc',
],
],
[
'name' => 'AddressIPVersion',
'in' => 'query',
'schema' => [
'description' => 'IP地址类型。'."\n"
."\n"
.'取值:'."\n"
."\n"
.'- **ipv4**'."\n"
.'- **ipv6**',
'type' => 'string',
'required' => false,
'example' => 'ipv4',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '173B0EEA-22ED-4EE2-91F9-3A1CDDFFBBBA',
],
'AvailableResources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AvailableResource' => [
'description' => '可用区及支持的资源列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'SlaveZoneId' => [
'description' => '备可用区。',
'type' => 'string',
'example' => 'cn-shanghai-b',
],
'MasterZoneId' => [
'description' => '主可用区。',
'type' => 'string',
'example' => 'cn-shanghai-a',
],
'SupportResources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SupportResource' => [
'description' => '支持的资源。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AddressType' => [
'description' => '网络类型。'."\n"
."\n"
.'取值:'."\n"
."\n"
.'- **vpc**:专有网络的私网负载均衡实例。'."\n"
.'- **classic_internet**:公网负载均衡实例。'."\n"
.'- **classic_intranet**:经典网络的私网负载均衡实例。',
'type' => 'string',
'example' => 'vpc',
],
'AddressIPVersion' => [
'description' => 'IP地址类型。'."\n"
."\n"
.'取值:'."\n"
."\n"
.'- **ipv4**'."\n"
.'- **ipv6**',
'type' => 'string',
'example' => 'ipv4',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"173B0EEA-22ED-4EE2-91F9-3A1CDDFFBBBA\\",\\n \\"AvailableResources\\": {\\n \\"AvailableResource\\": [\\n {\\n \\"SlaveZoneId\\": \\"cn-shanghai-b\\",\\n \\"MasterZoneId\\": \\"cn-shanghai-a\\",\\n \\"SupportResources\\": {\\n \\"SupportResource\\": [\\n {\\n \\"AddressType\\": \\"vpc\\",\\n \\"AddressIPVersion\\": \\"ipv4\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询资源售卖情况',
'summary' => '查询某个Region的可用区支持的资源售卖情况,可用的资源。',
'description' => '> 只返回支持售卖的可用区及资源类型。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeRegions' => [
'summary' => '查询可用地域。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88601',
'abilityTreeNodes' => [
'FEATUREslbL5KCST',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'AcceptLanguage',
'in' => 'query',
'schema' => [
'description' => '支持的语言。取值:'."\n"
."\n"
.'- **zh-CN**:中文'."\n"
.'- **en-US**:英文'."\n"
.'- **ja**:日文',
'type' => 'string',
'required' => false,
'example' => 'zh-CN',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6',
],
'Regions' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Region' => [
'description' => '地域列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'RegionEndpoint' => [
'description' => '地域服务的终端节点地址。',
'type' => 'string',
'example' => 'slb.aliyuncs.com',
],
'LocalName' => [
'description' => '地域名称。',
'type' => 'string',
'example' => '华北2(北京)',
],
'RegionId' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-beijing',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'InvalidParameter',
],
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6\\",\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"RegionEndpoint\\": \\"slb.aliyuncs.com\\",\\n \\"LocalName\\": \\"华北2(北京)\\",\\n \\"RegionId\\": \\"cn-beijing\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6\\n \\n slb.aliyuncs.com\\n 华北2(北京)\\n cn-beijing\\n \\n","errorExample":""}]',
'title' => '查询可用地域',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeZones' => [
'summary' => '查询指定地域的可用区信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '88615',
'abilityTreeNodes' => [
'FEATUREslbL5KCST',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AcceptLanguage',
'in' => 'query',
'schema' => [
'type' => 'string',
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'A48D35FF-440A-4BC0-A4A2-A9BF69B7E43A',
],
'Zones' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Zone' => [
'description' => '可用区列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ZoneId' => [
'description' => '可用区ID。',
'type' => 'string',
'example' => 'cn-hangzhou-b',
],
'LocalName' => [
'description' => '可用区名称。',
'type' => 'string',
'example' => 'Hangzhou Zone B',
],
'SlaveZones' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SlaveZone' => [
'description' => '主可用区对应的备可用区列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ZoneId' => [
'description' => '备可用区ID。',
'type' => 'string',
'example' => 'cn-hangzhou-g',
],
'LocalName' => [
'description' => '备可用区名称。',
'type' => 'string',
'example' => 'Hangzhou Zone G',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'InvalidParameter',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A48D35FF-440A-4BC0-A4A2-A9BF69B7E43A\\",\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-b\\",\\n \\"LocalName\\": \\"Hangzhou Zone B\\",\\n \\"SlaveZones\\": {\\n \\"SlaveZone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-g\\",\\n \\"LocalName\\": \\"Hangzhou Zone G\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n A48D35FF-440A-4BC0-A4A2-A9BF69B7E43A\\n \\n cn-hangzhou-b\\n 华东 1 可用区 B\\n \\n cn-hangzhou-g\\n 华东 1 可用区 G\\n \\n \\n","errorExample":""}]',
'title' => '查询指定地域的可用区信息',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateLoadBalancer' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'paid',
'abilityTreeCode' => '88523',
'abilityTreeNodes' => [
'FEATUREslbOL61C3',
'FEATUREslbMJNWX5',
'FEATUREslbPXBZ65',
'FEATUREslbFSBXXR',
'FEATUREslb4A0V0T',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~2401682~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AddressType',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的网络类型。取值:'."\n"
."\n"
.'- **internet**:创建公网负载均衡实例后,系统会分配一个公网IP地址,可以转发公网请求。'."\n"
.'- **intranet**:创建专有网络类型的负载均衡实例后,系统会分配一个内网IP地址,仅可转发内网请求。',
'type' => 'string',
'required' => false,
'example' => 'internet',
'default' => 'internet',
],
],
[
'name' => 'InternetChargeType',
'in' => 'query',
'schema' => [
'description' => '公网类型实例的付费方式。取值:'."\n"
."\n"
.'- **paybytraffic**(默认值):按使用流量计费。'."\n"
.'- **paybybandwidth**:按固定带宽计费。'."\n"
."\n\n"
.'>- 当**PayType**取值**PayOnDemand**且**InstanceChargeType**取值**PayByCLCU**时,该参数仅支持取值**paybytraffic**。'."\n"
.'>- 如果选择了**paybytraffic**,无需设置**Bandwidth**的值;如您设置了**Bandwidth**值,该值也不会生效。',
'type' => 'string',
'required' => false,
'example' => 'paybytraffic',
'default' => 'paybytraffic',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '实例的带宽峰值,单位:Mbps。'."\n"
.' '."\n"
.'取值范围:**1**~**5000**。'."\n"
."\n"
.'> 仅 **AddressType**取值为**internet**,且**InternetChargeType**取值为**paybybandwidth**时,该参数生效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5000',
'minimum' => '1',
'example' => '10',
'default' => '-1',
],
],
[
'name' => 'ClientToken',
'in' => 'query',
'schema' => [
'description' => '客户端Token,用于保证请求的幂等性。'."\n"
."\n"
.'由客户端生成该参数值,要保证在不同请求间唯一。'."\n"
."\n"
.'> 若您未指定,则系统自动使用API请求的**RequestId**作为**ClientToken**标识。每次API请求的**RequestId**不一样。',
'type' => 'string',
'required' => false,
'example' => '593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3',
],
],
[
'name' => 'LoadBalancerName',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的名称。'."\n"
."\n"
.'长度为1~80个英文或中文字符,必须以大小写字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。'."\n"
."\n"
.'不指定该参数时,默认由系统分配一个实例名称。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp1o94dp5i6ea****',
],
],
[
'name' => 'VpcId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的所属的VPC ID。',
'type' => 'string',
'required' => false,
'example' => 'vpc-bp1aevy8sofi8mh1****',
],
],
[
'name' => 'VSwitchId',
'in' => 'query',
'schema' => [
'description' => '专有网络实例的所属的交换机ID。'."\n"
."\n"
.'创建专有网络类型的负载均衡实例,必须指定该参数。如果指定了该参数,**AddressType**参数的值会默认被设置为**intranet**。'."\n"
."\n"
.'> 请确保该**VSwitchId**所在可用区与主可用区一致。',
'type' => 'string',
'required' => false,
'example' => 'vsw-bp12mw1f8k3jgy****',
],
],
[
'name' => 'MasterZoneId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的主可用区ID。'."\n"
."\n"
.'您可以通过调用[DescribeZone](~~27585~~)接口可查到相应地域下的主备可用区信息。'."\n"
."\n"
.'> 请确保该主可用区与**VSwitchId**所在可用区一致。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou-b',
],
],
[
'name' => 'SlaveZoneId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的备可用区ID。'."\n"
."\n"
.'您可以通过调用[DescribeZone](~~27585~~)接口查询相应地域下的主备可用区信息。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou-d',
],
],
[
'name' => 'LoadBalancerSpec',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的规格。取值:'."\n"
."\n"
.'- **slb.s1.small**'."\n"
.'- **slb.s2.small**'."\n"
.'- **slb.s2.medium**'."\n"
.'- **slb.s3.small**'."\n"
.'- **slb.s3.medium**'."\n"
.'- **slb.s3.large**'."\n"
."\n"
.''."\n"
."\n"
.'>- 当**InstanceChargeType**取值为**PayByCLCU**,该参数不生效,您无需配置该参数。'."\n"
.'>- 若不指定规格,则创建性能共享型实例。目前,共享型实例已停止售卖,请指定实例规格。'."\n"
."\n"
.''."\n"
."\n"
.''."\n"
."\n"
.'>- 当**InstanceChargeType**取值为**PayByCLCU**,该参数不生效,您无需配置该参数。'."\n"
.'>- CLB按规格计费实例已于2025年06月01日00:00:00(北京时间,UTC+8)停止售卖。详情请参见[传统型负载均衡CLB按规格计费实例停售公告](~~2872003~~)。'."\n"
."\n\n"
.'',
'type' => 'string',
'required' => false,
'example' => 'slb.s1.small',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '企业资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-atstuj3rtopt****',
],
],
[
'name' => 'PayType',
'in' => 'query',
'schema' => [
'description' => '实例的计费类型,取值:'."\n"
."\n"
.'- **PayOnDemand**:按量付费。',
'type' => 'string',
'deprecated' => true,
'required' => false,
'example' => 'PayOnDemand',
'default' => 'PayOnDemand',
],
],
[
'name' => 'PricingCycle',
'in' => 'query',
'schema' => [
'description' => '预付费公网实例的计费周期,取值:'."\n"
.'- **month**:月。'."\n"
.'- **year**:年。'."\n"
."\n"
.'>该参数仅适用于中国站且仅对包年包月实例有效。',
'type' => 'string',
'deprecated' => true,
'required' => false,
'example' => 'month',
],
],
[
'name' => 'Duration',
'in' => 'query',
'schema' => [
'description' => '预付费公网实例的购买时长,取值:'."\n"
.' '."\n"
.'* 如果**PricingCycle**为**month**,取值为**1~9**。'."\n"
.'* 如果**PricingCycle**为**year**,取值为**1~5**。'."\n"
."\n"
.'> 该参数仅适用于中国站且仅对包年包月实例有效。',
'type' => 'integer',
'format' => 'int32',
'deprecated' => true,
'required' => false,
'minimum' => '1',
'example' => '1',
],
],
[
'name' => 'AutoPay',
'in' => 'query',
'schema' => [
'description' => '是否是自动支付预付费公网实例的账单。取值:'."\n"
."\n"
.'- **true**:自动支付。调用API后,立即生成SLB实例。'."\n"
.'- **false**(默认值):调用API后SLB的订单创建成功,但是未支付。您可以在控制台看到未支付订单。由于订单未支付,SLB实例不会被创建出来。'."\n"
."\n"
.'> 该参数仅适用于中国站且仅对包年包月实例有效。',
'type' => 'boolean',
'deprecated' => true,
'required' => false,
'example' => 'true',
'default' => 'false',
],
],
[
'name' => 'AddressIPVersion',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的IP版本,取值:**ipv4**或**ipv6**。'."\n",
'type' => 'string',
'required' => false,
'example' => 'ipv4',
'default' => 'ipv4',
],
],
[
'name' => 'Address',
'in' => 'query',
'schema' => [
'description' => '指定实例的私网IP地址,该地址必须包含在交换机的目标网段下。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '实例的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '实例的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'value',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'DeleteProtection',
'in' => 'query',
'schema' => [
'description' => '是否开启实例删除保护。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'ModificationProtectionStatus',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡修改保护状态:'."\n"
."\n"
.'- **NonProtection**:不限制修改保护,设置后会清空之前设置的**ModificationProtectionReason**。'."\n"
.'- **ConsoleProtection**:实例控制台修改保护状态。'."\n"
."\n"
.'> 当取值为**ConsoleProtection**,即开启修改保护后,用户不能通过负载均衡控制台修改实例配置,但可以通过调用API修改实例配置。',
'type' => 'string',
'required' => false,
'example' => 'ConsoleProtection',
],
],
[
'name' => 'ModificationProtectionReason',
'in' => 'query',
'schema' => [
'description' => '设置修改保护状态的原因,长度为1~80个字符,必须以字母或中文开头,支持数字、半角句号(.)、下划线(_)和短划线(-)。'."\n"
."\n"
.'> 仅在**ModificationProtectionStatus**为**ConsoleProtection**时有效。',
'type' => 'string',
'required' => false,
'example' => 'Managed instance',
],
],
[
'name' => 'InstanceChargeType',
'in' => 'query',
'schema' => [
'description' => ''."\n"
."\n"
.'实例计费方式。取值:'."\n"
.'- **PayBySpec**(默认值):按规格计费。'."\n"
.'- **PayByCLCU**:按使用量计费。'."\n"
."\n"
.'>仅当**PayType**(实例付费模式)取值为**PayOnDemand**(按量付费)时,该参数生效。'."\n"
."\n"
.''."\n"
."\n"
.''."\n"
."\n"
.'实例计费方式。'."\n"
."\n"
.'取值:**PayByCLCU**:按使用量计费。'."\n"
."\n"
.'> - 仅当**PayType**(实例付费模式)取值为**PayOnDemand**(按量付费)时,该参数生效。'."\n"
.'> - CLB按规格计费实例已于2025年06月01日00:00:00(北京时间,UTC+8)停止售卖。详情请参见[传统型负载均衡CLB按规格计费实例停售公告](~~2872003~~)。'."\n"
."\n\n"
.'',
'type' => 'string',
'required' => false,
'example' => 'PayBySpec',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VpcId' => [
'description' => '传统型负载均衡实例的所属专有网络的ID。',
'type' => 'string',
'example' => 'vpc-25dvzy9****',
],
'AddressIPVersion' => [
'description' => '传统型负载均衡实例的IP地址类型。',
'type' => 'string',
'example' => 'ipv4',
],
'VSwitchId' => [
'description' => '传统型负载均衡实例的所属交换机的ID。',
'type' => 'string',
'example' => 'vsw-255ecr****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'LoadBalancerName' => [
'description' => '传统型负载均衡实例的名称。',
'type' => 'string',
'example' => 'lb-bp1o94dp5i6ea****',
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'example' => 'lb-hddhfjg****',
],
'ResourceGroupId' => [
'description' => '资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3rto****',
],
'Address' => [
'description' => '分配的负载均衡实例的IP地址。',
'type' => 'string',
'example' => '42.XX.XX.6',
],
'NetworkType' => [
'description' => '传统型负载均衡实例的网络类型,取值:'."\n"
."\n"
.'* **vpc**:专有网络类型。'."\n"
.'* **classic**:经典网络类型。',
'type' => 'string',
'example' => 'classic',
],
'OrderId' => [
'description' => '预付费实例的订单ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '20212961978****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationFailed.ZoneResourceLimit',
'errorMessage' => 'The operation failed because of resource limit of the specified zone.',
],
[
'errorCode' => 'CloudBoxNotSupportIpv6',
'errorMessage' => 'The cloudBox instance does not support ipv6.',
],
[
'errorCode' => 'CloudBoxNotSupportInternet',
'errorMessage' => 'The cloudBox instance does not support internet.',
],
[
'errorCode' => 'OperationFailed.RegionResourceLimit',
'errorMessage' => 'The operation failed because of resource limit of the specified region.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Operation Denied. The charge type of internet prepay instance can only be paybybandwidth.',
],
[
'errorCode' => 'OperationFailed.UnpaidBillsExist',
'errorMessage' => 'The account has unpaid bills. Please pay your overdue bill first.',
],
[
'errorCode' => 'RegionOrZonesNotSupportIpv6',
'errorMessage' => 'The specified region or master/slave zones does not support ipv6.',
],
[
'errorCode' => 'InvalidParameter.Mismatch',
'errorMessage' => 'AddressType and IpVersion is conflict, IPv6 does not support intranet instance.',
],
[
'errorCode' => 'PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE',
'errorMessage' => 'Your account does not have enough balance.',
],
[
'errorCode' => 'HighRiskOperationDenied',
'errorMessage' => 'The operation is denied because of high risk.',
],
[
'errorCode' => 'VSwitchAvailableIpNotExist',
'errorMessage' => 'The specified VSwitch has no availabe ip.',
],
[
'errorCode' => 'VSwitchNotExist',
'errorMessage' => 'The specified VSwitch does not exist.',
],
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'Illegal parameter. The IP address is not in subnet.',
],
[
'errorCode' => 'Instance.ShareSlbNotSupportPay95',
'errorMessage' => 'Illegal parameter. The share instance not support PayBy95 or PayByOld95.',
],
[
'errorCode' => 'Instance.Pay95RateInvalid',
'errorMessage' => 'Illegal parameter. The rate is illegal.',
],
[
'errorCode' => 'Instance.Pay95BandwidthIllegal',
'errorMessage' => 'Illegal parameter. The bandwidth is illegal.',
],
[
'errorCode' => 'Instance.InternetChargeTypeNotAllowed',
'errorMessage' => 'Illegal parameter. The specified InternetChargeType not allowed.',
],
[
'errorCode' => 'OperationFailed.TokenIsProcessing',
'errorMessage' => 'The operation is failed, because the Client Token is processing.',
],
[
'errorCode' => 'InsufficientBalance',
'errorMessage' => 'Your account does not have enough balance.',
],
[
'errorCode' => 'MissingParam.VSwitchId',
'errorMessage' => 'The parameter VSwitchId is required.',
],
[
'errorCode' => 'InvalidVpcId.NotExist',
'errorMessage' => 'The specified VPC not exist.',
],
[
'errorCode' => 'PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL',
'errorMessage' => 'Your account did not sign a withholding agreement or no coupons in Alipay.',
],
[
'errorCode' => 'InvalidParameter.CloudType',
'errorMessage' => 'The specified CloudType is invalid.',
],
[
'errorCode' => 'OperationFailed.InvalidAccount',
'errorMessage' => 'The account information is incomplete.',
],
[
'errorCode' => 'RegionOrZonesNotSupportCEN',
'errorMessage' => 'The specified region or master/slave zones does not support cloudType of hybrid_cen.',
],
[
'errorCode' => 'MissingParam.LoadBalancerSpec',
'errorMessage' => 'The param LoadBalancerSpec is required.',
],
[
'errorCode' => 'InvalidParameter.Bandwidth',
'errorMessage' => 'The param Bandwidth is invalid.',
],
[
'errorCode' => 'OperationForbidden.AccountRiskReject',
'errorMessage' => 'The operation failed because of account risk reject.',
],
[
'errorCode' => 'OperationForbidden.QuotaLimit',
'errorMessage' => 'The operation failed because of quota limit of shared loadbalancers.',
],
[
'errorCode' => 'InvalidParam.ModificationProtectionStatus',
'errorMessage' => 'The param ModificationProtectionStatus is invalid.',
],
[
'errorCode' => 'InvalidParam.ModificationProtectionReason',
'errorMessage' => 'The param ModificationProtectionReason is invalid.',
],
[
'errorCode' => 'ShareSlbHaltSales',
'errorMessage' => 'The share instance has been discontinued.',
],
[
'errorCode' => 'OperationFailed.CashBookInsufficient',
'errorMessage' => 'No payment method is specified for your account, We recommend that you add a payment method or maintain a prepayment balance.',
],
[
'errorCode' => 'OperationFailed.OnlyInnerCommoditySupportToPurchase',
'errorMessage' => 'AliCroup2Cloud user only can buy inner commodity.',
],
[
'errorCode' => 'OperationFailed.InvokeLingXiaoFailed',
'errorMessage' => 'Failed to invoke lingxiao service.',
],
[
'errorCode' => 'AllocateVpcInstanceFailed',
'errorMessage' => 'Failed to allocate vpc instance.',
],
[
'errorCode' => 'QueryCreditCtrlInfoFailed',
'errorMessage' => 'Failed to query credit ctrl info.',
],
[
'errorCode' => 'QueryCommodityCenterFailed',
'errorMessage' => 'Failed to query commodity center.',
],
[
'errorCode' => 'RegionNotSupportParameter',
'errorMessage' => 'Current region does not support the param of %s.',
],
[
'errorCode' => 'QueryAccountBookInfoFailed',
'errorMessage' => 'Failed to invoke account book info.',
],
[
'errorCode' => 'RateAccountFailed',
'errorMessage' => 'Failed to rate account for pricing.',
],
[
'errorCode' => 'TradeWaitDistributorAudit',
'errorMessage' => 'The trade needs distributor to audit.',
],
[
'errorCode' => 'OperationFailed.InvokeProxyFailed',
'errorMessage' => 'Failed to invoke proxy.',
],
[
'errorCode' => 'QueryAccountCompleteProgressFailed',
'errorMessage' => 'Failed to query account progress.',
],
[
'errorCode' => 'QueryVoucherInfoFailed',
'errorMessage' => 'Failed to query voucher info.',
],
[
'errorCode' => 'InvalidVSwitchId.NotFound',
'errorMessage' => 'The specified vSwitch instance is invalid.',
],
[
'errorCode' => 'IllegalParam.SpecType',
'errorMessage' => 'The param of SpecType is illegal.',
],
[
'errorCode' => 'MissingParam.SpecType',
'errorMessage' => 'The param of SpecType is missing.',
],
[
'errorCode' => 'UnsupportedRegion',
'errorMessage' => 'The feature is not supported in current region.',
],
[
'errorCode' => 'PayInsufficientBalance',
'errorMessage' => 'Your account balance is insufficient.',
],
[
'errorCode' => 'IllegalParam.InstanceChargeType',
'errorMessage' => 'The parameter InstanceChargeType is illegal.',
],
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
[
'errorCode' => 'PRODUCT.NOT_AVAILABLE_IZ',
'errorMessage' => 'The Instance zone id doesn t support',
],
[
'errorCode' => 'PRICE.INQUIRY_FAILED',
'errorMessage' => 'The instance pricing inquiry is failed.',
],
[
'errorCode' => 'AssociateIpFail',
'errorMessage' => 'The instance associating ip is failed.',
],
[
'errorCode' => 'SDK.ServerUnreachable',
'errorMessage' => 'Service is unreachable.',
],
[
'errorCode' => 'OverQuota',
'errorMessage' => 'The Total is over the quota',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'SubnetIpExhaust',
'errorMessage' => 'No subnet IP addresses are available.',
],
[
'errorCode' => 'BeforePayRuleBatchValidateError',
'errorMessage' => 'The pre-payment rule center instance rule validation failed. Please check if the instance limit has been reached.',
],
[
'errorCode' => 'TradeSyncCreateSubError',
'errorMessage' => 'Subscription transfer failed.',
],
[
'errorCode' => 'QueryOrderError',
'errorMessage' => 'Failed to query the order. Please try again later.',
],
[
'errorCode' => 'CreateOrderTimeout',
'errorMessage' => 'Order creation timed out. Please try again later.',
],
[
'errorCode' => 'MultiGrayKeyResourceInconsist',
'errorMessage' => 'The identifier for the gray resource is set incorrectly.',
],
[
'errorCode' => 'InsufficientAvailableQuota',
'errorMessage' => 'Your account available balance is less than 0. Please recharge before attempting to make a purchase.',
],
[
'errorCode' => 'Forbidden.AliGroupForbiddenRegion',
'errorMessage' => 'Thre region is forbidden for aligroup user.',
],
],
403 => [
[
'errorCode' => 'SecurityRisk.AuthVerification',
'errorMessage' => 'We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VpcId\\": \\"vpc-25dvzy9****\\",\\n \\"AddressIPVersion\\": \\"ipv4\\",\\n \\"VSwitchId\\": \\"vsw-255ecr****\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"LoadBalancerName\\": \\"lb-bp1o94dp5i6ea****\\",\\n \\"LoadBalancerId\\": \\"lb-hddhfjg****\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3rto****\\",\\n \\"Address\\": \\"42.XX.XX.6\\",\\n \\"NetworkType\\": \\"classic\\",\\n \\"OrderId\\": 0\\n}","errorExample":""},{"type":"xml","example":"\\n vpc-25dvzy9****\\n ipv4\\n vsw-255ecr****\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n lb-bp1o94dp5i6ea****\\n lb-hddhfjg****\\n rg-atstuj3rto****\\n 42.XX.XX.6\\n classic\\n","errorExample":""}]',
'title' => '创建传统型负载均衡实例',
'summary' => '创建负载均衡实例。',
'description' => ''."\n"
."\n"
.'> - CLB包年包月实例2024年12月01日00:00:00起停止新购。详细信息请参见[传统型负载均衡CLB包年包月停售公告](~~2839979~~)。'."\n"
.'> - 实例创建前,请调用[DescribeAvailableResource](~~117645~~)查询可用区支持的资源售卖情况。'."\n"
.'> - 实例创建后,会产生费用。'."\n"
.'> - 按量付费模式支持创建按使用量计费实例和按规格计费实例。'."\n"
."\n"
.''."\n"
."\n"
.''."\n"
."\n"
.'> - 实例创建前,请调用[DescribeAvailableResource](~~117645~~)查询可用区支持的资源售卖情况。'."\n"
.'> - 实例创建后,会产生费用。'."\n"
.'> - 按量付费模式只支持创建按使用量计费实例,按规格计费实例已于2025年06月01日00:00:00(北京时间,UTC+8)停止售卖。详情请参见[传统型负载均衡CLB按规格计费实例停售公告](~~2872003~~)。'."\n"
."\n"
.'',
],
'DeleteLoadBalancer' => [
'summary' => '删除后付费的负载均衡实例。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。'."\n",
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1h66tp5uat8********',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidChargeType',
'errorMessage' => 'The prepay loadBalancer does not support this action.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Operation Denied. Unfinished order exists.',
],
[
'errorCode' => 'OperationDenied.DeleteProtectionIsOn',
'errorMessage' => 'The loadbalancer can not be deleted due to DeleteProtection is enabled.',
],
[
'errorCode' => 'NoPermission.AliyunServiceRoleForSlbEipAccess',
'errorMessage' => 'You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForSlbEipAccess. Service Name: eipaccess.slb.aliyuncs.com. Please ensure the user has been granted the ram:CreateServiceLinkedRole permission ',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '删除后付费的负载均衡实例',
'description' => '> 如果负载均衡实例上还有监听或者绑定了相应的标签,也会一并被删除。',
'requestParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyLoadBalancerInstanceSpec' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719df*********',
],
],
[
'name' => 'LoadBalancerSpec',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的规格。取值:'."\n"
."\n"
.' - **slb.s1.small**'."\n"
.' - **slb.s2.small**'."\n"
.' - **slb.s2.medium**'."\n"
.' - **slb.s3.small**'."\n"
.' - **slb.s3.medium**'."\n"
.' - **slb.s3.large**'."\n"
."\n"
.'每个地域支持的规格不同。关于每种规格的说明,参见[性能保障型实例](~~85931~~)。 '."\n"
."\n"
.'> 将共享型实例变更为保障型实例,SLB将有小概率可能性出现短暂的业务中断(10~30秒),建议您在业务低谷期进行变配,或者通过DNS实现实例间的负载均衡后,再进行变配操作。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'slb.s2.small',
],
],
[
'name' => 'AutoPay',
'in' => 'query',
'schema' => [
'description' => '是否自动付费。取值:'."\n"
."\n"
.'- **true**:自动支付订单。'."\n"
.'- **false**(默认值):在订单中心中进行支付。'."\n"
."\n"
.'> 该参数仅对预付费实例有效。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
'default' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'OrderId' => [
'description' => '预付费实例的订单ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '201429619788910',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ModifySpecNotAllowed',
'errorMessage' => 'LoadBalancerSpec not allowed for this instance',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Operation Denied, Your account does not have enough balance.',
],
[
'errorCode' => 'InvalidParameter.Bandwidth',
'errorMessage' => 'The param Bandwidth is invalid.',
],
[
'errorCode' => 'ChangeLbSpecNotAllowed',
'errorMessage' => 'You cannot change the specification for the specified load balancer.',
],
[
'errorCode' => 'OperationDenied.PayByCLCU',
'errorMessage' => 'The operation is not allowed because the instanceChargeType of loadbalancer is PayByCLCU.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"OrderId\\": 201429619788910,\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 201429619788910\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n","errorExample":""}]',
'title' => '修改负载均衡的实例规格',
'summary' => '修改负载均衡的实例规格。',
'description' => '仅按规格计费实例支持调用ModifyLoadBalancerInstanceSpec接口,按使用量计费实例不支持调用该接口。'."\n"
."\n"
.'CLB按规格计费实例已于2025年06月01日00:00:00(北京时间,UTC+8)停止售卖。详情请参见[传统型负载均衡CLB按规格计费实例停售公告](~~2872003~~)。'."\n"
.'',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyLoadBalancerInternetSpec' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08ex******',
],
],
[
'name' => 'InternetChargeType',
'in' => 'query',
'schema' => [
'description' => '公网类型实例的付费方式。取值:'."\n"
."\n"
.'- **paybybandwidth**:按带宽计费。'."\n"
."\n"
.'- **paybytraffic**:按流量计费 。'."\n",
'type' => 'string',
'required' => false,
'example' => 'paybytraffic',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '按固定带宽计费方式的公网类型实例的带宽峰值。单位:Mbps。'."\n"
."\n"
.'取值范围:**1**~**5000**(各地域的带宽峰值会有不同)。'."\n"
."\n"
.'>按流量计费(即**InternetChargeType**取值为**paybytraffic**)的实例不需要指定该参数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5000',
'minimum' => '1',
'example' => '10',
'default' => '-1',
],
],
[
'name' => 'AutoPay',
'in' => 'query',
'schema' => [
'description' => '是否是自动支付预付费公网实例的账单。取值:'."\n"
."\n"
.'- **true**(默认值):自动支付订单。'."\n"
.'- **false**:在订单中心进行支付。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
'default' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '修改公网负载均衡实例的计费方式。',
'type' => 'object',
'properties' => [
'OrderId' => [
'description' => '预付费实例的订单ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '20142961978****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationFailed.UnpaidBillsExist',
'errorMessage' => 'The account has unpaid bills. Please pay your overdue bill first.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Operation Denied. Unfinished order exists.',
],
[
'errorCode' => 'Instance.ShareSlbNotSupportPay95',
'errorMessage' => 'Illegal parameter. The share instance not support PayBy95 or PayByOld95.',
],
[
'errorCode' => 'Instance.Pay95RateInvalid',
'errorMessage' => 'Illegal parameter. The rate is illegal.',
],
[
'errorCode' => 'Instance.Pay95BandwidthIllegal',
'errorMessage' => 'Illegal parameter. The bandwidth is illegal.',
],
[
'errorCode' => 'Instance.InternetChargeTypeNotAllowed',
'errorMessage' => 'Illegal parameter. The specified InternetChargeType not allowed.',
],
[
'errorCode' => 'PAYFOR.ACCOUNT_MONEY_VALIDATE_ERROR',
'errorMessage' => 'Your channel partner account does not have sufficient funds, please contact your channel partner to recharge the account.',
],
[
'errorCode' => 'OperationDenied.PayByCLCU',
'errorMessage' => 'The operation is not allowed because the instanceChargeType of loadbalancer is PayByCLCU.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"OrderId\\": 0,\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '修改公网负载均衡实例的计费方式',
'summary' => '修改公网负载均衡实例的计费方式。',
'description' => '- 仅按规格计费实例支持调用ModifyLoadBalancerInternetSpec接口,按使用量计费实例不支持调用该接口。'."\n"
."\n"
.'- 如果只调整按带宽计费实例的带宽峰值,修改完成后,立即生效。'."\n"
."\n"
.'- 如果涉及公网计费方式的变更(例如公网计费方式从按固定带宽变更为按流量),则所有变配会在次日00:00:00生效。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyLoadBalancerPayType' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => true,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '88634',
'abilityTreeNodes' => [
'FEATUREslbMMPQ1U',
],
'autoTest' => false,
'notSupportAutoTestReason' => '废弃',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08ex*****',
],
],
[
'name' => 'PayType',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例付费模式,取值:'."\n"
."\n"
.'- **PrePay**:包年包月。'."\n"
."\n"
.'- **PayOnDemand**(默认值):按量付费。'."\n"
."\n"
.'按量计费转为包年包月计费,该参数取值只能为**PrePay**,且该实例之前的计费模式必须为**PayOnDemand**。',
'type' => 'string',
'required' => false,
'example' => 'PrePay',
'default' => 'PrePay',
],
],
[
'name' => 'PricingCycle',
'in' => 'query',
'schema' => [
'description' => '计费周期。'."\n"
."\n"
.'取值:**year**或**month** 。'."\n"
."\n"
.'>只有当**PayType**的参数取值为**PrePay**时有效,即仅对按量计费实例有效。',
'type' => 'string',
'required' => false,
'example' => 'month',
],
],
[
'name' => 'Duration',
'in' => 'query',
'schema' => [
'description' => '计费时长。'."\n"
."\n"
.'* 如果**PricingCycle**为**month**,取值**1**~**9**。'."\n"
."\n"
.'* 如果**PricingCycle**为**year**,取值**1**~**5**。'."\n"
."\n"
.'>只有当**PayType**的参数取值为**PrePay**时有效,即仅对按量计费实例有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'minimum' => '1',
'example' => '1',
],
],
[
'name' => 'AutoPay',
'in' => 'query',
'schema' => [
'description' => '是否自动付费。取值:'."\n"
."\n"
.'- **true**:自动付费。'."\n"
."\n"
.'- **false(默认值)**:不自动付费。'."\n"
."\n"
.'>只有当**PayType**的参数取值为**PrePay**时有效,即仅对按量计费实例有效。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
'default' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'OrderId' => [
'description' => '预付费实例的订单ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '20212961978891',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Cannot change internet payByTraffic loadBalancer from PayOnDemand to PrePay.',
],
[
'errorCode' => 'OperationDenied.PayByCLCU',
'errorMessage' => 'The operation is not allowed because the instanceChargeType of loadbalancer is PayByCLCU.',
],
],
],
'staticInfo' => [
'noSubstitutionReason' => '无替代API,历史原因导致该API被标记为弃用。',
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"OrderId\\": 20212961978891,\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\"\\n}","type":"json"}]',
'title' => '将按量计费实例转换为包年包月实例(已废弃)',
'summary' => '将按量计费实例转换为包年包月实例。',
'description' => ''."\n"
."\n"
.'> CLB包年包月实例2024年12月01日00:00:00起停止新购。详细信息请参见[传统型负载均衡CLB包年包月停售公告](https://help.aliyun.com/zh/slb/product-overview/announcement-of-suspension-of-traditional-load-balancing-clb-package-year-and-month?spm=a2c4g.11186623.help-menu-27537.d_0_1_2.29f5f9f2WbxpDz)。'."\n"
."\n"
.''."\n"
."\n"
.'仅按规格计费(公网为按固定带宽计费)的实例支持调用ModifyLoadBalancerPayType接口,按使用量计费实例不支持调用该接口。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerDeleteProtection' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~2401682~~) 接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08e*****',
],
],
[
'name' => 'DeleteProtection',
'in' => 'query',
'schema' => [
'description' => '负载均衡删除保护状态。取值:'."\n"
."\n"
.'- **on**:开启删除保护。'."\n"
.'- **off**:关闭删除保护。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'off',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '791D8B68-AE0F-4174-AF54-088C8B3C5D54',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationUnsupported.DeleteProtectionForPrePayInstance',
'errorMessage' => 'The operation failed because prepay instance does not support delete protection.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"791D8B68-AE0F-4174-AF54-088C8B3C5D54\\"\\n}","type":"json"}]',
'title' => '设置实例删除保护状态',
'summary' => '设置实例删除保护状态。',
],
'SetLoadBalancerModificationProtection' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08e*****',
],
],
[
'name' => 'ModificationProtectionStatus',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡修改保护状态:'."\n"
."\n"
.'- **NonProtection**:不限制修改保护,设置后会清空之前设置的**ModificationProtectionReason**。'."\n"
."\n"
.'- **ConsoleProtection**:实例控制台修改保护状态。'."\n"
."\n"
.'> 当取值为**ConsoleProtection**,即开启修改保护后,用户不能通过负载均衡控制台修改实例配置,但可以通过调用API修改实例配置。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ConsoleProtection',
],
],
[
'name' => 'ModificationProtectionReason',
'in' => 'query',
'schema' => [
'description' => '设置修改保护状态的原因,长度为1~80个字符,必须以字母或中文开头,支持数字、半角句号(.)、下划线(_)和短划线(-)。'."\n"
."\n"
.'> 仅在**ModificationProtectionStatus**为**ConsoleProtection**时有效。',
'type' => 'string',
'required' => false,
'example' => '配置变更',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '791D8B68-AE0F-4174-AF54-088C8B3C5D54',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationUnsupported.SetLoadBalancerStatus',
'errorMessage' => 'The zone of the loadBalancer does not support this operation.',
],
[
'errorCode' => 'InvalidParam.ModificationProtectionStatus',
'errorMessage' => 'The param ModificationProtectionStatus is invalid.',
],
[
'errorCode' => 'InvalidParam.ModificationProtectionReason',
'errorMessage' => 'The param ModificationProtectionReason is invalid.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"791D8B68-AE0F-4174-AF54-088C8B3C5D54\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 791D8B68-AE0F-4174-AF54-088C8B3C5D54\\n","errorExample":""}]',
'title' => '设置实例修改保护状态',
'summary' => '设置负载均衡实例修改保护状态。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerName' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08e******',
],
],
[
'name' => 'LoadBalancerName',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的新名称。'."\n"
."\n"
.'长度为1~80个英文、数字或中文字符,可包含半角句号(.)、下划线(_)和短划线(-)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'test1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '修改负载均衡实例的名称',
'summary' => '修改负载均衡实例的名称。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerStatus' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08e******',
],
],
[
'name' => 'LoadBalancerStatus',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例状态。取值:**active**或**inactive**。'."\n"
."\n"
.'- **active**(默认值)'."\n"
."\n"
.' '."\n"
.' 当负载均衡实例的状态为**active**时,实例中的监听可以根据规则转发接收的流量。'."\n"
."\n"
.' 传统型实例创建后的状态默认为**active**。'."\n"
.' '."\n"
.'- **inactive**'."\n"
."\n"
.' 当负载均衡实例的状态为**inactive**时,实例中的监听不会再转发接收的流量。'."\n"
."\n\n"
.'> 当一个实例下的所有监听都被删除后,实例状态会自动变更为**inactive**。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'active',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationUnsupported.SetLoadBalancerStatus',
'errorMessage' => 'The zone of the loadBalancer does not support this operation.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '设置负载均衡实例的状态',
'summary' => '设置负载均衡实例的状态。',
],
'ModifyLoadBalancerInstanceChargeType' => [
'summary' => '变更按量付费CLB实例的实例计费方式。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b3jus5hpenznuu****',
],
],
[
'name' => 'InternetChargeType',
'in' => 'query',
'schema' => [
'description' => '变更后的公网计费方式。'."\n"
.'仅取值**paybytraffic**:按使用流量计费。'."\n"
."\n"
.'> - 当**InstanceChargeType**参数的值为**PayByCLCU**时,只支持按使用流量计费。'."\n"
.'> - 如果公网计费方式从按固定带宽变更为按使用流量,则所有变配会在次日00:00:00生效。',
'type' => 'string',
'required' => false,
'example' => 'paybytraffic',
],
],
[
'name' => 'InstanceChargeType',
'in' => 'query',
'schema' => [
'description' => '变更后的实例计费方式。'."\n"
.'仅取值**PayByCLCU**:按使用量计费。'."\n",
'type' => 'string',
'required' => true,
'example' => 'PayByCLCU',
],
],
[
'name' => 'LoadBalancerSpec',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的规格。'."\n"
."\n"
.'您无需设置该参数。目前仅支持按规格计费转按使用量计费,不支持按使用量计费转按规格计费。'."\n",
'type' => 'string',
'required' => false,
'example' => 'slb.s1.small',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '按带宽计费的公网型实例的带宽峰值。'."\n"
."\n"
.'您无需设置该参数,按使用量计费实例的公网计费方式仅支持按使用流量计费。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5000',
'minimum' => '1',
'example' => '5',
'default' => '-1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationFailed.UnpaidBillsExist',
'errorMessage' => 'The account has unpaid bills. Please pay your overdue bill first.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Operation Denied. Unfinished order exists.',
],
[
'errorCode' => 'PAYFOR.ACCOUNT_MONEY_VALIDATE_ERROR',
'errorMessage' => 'Your channel partner account does not have sufficient funds, please contact your channel partner to recharge the account.',
],
[
'errorCode' => 'OperationDenied.PayByCLCU',
'errorMessage' => 'The operation is not allowed because the instanceChargeType of loadbalancer is PayByCLCU.',
],
[
'errorCode' => 'IllegalParam.InstanceChargeType',
'errorMessage' => 'The parameter InstanceChargeType is illegal.',
],
[
'errorCode' => 'IllegalParam.InternetChargeType',
'errorMessage' => 'The parameter InternetChargeType is illegal.',
],
[
'errorCode' => 'InvalidAction.RegionNotSupport',
'errorMessage' => 'The region does not support this action.',
],
[
'errorCode' => 'MissingParam.LoadBalancerSpec',
'errorMessage' => 'The param LoadBalancerSpec is required.',
],
[
'errorCode' => 'OperationDenied.PayBySpec',
'errorMessage' => 'The operation is not allowed because the instanceChargeType of loadbalancer is PayBySpec.',
],
[
'errorCode' => 'InvalidParameterBandwidth',
'errorMessage' => 'The specified Bandwidth is invalid.',
],
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified LoadBalancerSpec is invalid.',
],
[
'errorCode' => 'Forbidden.LcuToSpec',
'errorMessage' => 'User does not have permission modify InstanceChargeType to spec.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n","errorExample":""}]',
'title' => '变更按量付费CLB实例的实例计费方式',
'description' => '> - 按量付费实例中,仅支持按规格计费转按使用量计费,不支持按使用量计费转按规格计费。'."\n"
.'> - 目前,该接口不支持批量变更实例计费方式。',
],
'DescribeLoadBalancerAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88574',
'abilityTreeNodes' => [
'FEATUREslbL5KCST',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08ex****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VpcId' => [
'description' => '传统型负载均衡私网实例的专有网络ID。',
'type' => 'string',
'example' => 'vpc-25dvzy9f8****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '实例的标签键。N的取值范围:**1**~**20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'test',
],
'TagValue' => [
'description' => '实例的标签值。N的取值范围:**1**~**20**。一旦输入该值,可以为空字符串。'."\n"
."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'value',
],
],
],
],
],
],
'CreateTimeStamp' => [
'description' => '传统型负载均衡实例创建时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'CreateTime' => [
'description' => '传统型负载均衡实例的创建时间。格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2017-08-31T02:49:05Z',
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'example' => 'lb-bp1b6c719dfa08ex****',
],
'PayType' => [
'description' => '传统型负载均衡实例付费类型。取值:'."\n"
."\n"
.'- **PrePay**:包年包月。'."\n"
."\n"
.'- **PayOnDemand**(默认值):按量付费。'."\n"
."\n"
.'- **PayOnDemand**(默认值):按量付费。'."\n"
."\n",
'type' => 'string',
'example' => 'PayOnDemand',
],
'AddressType' => [
'description' => '传统型负载均衡实例的地址类型。',
'type' => 'string',
'example' => 'internet',
],
'NetworkType' => [
'description' => '传统型负载均衡实例的网络类型。',
'type' => 'string',
'example' => 'vpc',
],
'AddressIPVersion' => [
'description' => 'IP版本。取值:**ipv4**或**ipv6**。',
'type' => 'string',
'example' => 'ipv4',
],
'RenewalCycUnit' => [
'description' => '自动续费周期,取值:**Year**或**Month**(默认值)。'."\n"
."\n"
.'>该参数仅适用于中国站包年包月实例,即**PayType**的参数值为**PrePay**且**RenewalStatus**为**AutoRenewal**时有效。'."\n",
'type' => 'string',
'example' => 'Month',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'Bandwidth' => [
'description' => '按带宽计费的公网型实例的带宽峰值。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'LoadBalancerName' => [
'description' => '传统型负载均衡实例的名称。',
'type' => 'string',
'example' => 'lb-instance-test',
],
'Address' => [
'description' => '传统型负载均衡实例的服务地址。 ',
'type' => 'string',
'example' => '42.XX.XX.6',
],
'SlaveZoneId' => [
'description' => '传统型负载均衡实例的备可用区ID。',
'type' => 'string',
'example' => 'cn-hangzhou-d',
],
'EndTimeStamp' => [
'description' => '传统型负载均衡实例结束时间戳。 ',
'type' => 'integer',
'format' => 'int64',
'example' => '3249380160000',
],
'MasterZoneId' => [
'description' => '传统型负载均衡实例的主可用区ID。',
'type' => 'string',
'example' => 'cn-hangzhou-b',
],
'LoadBalancerSpec' => [
'description' => '传统型负载均衡实例的性能规格。'."\n"
.'> 按使用量计费的实例无性能规格属性,默认返回 **slb.lcu.elastic**。',
'type' => 'string',
'example' => 'slb.s1.small',
],
'AutoReleaseTime' => [
'description' => '释放时间的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1513947075000',
],
'ModificationProtectionReason' => [
'description' => '设置修改保护状态的原因,长度为1~80个字符,必须以字母或中文开头,支持数字、半角句号(.)、下划线(_)和短划线(-)。'."\n"
."\n"
.'> 仅在**ModificationProtectionStatus**为**ConsoleProtection**时有效。',
'type' => 'string',
'example' => '实例业务保障期',
],
'RegionId' => [
'description' => '传统型负载均衡实例所在地域ID。 ',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'ModificationProtectionStatus' => [
'description' => '传统型负载均衡修改保护状态:'."\n"
."\n"
.'- **NonProtection**:不限制修改保护,设置后会清空之前设置的**ModificationProtectionReason**。'."\n"
.'- **ConsoleProtection**:实例控制台修改保护状态。'."\n"
."\n"
.'> 当取值为**ConsoleProtection**,即开启修改保护后,用户不能通过负载均衡控制台修改实例配置,但可以通过调用API修改实例配置。',
'type' => 'string',
'example' => 'ConsoleProtection',
],
'EndTime' => [
'description' => '传统型负载均衡实例结束时间。 ',
'type' => 'string',
'example' => '2022-09-08T16:00:00Z',
],
'VSwitchId' => [
'description' => '私网实例的交换机ID。',
'type' => 'string',
'example' => 'vsw-255ecrwq5****',
],
'LoadBalancerStatus' => [
'description' => '传统型负载均衡实例状态:'."\n"
."\n"
.'- **inactive**:实例已停止,此状态的实例监听不会再转发流量。'."\n"
."\n"
.'- **active**:实例运行中,实例创建后,默认状态为**active**。'."\n"
."\n"
.'- **locked**:实例已锁定,实例已经欠费或被阿里云锁定。'."\n"
.' ',
'type' => 'string',
'example' => 'active',
],
'ResourceGroupId' => [
'description' => '企业资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3rtop****',
],
'InternetChargeType' => [
'description' => '公网类型实例付费方式。取值:'."\n"
."\n"
.'- **paybytraffic**:按使用流量计费。'."\n"
.'- **paybybandwidth**:按固定带宽计费。',
'type' => 'string',
'example' => 'paybytraffic',
],
'DeleteProtection' => [
'description' => '是否开启实例删除保护。'."\n"
."\n"
.'取值:**on**或**off**。',
'type' => 'string',
'example' => 'off',
],
'RegionIdAlias' => [
'description' => '传统型负载均衡实例所属的地域别名。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'RenewalStatus' => [
'description' => '续费状态,取值:'."\n"
."\n"
.'- **AutoRenewal**:自动续费。'."\n"
.'- **Normal**:非自动续费,您需要自行续费负载均衡实例。'."\n"
.'- **NotRenewal**:不再续费。返回该值后,系统不再发送到期提醒,只在到期前第三天发送不续费提醒。'."\n"
."\n"
.'> 该参数仅适用于中国站包年包月实例,即**PayType**的参数值为**PrePay**时有效。',
'type' => 'string',
'example' => 'AutoRenewal',
],
'RenewalDuration' => [
'description' => '自动续费时长,仅在**RenewalStatus**为**AutoRenewal**时有效。'."\n"
."\n"
.'- **RenewalCycUnit**为**Year**时,取值:**1~5**。'."\n"
.'- **RenewalCycUnit**为**Month**时,取值:**1~9**。'."\n"
."\n"
.'> 该参数仅适用于中国站包年包月实例,即**PayType**的参数值为**PrePay**时有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'ListenerPorts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ListenerPort' => [
'description' => '传统型负载均衡实例前端使用的端口。',
'type' => 'array',
'items' => [
'description' => '传统型负载均衡实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
],
],
],
'ListenerPortsAndProtocal' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ListenerPortAndProtocal' => [
'description' => '监听端口或协议。',
'type' => 'array',
'items' => [
'description' => '传统型负载均衡实例前端使用的协议。 ',
'type' => 'object',
'properties' => [
'ListenerProtocal' => [
'description' => '传统型负载均衡实例前端使用的协议。 ',
'type' => 'string',
'example' => 'http',
],
'ListenerPort' => [
'description' => '实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '443',
],
],
],
],
],
],
'ListenerPortsAndProtocol' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ListenerPortAndProtocol' => [
'description' => '实例前端使用的端口和协议。',
'type' => 'array',
'items' => [
'description' => '实例前端使用的端口和协议。',
'type' => 'object',
'properties' => [
'ListenerPort' => [
'description' => '实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'ListenerProtocol' => [
'description' => '实例前端使用的协议。 ',
'type' => 'string',
'example' => 'https',
],
'ListenerForward' => [
'description' => '是否启用监听转发。',
'type' => 'string',
'example' => 'on',
],
'Description' => [
'description' => '监听端口和协议描述。',
'type' => 'string',
'example' => '监听描述',
],
'ForwardPort' => [
'description' => '转发到的目的监听端口,必须是已经存在的HTTPS监听端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '443',
],
],
],
],
],
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '实例的后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '实例的后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型。'."\n"
.'ecs:ECS实例(默认)。'."\n"
.'eni:弹性网卡实例。'."\n"
.'eci:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重。 ',
'type' => 'integer',
'format' => 'int32',
'example' => '90',
],
'Description' => [
'description' => '后端服务器描述。'."\n"
."\n"
.'> 若用户未设置**Description**,则该参数不返回。',
'type' => 'string',
'example' => '用来接收转发请求的后端服务器',
],
'ServerIp' => [
'description' => 'ENI或ECI的实例ID。',
'type' => 'string',
'example' => '192.XX.XX.11',
],
'ServerId' => [
'description' => '后端服务器实例ID。',
'type' => 'string',
'example' => 'i-2zej4lxhjoq1icu*****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VpcId\\": \\"vpc-25dvzy9f8****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"test\\",\\n \\"TagValue\\": \\"value\\"\\n }\\n ]\\n },\\n \\"CreateTimeStamp\\": 1504147745000,\\n \\"CreateTime\\": \\"2017-08-31T02:49:05Z\\",\\n \\"LoadBalancerId\\": \\"lb-bp1b6c719dfa08ex****\\",\\n \\"PayType\\": \\"PayOnDemand\\",\\n \\"AddressType\\": \\"internet\\",\\n \\"NetworkType\\": \\"vpc\\",\\n \\"AddressIPVersion\\": \\"ipv4\\",\\n \\"RenewalCycUnit\\": \\"Month\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"Bandwidth\\": 5,\\n \\"LoadBalancerName\\": \\"lb-instance-test\\",\\n \\"Address\\": \\"42.XX.XX.6\\",\\n \\"SlaveZoneId\\": \\"cn-hangzhou-d\\",\\n \\"EndTimeStamp\\": 3249380160000,\\n \\"MasterZoneId\\": \\"cn-hangzhou-b\\",\\n \\"LoadBalancerSpec\\": \\"slb.s1.small\\",\\n \\"AutoReleaseTime\\": 1513947075000,\\n \\"ModificationProtectionReason\\": \\"实例业务保障期\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ModificationProtectionStatus\\": \\"ConsoleProtection\\",\\n \\"EndTime\\": \\"2022-09-08T16:00:00Z\\",\\n \\"VSwitchId\\": \\"vsw-255ecrwq5****\\",\\n \\"LoadBalancerStatus\\": \\"active\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3rtop****\\",\\n \\"InternetChargeType\\": \\"paybytraffic\\",\\n \\"DeleteProtection\\": \\"off\\",\\n \\"RegionIdAlias\\": \\"cn-hangzhou\\",\\n \\"RenewalStatus\\": \\"AutoRenewal\\",\\n \\"RenewalDuration\\": 1,\\n \\"ListenerPorts\\": {\\n \\"ListenerPort\\": [\\n 80\\n ]\\n },\\n \\"ListenerPortsAndProtocal\\": {\\n \\"ListenerPortAndProtocal\\": [\\n {\\n \\"ListenerProtocal\\": \\"http\\",\\n \\"ListenerPort\\": 443\\n }\\n ]\\n },\\n \\"ListenerPortsAndProtocol\\": {\\n \\"ListenerPortAndProtocol\\": [\\n {\\n \\"ListenerPort\\": 80,\\n \\"ListenerProtocol\\": \\"https\\",\\n \\"ListenerForward\\": \\"on\\",\\n \\"Description\\": \\"监听描述\\",\\n \\"ForwardPort\\": 443\\n }\\n ]\\n },\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": 90,\\n \\"Description\\": \\"用来接收转发请求的后端服务器\\",\\n \\"ServerIp\\": \\"192.XX.XX.11\\",\\n \\"ServerId\\": \\"i-2zej4lxhjoq1icu*****\\"\\n }\\n ]\\n },\\n \\"InstanceChargeType\\": \\"PayBySpec\\"\\n}","errorExample":""},{"type":"xml","example":"\\n vpc-25dvzy9f8****\\n \\n test\\n value\\n \\n 1504147745000\\n 2017-08-31T02:49:05Z\\n lb-bp1b6c719dfa08ex****\\n PayOnDemand\\n internet\\n vpc\\n ipv4\\n Month\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n 5\\n lb-instance-test\\n 42.XX.XX.6\\n cn-hangzhou-d\\n 32493801600000\\n cn-hangzhou-b\\n slb.s1.small\\n 1513947075000\\n 实例业务保障期\\n cn-hangzhou\\n ConsoleProtection\\n 2022-09-08T16:00:00Z\\n vsw-255ecrwq5****\\n active\\n rg-atstuj3rtop****\\n paybytraffic\\n off\\n hangzhou\\n AutoRenewal\\n 1\\n 80\\n \\n http\\n 443\\n \\n \\n 80\\n https\\n on\\n 监听描述\\n 443\\n \\n \\n ecs\\n 90\\n 用来接收转发请求的后端服务器\\n 192.XX.XX.11\\n i-2zej4lxhjoq1icu*****\\n \\n PayBySpec\\n","errorExample":""}]',
'title' => '查询指定负载均衡实例的详细信息',
'summary' => '查询指定负载均衡实例的详细信息。',
'description' => '> 如果后端服务器设置在虚拟服务器组下面,请调用[DescribeVServerGroupAttribute](~~35224~~)查询。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLoadBalancers' => [
'summary' => '查询已创建的负载均衡实例。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '88581',
'abilityTreeNodes' => [
'FEATUREslbL5KCST',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~2401682~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ServerId',
'in' => 'query',
'schema' => [
'description' => '添加的后端服务器ID。',
'type' => 'string',
'required' => false,
'example' => 'i-2zebcbq******',
],
],
[
'name' => 'AddressIPVersion',
'in' => 'query',
'schema' => [
'description' => 'IP版本,可以设置为**ipv4**或者**ipv6**。',
'type' => 'string',
'required' => false,
'example' => 'ipv4',
],
],
[
'name' => 'LoadBalancerStatus',
'in' => 'query',
'schema' => [
'description' => '实例状态。取值:'."\n"
."\n"
.'- **inactive**: 实例已停止,此状态的实例监听不会再转发流量。'."\n"
."\n"
.'- **active**: 实例运行中,实例创建后,默认状态为**active**。'."\n"
."\n"
.'- **locked**: 实例已锁定。当负载均衡实例到期后,但到期时间未超过7天时,负载均衡实例进入锁定状态。此种状态下,您不能对负载均衡实例进行任何操作,并且实例不再会进行流量转发,但会保留实例的IP和其它配置。',
'type' => 'string',
'required' => false,
'example' => 'active',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。'."\n"
."\n"
.'支持多值查询,最多可输入10个ID,以半角逗号(,)分隔。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp1b6c719dfa****',
],
],
[
'name' => 'LoadBalancerName',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例名称。'."\n"
."\n"
.'长度为1~80个英文或中文字符,必须以大小字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。'."\n"
."\n"
.'支持多值查询,最多可输入10个名称,以半角逗号(,)分隔。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'ServerIntranetAddress',
'in' => 'query',
'schema' => [
'description' => '添加的后端服务器的内网地址。'."\n"
."\n"
.'支持多值查询,以半角逗号(,)分隔。',
'type' => 'string',
'required' => false,
'example' => '10.XX.XX.102',
],
],
[
'name' => 'AddressType',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的网络类型。取值:'."\n"
."\n"
.'* **internet**:创建公网负载均衡实例后,系统会分配一个公网IP地址,可以转发公网请求。'."\n"
."\n"
.'* **intranet**:创建内网负载均衡实例后,系统会分配一个内网IP地址,仅可转发内网请求。',
'type' => 'string',
'required' => false,
'example' => 'intranet',
],
],
[
'name' => 'InternetChargeType',
'in' => 'query',
'schema' => [
'description' => '公网计费方式。取值:'."\n"
.'- **paybybandwidth**:按带宽计费。'."\n"
."\n"
.'- **paybytraffic**:按流量计费。'."\n"
."\n"
.'当**PayType**参数的值为**PrePay**时,只支持按带宽计费。当**InstanceChargeType**参数的值为**PayByCLCU**时,只支持按流量计费。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'paybytraffic',
],
],
[
'name' => 'VpcId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所属的VPC ID。',
'type' => 'string',
'required' => false,
'example' => 'vpc-bp1aevy8sof****',
],
],
[
'name' => 'VSwitchId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所属的交换机ID。',
'type' => 'string',
'required' => false,
'example' => 'vsw-bp12mw1f8k3****',
],
],
[
'name' => 'NetworkType',
'in' => 'query',
'schema' => [
'description' => '私网实例的网络类型。取值:'."\n"
."\n"
.'- **vpc**:专有网络类型。 '."\n"
."\n"
.'- **classic**:经典网络类型。',
'type' => 'string',
'required' => false,
'example' => 'vpc',
],
],
[
'name' => 'Address',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的服务地址。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'MasterZoneId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的主可用区ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou-b',
],
],
[
'name' => 'SlaveZoneId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的备可用区ID。'."\n"
."\n"
.'目前对金融云用户暂时不支持多可用区功能。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou-d',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例绑定的标签列表,其结构是一个JSON dictionary,包含标签键和标签值。'."\n"
."\n"
.'一次请求中,绑定的标签列表中最多支持10个标签。',
'type' => 'string',
'required' => false,
'example' => '[{"tagKey":"Key1","tagValue":"Value1"}]',
],
],
[
'name' => 'PayType',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例付费模式。取值:'."\n"
."\n"
.'* **PayOnDemand**:按量付费。'."\n"
."\n"
.'- **PrePay**:包年包月。',
'type' => 'string',
'required' => false,
'example' => 'PayOnDemand',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '企业资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-acfmxazb4p****',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页查询时的页码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '1000',
'minimum' => '1',
'example' => '1',
'default' => '0',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页查询时设置的每页行数。'."\n"
."\n"
.'取值范围:**1**~**100**。'."\n"
."\n"
.'> 如果设置了**PageSize**,则需要同时设置**PageNumber**。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '100',
'minimum' => '1',
'example' => '50',
'default' => '10',
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceDept',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceJoshua',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E',
],
'PageNumber' => [
'description' => '实例列表页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '当前分页的行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'TotalCount' => [
'description' => '根据过滤条件得到的实例总个数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'LoadBalancers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'LoadBalancer' => [
'description' => '数组格式,返回负载均衡实例列表。',
'type' => 'array',
'items' => [
'description' => '数组格式,返回负载均衡实例列表。'."\n"
."\n",
'type' => 'object',
'properties' => [
'VpcId' => [
'description' => '私网负载均衡实例的专有网络ID。',
'type' => 'string',
'example' => 'vpc-25dvzy9f8****',
],
'CreateTimeStamp' => [
'description' => '实例创建时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'LoadBalancerId' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1b6c719dfa****',
],
'CreateTime' => [
'description' => '实例创建时间,格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2021-12-02T02:49:05Z',
],
'PayType' => [
'description' => '负载均衡实例付费模式,取值:'."\n"
."\n"
.'* **PayOnDemand**:按量付费。'."\n"
."\n"
.'- **PrePay**:包年包月。',
'type' => 'string',
'example' => 'PayOnDemand',
],
'AddressType' => [
'description' => '实例的网络类型。取值:'."\n"
."\n"
.'* **internet**:创建公网负载均衡实例后,系统会分配一个公网IP地址,可以转发公网请求。'."\n"
."\n"
.'* **intranet**:创建内网负载均衡实例后,系统会分配一个内网IP地址,仅可转发内网请求。',
'type' => 'string',
'example' => 'intranet',
],
'NetworkType' => [
'description' => '私网负载均衡实例的网络类型,取值:'."\n"
."\n"
.'* **vpc**:专有网络类型。'."\n"
."\n"
.'* **classic**:经典网络类型。',
'type' => 'string',
'example' => 'vpc',
],
'AddressIPVersion' => [
'description' => 'IP版本,可以设置为**ipv4**或者**ipv6**。',
'type' => 'string',
'example' => 'ipv4',
],
'LoadBalancerName' => [
'description' => '负载均衡实例的名称。',
'type' => 'string',
'example' => 'lb-bp1o94dp5i6ea****',
],
'Bandwidth' => [
'description' => '监听的带宽峰值,单位:Mbps。',
'type' => 'integer',
'format' => 'int32',
'example' => '-1',
],
'Address' => [
'description' => '负载均衡实例服务地址。 ',
'type' => 'string',
'example' => '100.XX.XX.28',
],
'SlaveZoneId' => [
'description' => '实例的备可用区ID。',
'type' => 'string',
'example' => 'cn-hangzhou-d',
],
'MasterZoneId' => [
'description' => '实例的主可用区ID。',
'type' => 'string',
'example' => 'cn-hangzhou-b',
],
'InternetChargeTypeAlias' => [
'description' => '公网计费方式。取值:'."\n"
."\n"
.'- **paybybandwidth**:按带宽计费。'."\n"
."\n"
.'- **paybytraffic**:按流量计费'."\n"
."\n"
.'当**PayType**参数的值为**PrePay**时,只支持按带宽计费。当**InstanceChargeType**参数的值为**PayByCLCU**时,只支持按流量计费。',
'type' => 'string',
'example' => 'paybybandwidth',
],
'LoadBalancerSpec' => [
'description' => '负载均衡实例的性能规格。'."\n"
.'> 按流量计费的实例无性能规格属性,默认返回 **slb.lcu.elastic**。',
'type' => 'string',
'example' => 'slb.s1.small',
],
'RegionId' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'ModificationProtectionReason' => [
'description' => '设置修改保护状态的原因,长度为1~80个字符,必须以字母或中文开头,支持数字、半角句号(.)、下划线(_)和短划线(-)。'."\n"
."\n"
.'> 仅在`ModificationProtectionStatus`为**ConsoleProtection**时有效。',
'type' => 'string',
'example' => 'ManagedInstance',
],
'ModificationProtectionStatus' => [
'description' => '负载均衡修改保护状态:'."\n"
."\n"
.'- **NonProtection**:不限制修改保护,设置后会清空之前设置的`ModificationProtectionReason`。'."\n"
."\n"
.'- **ConsoleProtection**:实例控制台修改保护状态。'."\n"
."\n"
.'> 当取值为**ConsoleProtection**,即开启修改保护后,用户不能通过负载均衡控制台修改实例配置,但可以通过调用API修改实例配置。'."\n",
'type' => 'string',
'example' => 'ConsoleProtection',
],
'VSwitchId' => [
'description' => '私网负载均衡实例的交换机ID。',
'type' => 'string',
'example' => 'vsw-255ecr****',
],
'LoadBalancerStatus' => [
'description' => '负载均衡实例状态。取值:'."\n"
."\n"
.'* **inactive**:实例已停止,此状态的实例监听不会再转发流量。'."\n"
."\n"
.'* **active**:实例运行中,实例创建后,默认状态为**active**。'."\n"
."\n"
.'* **locked**:实例已锁定,实例已经被锁定。',
'type' => 'string',
'example' => 'active',
],
'ResourceGroupId' => [
'description' => '企业资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3r****',
],
'InternetChargeType' => [
'description' => '公网类型实例付费方式。取值:'."\n"
.'- **3**:按带宽计费(**paybybandwidth**)。'."\n"
."\n"
.'- **4**:按流量计费(**paybytraffic**)。'."\n"
."\n"
.'当**PayType**参数的值为**PrePay**时,只支持按带宽计费。当**InstanceChargeType**参数的值为**PayByCLCU**时,只支持按流量计费。'."\n",
'type' => 'string',
'example' => '3',
],
'DeleteProtection' => [
'description' => '负载均衡删除保护状态。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:关闭。',
'type' => 'string',
'example' => 'off',
],
'RegionIdAlias' => [
'description' => '传统型负载均衡实例的地域名称。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表',
'type' => 'array',
'items' => [
'description' => '标签列表',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'testvalue',
],
'TagKey' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'testkey',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidTag',
'errorMessage' => 'The specified tags is invalid.',
],
[
'errorCode' => 'TooManyResult',
'errorMessage' => 'fuzzy query retrieve too many instances.',
],
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 50,\\n \\"TotalCount\\": 1,\\n \\"LoadBalancers\\": {\\n \\"LoadBalancer\\": [\\n {\\n \\"VpcId\\": \\"vpc-25dvzy9f8****\\",\\n \\"CreateTimeStamp\\": 1504147745000,\\n \\"LoadBalancerId\\": \\"lb-bp1b6c719dfa****\\",\\n \\"CreateTime\\": \\"2021-12-02T02:49:05Z\\",\\n \\"PayType\\": \\"PayOnDemand\\",\\n \\"AddressType\\": \\"intranet\\",\\n \\"NetworkType\\": \\"vpc\\",\\n \\"AddressIPVersion\\": \\"ipv4\\",\\n \\"LoadBalancerName\\": \\"lb-bp1o94dp5i6ea****\\",\\n \\"Bandwidth\\": -1,\\n \\"Address\\": \\"100.XX.XX.28\\",\\n \\"SlaveZoneId\\": \\"cn-hangzhou-d\\",\\n \\"MasterZoneId\\": \\"cn-hangzhou-b\\",\\n \\"InternetChargeTypeAlias\\": \\"paybybandwidth\\",\\n \\"LoadBalancerSpec\\": \\"slb.s1.small\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ModificationProtectionReason\\": \\"ManagedInstance\\",\\n \\"ModificationProtectionStatus\\": \\"ConsoleProtection\\",\\n \\"VSwitchId\\": \\"vsw-255ecr****\\",\\n \\"LoadBalancerStatus\\": \\"active\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3r****\\",\\n \\"InternetChargeType\\": \\"3\\",\\n \\"DeleteProtection\\": \\"off\\",\\n \\"RegionIdAlias\\": \\"cn-hangzhou\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagValue\\": \\"testvalue\\",\\n \\"TagKey\\": \\"testkey\\"\\n }\\n ]\\n },\\n \\"InstanceChargeType\\": \\"PayBySpec\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E\\n 1\\n 50\\n 1\\n \\n vpc-25dvzy9f8****\\n 1504147745000\\n lb-bp1b6c719dfa****\\n 2021-12-02T02:49:05Z\\n PayOnDemand\\n intranet\\n vpc\\n ipv4\\n lb-bp1o94dp5i6ea****\\n -1\\n 100.XX.XX.28\\n cn-hangzhou-d\\n cn-hangzhou-b\\n paybybandwidth\\n slb.s1.small\\n cn-hangzhou\\n 托管实例\\n ConsoleProtection\\n vsw-255ecr****\\n active\\n rg-atstuj3r****\\n 3\\n off\\n hangzhou\\n \\n FinanceJoshua\\n FinanceDept\\n \\n PayBySpec\\n \\n","errorExample":""}]',
'title' => '查询已创建的负载均衡实例',
],
'DeleteLoadBalancerListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。'."\n"
."\n\n"
.'> 当您所选地域的Endpoint(服务地址)为slb.aliyuncs.com时,**RegionId**必填。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp13jaf5qli5xmgl1miup',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1~65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的协议。'."\n"
."\n"
.'> 相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ListenerForwardExist',
'errorMessage' => 'The specified listener is forwarded by the other listener, the ListenerForward relationship should be deleted firstly.',
],
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'The specified listener is not allowed to operate.',
],
],
404 => [
[
'errorCode' => 'ResourceNotFound.Listener',
'errorMessage' => 'The specified listener is not found.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '删除监听',
'summary' => '删除监听。',
'description' => '> 只有当监听的状态为**stopped**或者**running**时,才可以删除。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'StartLoadBalancerListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp13jaf5qli5*********',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1-65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
."\n"
.'> 相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Operation.Deny',
'errorMessage' => 'The specified listener is configuring, please try again later.',
],
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'The specified listener is not allowed to operate.',
],
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '启动监听',
'summary' => '启动监听。',
'description' => '在调用该接口时,注意:'."\n"
."\n"
.'* 监听状态必须为stopped时,才可以调用该接口。'."\n"
."\n"
.'* 接口调用成功后,监听进入starting状态。'."\n"
."\n"
.'* 当监听所属负载均衡实例的状态为locked时,调用此接口会失败。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'StopLoadBalancerListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp13jaf5qli5xmgl1miup',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1-65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
."\n"
.'> 相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'The specified listener is not allowed to operate.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '停止监听',
'summary' => '停止监听。',
'description' => '在调用该接口时,注意:'."\n"
."\n"
.'- 接口调用成功后,监听进入stopped状态。'."\n"
."\n"
.'- 当监听所属负载均衡实例的状态为locked时,调用此接口会失败。'."\n"
."\n"
.'> 停止监听会使访问中断,请谨慎操作。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLoadBalancerListeners' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88579',
'abilityTreeNodes' => [
'FEATUREslbOL61C3',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。'."\n"
."\n"
.'> 当您所选地域的Endpoint(服务地址)为slb.aliyuncs.com时,`RegionId`必填。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '是否拥有下一次查询的令牌(Token)。取值:'."\n"
.'- 第一次查询和没有下一次查询时,均无需填写。'."\n"
.'- 如果有下一次查询,取值为上一次API调用返回的NextToken值。',
'type' => 'string',
'required' => false,
'example' => 'FFmyTO70tTpLG6I3FmYAXGKPd****',
],
],
[
'name' => 'MaxResults',
'in' => 'query',
'schema' => [
'description' => '分批次查询时每次显示的条目数。'."\n"
."\n"
.'取值范围:**1**~**100**,入参为空时,默认值:**20**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '101',
'minimum' => '0',
'example' => '50',
'default' => '20',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡监听协议。取值:'."\n"
.'- **tcp**'."\n"
.'- **udp**'."\n"
.'- **http**'."\n"
.'- **https**'."\n",
'type' => 'string',
'required' => false,
'example' => 'http',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '传统型负载均衡实例的ID列表,最多支持10个实例ID。'."\n"
."\n\n"
.'> 非SDK调用,请使用LoadBalancerId.N形式添加参数。',
'type' => 'array',
'items' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => false,
'example' => 'lb-uf6so8u4g35prnvsw****',
],
'required' => false,
'example' => 'lb-123wrwer',
'maxItems' => 11,
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => 'CLB实例使用的监听端口。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '0',
'example' => '443',
],
],
[
'name' => 'Description',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '自定义监听名称。',
'type' => 'string',
'required' => false,
'example' => 'HTTPS_443',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '是否拥有下一次查询的令牌(Token)。取值:'."\n"
.'- 如果**NextToken**为空表示没有下一次查询。'."\n"
.'- 如果**NextToken**有返回值,该取值表示下一次查询开始的令牌。',
'type' => 'string',
'example' => 'FFmyTO70tTpLG6I3FmYAXGKPd****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'TotalCount' => [
'description' => '本次请求条件下的数据总量。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'MaxResults' => [
'description' => '分批次查询时每次显示的条目数。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'Listeners' => [
'description' => '返回传统型负载均衡的监听列表。'."\n"
."\n"
.'> 实例未配置监听时,不会返回该参数。',
'type' => 'array',
'items' => [
'description' => '返回传统型负载均衡的监听列表。'."\n"
."\n"
.'> 实例未配置监听时,不会返回该参数。',
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '访问控制类型。取值:'."\n"
."\n"
.'- **white**:仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**:来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。',
'type' => 'string',
'example' => 'white',
],
'Status' => [
'description' => '监听的状态。取值:'."\n"
."\n"
.'- **running**:表示监听正常运行。'."\n"
."\n"
.'- **stopped**:表示监听运行停止。',
'type' => 'string',
'example' => 'running',
],
'VServerGroupId' => [
'description' => '监听绑定的虚拟服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j****',
],
'ListenerProtocol' => [
'description' => '传统型负载均衡监听协议。',
'type' => 'string',
'example' => 'http',
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'example' => 'lb-bp1b6c719dfa****',
],
'ListenerPort' => [
'description' => '监听端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'example' => 'acl-a2do9e413e0spzasx****',
],
'Scheduler' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'- **sch**:基于源 IP 地址的一致性 hash,相同的源地址会调度到相同的后端服务器。'."\n"
.'- **tch**:基于四元组的一致性 hash(源 IP+目的 IP+源端口+目的端口),相同的流会调度到相同的后端服务器。'."\n"
.'- **qch**:基于 QUIC Connection ID 一致性 hash,相同的 QUIC Connection ID 会调度到相同的后端服务器。'."\n"
."\n"
.'> 仅性能保障型实例支持 **sch**、**tch** 和 **qch** 一致性 hash 算法。',
'type' => 'string',
'example' => 'wrr',
],
'Bandwidth' => [
'description' => '监听的带宽峰值。单位:Mbps。',
'type' => 'integer',
'format' => 'int32',
'example' => '-1',
],
'Description' => [
'description' => '监听描述。',
'type' => 'string',
'example' => 'test',
],
'AclStatus' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'BackendServerPort' => [
'description' => '后端服务器的端口。'."\n"
."\n"
.'> `VServerGroupId`和`MasterSlaveServerGroupId`均为空时,此参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'AclIds' => [
'description' => '访问控制策略组ID列表。',
'type' => 'array',
],
'HTTPListenerConfig' => [
'description' => 'HTTP监听配置。',
'type' => 'object',
'properties' => [
'HealthCheckHttpVersion' => [
'description' => '健康检查HTTP协议版本。',
'type' => 'string',
'example' => 'HTTP 1.0',
],
'XForwardedFor_ClientSrcPort' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'Cookie' => [
'description' => '服务器上配置的Cookie。',
'type' => 'string',
'example' => 'B490B5EBF6F3CD402E515D22BCDA****',
],
'Gzip' => [
'description' => '是否开启Gzip压缩。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的端口。'."\n"
."\n"
.'> 当**HealthCheck**值为**on**时该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'HealthCheckTimeout' => [
'description' => '每次健康检查响应的最大超时间,单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'HealthCheckType' => [
'description' => '健康检查协议。',
'type' => 'string',
'example' => 'tcp',
],
'CookieTimeout' => [
'description' => 'Cookie超时时间。单位:秒。'."\n"
."\n"
.'取值:**1**~**86400**。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'HealthCheckDomain' => [
'description' => '健康检查的域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'UnhealthyThreshold' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_SLBID' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'ForwardPort' => [
'description' => 'HTTP转发至HTTPS的监听端口。'."\n"
."\n"
.'> 如果**ListenerForward**的值为**off**,该参数不显示。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码。',
'type' => 'string',
'example' => 'http_2xx,http_3xx',
],
'ListenerForward' => [
'description' => '是否开启HTTP至HTTPS监听转发。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor' => [
'description' => '是否通过`XForwardedFor`的方式获取来访者真实IP。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'IdleTimeout' => [
'description' => '指定连接空闲超时时间。单位:秒。取值范围:**1**~**60**。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立连接。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
'RequestTimeout' => [
'description' => '指定请求超时时间。单位:秒。取值范围:**1**~**180**。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回`HTTP 504`错误码。',
'type' => 'integer',
'format' => 'int32',
'example' => '60',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔,单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'XForwardedFor_SLBPORT' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'HealthCheckURI' => [
'description' => '健康检查的URI。',
'type' => 'string',
'example' => '/test/index.html',
],
'StickySessionType' => [
'description' => 'Cookie的处理方式。取值:'."\n"
."\n"
.'- **insert**:植入Cookie。客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP和HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'- **server**:重写Cookie。负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n",
'type' => 'string',
'example' => 'insert',
],
'HealthyThreshold' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_proto' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor_SLBIP' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'StickySession' => [
'description' => '是否开启会话保持。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'HealthCheckMethod' => [
'description' => '健康检查方式。取值:**head**或**get**。',
'type' => 'string',
'example' => 'get',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
],
],
'HTTPSListenerConfig' => [
'description' => 'HTTPS监听配置。',
'type' => 'object',
'properties' => [
'XForwardedFor_ClientCertClientVerify' => [
'description' => '是否通过`XForwardedFor_ClientCertClientVerify`头字段获取对访问负载均衡实例客户端证书的校验结果。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'HealthCheckHttpVersion' => [
'description' => '健康检查HTTP协议版本。',
'type' => 'string',
'example' => 'HTTP 1.0',
],
'XForwardedFor_ClientSrcPort' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'Cookie' => [
'description' => '服务器上配置的Cookie。',
'type' => 'string',
'example' => 'B490B5EBF6F3CD402E515D22BCDA****',
],
'Gzip' => [
'description' => '是否开启Gzip压缩。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'EnableHttp2' => [
'description' => '是否开启`HTTP 2.0`特性。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'CACertificateId' => [
'description' => 'CA证书ID。',
'type' => 'string',
'example' => 'idkp-234-cn-test-0****',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'HealthCheckTimeout' => [
'description' => '每次健康检查响应的最大超时间。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'HealthCheckType' => [
'description' => '健康检查协议。',
'type' => 'string',
'example' => 'tcp',
],
'CookieTimeout' => [
'description' => 'Cookie超时时间。单位:秒。'."\n"
."\n"
.'取值:**1**~**86400**。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'HealthCheckDomain' => [
'description' => '健康检查的域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'UnhealthyThreshold' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_SLBID' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor_ClientCertSubjectDN' => [
'description' => '是否通过`XForwardedFor_ClientCertSubjectDN`头字段获取访问负载均衡实例客户端证书的所有者信息。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码。',
'type' => 'string',
'example' => 'http_2xx,http_3xx',
],
'XForwardedFor_ClientCertFingerprint' => [
'description' => '是否通过`XForwardedFor_ClientCertFingerprint`头字段获取访问负载均衡实例客户端证书的指纹。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'XForwardedFor' => [
'description' => '是否开启通过`XForwardedFor`的方式获取来访者真实IP。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'RequestTimeout' => [
'description' => '指定请求超时时间,单位:秒。取值范围:**1**~**180**。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回`HTTP 504`错误码。',
'type' => 'integer',
'format' => 'int32',
'example' => '60',
],
'IdleTimeout' => [
'description' => '指定连接空闲超时时间。单位:秒。取值范围:**1**~**60**。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立连接。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
'ServerCertificateId' => [
'description' => '服务器证书的ID。',
'type' => 'string',
'example' => 'idkp-123-cn-test-0****',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'XForwardedFor_SLBPORT' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'HealthCheckURI' => [
'description' => '健康检查的URI。',
'type' => 'string',
'example' => '/test/index.html',
],
'StickySessionType' => [
'description' => 'Cookie的处理方式。'."\n"
."\n"
.'- **insert**:植入Cookie。客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP和HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'- **server**:重写Cookie。负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。',
'type' => 'string',
'example' => 'insert',
],
'XForwardedFor_ClientCertIssuerDN' => [
'description' => '是否通过`XForwardedFor_ClientCertIssuerDN`头字段获取访问负载均衡实例客户端证书的发行者信息。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'HealthyThreshold' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_proto' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor_SLBIP' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'StickySession' => [
'description' => '是否开启会话保持。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'HealthCheckMethod' => [
'description' => '健康检查方式。',
'type' => 'string',
'example' => 'get',
],
'TLSCipherPolicy' => [
'description' => '安全策略包含HTTPS可选的TLS协议版本和配套的加密算法套件。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_0**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.0、TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_1**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_2**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_2\\_strict**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA和ECDHE-RSA-AES256-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_2\\_strict\\_with\\_1\\_3**'."\n"
.' '."\n"
.' 支持TLS版本:TLSv1.2及TLSv1.3。'."\n"
.' '."\n"
.' 支持的加密算法套件:TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256、TLS_AES_128_CCM_SHA256、TLS_AES_128_CCM_8_SHA256、ECDHE-ECDSA-AES128-GCM-SHA256、ECDHE-ECDSA-AES256-GCM-SHA384、ECDHE-ECDSA-AES128-SHA256、ECDHE-ECDSA-AES256-SHA384、ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-ECDSA-AES128-SHA、ECDHE-ECDSA-AES256-SHA、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA。 ',
'type' => 'string',
'example' => 'tls_cipher_policy_1_0',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
],
],
'TCPListenerConfig' => [
'description' => 'TCP监听配置。',
'type' => 'object',
'properties' => [
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码。',
'type' => 'string',
'example' => 'http_2xx,http_3xx',
],
'ConnectionDrainTimeout' => [
'description' => '设置连接优雅中断超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**10~900**。',
'type' => 'integer',
'format' => 'int32',
'example' => '300',
],
'PersistenceTimeout' => [
'description' => '是否开启了会话保持。单位:秒。'."\n"
."\n"
.'取值范围:**0**~**3600**。'."\n"
."\n"
.'取值为**0**时,表示未开启。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔,单位为秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'HealthCheckURI' => [
'description' => '健康检查的URI。',
'type' => 'string',
'example' => '/test/index.html',
],
'HealthCheckConnectPort' => [
'description' => '健康检查使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'EstablishedTimeout' => [
'description' => '连接超时时间。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'HealthCheckType' => [
'description' => '健康检查协议。',
'type' => 'string',
'example' => 'tcp',
],
'HealthCheckConnectTimeout' => [
'description' => '健康检查超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**300**。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'MasterSlaveServerGroupId' => [
'description' => '监听绑定的主备服务器组ID。',
'type' => 'string',
'example' => 'rsp-0bfucw*****',
],
'HealthyThreshold' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'HealthCheckDomain' => [
'description' => '健康检查的域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'UnhealthyThreshold' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'ConnectionDrain' => [
'description' => '是否开启连接优雅中断。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'HealthCheckMethod' => [
'description' => '健康检查方式。',
'type' => 'string',
'example' => 'get',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'ProxyProtocolV2Enabled' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。',
'type' => 'string',
'example' => 'false',
],
],
],
'UDPListenerConfig' => [
'description' => 'UDP监听配置。',
'type' => 'object',
'properties' => [
'ConnectionDrainTimeout' => [
'description' => '设置连接优雅中断超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**10~900**。',
'type' => 'integer',
'format' => 'int32',
'example' => '300',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔,单位为秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'HealthCheckExp' => [
'description' => 'UDP监听健康检查的响应串。',
'type' => 'string',
'example' => 'ok',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'HealthCheckConnectTimeout' => [
'description' => '健康检查响应超时时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'MasterSlaveServerGroupId' => [
'description' => '绑定的主备服务器组ID。',
'type' => 'string',
'example' => 'rsp-0bfucw****',
],
'HealthyThreshold' => [
'description' => '健康检查阈值。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'UnhealthyThreshold' => [
'description' => '不健康检查阈值。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'ConnectionDrain' => [
'description' => '是否开启连接优雅中断。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'off',
],
'HealthCheckReq' => [
'description' => 'UDP监听健康检查的请求串。',
'type' => 'string',
'example' => 'hello',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是'."\n"
.'- **off**:否',
'type' => 'string',
'example' => 'on',
],
'ProxyProtocolV2Enabled' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。',
'type' => 'string',
'example' => 'false',
],
],
],
'Tags' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '资源的标签值。',
'type' => 'string',
'example' => 'TestValue',
],
'TagKey' => [
'description' => '资源的标签键。',
'type' => 'string',
'example' => 'TestKey',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'IllegalParam.ListenerProtocol',
'errorMessage' => 'The param of ListenerProtocol is illegal.',
],
[
'errorCode' => 'IllegalParam.MaxResults',
'errorMessage' => 'The param of MaxResults is illegal.',
],
[
'errorCode' => 'IllegalParam.NextToken',
'errorMessage' => 'The param of NextToken is illegal.',
],
[
'errorCode' => 'IllegalParamSize.LoadBalancerId',
'errorMessage' => 'The param size of LoadBalancerId is illegal.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param of TagKey is missing.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"NextToken\\": \\"FFmyTO70tTpLG6I3FmYAXGKPd****\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"TotalCount\\": 10,\\n \\"MaxResults\\": 50,\\n \\"Listeners\\": [\\n {\\n \\"AclType\\": \\"white\\",\\n \\"Status\\": \\"running\\",\\n \\"VServerGroupId\\": \\"rsp-cige6j****\\",\\n \\"ListenerProtocol\\": \\"http\\",\\n \\"LoadBalancerId\\": \\"lb-bp1b6c719dfa****\\",\\n \\"ListenerPort\\": 80,\\n \\"AclId\\": \\"acl-a2do9e413e0spzasx****\\",\\n \\"Scheduler\\": \\"wrr\\",\\n \\"Bandwidth\\": -1,\\n \\"Description\\": \\"test\\",\\n \\"AclStatus\\": \\"off\\",\\n \\"BackendServerPort\\": 80,\\n \\"AclIds\\": [\\n \\"\\"\\n ],\\n \\"HTTPListenerConfig\\": {\\n \\"HealthCheckHttpVersion\\": \\"HTTP 1.0\\",\\n \\"XForwardedFor_ClientSrcPort\\": \\"on\\",\\n \\"Cookie\\": \\"B490B5EBF6F3CD402E515D22BCDA****\\",\\n \\"Gzip\\": \\"on\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"HealthCheckTimeout\\": 3,\\n \\"HealthCheckType\\": \\"tcp\\",\\n \\"CookieTimeout\\": 500,\\n \\"HealthCheckDomain\\": \\"www.example.com\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"XForwardedFor_SLBID\\": \\"on\\",\\n \\"ForwardPort\\": 80,\\n \\"HealthCheckHttpCode\\": \\"http_2xx,http_3xx\\",\\n \\"ListenerForward\\": \\"on\\",\\n \\"XForwardedFor\\": \\"on\\",\\n \\"IdleTimeout\\": 15,\\n \\"RequestTimeout\\": 60,\\n \\"HealthCheckInterval\\": 5,\\n \\"XForwardedFor_SLBPORT\\": \\"on\\",\\n \\"HealthCheckURI\\": \\"/test/index.html\\",\\n \\"StickySessionType\\": \\"insert\\",\\n \\"HealthyThreshold\\": 4,\\n \\"XForwardedFor_proto\\": \\"on\\",\\n \\"XForwardedFor_SLBIP\\": \\"on\\",\\n \\"StickySession\\": \\"on\\",\\n \\"HealthCheckMethod\\": \\"get\\",\\n \\"HealthCheck\\": \\"on\\"\\n },\\n \\"HTTPSListenerConfig\\": {\\n \\"XForwardedFor_ClientCertClientVerify\\": \\"off\\",\\n \\"HealthCheckHttpVersion\\": \\"HTTP 1.0\\",\\n \\"XForwardedFor_ClientSrcPort\\": \\"off\\",\\n \\"Cookie\\": \\"B490B5EBF6F3CD402E515D22BCDA****\\",\\n \\"Gzip\\": \\"on\\",\\n \\"EnableHttp2\\": \\"off\\",\\n \\"CACertificateId\\": \\"idkp-234-cn-test-0****\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"HealthCheckTimeout\\": 3,\\n \\"HealthCheckType\\": \\"tcp\\",\\n \\"CookieTimeout\\": 500,\\n \\"HealthCheckDomain\\": \\"www.example.com\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"XForwardedFor_SLBID\\": \\"on\\",\\n \\"XForwardedFor_ClientCertSubjectDN\\": \\"off\\",\\n \\"HealthCheckHttpCode\\": \\"http_2xx,http_3xx\\",\\n \\"XForwardedFor_ClientCertFingerprint\\": \\"off\\",\\n \\"XForwardedFor\\": \\"on\\",\\n \\"RequestTimeout\\": 60,\\n \\"IdleTimeout\\": 15,\\n \\"ServerCertificateId\\": \\"idkp-123-cn-test-0****\\",\\n \\"HealthCheckInterval\\": 5,\\n \\"XForwardedFor_SLBPORT\\": \\"off\\",\\n \\"HealthCheckURI\\": \\"/test/index.html\\",\\n \\"StickySessionType\\": \\"insert\\",\\n \\"XForwardedFor_ClientCertIssuerDN\\": \\"off\\",\\n \\"HealthyThreshold\\": 4,\\n \\"XForwardedFor_proto\\": \\"on\\",\\n \\"XForwardedFor_SLBIP\\": \\"on\\",\\n \\"StickySession\\": \\"on\\",\\n \\"HealthCheckMethod\\": \\"get\\",\\n \\"TLSCipherPolicy\\": \\"tls_cipher_policy_1_0\\",\\n \\"HealthCheck\\": \\"on\\"\\n },\\n \\"TCPListenerConfig\\": {\\n \\"HealthCheckHttpCode\\": \\"http_2xx,http_3xx\\",\\n \\"ConnectionDrainTimeout\\": 300,\\n \\"PersistenceTimeout\\": 0,\\n \\"HealthCheckInterval\\": 5,\\n \\"HealthCheckURI\\": \\"/test/index.html\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"EstablishedTimeout\\": 500,\\n \\"HealthCheckType\\": \\"tcp\\",\\n \\"HealthCheckConnectTimeout\\": 100,\\n \\"MasterSlaveServerGroupId\\": \\"rsp-0bfucw*****\\",\\n \\"HealthyThreshold\\": 4,\\n \\"HealthCheckDomain\\": \\"www.example.com\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"ConnectionDrain\\": \\"off\\",\\n \\"HealthCheckMethod\\": \\"get\\",\\n \\"HealthCheck\\": \\"on\\",\\n \\"ProxyProtocolV2Enabled\\": \\"false\\"\\n },\\n \\"UDPListenerConfig\\": {\\n \\"ConnectionDrainTimeout\\": 300,\\n \\"HealthCheckInterval\\": 5,\\n \\"HealthCheckExp\\": \\"ok\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"HealthCheckConnectTimeout\\": 100,\\n \\"MasterSlaveServerGroupId\\": \\"rsp-0bfucw****\\",\\n \\"HealthyThreshold\\": 4,\\n \\"UnhealthyThreshold\\": 4,\\n \\"ConnectionDrain\\": \\"off\\",\\n \\"HealthCheckReq\\": \\"hello\\",\\n \\"HealthCheck\\": \\"on\\",\\n \\"ProxyProtocolV2Enabled\\": \\"false\\"\\n },\\n \\"Tags\\": [\\n {\\n \\"TagValue\\": \\"TestValue\\",\\n \\"TagKey\\": \\"TestKey\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n FFmyTO70tTpLG6I3FmYAXGKPd****\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n 10\\n 50\\n \\n white\\n running\\n rsp-cige6j****\\n http\\n lb-bp1b6c719dfa****\\n 80\\n nacl-a2do9e413e0spzasx****\\n wrr\\n -1\\n test\\n off\\n 80\\n \\n HTTP 1.0\\n on\\n B490B5EBF6F3CD402E515D22BCDA****\\n on\\n 8080\\n 3\\n tcp\\n 500\\n www.example.com\\n 4\\n on\\n 80\\n http_2xx,http_3xx\\n on\\n on\\n 15\\n 60\\n 5\\n on\\n /test/index.html\\n insert\\n 4\\n on\\n on\\n on\\n get\\n on\\n \\n \\n off\\n HTTP 1.0\\n off\\n B490B5EBF6F3CD402E515D22BCDA****\\n on\\n off\\n idkp-234-cn-test-0****\\n 8080\\n 3\\n tcp\\n 500\\n www.example.com\\n 4\\n on\\n off\\n http_2xx,http_3xx\\n off\\n on\\n 60\\n 15\\n idkp-123-cn-test-0****\\n 5\\n off\\n /test/index.html\\n insert\\n off\\n 4\\n on\\n on\\n on\\n get\\n tls_cipher_policy_1_0\\n on\\n \\n \\n http_2xx,http_3xx\\n 300\\n 0\\n 5\\n /test/index.html\\n 8080\\n 500\\n tcp\\n 100\\n rsp-0bfucw*****\\n 4\\n www.example.com\\n 4\\n off\\n get\\n on\\n false\\n \\n \\n 300\\n 5\\n ok\\n 8080\\n 100\\n rsp-0bfucw****\\n 4\\n 4\\n off\\n hello\\n on\\n false\\n \\n \\n TestValue\\n TestKey\\n \\n \\n","errorExample":""}]',
'title' => '查询负载均衡监听列表',
'summary' => '查询负载均衡监听列表详情。',
'description' => '- 您已经创建了传统型负载均衡实例。具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
.'- 您已经为创建的传统型负载均衡实例配置了监听。具体操作,请参见:'."\n"
."\n"
.' - [CreateLoadBalancerUDPListener](~~27595~~)'."\n"
.' - [CreateLoadBalancerTCPListener](~~27594~~)'."\n"
.' - [CreateLoadBalancerHTTPListener](~~27592~~) '."\n"
.' - [CreateLoadBalancerHTTPSListener](~~27593~~)',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateLoadBalancerTCPListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88528',
'abilityTreeNodes' => [
'FEATUREslbOL61C3',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~2401682~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c719dfa08ex****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'BackendServerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例后端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。'."\n"
."\n"
.'如果不使用服务器组(不指定**vServerGroupId**),则该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值,单位:Mbps。取值:'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为-1,即不限制带宽峰值。'."\n"
."\n"
.'- **1**~**5120**: 对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**(默认值):权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'- **sch**:基于源IP地址的一致性hash,相同的源地址会调度到相同的后端服务器。'."\n"
."\n"
.'- **tch**:基于四元组的一致性hash(源IP+目的IP+源端口+目的端口),相同的流会调度到相同的后端服务器。'."\n"
."\n"
.'> 仅性能保障型实例支持**sch**和**tch**一致性hash算法。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
'default' => 'wrr',
],
],
[
'name' => 'PersistenceTimeout',
'in' => 'query',
'schema' => [
'description' => '会话保持的超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**0~3600**。'."\n"
."\n"
.'默认值:**0**,表示关闭会话保持。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '3600',
'minimum' => '0',
'example' => '0',
'default' => '0',
],
],
[
'name' => 'EstablishedTimeout',
'in' => 'query',
'schema' => [
'description' => '连接超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**10**~**900**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '900',
'minimum' => '10',
'example' => '500',
'default' => '900',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值范围: **2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
'default' => '3',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
'default' => '3',
],
],
[
'name' => 'HealthCheckConnectTimeout',
'in' => 'query',
'schema' => [
'description' => '每次健康检查响应的最大超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**300**。'."\n"
."\n"
.'默认值:**5**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '100',
'default' => '5',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。'."\n"
."\n"
.'不设置此参数时,表示使用后端服务端口(**BackendServerPort**)。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'healthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**50**。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名。取值:'."\n"
."\n"
.'* **$_ip**: 后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'* **domain**:域名长度为1~80,只能包含字母、数字、半角句号(.)和短划线(-)。',
'type' => 'string',
'required' => false,
'example' => '172.XX.XX.6',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。长度限制为1~80,只能使用字母、数字、短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、井号(#)和and(&)这些字符。 URI不能只为正斜线(/),但必须以正斜线(/)开头。'."\n"
."\n"
.'当TCP监听需要使用HTTP健康检查时可配置此参数,如不配置则按TCP健康检查。',
'type' => 'string',
'required' => false,
'example' => '/test/index.html',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。取值:'."\n"
."\n"
.'- **http_2xx**(默认值)'."\n"
.'- **http_3xx**'."\n"
.'- **http_4xx**'."\n"
.'- **http_5xx**',
'type' => 'string',
'required' => false,
'example' => 'http_2xx,http_3xx',
],
],
[
'name' => 'HealthCheckType',
'in' => 'query',
'schema' => [
'description' => '健康检查类型。取值:'."\n"
."\n"
.'- **tcp**(默认值)'."\n"
.'- **http**',
'type' => 'string',
'required' => false,
'example' => 'tcp',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j****',
],
],
[
'name' => 'MasterSlaveServerGroupId',
'in' => 'query',
'schema' => [
'description' => '主备服务器组ID。'."\n"
."\n"
.'> 虚拟服务器组ID和主备服务器组ID只能选择一个。',
'type' => 'string',
'required' => false,
'example' => 'rsp-0bfucw****',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'acl-uf60jwfiv6******',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型:'."\n"
."\n"
.'* **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。'."\n"
.'设置白名单存在一定业务风险。'."\n"
.' '."\n"
.' 一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'* **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'black',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**(默认值):不开启。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'tcp_80',
],
],
[
'name' => 'ConnectionDrain',
'in' => 'query',
'schema' => [
'description' => '是否开启连接优雅中断。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
."\n"
.'- **off**:不开启。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'ConnectionDrainTimeout',
'in' => 'query',
'schema' => [
'description' => '设置连接优雅中断超时时间。单位:秒。'."\n"
."\n"
.'取值范围:**10**~**900**。'."\n"
."\n"
.'> 当**ConnectionDrain**取值为**on**时,该选项必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '300',
],
],
[
'name' => 'ProxyProtocolV2Enabled',
'in' => 'query',
'schema' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**(默认值):否。'."\n",
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'HealthCheckSwitch',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**(默认值):开启。'."\n"
.'- **off**:不开启。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue.SpecNotSupport',
'errorMessage' => 'The loadBalancer of shared spec does not support the parameter value, %s.',
],
[
'errorCode' => 'OperationNotSupport.Acl',
'errorMessage' => 'The cloud box instance does not support acl.',
],
[
'errorCode' => 'InvalidParameterValue.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter value, %s.',
],
[
'errorCode' => 'Abs.VServerGroupIdAndMasterSlaveServerGroupId.MissMatch',
'errorMessage' => 'The parameters VServerGroupId or MasterSlaveServerGroupId miss match.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameterValue.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter value, %s.',
],
[
'errorCode' => 'ListenerProcessing',
'errorMessage' => 'A previous configuration of the listener is pending, please try again later.',
],
[
'errorCode' => 'AclNotExist',
'errorMessage' => 'Acl does not exist.',
],
[
'errorCode' => 'InvalidParameter.ListenerPortConflict',
'errorMessage' => 'There is conflict listener port exists.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'InvalidParam.VServerGroupId',
'errorMessage' => 'The specified VServerGroupId is invalid.',
],
[
'errorCode' => 'MissingParam.HealthCheckConnectPort',
'errorMessage' => 'The parameter HealthCheckConnectPort is required.',
],
[
'errorCode' => 'InvalidParam.ListenerPort',
'errorMessage' => 'The specified ListenerPort is invalid.',
],
[
'errorCode' => 'InvalidParam.StartPort',
'errorMessage' => 'The specified StartPort is invalid.',
],
[
'errorCode' => 'InvalidParamSize.PortRange',
'errorMessage' => 'The size of param PortRange is invalid.',
],
[
'errorCode' => 'InvalidParam.EndPort',
'errorMessage' => 'The specified EndPort is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationUnsupported.SetAccessControl',
'errorMessage' => 'The singleTunnel/anyTunnel loadbalancer does not support config AccessControlList.',
],
[
'errorCode' => 'InvalidParam.PortRange',
'errorMessage' => 'The specified PortRange is invalid.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'LbNotSupportTcpssl',
'errorMessage' => 'You cannot create a TCP SSL type listener for the specified load balancer.',
],
[
'errorCode' => 'LbSupportTcpsslOnly',
'errorMessage' => 'The specified load balancer supports TCP SSL type listener only.',
],
[
'errorCode' => 'ListenerNotSupportRule',
'errorMessage' => 'You cannot create a rule for the specified listener.',
],
[
'errorCode' => 'ListenerPortConflict',
'errorMessage' => 'The specified ListenerPort is conflict with other listener.',
],
[
'errorCode' => 'ResourceNotFound.VServerGroup',
'errorMessage' => '%s.',
],
[
'errorCode' => 'IllegalParam.FailoverThreshold',
'errorMessage' => 'The parameter FailoverThreshold is illegal.',
],
[
'errorCode' => 'IllegalParam.FailoverStrategy',
'errorMessage' => 'The parameter FailoverStrategy is illegal.',
],
[
'errorCode' => 'MasterSlaveServerConflict',
'errorMessage' => 'The servers are conflict for MasterSlaveGroup.',
],
[
'errorCode' => 'OperationDenied.HealthCheckClosedForMasterSlaveMode',
'errorMessage' => 'The operation is denied because of HealthCheckClosedForMasterSlaveMode.',
],
[
'errorCode' => 'IllegalParam.HealthCheck',
'errorMessage' => 'The param of HelathCheck is illegal.',
],
[
'errorCode' => 'Mismatch.SlbSpecTypeAndListenerProtocol',
'errorMessage' => 'The SlbSpecType and ListenerProtocol are mismatched.',
],
[
'errorCode' => 'OperationDenied.FullNatModeNotAllowed',
'errorMessage' => 'The operation is not allowed because of FullNatModeNotAllowed.',
],
[
'errorCode' => 'OperationDenied.OnlyIpv4SlbSupport',
'errorMessage' => 'The operation is not allowed because of OnlyIpv4SlbSupport.',
],
[
'errorCode' => 'SpecNotSupportParameter',
'errorMessage' => 'The instance with share spec does not support FullNatEnabled parameter.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'MissingParameter',
'errorMessage' => 'The BackendServerPort or VServerGroupId is required at lease one.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '创建TCP监听',
'summary' => '创建TCP监听。',
'description' => '> 新建的监听的状态为**stopped**。创建完成后,调用[StartLoadBalancerListener](~~2401757~~)接口启动监听来转发流量。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerTCPListenerAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '88674',
'abilityTreeNodes' => [
'FEATUREslbOL61C3',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1ygod3yctvg1y****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值。单位:Mbps。取值:**-1**或**1**~**5120**。'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为**-1**,即不限制带宽峰值。'."\n"
.'- **1**~**5120**:对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5120',
'minimum' => '-1',
'example' => '43',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的概率也越高。'."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
.'- **sch**:基于源IP地址的一致性哈希,相同的源地址会调度到相同的后端服务器。'."\n"
.'- **tch**:基于四元组的一致性哈希(源IP、目的IP、源端口和目的端口),相同的流会调度到相同的后端服务器。'."\n"
."\n"
.'> - 仅性能保障型实例支持**sch**和**tch**一致性哈希算法。'."\n"
.'> - CLB不支持**wrr**和**rr**算法变更为一致性哈希算法,也不支持一致性哈希算法互转。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
],
],
[
'name' => 'PersistenceTimeout',
'in' => 'query',
'schema' => [
'description' => '会话保持的超时时间。单位:秒,取值范围:**0**~**3600**。'."\n"
."\n"
.'默认值:**0**,表示关闭会话保持。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '3600',
'minimum' => '0',
'example' => '0',
],
],
[
'name' => 'EstablishedTimeout',
'in' => 'query',
'schema' => [
'description' => '连接超时时间。单位:秒。取值范围:**10**~**900**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '900',
'minimum' => '10',
'example' => '500',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckConnectTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。单位:秒,取值范围:**1**~**300**。'."\n"
."\n"
.'如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。'."\n"
."\n"
.'> 如果该值小于**HealthCheckInterval**的值,则该值无效,超时时间为**HealthCheckInterval**的值。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '100',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。取值范围:**1**~**65535**。'."\n"
."\n"
.'不设置此参数时,表示使用**BackendServerPort**(后端服务端口)。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '8080',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**50**。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '5',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名。当TCP监听需要使用HTTP健康检查时可配置此参数,如不配置则按TCP健康检查。'."\n"
."\n"
.'* **$_ip**:后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用后端服务器的私网IP当做健康检查使用的域名。'."\n"
.'* **domain**:域名,长度为1~80个字符,支持字母、数字、半角句号(.)和短划线(-)。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。长度为1~80个字符,支持字母、数字和短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、半角问号(?)、井号(#)和and(&)这些字符。URI不能只为正斜线(/),但必须以正斜线(/)开头。'."\n"
."\n"
.'当TCP监听需要使用HTTP健康检查时,可配置此参数。'."\n"
."\n"
.'如不配置,则使用TCP健康检查。',
'type' => 'string',
'required' => false,
'example' => '/test/index.html',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。'."\n"
."\n"
.'取值:**http_2xx**、**http_3xx**、**http_4xx**或**http_5xx**。',
'type' => 'string',
'required' => false,
'example' => 'http_2xx',
],
],
[
'name' => 'HealthCheckType',
'in' => 'query',
'schema' => [
'description' => '健康检查类型。取值:**tcp**或**http**。'."\n",
'type' => 'string',
'required' => false,
'example' => 'tcp',
],
],
[
'name' => 'SynProxy',
'in' => 'query',
'schema' => [
'description' => '是否开启负载均衡的攻击防护功能SynProxy。取值:'."\n"
."\n"
.'- **enable**:开启。'."\n"
.'- **disable**:不开启。'."\n"
."\n"
.'建议一般情况下不要调整这个参数,由负载均衡控制。',
'type' => 'string',
'required' => false,
'example' => 'enable',
],
],
[
'name' => 'VServerGroup',
'in' => 'query',
'schema' => [
'description' => '是否使用虚拟服务器组。取值:'."\n"
."\n"
.'- **on**:使用。'."\n"
.'- **off**:不使用。'."\n"
."\n"
.'> **VserverGroup**和**MasterSlaveServerGroup**只允许一个值为**on**。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j5****',
],
],
[
'name' => 'MasterSlaveServerGroupId',
'in' => 'query',
'schema' => [
'description' => '主备服务器组ID。'."\n"
."\n"
.'>虚拟服务器组ID和主备服务器组ID只能选择一个。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige****',
],
],
[
'name' => 'MasterSlaveServerGroup',
'in' => 'query',
'schema' => [
'description' => '是否使用主备服务器组。取值:'."\n"
."\n"
.'- **on**:使用。'."\n"
.'- **off**:不使用。'."\n"
."\n"
.'**VserverGroup**和**MasterSlaveServerGroup**只允许一个值为**on**。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'当**AclStatus**参数值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => '12333',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型。取值:'."\n"
."\n"
.'- **white**:仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
.' '."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**:不会转发来自所选访问控制策略组中设置的IP地址或地址段,黑名单适用于只限制某些特定IP访问的场景。 '."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
."\n"
.'- **on**:开启访问控制。'."\n"
.'- **off**:关闭访问控制。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'tcp_80',
],
],
[
'name' => 'ConnectionDrain',
'in' => 'query',
'schema' => [
'description' => '是否开启连接优雅中断。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:不开启。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'ConnectionDrainTimeout',
'in' => 'query',
'schema' => [
'description' => '设置连接优雅中断超时时间。当**ConnectionDrain**取值为**on**时,该选项必选。单位:秒。'."\n"
."\n"
.'取值范围:**10**~**900**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '300',
],
],
[
'name' => 'ProxyProtocolV2Enabled',
'in' => 'query',
'schema' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'HealthCheckSwitch',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:不开启。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue.SpecNotSupport',
'errorMessage' => 'The loadBalancer of shared spec does not support the parameter value, %s.',
],
[
'errorCode' => 'OperationNotSupport.Acl',
'errorMessage' => 'The cloud box instance does not support acl.',
],
[
'errorCode' => 'InvalidParameterValue.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter value, %s.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameterValue.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter value, %s.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'OperationFailed.ServerGroupInUse',
'errorMessage' => 'The VServerGroup or MasterSlaveServerGroup can not be close for this listener.',
],
[
'errorCode' => 'InvalidParam.VServerGroupId',
'errorMessage' => 'The specified VServerGroupId is invalid.',
],
[
'errorCode' => 'MissingParam.HealthCheckConnectPort',
'errorMessage' => 'The parameter HealthCheckConnectPort is required.',
],
[
'errorCode' => 'InvalidParam.ListenerPort',
'errorMessage' => 'The specified ListenerPort is invalid.',
],
[
'errorCode' => 'InvalidParam.StartPort',
'errorMessage' => 'The specified StartPort is invalid.',
],
[
'errorCode' => 'InvalidParamSize.PortRange',
'errorMessage' => 'The size of param PortRange is invalid.',
],
[
'errorCode' => 'InvalidParam.EndPort',
'errorMessage' => 'The specified EndPort is invalid.',
],
[
'errorCode' => 'InvalidParam.PortRange',
'errorMessage' => 'The specified PortRange is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'ResourceNotFound.VServerGroup',
'errorMessage' => '%s.',
],
[
'errorCode' => 'IllegalParam.FailoverStrategy',
'errorMessage' => 'The parameter FailoverStrategy is illegal.',
],
[
'errorCode' => 'IllegalParam.FailoverThreshold',
'errorMessage' => 'The parameter FailoverThreshold is illegal.',
],
[
'errorCode' => 'MasterSlaveServerConflict',
'errorMessage' => 'The servers are conflict for MasterSlaveGroup.',
],
[
'errorCode' => 'MissingParam.VServerGroupId',
'errorMessage' => 'The parameter VServerGroupId is missing.',
],
[
'errorCode' => 'OperationDenied.HealthCheckClosedForMasterSlaveMode',
'errorMessage' => 'The operation is denied because of HealthCheckClosedForMasterSlaveMode.',
],
[
'errorCode' => 'InvalidParam.HealthCheck',
'errorMessage' => 'The param of HealthCheck is illegal.',
],
[
'errorCode' => 'OperationDenied.MasterSlaveGroupLogEnabled',
'errorMessage' => 'The operation is denied because of MasterSlaveGroupLogEnabled.',
],
[
'errorCode' => 'OperationDenied.NotSupportAcl',
'errorMessage' => 'The operation is denied because The single Tunnel or any Tunnel loadbalancer does not support config AccessControlList.',
],
[
'errorCode' => 'OperationDenied.FullNatModeNotAllowed',
'errorMessage' => 'The operation is not allowed because of FullNatModeNotAllowed.',
],
[
'errorCode' => 'OperationDenied.OnlyIpv4SlbSupport',
'errorMessage' => 'The operation is not allowed because of OnlyIpv4SlbSupport.',
],
[
'errorCode' => 'SpecNotSupportParameter',
'errorMessage' => 'The instance with share spec does not support FullNatEnabled parameter.',
],
[
'errorCode' => 'Abs.VServerGroupIdAndMasterSlaveServerGroupId.MissMatch',
'errorMessage' => 'Virtual service group ID or master slave server group ID is missing. Please check the input parameters.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '修改TCP监听的配置',
'summary' => '修改TCP监听的配置。',
'description' => '- 您已经创建传统型负载均衡。具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
."\n"
.'- 您已经创建TCP监听。具体操作,请参见[CreateLoadBalancerTCPListener](~~27594~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLoadBalancerTCPListenerAttribute' => [
'summary' => '查询TCP监听配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88587',
'abilityTreeNodes' => [
'FEATUREslbZQW9H1',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1ygod3yctvg1y****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '绑定的服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6******8',
],
'Status' => [
'description' => '当前监听的状态。取值:'."\n"
."\n"
.'* **running**:监听正常运行中。'."\n"
."\n"
.'* **stopped**:监听停止。',
'type' => 'string',
'example' => 'stopped',
],
'AclType' => [
'description' => '访问控制类型:'."\n"
."\n"
.'* **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于应用只允许特定IP访问的场景。'."\n"
.'设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'* **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于应用只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'example' => 'white',
],
'ConnectionDrainTimeout' => [
'description' => '设置连接优雅中断超时时间。当**ConnectionDrain**取值为**on**时,返回该值。'."\n"
."\n"
.'取值范围:10~900秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '300',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'HealthCheckConnectPort' => [
'description' => '健康检查使用的端口。取值:**1**~**65535**。不设置此参数时,表示使用后端服务端口(BackendServerPort)。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'Description' => [
'description' => '自定义监听名称。',
'type' => 'string',
'example' => 'TCP_80',
],
'Bandwidth' => [
'description' => '监听的带宽峰值,单位Mbps。取值:'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为-1,即不限制带宽峰值。'."\n"
."\n"
.'- **1**~**5120**:对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。',
'type' => 'integer',
'format' => 'int32',
'example' => '-1',
],
'HealthCheckType' => [
'description' => 'TCP协议监听的健康检查方式。'."\n"
."\n"
.'取值:**tcp**或**http**。',
'type' => 'string',
'example' => 'tcp',
],
'MasterSlaveServerGroupId' => [
'description' => '绑定的主备服务器组ID。'."\n"
.' ',
'type' => 'string',
'example' => 'rsp-0bfucw****',
],
'BackendServerPort' => [
'description' => '传统型负载均衡实例后端使用的端口。'."\n"
."\n"
.'> 当后端服务器组为虚拟服务器组时,该参数不显示。'."\n",
'type' => 'integer',
'format' => 'int32',
'example' => '443',
],
'AclStatus' => [
'description' => '是否开启访问控制功能。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:不开启。',
'type' => 'string',
'example' => 'off',
],
'HealthCheckDomain' => [
'description' => '用于健康检查的域名。取值:'."\n"
."\n"
.'- **$_ip**:后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'- **domain**:域名长度为1~80个字符,只能包含字母、数字、半角句号(.)和短划线(-)。',
'type' => 'string',
'example' => 'www.domain.com',
],
'UnhealthyThreshold' => [
'description' => '不健康检查阈值。健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。取值:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码。',
'type' => 'string',
'example' => 'http_2xx',
],
'ProxyProtocolV2Enabled' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。',
'type' => 'boolean',
'example' => 'false',
],
'PersistenceTimeout' => [
'description' => '会话保持的超时时间。'."\n"
."\n"
.'取值:**0**~**3600**秒。默认值:**0**,表示关闭会话保持。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'ListenerPort' => [
'description' => '传统型负载均衡实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '110',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔,取值:**1**~**50**秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'HealthCheckURI' => [
'description' => '用于健康检查的URL。长度限制为1~80个字符,只能使用字母、数字和短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、半角问号(?)、井号(#)和and(&)这些字符。 URL不能只为正斜线(/),但必须以正斜线(/)开头。',
'type' => 'string',
'example' => '/test/index.html',
],
'AclId' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'example' => 'acl-uf60jwfi******',
],
'SynProxy' => [
'description' => '是否开启负载均衡的攻击防护功能SynProxy。'."\n"
."\n"
.'建议用户一般情况下不要调整这个参数,由负载均衡控制。'."\n"
."\n"
.'* **enable**:开启。'."\n"
."\n"
.'* **disable**:关闭。',
'type' => 'string',
'example' => 'disable',
],
'Scheduler' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**(默认值):权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n\n"
.'- **sch**:基于源IP地址的一致性hash,相同的源地址会调度到相同的后端服务器。'."\n"
."\n"
.'- **tch**:基于四元组的一致性hash(源IP+目的IP+源端口+目的端口),相同的流会调度到相同的后端服务器。'."\n"
."\n"
.'> 仅性能保障型实例支持**sch**和**tch**一致性hash算法。',
'type' => 'string',
'example' => 'wrr',
],
'EstablishedTimeout' => [
'description' => '连接超时时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'HealthCheckConnectTimeout' => [
'description' => '超时时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'HealthyThreshold' => [
'description' => '健康检查阈值。健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。取值:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'ConnectionDrain' => [
'description' => '是否开启连接优雅中断。当**ConnectionDrain**取值为**on**时,返回该值。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
."\n"
.'- **off**:未开启。',
'type' => 'string',
'example' => 'off',
],
'HealthCheckMethod' => [
'description' => '健康检查方式。',
'type' => 'string',
'example' => 'tcp',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:关闭。',
'type' => 'string',
'example' => 'on',
],
'AclIds' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AclId' => [
'description' => '访问控制策略组ID列表。',
'type' => 'array',
],
],
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1ygod3yctvg1y****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6******8\\",\\n \\"Status\\": \\"stopped\\",\\n \\"AclType\\": \\"white\\",\\n \\"ConnectionDrainTimeout\\": 300,\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"Description\\": \\"TCP_80\\",\\n \\"Bandwidth\\": -1,\\n \\"HealthCheckType\\": \\"tcp\\",\\n \\"MasterSlaveServerGroupId\\": \\"rsp-0bfucw****\\",\\n \\"BackendServerPort\\": 443,\\n \\"AclStatus\\": \\"off\\",\\n \\"HealthCheckDomain\\": \\"www.domain.com\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"HealthCheckHttpCode\\": \\"http_2xx\\",\\n \\"ProxyProtocolV2Enabled\\": false,\\n \\"PersistenceTimeout\\": 0,\\n \\"ListenerPort\\": 110,\\n \\"HealthCheckInterval\\": 5,\\n \\"HealthCheckURI\\": \\"/test/index.html\\",\\n \\"AclId\\": \\"acl-uf60jwfi******\\",\\n \\"SynProxy\\": \\"disable\\",\\n \\"Scheduler\\": \\"wrr\\",\\n \\"EstablishedTimeout\\": 500,\\n \\"HealthCheckConnectTimeout\\": 100,\\n \\"HealthyThreshold\\": 4,\\n \\"ConnectionDrain\\": \\"off\\",\\n \\"HealthCheckMethod\\": \\"tcp\\",\\n \\"HealthCheck\\": \\"on\\",\\n \\"AclIds\\": {\\n \\"AclId\\": [\\n \\"\\"\\n ]\\n },\\n \\"LoadBalancerId\\": \\"lb-bp1ygod3yctvg1y****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n rsp-cige6******8\\n stopped\\n white\\n 300\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n 8080\\n TCP_80\\n -1\\n tcp\\n rsp-0bfucw****\\n 443\\n off\\n www.domain.com\\n 4\\n http_2xx\\n false\\n 0\\n 110\\n 5\\n /test/index.html\\n 12\\n enable\\n wrr\\n 500\\n 100\\n 4\\n off\\n tcp\\n on\\n lb-bp1ygod3yctvg1y****\\n \\n TestKey\\n TestValue\\n \\n","errorExample":""}]',
'title' => '查询TCP监听配置',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateLoadBalancerUDPListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88530',
'abilityTreeNodes' => [
'FEATUREslbMJNWX5',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '监听的标签集合。',
'type' => 'array',
'items' => [
'description' => '监听的标签集合。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1ygod3yctvg1y7****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'BackendServerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例后端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。'."\n"
."\n"
.'如果不使用虚拟服务器组(不指定**VServerGroupId**),则该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值。单位:Mbps。取值:'."\n"
."\n\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为**-1**,即不限制带宽峰值。'."\n"
.'- **1**~**5120**:对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。'."\n"
."\n"
.'**-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为**-1**,即不限制带宽峰值。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'* **wrr**(默认值):权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'* **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'* **sch**:基于源IP地址的一致性hash,相同的源地址会调度到相同的后端服务器。'."\n"
."\n"
.'* **tch**:基于四元组的一致性hash(源IP+目的IP+源端口+目的端口),相同的流会调度到相同的后端服务器。'."\n"
."\n"
.'* **qch**:基于QUIC Connection ID一致性hash,相同的QUIC Connection ID会调度到相同的后端服务器。'."\n"
."\n\n"
.'仅性能保障型实例支持sch、 tch和qch一致性hash算法。'."\n",
'type' => 'string',
'required' => false,
'example' => 'wrr',
'default' => 'wrr',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
'default' => '3',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值范围:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
'default' => '3',
],
],
[
'name' => 'HealthCheckConnectTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。'."\n"
."\n"
.'如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**300**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '100',
'default' => '5',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。'."\n"
."\n"
.'不设置此参数时,表示使用后端服务端口(**BackendServerPort**)。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'healthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**50**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'healthCheckReq',
'in' => 'query',
'schema' => [
'description' => 'UDP监听健康检查的请求字符串,只允许包含字母、数字,最大长度限制为64个字符。',
'type' => 'string',
'required' => false,
'example' => 'hello',
],
],
[
'name' => 'healthCheckExp',
'in' => 'query',
'schema' => [
'description' => 'UDP监听健康检查的响应字符串,只允许包含字母、数字,最大长度限制为64个字符。',
'type' => 'string',
'required' => false,
'example' => 'ok',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j8****',
],
],
[
'name' => 'MasterSlaveServerGroupId',
'in' => 'query',
'schema' => [
'description' => '主备服务器组ID。'."\n"
."\n"
.'> 虚拟服务器组ID和主备服务器组ID只能选择一个。',
'type' => 'string',
'required' => false,
'example' => 'rsp-0bfucwu****',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'acl-uf60jw***',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型,取值:'."\n"
."\n"
.'* **white**:仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于应用只允许特定IP访问的场景。设置白名单存在一定业务风险,一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
.' '."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'* **black**:来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于应用只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**(默认值):关闭。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'udp_80',
],
],
[
'name' => 'ProxyProtocolV2Enabled',
'in' => 'query',
'schema' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**(默认值):否。'."\n",
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'HealthCheckSwitch',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**(默认值):开启。'."\n"
.'- **off**:关闭。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '06F00FBB-3D9E-4CCE-9D43-1A6946A75556',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue.SpecNotSupport',
'errorMessage' => 'The loadBalancer of shared spec does not support the parameter value, %s.',
],
[
'errorCode' => 'OperationNotSupport.Acl',
'errorMessage' => 'The cloud box instance does not support acl.',
],
[
'errorCode' => 'InvalidParameterValue.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter value, %s.',
],
[
'errorCode' => 'Abs.VServerGroupIdAndMasterSlaveServerGroupId.MissMatch',
'errorMessage' => 'The parameters VServerGroupId or MasterSlaveServerGroupId miss match.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameterValue.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter value, %s.',
],
[
'errorCode' => 'ListenerProcessing',
'errorMessage' => 'A previous configuration of the listener is pending,please try again later.',
],
[
'errorCode' => 'AclNotExist',
'errorMessage' => 'Acl does not exist.',
],
[
'errorCode' => 'InvalidParameter.ListenerPortConflict',
'errorMessage' => 'There is conflict listener port exists.',
],
[
'errorCode' => 'InvalidParam.VServerGroupId',
'errorMessage' => 'The specified VServerGroupId is invalid.',
],
[
'errorCode' => 'MissingParam.HealthCheckConnectPort',
'errorMessage' => 'The parameter HealthCheckConnectPort is required.',
],
[
'errorCode' => 'InvalidParam.ListenerPort',
'errorMessage' => 'The specified ListenerPort is invalid.',
],
[
'errorCode' => 'InvalidParam.StartPort',
'errorMessage' => 'The specified StartPort is invalid.',
],
[
'errorCode' => 'InvalidParamSize.PortRange',
'errorMessage' => 'The size of param PortRange is invalid.',
],
[
'errorCode' => 'InvalidParam.EndPort',
'errorMessage' => 'The specified EndPort is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'LbNotSupportTcpssl',
'errorMessage' => 'You cannot create a TCP SSL type listener for the specified load balancer.',
],
[
'errorCode' => 'LbSupportTcpsslOnly',
'errorMessage' => 'The specified load balancer supports TCP SSL type listener only.',
],
[
'errorCode' => 'ListenerNotSupportRule',
'errorMessage' => 'You cannot create a rule for the specified listener.',
],
[
'errorCode' => 'InvalidParamLength.HealthCheckExp',
'errorMessage' => 'The length of the parameter HealthCheckReq is invalid.',
],
[
'errorCode' => 'InvalidParamLength.HealthCheckReq',
'errorMessage' => 'The length of the parameter HealthCheckReq is invalid.',
],
[
'errorCode' => 'InvalidParam.HealthCheckReq',
'errorMessage' => 'The param HealthCheckReq is invalid.',
],
[
'errorCode' => 'InvalidParam.HealthCheckExp',
'errorMessage' => 'The param HealthCheckExp is invalid.',
],
[
'errorCode' => 'ResourceNotFound.VServerGroup',
'errorMessage' => '%s.',
],
[
'errorCode' => 'IllegalParam.FailoverThreshold',
'errorMessage' => 'The parameter FailoverThreshold is illegal.',
],
[
'errorCode' => 'IllegalParam.FailoverStrategy',
'errorMessage' => 'The parameter FailoverStrategy is illegal.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'MasterSlaveServerConflict',
'errorMessage' => 'The servers are conflict for MasterSlaveGroup.',
],
[
'errorCode' => 'VipNotSupportQuicVersion',
'errorMessage' => 'The listener does not support the parameter of QuicVersion.',
],
[
'errorCode' => 'IllegalParam.HealthCheckType',
'errorMessage' => 'The param of HealthCheckType is illegal.',
],
[
'errorCode' => 'MissingParam.HealthCheckMethod',
'errorMessage' => 'The param of HealthCheckMethod is missing.',
],
[
'errorCode' => 'IllegalParam.HealthCheckMethod',
'errorMessage' => 'The param of HealthCheckMethod is illegal.',
],
[
'errorCode' => 'IllegalParam.HealthCheck',
'errorMessage' => 'The param of HealthCheck is illegal.',
],
[
'errorCode' => 'OperationDenied.SpecialListenerPortNotAllowed',
'errorMessage' => 'The operation is not allowed because port 4789 is reserved by the system.',
],
[
'errorCode' => 'Mismatch.SlbSpecTypeAndListenerProtocol',
'errorMessage' => 'The SlbSpecType and ListenerProtocol are mismatched.',
],
[
'errorCode' => 'OperationDenied.OnlyIpv4SlbSupport',
'errorMessage' => 'The operation is not allowed because of OnlyIpv4SlbSupport.',
],
[
'errorCode' => 'OperationDenied.FullNatModeNotAllowed',
'errorMessage' => 'The operation is not allowed because of FullNatModeNotAllowed.',
],
[
'errorCode' => 'SpecNotSupportParameter',
'errorMessage' => 'The instance with share spec does not support FullNatEnabled parameter.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"06F00FBB-3D9E-4CCE-9D43-1A6946A75556\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 06F00FBB-3D9E-4CCE-9D43-1A6946A75556\\n","errorExample":""}]',
'title' => '创建UDP监听',
'summary' => '创建UDP监听。',
'description' => '> 新建的监听的状态为**stopped**。创建完成后,调用[StartLoadBalancerListener](~~27597~~)接口启动监听来转发流量。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerUDPListenerAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '88677',
'abilityTreeNodes' => [
'FEATUREslbMJNWX5',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1rtfnodmywb43ecu4sf-c****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值,单位:Mbps。取值:'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为**-1**,即不限制带宽峰值。'."\n"
.' '."\n"
.'- **1**~**5120**: 对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的次数(概率)也越高。当权重值相同时,当前连接数越小的后端服务器被轮询到的次数(概率)也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'- **sch**:基于源IP地址的一致性哈希算法,相同的源地址会调度到相同的后端服务器。'."\n"
."\n"
.'- **tch**:基于四元组的一致性哈希算法(源IP、目的IP、源端口和目的端口),相同的流会调度到相同的后端服务器。'."\n"
."\n"
.'- **qch**:基于QUIC Connection ID一致性哈希算法,相同的QUIC Connection ID会调度到相同的后端服务器。'."\n"
."\n"
.'> - 仅有性能保障型实例支持**sch**、**tch**和**qch**的调度算法。'."\n"
.'> - CLB不支持**wrr**和**rr**算法变更为一致性哈希算法,也不支持一致性哈希算法互转。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值范围:**1**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值范围:**1**~**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckConnectTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。'."\n"
."\n"
.'取值范围:**1**~**300**。'."\n"
."\n"
.'> 如果**HealthCheckConnectTimeout**的值小于**HealthCheckInterval**的值,则**HealthCheckConnectTimeout**无效,超时时间为**HealthCheckInterval**的值。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '100',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔,单位:秒。'."\n"
."\n"
.'取值范围:**1**~**50**。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '5',
],
],
[
'name' => 'healthCheckReq',
'in' => 'query',
'schema' => [
'description' => 'UDP监听健康检查的请求串,只允许包含字母、数字,最大长度限制为64个字符。',
'type' => 'string',
'required' => false,
'example' => 'hello',
],
],
[
'name' => 'healthCheckExp',
'in' => 'query',
'schema' => [
'description' => 'UDP监听健康检查的响应串,只允许包含字母、数字,最大长度限制为64个字符。',
'type' => 'string',
'required' => false,
'example' => 'ok',
],
],
[
'name' => 'VServerGroup',
'in' => 'query',
'schema' => [
'description' => '是否使用虚拟服务器组。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n"
."\n"
.'> **VserverGroup**和**MasterSlaveServerGroup**只允许一个值为**on**。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6****',
],
],
[
'name' => 'MasterSlaveServerGroupId',
'in' => 'query',
'schema' => [
'description' => '主备服务器组ID。'."\n"
."\n"
.'> 虚拟服务器组ID和主备服务器组ID只能选择一个。',
'type' => 'string',
'required' => false,
'example' => 'rsp-0bfuc****',
],
],
[
'name' => 'MasterSlaveServerGroup',
'in' => 'query',
'schema' => [
'description' => '是否使用主备服务器组。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n"
."\n"
.'> **VserverGroup**和**MasterSlaveServerGroup**只允许取值为**on**。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型。取值:'."\n"
."\n"
.'- **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。 '."\n"
."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**: 不会转发来自所选访问控制策略组中设置的IP地址或地址段,黑名单适用于只限制某些特定IP访问的场景。 '."\n"
.' '."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'>当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'udp_80',
],
],
[
'name' => 'ProxyProtocolV2Enabled',
'in' => 'query',
'schema' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**(默认值):否。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'HealthCheckSwitch',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**(默认值):开启。'."\n"
."\n"
.'- **off**:不开启。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue.SpecNotSupport',
'errorMessage' => 'The loadBalancer of shared spec does not support the parameter value, %s.',
],
[
'errorCode' => 'OperationNotSupport.Acl',
'errorMessage' => 'The cloud box instance does not support acl.',
],
[
'errorCode' => 'InvalidParameterValue.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter value, %s.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameterValue.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter value, %s.',
],
[
'errorCode' => 'OperationFailed.ServerGroupInUse',
'errorMessage' => 'The VServerGroup or MasterSlaveServerGroup can not be close for this listener.',
],
[
'errorCode' => 'InvalidParam.VServerGroupId',
'errorMessage' => 'The specified VServerGroupId is invalid.',
],
[
'errorCode' => 'MissingParam.HealthCheckConnectPort',
'errorMessage' => 'The parameter HealthCheckConnectPort is required.',
],
[
'errorCode' => 'InvalidParam.ListenerPort',
'errorMessage' => 'The specified ListenerPort is invalid.',
],
[
'errorCode' => 'InvalidParam.StartPort',
'errorMessage' => 'The specified StartPort is invalid.',
],
[
'errorCode' => 'InvalidParamSize.PortRange',
'errorMessage' => 'The size of param PortRange is invalid.',
],
[
'errorCode' => 'InvalidParam.EndPort',
'errorMessage' => 'The specified EndPort is invalid.',
],
[
'errorCode' => 'InvalidParam.PortRange',
'errorMessage' => 'The specified PortRange is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParamLength.HealthCheckReq',
'errorMessage' => 'The length of the parameter HealthCheckReq is invalid.',
],
[
'errorCode' => 'InvalidParamLength.HealthCheckExp',
'errorMessage' => 'The length of the parameter HealthCheckExp is invalid.',
],
[
'errorCode' => 'InvalidParam.HealthCheckReq',
'errorMessage' => 'The param HealthCheckReq is invalid.',
],
[
'errorCode' => 'InvalidParam.HealthCheckExp',
'errorMessage' => 'The param HealthCheckExp is invalid.',
],
[
'errorCode' => 'ResourceNotFound.VServerGroup',
'errorMessage' => '%s.',
],
[
'errorCode' => 'IllegalParam.FailoverThreshold',
'errorMessage' => 'The parameter FailoverThreshold is illegal.',
],
[
'errorCode' => 'IllegalParam.FailoverStrategy',
'errorMessage' => 'The parameter FailoverStrategy is illegal.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'MasterSlaveServerConflict',
'errorMessage' => 'The servers are conflict for MasterSlaveGroup.',
],
[
'errorCode' => 'MissingParam.VServerGroupId',
'errorMessage' => 'The parameter VServerGroupId is missing.',
],
[
'errorCode' => 'VipNotSupportQuicVersion',
'errorMessage' => 'The listener does not support the parameter of QuicVersion.',
],
[
'errorCode' => 'IllegalParam.HealthCheckType',
'errorMessage' => 'The param of HealthCheckType is illegal.',
],
[
'errorCode' => 'IllegalParam.HealthCheckMethod',
'errorMessage' => 'The param of HealthCheckMethod is illegal.',
],
[
'errorCode' => 'IllegalParam.HealthCheck',
'errorMessage' => 'The param of HealthCheck is illegal.',
],
[
'errorCode' => 'OperationDenied.MasterSlaveGroupLogEnabled',
'errorMessage' => 'The operation is denied because of MasterSlaveGroupLogEnabled.',
],
[
'errorCode' => 'OperationDenied.OnlyIpv4SlbSupport',
'errorMessage' => 'The operation is not allowed because of OnlyIpv4SlbSupport.',
],
[
'errorCode' => 'OperationDenied.FullNatModeNotAllowed',
'errorMessage' => 'The operation is not allowed because of FullNatModeNotAllowed.',
],
[
'errorCode' => 'SpecNotSupportParameter',
'errorMessage' => 'The instance with share spec does not support FullNatEnabled parameter.',
],
[
'errorCode' => 'Abs.VServerGroupIdAndMasterSlaveServerGroupId.MissMatch',
'errorMessage' => 'Virtual service group ID or master slave server group ID is missing. Please check the input parameters.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '修改UDP协议监听的配置',
'summary' => '修改UDP协议监听的配置。',
'description' => '- 您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
.'- 您已经创建UDP监听,具体操作,请参见[CreateLoadBalancerUDPListener](~~27595~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLoadBalancerUDPListenerAttribute' => [
'summary' => '查询UDP监听的配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88590',
'abilityTreeNodes' => [
'FEATUREslbYU0ILA',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1rtfnodmywb43e*****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '绑定的虚拟服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j****',
],
'Status' => [
'description' => '当前监听的状态。取值:'."\n"
."\n"
.'* **running**:监听正常运行。'."\n"
."\n"
.'* **stopped**:监听停止运行。',
'type' => 'string',
'example' => 'stopped',
],
'AclType' => [
'description' => '访问控制类型:'."\n"
."\n"
.'- **white**:仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于应用只允许特定IP访问的场景。'."\n"
."\n"
.' 设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**:来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于应用只限制某些特定IP访问的场景。'."\n"
.' '."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。',
'type' => 'string',
'example' => 'white',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的端口。取值:**1**~**65535**。不设置此参数时,表示使用后端服务端口(BackendServerPort)。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'Description' => [
'description' => '自定义监听名称。',
'type' => 'string',
'example' => 'UDP_80',
],
'Bandwidth' => [
'description' => '监听的带宽峰值,单位Mbps。取值:'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为-1,即不限制带宽峰值。'."\n"
."\n"
.'- **1**~**5120**:对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。',
'type' => 'integer',
'format' => 'int32',
'example' => '-1',
],
'MasterSlaveServerGroupId' => [
'description' => '绑定的主备服务器组ID。',
'type' => 'string',
'example' => 'rsp-0bfucw****',
],
'BackendServerPort' => [
'description' => '传统型负载均衡实例后端使用的端口。'."\n"
."\n"
.'> 如果后端服务器组为虚拟服务器组,则不返回该参数。'."\n",
'type' => 'integer',
'format' => 'int32',
'example' => '90',
],
'AclStatus' => [
'description' => '是否开启访问控制功能。取值:**on**或**off**(默认值)。',
'type' => 'string',
'example' => 'off',
],
'UnhealthyThreshold' => [
'description' => '不健康检查阈值。健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。取值:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'ProxyProtocolV2Enabled' => [
'description' => '是否支持通过Proxy Protocol协议携带客户端源地址到后端服务器。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。',
'type' => 'boolean',
'example' => 'false',
],
'ListenerPort' => [
'description' => '传统型负载均衡实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '53',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔,取值:**1**~**50**秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'HealthCheckExp' => [
'description' => 'UDP监听健康检查的响应串。只允许包含字母、数字,最大长度限制为64个字符。',
'type' => 'string',
'example' => 'ok',
],
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'example' => 'acl-uf60jwfiv6******',
],
'Scheduler' => [
'description' => '调度算法,取值:'."\n"
.'* **wrr**(默认值):权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'* **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'example' => 'wrr',
],
'HealthCheckConnectTimeout' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。取值:**1**~**300**秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'HealthyThreshold' => [
'description' => '健康检查阈值。健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。取值:**2**~**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'HealthCheckReq' => [
'description' => 'UDP监听健康检查的请求串。只允许包含字母、数字,最大长度限制为64个字符。',
'type' => 'string',
'example' => 'hello',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:关闭。',
'type' => 'string',
'example' => 'on',
],
'AclIds' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'array',
],
],
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1rtfnodmywb43e*****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6j****\\",\\n \\"Status\\": \\"stopped\\",\\n \\"AclType\\": \\"white\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"Description\\": \\"UDP_80\\",\\n \\"Bandwidth\\": -1,\\n \\"MasterSlaveServerGroupId\\": \\"rsp-0bfucw****\\",\\n \\"BackendServerPort\\": 90,\\n \\"AclStatus\\": \\"off\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"ProxyProtocolV2Enabled\\": false,\\n \\"ListenerPort\\": 53,\\n \\"HealthCheckInterval\\": 5,\\n \\"HealthCheckExp\\": \\"ok\\",\\n \\"AclId\\": \\"acl-uf60jwfiv6******\\",\\n \\"Scheduler\\": \\"wrr\\",\\n \\"HealthCheckConnectTimeout\\": 100,\\n \\"HealthyThreshold\\": 4,\\n \\"HealthCheckReq\\": \\"hello\\",\\n \\"HealthCheck\\": \\"on\\",\\n \\"AclIds\\": {\\n \\"AclId\\": [\\n \\"\\"\\n ]\\n },\\n \\"LoadBalancerId\\": \\"lb-bp1rtfnodmywb43e*****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n rsp-cige6j****\\n stopped\\n white\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n 8080\\n UDP_80\\n -1\\n rsp-0bfucw****\\n 90\\n off\\n 4\\n false\\n 53\\n 5\\n ok\\n 123943****\\n wrr\\n 100\\n 4\\n hello\\n on\\n lb-bp1rtfnodmywb43e*****\\n \\n TestKey\\n TestValue\\n \\n","errorExample":""}]',
'title' => '查询UDP监听的配置',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateLoadBalancerHTTPListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88525',
'abilityTreeNodes' => [
'FEATUREslbPXBZ65',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~27584~~)接口获取地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1c9vixxjh92q83tw*****',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值,单位:Mbps。取值:'."\n"
."\n"
.'**-1**:不限制带宽峰值。'."\n"
."\n"
.''."\n"
."\n"
.'- **-1**:不限制带宽峰值。'."\n"
."\n"
.'- **1**~**5120**:监听的带宽峰值,所有监听的带宽峰值之和不能超过实例的带宽峰值。'."\n"
."\n"
.'',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
'default' => '-1',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'BackendServerPort',
'in' => 'query',
'schema' => [
'description' => '实例后端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。'."\n"
."\n"
.'> 如果不使用虚拟服务器组(不指定VServerGroupId参数),则该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'XForwardedFor',
'in' => 'query',
'schema' => [
'description' => '是否开启通过`X-Forwarded-For`头字段获取来访客户端IP。取值:'."\n"
.'- **on**(默认值):是。'."\n"
.'- **off**:否。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'on',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**(默认值):权重值越高的后端服务器,被轮询到的概率也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
'default' => 'wrr',
],
],
[
'name' => 'StickySession',
'in' => 'query',
'schema' => [
'description' => '是否开启会话保持。取值:'."\n"
."\n"
.'- **on**:是。'."\n"
."\n"
.'- **off**(默认值):否。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'off',
'default' => 'off',
],
],
[
'name' => 'StickySessionType',
'in' => 'query',
'schema' => [
'description' => 'Cookie处理方式。取值:'."\n"
."\n"
.'- **insert**:植入Cookie。'."\n"
."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie,下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'- **server**:重写Cookie。'."\n"
."\n"
.' 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'> 当**StickySession**值为**on**时,必须指定该参数。',
'type' => 'string',
'required' => false,
'example' => 'insert',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'CookieTimeout',
'in' => 'query',
'schema' => [
'description' => 'Cookie超时时间。单位:秒。'."\n"
."\n"
.'取值:**1**~**86400**。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**insert**时,该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '86400',
'minimum' => '1',
'example' => '500',
],
],
[
'name' => 'Cookie',
'in' => 'query',
'schema' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200个字符,只能包含ASCII英文字母和数字字符,不能包含半角逗号(,)、半角分号(;)或空格,也不能以美元符号($)开头。'."\n"
."\n"
.'>当**StickySession**为**on**且**StickySessionType**为**server**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'testCookie',
],
],
[
'name' => 'HealthCheck',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**:开启健康检查。'."\n"
."\n"
.'- **off**:不开启健康检查。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'on',
],
],
[
'name' => 'HealthCheckMethod',
'in' => 'query',
'schema' => [
'description' => '监听HTTP类型健康检查的健康检查方法。取值:**head**或**get**。'."\n"
."\n"
.'> **HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => 'get',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名,取值:'."\n"
."\n"
.'- **$_ip**: 后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'- **domain**:域名长度为1~80字符,只能包含字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => '172.16.*.*/12',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'长度限制为1~80个字符,只能使用字母、数字和短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、半角问号(?)、井号(#)和and(&)这些字符。URI不能只为正斜线(/),但必须以正斜线(/)开头。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => '/test/index.html',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。'."\n"
."\n"
.'取值:**1**~**300**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查的后端服务器的端口。'."\n"
."\n"
.'取值: **1**~**65535**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '-520',
'example' => '80',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值: **1**~**50**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '5',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用逗号分隔。'."\n"
."\n"
.'取值:**http\\_2xx**(默认值)、**http\\_3xx**、**http\\_4xx**或**http\\_5xx**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => 'http_2xx',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j*****',
],
],
[
'name' => 'XForwardedFor_SLBIP',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**(默认值):否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'XForwardedFor_SLBID',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**(默认值):否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'XForwardedFor_proto',
'in' => 'query',
'schema' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**(默认值):否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'Gzip',
'in' => 'query',
'schema' => [
'description' => '是否开启`Gzip`压缩,对特定文件类型进行压缩。取值:'."\n"
.'- **on**(默认值):是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'on',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'acl-uf60jw******',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型。取值:'."\n"
."\n"
.'- **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
.' '."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'>当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**(默认值):否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'HTTP_443',
],
],
[
'name' => 'ListenerForward',
'in' => 'query',
'schema' => [
'description' => '是否开启HTTP至HTTPS的转发。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**(默认值):否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'ForwardPort',
'in' => 'query',
'schema' => [
'description' => 'HTTP至HTTPS的监听转发端口。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '443',
],
],
[
'name' => 'IdleTimeout',
'in' => 'query',
'schema' => [
'description' => '指定连接空闲超时时间。单位:秒。'."\n"
."\n"
.'默认值为**15**,取值范围:**1**~**60**。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立新的连接。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'RequestTimeout',
'in' => 'query',
'schema' => [
'description' => '指定请求超时时间。单位:秒。'."\n"
."\n"
.'默认值为**60**,取值范围为**1**~**180**。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回` HTTP 504 `错误码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '6',
],
],
[
'name' => 'XForwardedFor_SLBPORT',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'XForwardedFor_ClientSrcPort',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified ListenerPort or ForwardPort is invalid.',
],
[
'errorCode' => 'ListenerForwardNotSupport',
'errorMessage' => 'X-Forward-For is not supported to a ipv6 instance.',
],
[
'errorCode' => 'InvalidParameter.IdleTimeout',
'errorMessage' => 'The specified IdleTimeout exceeds the limit.',
],
[
'errorCode' => 'InvalidParameter.RequestTimeout',
'errorMessage' => 'The specified RequestTimeout exceeds the limit.',
],
[
'errorCode' => 'ListenerProcessing',
'errorMessage' => 'A previous configuration of the listener is pending,please try again later.',
],
[
'errorCode' => 'InvalidParameter.ListenerPortConflict',
'errorMessage' => 'There is conflict listener port exists.',
],
[
'errorCode' => 'ResourceNotAvailible.HttpListener',
'errorMessage' => 'The specified Zone did not have enough resource.',
],
[
'errorCode' => 'AclNotExist',
'errorMessage' => 'Acl does not exist.',
],
[
'errorCode' => 'OperationUnsupported.CreateLoadBalancerLayer7Listener',
'errorMessage' => 'The slb instance does not support create HTTP or HTTPS listener.',
],
[
'errorCode' => 'InvalidParameter.VServerGroupId',
'errorMessage' => 'The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener.',
],
[
'errorCode' => 'MissingParam.HealthCheckDomain',
'errorMessage' => 'The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1.',
],
[
'errorCode' => 'InvalidParameter.HealthCheckHttpVersion',
'errorMessage' => 'The param HealthCheckHttpVersion is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationFailed.InsufficientResources',
'errorMessage' => 'The loadbalancer does not support this operation because of insufficient resources.',
],
[
'errorCode' => 'InvalidParameter.ForwardCode',
'errorMessage' => 'The specified ForwardCode is invalid.',
],
[
'errorCode' => 'LbNotSupportTcpssl',
'errorMessage' => 'You cannot create a TCP SSL type listener for the specified load balancer.',
],
[
'errorCode' => 'LbSupportTcpsslOnly',
'errorMessage' => 'The specified load balancer supports TCP SSL type listener only.',
],
[
'errorCode' => 'ListenerNotSupportRule',
'errorMessage' => 'You cannot create a rule for the specified listener.',
],
[
'errorCode' => 'Mismatch.SlbSpecTypeAndListenerProtocol',
'errorMessage' => 'The SlbSpecType and ListenerProtocol are mismatched.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '创建HTTP监听',
'summary' => '创建HTTP监听。',
'description' => '### 注意事项'."\n"
."\n"
.' 新建的监听的状态为**stopped**。创建完成后,调用[StartLoadBalancerListener](~~27597~~)接口启动监听来转发流量。'."\n"
."\n"
.'### 前提条件'."\n"
."\n"
.'您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerHTTPListenerAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '88668',
'abilityTreeNodes' => [
'FEATUREslbPXBZ65',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~27585~~)列表或通过调用[DescribeRegions](~~27584~~)接口获取地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1qjwo61pqz3ah*****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值。单位:Mbps。取值:'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为**-1**,即不限制带宽峰值。'."\n"
."\n"
.'- **1**~**5120**(Mbps):对于按带宽计费的公网负载均衡实例,可以为每个监听设置带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。详情参见[共享实例带宽](~~85930~~)。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
],
],
[
'name' => 'XForwardedFor',
'in' => 'query',
'schema' => [
'description' => '是否通过`X-Forwarded-For`头字段获取客户端请求的真实IP。取值:'."\n"
.'- **on**(默认值):是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的概率也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
],
],
[
'name' => 'StickySession',
'in' => 'query',
'schema' => [
'description' => '是否开启会话保持。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'StickySessionType',
'in' => 'query',
'schema' => [
'description' => 'Cookie的处理方式。取值:'."\n"
."\n"
.'- **insert**:植入Cookie。'."\n"
."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP/HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'- **server**:重写Cookie。'."\n"
.' '."\n"
.' 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
.' '."\n"
.'> 当**StickySession**的值为**on**时,必须指定该参数。',
'type' => 'string',
'required' => false,
'example' => 'insert',
],
],
[
'name' => 'CookieTimeout',
'in' => 'query',
'schema' => [
'description' => 'Cookie超时时间。'."\n"
."\n"
.'取值:**1**~**86400**秒。'."\n"
."\n"
.'>当**StickySession**为**on**且**StickySessionType**为**insert**时,该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '86400',
'minimum' => '1',
'example' => '500',
],
],
[
'name' => 'Cookie',
'in' => 'query',
'schema' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200字符,只能包含ASCII英文字母和数字字符,不能包含半角逗号(,)、半角分号(;)或空格,也不能以美元符号($)开头。'."\n"
.' '."\n"
."\n"
.'>当**StickySession**为**on**且**StickySessionType**为**server**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'testCookie',
],
],
[
'name' => 'HealthCheck',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'HealthCheckMethod',
'in' => 'query',
'schema' => [
'description' => '监听HTTP类型健康检查的健康检查方法。取值:**head**或**get**。'."\n"
."\n"
.'> **HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => 'get',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名,取值:'."\n"
.' '."\n"
.'* **$_ip**: 后端服务器的私网IP。当指定了**$_ip**或**HealthCheckDomain**未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'* **domain**:域名长度为1~80字符,只能包含字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => '172.XX.XX.16',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'长度限制为1~80字符,只能使用字母、数字、短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、半角问号(?)、井号(#)和and(&)字符。URI不能只为正斜线(/),但必须以正斜线(/)开头。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => '/test/index.html',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。在**HealthCheck**值为**on**时才会有效。'."\n"
."\n"
.'取值:**1**~**300**秒。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。'."\n"
."\n"
.'取值:**1**~**50**秒。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '5',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。'."\n"
."\n"
.'> 当**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '-520',
'example' => '8080',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。'."\n"
."\n"
.'取值:**http_2xx**、**http_3xx**、**http_4xx**或**http_5xx**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'string',
'required' => false,
'example' => 'http_2xx,http_3xx',
],
],
[
'name' => 'VServerGroup',
'in' => 'query',
'schema' => [
'description' => '是否使用虚拟服务器组。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j*****',
],
],
[
'name' => 'XForwardedFor_SLBIP',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'XForwardedFor_SLBID',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'XForwardedFor_proto',
'in' => 'query',
'schema' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'Gzip',
'in' => 'query',
'schema' => [
'description' => '是否开启`Gzip`压缩,对特定文件类型进行压缩。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'acl-uf60jw******',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型:'."\n"
."\n"
.'- **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
.' '."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'>当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'IdleTimeout',
'in' => 'query',
'schema' => [
'description' => '指定连接空闲超时时间,取值范围为**1~60**秒,默认值为**15**秒。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立新的连接。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '12',
],
],
[
'name' => 'RequestTimeout',
'in' => 'query',
'schema' => [
'description' => '指定请求超时时间,取值范围为**1~180**秒,默认值为**60**秒。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回HTTP 504错误码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '设置监听的描述信息。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'XForwardedFor_SLBPORT',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'XForwardedFor_ClientSrcPort',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'Operation Denied. The HTTP listener does not support this action.',
],
[
'errorCode' => 'InvalidParameter.IdleTimeout',
'errorMessage' => 'The specified IdleTimeout exceeds the limit.',
],
[
'errorCode' => 'InvalidParameter.RequestTimeout',
'errorMessage' => 'The specified RequestTimeout exceeds the limit.',
],
[
'errorCode' => 'ListenerForwardNotSupport',
'errorMessage' => 'X-Forward-For is not supported to a ipv6 instance.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'OperationFailed.ServerGroupInUse',
'errorMessage' => 'The VServerGroup or MasterSlaveServerGroup can not be close for this listener.',
],
[
'errorCode' => 'InvalidParameter.VServerGroupId',
'errorMessage' => 'The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener.',
],
[
'errorCode' => 'MissingParam.HealthCheckDomain',
'errorMessage' => 'The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1.',
],
[
'errorCode' => 'InvalidParameter.HealthCheckHttpVersion',
'errorMessage' => 'The param HealthCheckHttpVersion is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParameter.ForwardCode',
'errorMessage' => 'The specified ForwardCode is invalid.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n\\tCEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '修改HTTP监听的配置',
'summary' => '修改HTTP监听的配置。',
'description' => '### 前提条件'."\n"
."\n"
.'- 您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
.'- 您已经创建HTTP监听,具体操作,请参见[CreateLoadBalancerHTTPListener](~~27592~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLoadBalancerHTTPListenerAttribute' => [
'summary' => '查询HTTP监听配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88577',
'abilityTreeNodes' => [
'FEATUREslbOMAMKB',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以调用[DescribeRegions](~~25609~~)接口获取地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1uaunez0uho0zf0****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '访问控制类型:'."\n"
."\n"
.'- **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'example' => 'white',
],
'VServerGroupId' => [
'description' => '绑定的服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j****',
],
'Status' => [
'description' => '当前监听的状态。取值:'."\n"
."\n"
.'- **running**:表示监听正常运行。'."\n"
."\n"
.'- **stopped**:表示监听停止。',
'type' => 'string',
'example' => 'stopped',
],
'XForwardedFor_ClientSrcPort' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'Cookie' => [
'description' => '服务器上配置的Cookie。',
'type' => 'string',
'example' => 'testCookie',
],
'Gzip' => [
'description' => '是否开启`Gzip`压缩,对特定文件类型进行压缩。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的端口。'."\n"
."\n"
.' > 当**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'Description' => [
'description' => '自定义监听名称。',
'type' => 'string',
'example' => 'HTTP_80',
],
'Bandwidth' => [
'description' => '监听的带宽峰值。单位:Mbps。'."\n"
."\n"
.'- **-1**:不限制带宽峰值。'."\n"
."\n"
.'- **1~5120**:监听的带宽峰值,所有监听的带宽峰值之和不能超过实例的带宽峰值。',
'type' => 'integer',
'format' => 'int32',
'example' => '-1',
],
'HealthCheckTimeout' => [
'description' => '每次健康检查响应的超时时间,单位:秒。'."\n",
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'AclStatus' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'BackendServerPort' => [
'description' => '实例后端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'CookieTimeout' => [
'description' => 'Cookie超时时间。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'HealthCheckDomain' => [
'description' => '用于健康检查的域名。',
'type' => 'string',
'example' => 'www.domain.com',
],
'UnhealthyThreshold' => [
'description' => '不健康检查阈值。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'ForwardPort' => [
'description' => 'HTTP至HTTPS的监听转发端口。'."\n"
."\n"
.'> 如果**ListenerForward**的值为**off**,该参数不显示。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'XForwardedFor_SLBID' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'SecurityStatus' => [
'description' => '是否开启安全状态。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码。',
'type' => 'string',
'example' => 'http_2xx,http_3xx',
],
'ListenerForward' => [
'description' => '是否开启HTTP至HTTPS的监听转发。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor' => [
'description' => '是否开启通过`X-Forwarded-For`头字段的方式获取来访者真实IP。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'IdleTimeout' => [
'description' => '指定连接空闲超时时间,单位:秒。'."\n"
."\n"
.'默认值为**15**,取值范围为**1~60**。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到下一次请求来临时重新建立新的连接。'."\n",
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'RequestTimeout' => [
'description' => '指定请求超时时间。单位:秒。'."\n"
."\n"
.'默认值为**60**,取值范围为**1~180**。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回HTTP 504错误码。',
'type' => 'integer',
'format' => 'int32',
'example' => '34',
],
'ListenerPort' => [
'description' => '实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔,单位:秒。'."\n",
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'XForwardedFor_SLBPORT' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'HealthCheckURI' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'长度限制为1~80,只能使用字母、数字和短划线(-)、正斜线(/)、半角句号(.)、百分号(%),半角问号(?)、井号(#)和and(&)这些字符。URI不能只为正斜线(/),但必须以正斜线(/)开头。',
'type' => 'string',
'example' => '/test/index.html',
],
'StickySessionType' => [
'description' => 'Cookie的处理方式。'."\n"
."\n"
.'取值:**insert**或**server**。'."\n"
."\n"
.'- **insert**:植入Cookie。'."\n"
."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP或HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'- **server**:重写Cookie。'."\n"
."\n"
.' 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'>当**StickySession**的值为**on**时,必须指定该参数。',
'type' => 'string',
'example' => 'insert ',
],
'AclId' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,返回该参数。',
'type' => 'string',
'example' => 'acl-uf60jw******',
],
'Scheduler' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的概率也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'example' => 'wrr',
],
'HealthyThreshold' => [
'description' => '健康检查阈值。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_proto' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor_SLBIP' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'StickySession' => [
'description' => '是否开启会话保持。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'HealthCheckMethod' => [
'description' => '监听HTTP类型健康检查的健康检查方法。取值:**head**或**get**。'."\n"
."\n"
.'> **HealthCheck**值为**on**时,返回该参数。',
'type' => 'string',
'example' => 'get',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'AclIds' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'array',
],
],
],
'Rules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Rule' => [
'description' => '转发规则描述。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '转发规则的目标服务器组ID。',
'type' => 'string',
'example' => 'rsp-uf6w******',
],
'Url' => [
'description' => '访问路径。',
'type' => 'string',
'example' => '/example',
],
'Domain' => [
'description' => '域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'RuleName' => [
'description' => '转发规则名称。',
'type' => 'string',
'example' => 'test',
],
'RuleId' => [
'description' => '转发规则ID。',
'type' => 'string',
'example' => '1234',
],
],
],
],
],
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1uaunez0uho0zf0****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"AclType\\": \\"white\\",\\n \\"VServerGroupId\\": \\"rsp-cige6j****\\",\\n \\"Status\\": \\"stopped\\",\\n \\"XForwardedFor_ClientSrcPort\\": \\"off\\",\\n \\"Cookie\\": \\"testCookie\\",\\n \\"Gzip\\": \\"on\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"Description\\": \\"HTTP_80\\",\\n \\"Bandwidth\\": -1,\\n \\"HealthCheckTimeout\\": 3,\\n \\"AclStatus\\": \\"off\\",\\n \\"BackendServerPort\\": 80,\\n \\"CookieTimeout\\": 500,\\n \\"HealthCheckDomain\\": \\"www.domain.com\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"ForwardPort\\": 80,\\n \\"XForwardedFor_SLBID\\": \\"on\\",\\n \\"SecurityStatus\\": \\"on\\",\\n \\"HealthCheckHttpCode\\": \\"http_2xx,http_3xx\\",\\n \\"ListenerForward\\": \\"on\\",\\n \\"XForwardedFor\\": \\"on\\",\\n \\"IdleTimeout\\": 2,\\n \\"RequestTimeout\\": 34,\\n \\"ListenerPort\\": 80,\\n \\"HealthCheckInterval\\": 5,\\n \\"XForwardedFor_SLBPORT\\": \\"off\\",\\n \\"HealthCheckURI\\": \\"/test/index.html\\",\\n \\"StickySessionType\\": \\"insert \\",\\n \\"AclId\\": \\"acl-uf60jw******\\",\\n \\"Scheduler\\": \\"wrr\\",\\n \\"HealthyThreshold\\": 4,\\n \\"XForwardedFor_proto\\": \\"on\\",\\n \\"XForwardedFor_SLBIP\\": \\"on\\",\\n \\"StickySession\\": \\"on\\",\\n \\"HealthCheckMethod\\": \\"get\\",\\n \\"HealthCheck\\": \\"on\\",\\n \\"AclIds\\": {\\n \\"AclId\\": [\\n \\"\\"\\n ]\\n },\\n \\"Rules\\": {\\n \\"Rule\\": [\\n {\\n \\"VServerGroupId\\": \\"rsp-uf6w******\\",\\n \\"Url\\": \\"/example\\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"RuleName\\": \\"test\\",\\n \\"RuleId\\": \\"1234\\"\\n }\\n ]\\n },\\n \\"LoadBalancerId\\": \\"lb-bp1uaunez0uho0zf0****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n white\\n rsp-cige6j****\\n stopped\\n B490B5EBF6F3CD402E515D22BCDA1598\\n on\\n 8080\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n HTTP_80\\n -1\\n 3\\n off\\n 80\\n 500\\n www.domain.com\\n 4\\n 80\\n on\\n on\\n http_2xx,http_3xx\\n on\\n on\\n 2\\n 34\\n 80\\n 5\\n /test/index.html\\n insert \\n on\\n wrr\\n 4\\n on\\n on\\n on\\n get\\n on\\n \\n 123\\n /example\\n www.example.com\\n test\\n 1234\\n \\n lb-bp1uaunez0uho0zf0****\\n \\n TestKey\\n TestValue\\n \\n","errorExample":""}]',
'title' => '查询HTTP监听配置',
'description' => '## 前提条件'."\n"
."\n"
.'- 您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
.'- 您已经创建HTTP监听,具体操作,请参见[CreateLoadBalancerHTTPListener](~~27592~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateLoadBalancerHTTPSListener' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88526',
'abilityTreeNodes' => [
'FEATUREslbFSBXXR',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1o94dp5i6earr****',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值。单位:Mbps。'."\n"
."\n"
.'取值范围:'."\n"
."\n"
.'- **-1**:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为**-1**,即不限制带宽峰值。'."\n"
."\n"
.''."\n"
."\n"
.'- **1**~**5120**: 对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。'."\n"
.'',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '实例前端使用的端口。'."\n"
."\n"
.'取值范围:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'BackendServerPort',
'in' => 'query',
'schema' => [
'description' => '实例后端使用的端口,取值范围:**1**~**65535**。'."\n"
."\n"
.'如果不使用服务器组(不指定VServerGroupId),则该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'XForwardedFor',
'in' => 'query',
'schema' => [
'description' => '是否通过`X-Forwarded-For`获取来访者客户端IP。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'on',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
'default' => 'wrr',
],
],
[
'name' => 'StickySession',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => [
'description' => '是否开启会话保持。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'StickySessionType',
'in' => 'query',
'schema' => [
'description' => 'Cookie的处理方式。取值:**insert**或**server**。'."\n"
."\n"
.'- **insert**:植入Cookie。'."\n"
."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP/HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。 '."\n"
."\n"
.'- **server**:重写Cookie。'."\n"
."\n"
.' 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'> 当**StickySession**的值为**on**时,必须指定该参数。',
'type' => 'string',
'required' => false,
'example' => 'insert ',
],
],
[
'name' => 'CookieTimeout',
'in' => 'query',
'schema' => [
'description' => 'Cookie超时时间。单位:秒。'."\n"
."\n"
.'取值:**1**~**86400**。'."\n"
."\n"
.'>当**StickySession**为**on**且**StickySessionType**为**insert**时,该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '86400',
'minimum' => '1',
'example' => '500',
],
],
[
'name' => 'Cookie',
'in' => 'query',
'schema' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200个字符,只能包含ASCII英文字母和数字字符,不能包含半角逗号(,)、半角分号(;)或空格,也不能以美元符号($)开头。'."\n"
."\n"
.'>当**StickySession**为**on**且**StickySessionType**为**server**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'testCookie',
],
],
[
'name' => 'HealthCheck',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'on',
],
],
[
'name' => 'HealthCheckMethod',
'in' => 'query',
'schema' => [
'description' => '监听HTTP类型健康检查的健康检查方法。取值:**head**或**get**。'."\n"
."\n"
.'> **HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => 'get',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名。取值:'."\n"
."\n"
.'* **$_ip**: 后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
.' '."\n"
.' '."\n"
.'* **domain**:域名长度为1~80个字符,只能包含英文字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'string',
'required' => false,
'example' => '172.XX.XX.16',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'URI长度为1~80个字符,可包含英文字母、数字和`-/.%?#&`这些特殊字符。URI不能只为`/`,但必须以`/`开头。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'string',
'required' => false,
'example' => '/test/index.html',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。取值:**1**~**300**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。'."\n"
."\n"
.'> 当**HealthCheck**值为**on**时才会有效。'."\n"
."\n"
.' ',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '-520',
'example' => '8080',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值:**1**~**50**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '5',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。'."\n"
."\n"
.'取值:**http\\_2xx**、**http\\_3xx**、**http\\_4xx**或**http\\_5xx**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。'."\n",
'type' => 'string',
'required' => false,
'example' => 'http_2xx,http_3xx',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '服务器证书的ID。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'idkp-123-cn-test-****',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j5e7p****',
],
],
[
'name' => 'CACertificateId',
'in' => 'query',
'schema' => [
'description' => 'CA证书ID。'."\n"
."\n"
.'若既上传CA证书又上传服务器证书,即采用双向认证。'."\n"
."\n"
.'若用户只上传服务器证书,即为单向认证。',
'type' => 'string',
'required' => false,
'example' => '139a00604ad-cn-east-hangzh****',
],
],
[
'name' => 'XForwardedFor_SLBIP',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-IP`头字段获取来访者的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'XForwardedFor_SLBID',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-ID`头字段获取SLB实例ID。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'XForwardedFor_proto',
'in' => 'query',
'schema' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取SLB的监听协议。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'off',
],
],
[
'name' => 'Gzip',
'in' => 'query',
'schema' => [
'description' => '是否开启`Gzip`压缩,对特定文件类型进行压缩。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => false,
'example' => 'on',
'default' => 'on',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'>当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'acl-a2do9e413e0spzasx****',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型。取值:'."\n"
."\n"
.'- **white**:仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
.' '."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**:来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'>当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'HTTPS_443',
],
],
[
'name' => 'IdleTimeout',
'in' => 'query',
'schema' => [
'description' => '指定连接空闲超时时间,取值范围为**1~60**,默认值为**15**。单位:秒。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立新的连接。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '12',
],
],
[
'name' => 'RequestTimeout',
'in' => 'query',
'schema' => [
'description' => '指定请求超时时间,取值范围为**1~180**,默认值为**60**。单位:秒。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回HTTP 504错误码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '23',
],
],
[
'name' => 'EnableHttp2',
'in' => 'query',
'schema' => [
'description' => '是否开启HTTP2特性。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off** :否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'TLSCipherPolicy',
'in' => 'query',
'schema' => [
'description' => '安全策略包含HTTPS可选的TLS协议版本和配套的加密算法套件。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1_0**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.0、TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_1**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1_2**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_2_strict**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA和ECDHE-RSA-AES256-SHA。'."\n"
."\n"
.'- **tls\\_cipher\\_policy\\_1\\_2\\_strict_with_1_3**'."\n"
.' '."\n"
.' 支持TLS版本:TLSv1.2及TLSv1.3。'."\n"
.' '."\n"
.' 支持的加密算法套件:TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256、TLS_AES_128_CCM_SHA256、TLS_AES_128_CCM_8_SHA256、ECDHE-ECDSA-AES128-GCM-SHA256、ECDHE-ECDSA-AES256-GCM-SHA384、ECDHE-ECDSA-AES128-SHA256、ECDHE-ECDSA-AES256-SHA384、ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-ECDSA-AES128-SHA、ECDHE-ECDSA-AES256-SHA、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA。 ',
'type' => 'string',
'required' => false,
'example' => 'tls_cipher_policy_1_1',
],
],
[
'name' => 'XForwardedFor_SLBPORT',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'XForwardedFor_ClientSrcPort',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParamDuplicateError',
'errorMessage' => 'The specified parameter value of XForwardedFor_ClientCertSubjectDNAlias is duplicate. Please change to a different one.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameter.IdleTimeout',
'errorMessage' => 'The specified IdleTimeout exceeds the limit.',
],
[
'errorCode' => 'InvalidParameter.RequestTimeout',
'errorMessage' => 'The specified RequestTimeout exceeds the limit.',
],
[
'errorCode' => 'ListenerForwardNotSupport',
'errorMessage' => 'X-Forward-For is not supported to a ipv6 instance.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'InvalidParameter.SpecNotSupport',
'errorMessage' => 'The loadBalancer of shared spec does not support the parameter: %s.',
],
[
'errorCode' => 'ListenerProcessing',
'errorMessage' => 'A previous configuration of the listener is pending,please try again later.',
],
[
'errorCode' => 'Certkey.Forbidden',
'errorMessage' => 'The specified certkey is not owned by the current user.',
],
[
'errorCode' => 'InvalidParameter.ListenerPortConflict',
'errorMessage' => 'There is conflict listener port exists.',
],
[
'errorCode' => 'ResourceNotAvailible.HttpsListener',
'errorMessage' => 'The specified Zone did not have enough resource.',
],
[
'errorCode' => 'AclNotExist',
'errorMessage' => 'Acl does not exist.',
],
[
'errorCode' => 'OperationUnsupported.CreateLoadBalancerLayer7Listener',
'errorMessage' => 'The slb instance does not support create HTTP or HTTPS listener.',
],
[
'errorCode' => 'InvalidParameter.VServerGroupId',
'errorMessage' => 'The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener.',
],
[
'errorCode' => 'MissingParam.HealthCheckDomain',
'errorMessage' => 'The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1.',
],
[
'errorCode' => 'InvalidParameter.HealthCheckHttpVersion',
'errorMessage' => 'The param HealthCheckHttpVersion is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'CertificateNotExist',
'errorMessage' => 'The specified CertificateId does not exist.',
],
[
'errorCode' => 'OperationFailed.InsufficientResources',
'errorMessage' => 'The loadbalancer does not support this operation because of insufficient resources.',
],
[
'errorCode' => 'InvalidTLSPolicyId.NotExist',
'errorMessage' => 'The specified TLS cipher policy does not exist.',
],
[
'errorCode' => 'TLSPolicyConfiguring',
'errorMessage' => 'The specified TLS cipher policy is configuring.',
],
[
'errorCode' => 'TLSCipherPolicyVipRelationOverLimit',
'errorMessage' => 'The number of listeners associated with a policy has exceeded.',
],
[
'errorCode' => 'CertificateTypeMismatched',
'errorMessage' => 'The certificate type does not match.',
],
[
'errorCode' => 'MissingParam.ServerCertificates',
'errorMessage' => 'Server certificates are required.',
],
[
'errorCode' => 'TooManyCertificates',
'errorMessage' => 'The number of certificates must not be greater than one.',
],
[
'errorCode' => 'CnCertificateNotSupport',
'errorMessage' => 'The cn certificate is not support.',
],
[
'errorCode' => 'InvalidParam.CertificateBindingType',
'errorMessage' => 'The param CertificateBindingType is invalid.',
],
[
'errorCode' => 'InvalidParamSize.ServerCertificates',
'errorMessage' => 'The size of param ServerCertificates is invalid.',
],
[
'errorCode' => 'TooManyCertificates.ServerCertificates',
'errorMessage' => 'The number of certificates must not be greater than one.',
],
[
'errorCode' => 'SPEC_NOT_SUPPORT_PARAMETER',
'errorMessage' => 'Share spec does not support the feature.',
],
[
'errorCode' => 'LbNotSupportTcpssl',
'errorMessage' => 'You cannot create a TCP SSL type listener for the specified load balancer.',
],
[
'errorCode' => 'LbSupportTcpsslOnly',
'errorMessage' => 'The specified load balancer supports TCP SSL type listener only.',
],
[
'errorCode' => 'ListenerNotSupportRule',
'errorMessage' => 'You cannot create a rule for the specified listener.',
],
[
'errorCode' => 'Mismatch.SlbSpecTypeAndListenerProtocol',
'errorMessage' => 'The SlbSpecType and ListenerProtocol are mismatched.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
404 => [
[
'errorCode' => 'ResourceNotFound.Certificate',
'errorMessage' => 'The specified resource is not found.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '创建HTTPS监听',
'summary' => '创建HTTPS监听。',
'description' => '### 注意事项'."\n"
."\n"
.'新建的监听的状态为**stopped**。创建完成后,调用[StartLoadBalancerListener](~~27597~~)接口启动监听来转发流量。'."\n"
."\n"
.'### 前提条件'."\n"
."\n"
.'您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetLoadBalancerHTTPSListenerAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '88669',
'abilityTreeNodes' => [
'FEATUREslbFSBXXR',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-sjhfdji****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'Bandwidth',
'in' => 'query',
'schema' => [
'description' => '监听的带宽峰值。单位:Mbps。'."\n"
."\n"
.'取值:'."\n"
."\n"
.'- **-1**:不限制带宽峰值。'."\n"
."\n"
.' '."\n"
."\n"
.'- **1**~**5120**:监听的带宽峰值,所有监听的带宽峰值之和不能超过实例的带宽峰值。'."\n"
.'',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '5120',
'minimum' => '-1',
'example' => '-1',
],
],
[
'name' => 'XForwardedFor',
'in' => 'query',
'schema' => [
'description' => '是否开启通过`X-Forwarded-For`头字段获取来访者真实IP。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'- **wrr**:权重值越高的后端服务器,被轮询到的-概率也越高。'."\n"
."\n"
.'- **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
],
],
[
'name' => 'StickySession',
'in' => 'query',
'schema' => [
'description' => '是否开启会话保持。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'StickySessionType',
'in' => 'query',
'schema' => [
'description' => 'cookie的处理方式。取值:'."\n"
."\n"
.'* **insert**:植入Cookie。'."\n"
."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP/HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'* **server**:重写Cookie。'."\n"
."\n"
.' 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'> 当**StickySession**的值为**on**时,必须指定该参数。',
'type' => 'string',
'required' => false,
'example' => 'insert',
],
],
[
'name' => 'CookieTimeout',
'in' => 'query',
'schema' => [
'description' => 'Cookie超时时间。'."\n"
."\n"
.'取值:**1**~**86400**(秒)。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**insert**时,该参数必选。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '86400',
'minimum' => '1',
'example' => '500',
],
],
[
'name' => 'Cookie',
'in' => 'query',
'schema' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200个字符,只能包含ASCII英文字母和数字字符,不能包含半角逗号(,)、半角分号(;)或空格,不能以$开头。'."\n"
."\n"
.'>当**StickySession**为**on**且**StickySessionType**为**server**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'testCookie',
],
],
[
'name' => 'HealthCheck',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'HealthCheckMethod',
'in' => 'query',
'schema' => [
'description' => '监听HTTP类型健康检查的健康检查方法。取值:**head**或**get**。'."\n"
."\n"
.'> **HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => 'get',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名,取值:'."\n"
."\n"
.'* **$_ip**: 后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'* **domain**:域名长度为1~80字符,只能包含字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => '172.XX.XX.16',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'长度限制为1~80字符,支持英文字母、数字、短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、半角问号(?)、井号(#)和and(&)字符。URI不能只包含正斜线(/),但必须以正斜线(/)开头。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => '/test/index.html',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'>在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。取值:**1**~**300**。'."\n"
."\n\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '3',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值:**1**~**50**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '5',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。'."\n"
."\n"
.'> 当**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '-520',
'example' => '8080',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。'."\n"
."\n"
.'取值:**http_2xx**或**http_3xx**或**http_4xx**或**http_5xx**。'."\n"
."\n"
.'> 在**HealthCheck**值为**on**时才会有效。',
'type' => 'string',
'required' => false,
'example' => 'http_2xx,http_3xx',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '服务器证书的ID。',
'type' => 'string',
'required' => false,
'example' => 'idkp-123-cn-te****',
],
],
[
'name' => 'CACertificateId',
'in' => 'query',
'schema' => [
'description' => 'CA证书ID。'."\n"
."\n"
.'- 若既上传CA证书又上传服务器证书,即采用双向认证。'."\n"
."\n"
.'- 若用户只上传服务器证书,即为单向认证。',
'type' => 'string',
'required' => false,
'example' => '139a00604ad-cn-east-****',
],
],
[
'name' => 'VServerGroup',
'in' => 'query',
'schema' => [
'description' => '是否使用服务器组。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6j****',
],
],
[
'name' => 'XForwardedFor_SLBIP',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'XForwardedFor_SLBID',
'in' => 'query',
'schema' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'XForwardedFor_proto',
'in' => 'query',
'schema' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'Gzip',
'in' => 'query',
'schema' => [
'description' => '是否开启`Gzip`压缩,对特定文件类型进行压缩。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'on',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'acl-a2do9e413e0spzasx****',
],
],
[
'name' => 'AclType',
'in' => 'query',
'schema' => [
'description' => '访问控制类型:'."\n"
."\n"
.'- **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
.' '."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'- **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'>当**AclStatus**参数的值为**on**时,该参数有效。',
'type' => 'string',
'required' => false,
'example' => 'white',
],
],
[
'name' => 'AclStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'IdleTimeout',
'in' => 'query',
'schema' => [
'description' => '指定连接空闲超时时间,取值范围为**1~60**秒,默认值为**15**秒。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立新的连接。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '23',
],
],
[
'name' => 'RequestTimeout',
'in' => 'query',
'schema' => [
'description' => '指定请求超时时间,取值范围为**1~180**秒,默认值为**60**秒。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回HTTP 504错误码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '9999',
'minimum' => '1',
'example' => '223',
],
],
[
'name' => 'EnableHttp2',
'in' => 'query',
'schema' => [
'description' => '是否开启`HTTP 2.0`特性。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。'."\n",
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'TLSCipherPolicy',
'in' => 'query',
'schema' => [
'description' => '安全策略包含HTTPS可选的TLS协议版本和配套的加密算法套件。'."\n"
."\n"
.'- **tls_cipher_policy_1_0**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.0、TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_1**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_2**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_2_strict**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA和ECDHE-RSA-AES256-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_2_strict_with_1_3**'."\n"
.' '."\n"
.' 支持TLS版本:TLSv1.2及TLSv1.3。'."\n"
.' '."\n"
.' 支持的加密算法套件:TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256、TLS_AES_128_CCM_SHA256、TLS_AES_128_CCM_8_SHA256、ECDHE-ECDSA-AES128-GCM-SHA256、ECDHE-ECDSA-AES256-GCM-SHA384、ECDHE-ECDSA-AES128-SHA256、ECDHE-ECDSA-AES256-SHA384、ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-ECDSA-AES128-SHA、ECDHE-ECDSA-AES256-SHA、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA。 ',
'type' => 'string',
'required' => false,
'example' => 'tls_cipher_policy_1_2',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '自定义监听名称。'."\n"
."\n"
.'长度限制为1~256个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'https_80',
],
],
[
'name' => 'XForwardedFor_SLBPORT',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'XForwardedFor_ClientSrcPort',
'in' => 'query',
'schema' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParamDuplicateError',
'errorMessage' => 'The specified parameter value of XForwardedFor_ClientCertSubjectDNAlias is duplicate. Please change to a different one.',
],
[
'errorCode' => 'IpVersionConflict',
'errorMessage' => 'The ip version of this LoadBalancer and the Acl is conflict.',
],
[
'errorCode' => 'InvalidParameter.IdleTimeout',
'errorMessage' => 'The specified IdleTimeout exceeds the limit.',
],
[
'errorCode' => 'InvalidParameter.RequestTimeout',
'errorMessage' => 'The specified RequestTimeout exceeds the limit.',
],
[
'errorCode' => 'ListenerForwardNotSupport',
'errorMessage' => 'X-Forward-For is not supported to a ipv6 instance.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'InvalidParameter.SpecNotSupport',
'errorMessage' => 'The loadBalancer of shared spec does not support the parameter: %s.',
],
[
'errorCode' => 'OperationFailed.ServerGroupInUse',
'errorMessage' => 'The VServerGroup or MasterSlaveServerGroup can not be close for this listener.',
],
[
'errorCode' => 'InvalidParameter.VServerGroupId',
'errorMessage' => 'The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener.',
],
[
'errorCode' => 'MissingParam.HealthCheckDomain',
'errorMessage' => 'The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1.',
],
[
'errorCode' => 'InvalidParameter.HealthCheckHttpVersion',
'errorMessage' => 'The param HealthCheckHttpVersion is invalid.',
],
[
'errorCode' => 'Duplicated.AclEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'CertificateNotExist',
'errorMessage' => 'The specified CertificateId does not exist.',
],
[
'errorCode' => 'InvalidTLSPolicyId.NotExist',
'errorMessage' => 'The specified TLS cipher policy does not exist.',
],
[
'errorCode' => 'TLSPolicyConfiguring',
'errorMessage' => 'The specified TLS cipher policy is configuring.',
],
[
'errorCode' => 'TLSCipherPolicyVipRelationOverLimit',
'errorMessage' => 'The number of listeners associated with a policy has exceeded.',
],
[
'errorCode' => 'TooManyCertificates',
'errorMessage' => 'The number of certificates must not be greater than one.',
],
[
'errorCode' => 'CertificateTypeMismatched',
'errorMessage' => 'The certificate type does not match.',
],
[
'errorCode' => 'MissingParam.ServerCertificates',
'errorMessage' => 'Server certificates are required.',
],
[
'errorCode' => 'CnCertificateNotSupport',
'errorMessage' => 'The cn certificate is not support.',
],
[
'errorCode' => 'InvalidParam.CertificateBindingType',
'errorMessage' => 'The param CertificateBindingType is invalid.',
],
[
'errorCode' => 'InvalidParamSize.ServerCertificates',
'errorMessage' => 'The size of param ServerCertificates is invalid.',
],
[
'errorCode' => 'TooManyCertificates.ServerCertificates',
'errorMessage' => 'The number of certificates must not be greater than one.',
],
[
'errorCode' => 'AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclAttachedToListener',
'errorMessage' => 'The number of Acl bound listeners has reached the quota limit',
],
[
'errorCode' => 'QuotaLimitExceeds.TotalAclEntry',
'errorMessage' => 'The number of Acl entries has reached the quota limit.',
],
[
'errorCode' => 'QuotaLimitExceeds.AclListenerOverLimit',
'errorMessage' => 'This acl has reached the limit of binding to listeners.',
],
],
404 => [
[
'errorCode' => 'ResourceNotFound.Certificate',
'errorMessage' => 'The specified resource is not found.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\nCEF72CEB-54B6-4AE8-B225-F876FF7BA984\\r\\n","errorExample":""}]',
'title' => '修改HTTPS监听的配置',
'summary' => '修改HTTPS监听的配置。',
'description' => '- 您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
.'- 您已经创建HTTPS监听,具体操作,请参见[CreateLoadBalancerHTTPSListener](~~27593~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLoadBalancerHTTPSListenerAttribute' => [
'summary' => '查询HTTPS监听配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88578',
'abilityTreeNodes' => [
'FEATUREslb91TBWT',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1mxu5r8lau****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '实例前端使用的端口。'."\n"
."\n"
.'取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AclType' => [
'description' => '访问控制类型:'."\n"
."\n"
.'* **white**: 仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求,白名单适用于只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单,就只有白名单中的IP可以访问负载均衡监听。'."\n"
."\n"
.' 如果开启了白名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'* **black**: 来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发,黑名单适用于只限制某些特定IP访问的场景。'."\n"
."\n"
.' 如果开启了黑名单访问,但访问策略组中没有添加任何IP,则负载均衡监听会转发全部请求。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'example' => 'white',
],
'XForwardedFor_ClientCertClientVerify' => [
'description' => '是否通过`XForwardedFor_ClientCertClientVerify`头字段获取对访问负载均衡实例客户端证书的校验结果。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'CACertificateId' => [
'description' => 'CA证书ID。',
'type' => 'string',
'example' => 'idkp-234-cn-test-0**',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF3********',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的端口。'."\n"
."\n"
.'> 当**HealthCheck**值为**on**时才会有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'BackendServerPort' => [
'description' => '实例后端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '8080',
],
'CookieTimeout' => [
'description' => 'Cookie超时时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'HealthCheckDomain' => [
'description' => '用于健康检查的域名。',
'type' => 'string',
'example' => 'www.test.com',
],
'XForwardedFor' => [
'description' => '是否通过`X-Forwarded-For`的方式获取来访者真实IP。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor_ClientCertFingerprint' => [
'description' => '是否通过`XForwardedFor_ClientCertFingerprint`头字段获取访问负载均衡实例客户端证书的指纹。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'IdleTimeout' => [
'description' => '指定连接空闲超时时间,取值范围为**1**~**60**,默认值为**15**。单位:秒。'."\n"
."\n"
.'在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到一下次请求来临时重新建立新的连接。',
'type' => 'integer',
'format' => 'int32',
'example' => '23',
],
'ListenerPort' => [
'description' => '实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'HealthCheckURI' => [
'description' => '用于健康检查的URI。',
'type' => 'string',
'example' => '/test/index.html',
],
'XForwardedFor_SLBPORT' => [
'description' => '是否通过`XForwardedFor_SLBPORT`头字段获取负载均衡实例的监听端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'StickySessionType' => [
'description' => 'Cookie的处理方式。'."\n"
."\n"
.'取值:**insert**或**server**。'."\n"
."\n"
.'* **insert**:植入Cookie。'."\n"
.' '."\n"
.' '."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie,下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'* **server**:重写Cookie。'."\n"
.' '."\n"
.' '."\n"
.' 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。',
'type' => 'string',
'example' => 'insert',
],
'Scheduler' => [
'description' => '调度算法。取值:**wrr**或**rr**。'."\n"
."\n"
.'* **wrr**:权重值越高的后端服务器,被轮询到的概率也越高。'."\n"
."\n"
.'* **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。',
'type' => 'string',
'example' => 'wrr',
],
'XForwardedFor_proto' => [
'description' => '是否通过`X-Forwarded-Proto`头字段获取负载均衡实例的监听协议。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'HealthCheckMethod' => [
'description' => '监听HTTP类型健康检查的健康检查方法。取值:**head**或**get**。'."\n"
."\n"
.'> **HealthCheck**值为**on**时,该参数才会显示。',
'type' => 'string',
'example' => 'get',
],
'TLSCipherPolicy' => [
'description' => '只有性能保障型实例才可以指定TLSCipherPolicy参数,每种policy定义了一种安全策略。'."\n"
."\n"
.'安全策略包含HTTPS可选的TLS协议版本和配套的加密算法套件。'."\n"
."\n"
.'- **tls_cipher_policy_1_0**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.0、TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_1**:'."\n"
."\n"
.' 支持TLS版本: TLSv1.1和TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_2**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA和DES-CBC3-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_2_strict**'."\n"
."\n"
.' 支持TLS版本:TLSv1.2。'."\n"
."\n"
.' 支持加密算法套件:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA和ECDHE-RSA-AES256-SHA。'."\n"
."\n"
.'- **tls_cipher_policy_1_2_strict_with_1_3**'."\n"
.' '."\n"
.' 支持TLS版本:TLSv1.2及TLSv1.3。'."\n"
.' '."\n"
.' 支持的加密算法套件:TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256、TLS_AES_128_CCM_SHA256、TLS_AES_128_CCM_8_SHA256、ECDHE-ECDSA-AES128-GCM-SHA256、ECDHE-ECDSA-AES256-GCM-SHA384、ECDHE-ECDSA-AES128-SHA256、ECDHE-ECDSA-AES256-SHA384、ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-ECDSA-AES128-SHA、ECDHE-ECDSA-AES256-SHA、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA。 ',
'type' => 'string',
'example' => 'tls_cipher_policy_1_0',
],
'Status' => [
'description' => '当前监听的状态。取值:'."\n"
.'- **running**:运行中。'."\n"
.'- **stopped**:已停止。',
'type' => 'string',
'example' => 'stopped',
],
'VServerGroupId' => [
'description' => '绑定的服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j5e********',
],
'XForwardedFor_ClientSrcPort' => [
'description' => '是否通过`XForwardedFor_ClientSrcPort`头字段获取访问负载均衡实例客户端的端口。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'Cookie' => [
'description' => '服务器上配置的Cookie。',
'type' => 'string',
'example' => 'testCookie',
],
'Gzip' => [
'description' => '是否开启`Gzip`压缩。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'EnableHttp2' => [
'description' => '是否开启`HTTP2`特性。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'Bandwidth' => [
'description' => '监听的带宽峰值。单位:Mbps。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'Description' => [
'description' => '自定义监听名称。',
'type' => 'string',
'example' => 'HTTPS_443',
],
'HealthCheckTimeout' => [
'description' => '每次健康检查响应的最大超时间。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'AclStatus' => [
'description' => '是否开启访问控制功能。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'UnhealthyThreshold' => [
'description' => '不健康检查阈值。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_SLBID' => [
'description' => '是否通过`SLB-ID`头字段获取负载均衡实例ID。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'XForwardedFor_ClientCertSubjectDN' => [
'description' => '是否通过`XForwardedFor_ClientCertSubjectDN`头字段获取访问负载均衡实例客户端证书的所有者信息。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'SecurityStatus' => [
'description' => '是否处于安全状态。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码。',
'type' => 'string',
'example' => 'http_2xx,http_3xx',
],
'RequestTimeout' => [
'description' => '指定请求超时时间,取值范围为**1**~**180**,默认值为**60**。单位:秒。'."\n"
."\n"
.'在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回HTTP 504错误码。',
'type' => 'integer',
'format' => 'int32',
'example' => '43',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'ServerCertificateId' => [
'description' => '服务器证书的ID。',
'type' => 'string',
'example' => 'idkp-123-cn-test-0**',
],
'AclId' => [
'description' => '监听绑定的访问策略组ID。'."\n"
."\n"
.'> 当**AclStatus**参数的值为**on**时,该参数必选。',
'type' => 'string',
'example' => 'acl-a2do9e413e0spzasx****',
],
'XForwardedFor_ClientCertIssuerDN' => [
'description' => '是否通过`XForwardedFor_ClientCertIssuerDN`头字段获取访问负载均衡实例客户端证书的发行者信息。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'off',
],
'HealthyThreshold' => [
'description' => '健康检查阈值。',
'type' => 'integer',
'format' => 'int32',
'example' => '4',
],
'XForwardedFor_SLBIP' => [
'description' => '是否通过`SLB-IP`头字段获取客户端请求的VIP(Virtual IP address)。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'StickySession' => [
'description' => '是否开启会话保持。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:未开启。',
'type' => 'string',
'example' => 'on',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
.'- **on**:是。'."\n"
.'- **off**:否。',
'type' => 'string',
'example' => 'on',
],
'AclIds' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AclId' => [
'description' => '监听绑定的访问策略组ID。',
'type' => 'array',
],
],
],
'Rules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Rule' => [
'description' => '监听下的转发规则列表。',
'type' => 'array',
'items' => [
'description' => '监听下的转发规则列表。',
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '转发规则的目标服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j5e********',
],
'Url' => [
'description' => '访问路径。',
'type' => 'string',
'example' => '/example',
],
'Domain' => [
'description' => '域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'RuleName' => [
'description' => '转发规则名称。',
'type' => 'string',
'example' => 'example',
],
'RuleId' => [
'description' => '转发规则ID。',
'type' => 'string',
'example' => '23',
],
],
],
],
],
],
'DomainExtensions' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'DomainExtension' => [
'description' => '域名扩展列表。',
'type' => 'array',
'items' => [
'description' => '域名扩展列表。',
'type' => 'object',
'properties' => [
'ServerCertificateId' => [
'description' => '与域名对应的证书ID。',
'type' => 'string',
'example' => '13344444****',
],
'Domain' => [
'description' => '域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'DomainExtensionId' => [
'description' => '域名扩展ID。',
'type' => 'string',
'example' => '12',
],
],
],
],
],
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1mxu5r8lau****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"AclType\\": \\"white\\",\\n \\"XForwardedFor_ClientCertClientVerify\\": \\"off\\",\\n \\"CACertificateId\\": \\"idkp-234-cn-test-0**\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF3********\\",\\n \\"HealthCheckConnectPort\\": 8080,\\n \\"BackendServerPort\\": 8080,\\n \\"CookieTimeout\\": 500,\\n \\"HealthCheckDomain\\": \\"www.test.com\\",\\n \\"XForwardedFor\\": \\"on\\",\\n \\"XForwardedFor_ClientCertFingerprint\\": \\"off\\",\\n \\"IdleTimeout\\": 23,\\n \\"ListenerPort\\": 80,\\n \\"HealthCheckURI\\": \\"/test/index.html\\",\\n \\"XForwardedFor_SLBPORT\\": \\"off\\",\\n \\"StickySessionType\\": \\"insert\\",\\n \\"Scheduler\\": \\"wrr\\",\\n \\"XForwardedFor_proto\\": \\"on\\",\\n \\"HealthCheckMethod\\": \\"get\\",\\n \\"TLSCipherPolicy\\": \\"tls_cipher_policy_1_0\\",\\n \\"Status\\": \\"stopped\\",\\n \\"VServerGroupId\\": \\"rsp-cige6j5e********\\",\\n \\"XForwardedFor_ClientSrcPort\\": \\"off\\",\\n \\"Cookie\\": \\"testCookie\\",\\n \\"Gzip\\": \\"on\\",\\n \\"EnableHttp2\\": \\"off\\",\\n \\"Bandwidth\\": 10,\\n \\"Description\\": \\"HTTPS_443\\",\\n \\"HealthCheckTimeout\\": 3,\\n \\"AclStatus\\": \\"off\\",\\n \\"UnhealthyThreshold\\": 4,\\n \\"XForwardedFor_SLBID\\": \\"on\\",\\n \\"XForwardedFor_ClientCertSubjectDN\\": \\"off\\",\\n \\"SecurityStatus\\": \\"on\\",\\n \\"HealthCheckHttpCode\\": \\"http_2xx,http_3xx\\",\\n \\"RequestTimeout\\": 43,\\n \\"HealthCheckInterval\\": 5,\\n \\"ServerCertificateId\\": \\"idkp-123-cn-test-0**\\",\\n \\"AclId\\": \\"acl-a2do9e413e0spzasx****\\",\\n \\"XForwardedFor_ClientCertIssuerDN\\": \\"off\\",\\n \\"HealthyThreshold\\": 4,\\n \\"XForwardedFor_SLBIP\\": \\"on\\",\\n \\"StickySession\\": \\"on\\",\\n \\"HealthCheck\\": \\"on\\",\\n \\"AclIds\\": {\\n \\"AclId\\": [\\n \\"\\"\\n ]\\n },\\n \\"Rules\\": {\\n \\"Rule\\": [\\n {\\n \\"VServerGroupId\\": \\"rsp-cige6j5e********\\",\\n \\"Url\\": \\"/example\\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"RuleName\\": \\"example\\",\\n \\"RuleId\\": \\"23\\"\\n }\\n ]\\n },\\n \\"DomainExtensions\\": {\\n \\"DomainExtension\\": [\\n {\\n \\"ServerCertificateId\\": \\"13344444****\\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"DomainExtensionId\\": \\"12\\"\\n }\\n ]\\n },\\n \\"LoadBalancerId\\": \\"lb-bp1mxu5r8lau****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n white\\n off\\n idkp-234-cn-test-0**\\n 365F4154-92F6-4AE4-92F8-7FF3********\\n 8080\\n 8080\\n 500\\n www.test.com\\n on\\n off\\n 23\\n 80\\n /test/index.html\\n off\\n insert\\n wrr\\n on\\n get\\n tls_cipher_policy_1_0\\n stopped\\n rsp-cige6j5e********\\n off\\n B490B5EBF6F3CD402E515D22BCDA1598\\n on\\n off\\n -1\\n HTTPS_443\\n 3\\n off\\n 4\\n on\\n off\\n on\\n http_2xx,http_3xx\\n 43\\n 5\\n idkp-123-cn-test-0**\\n nacl-a2do9e413e0spzasx****\\n off\\n 4\\n on\\n on\\n on\\n \\n 12\\n /example\\n www.example.com\\n example\\n 23\\n \\n \\n 13344444****\\n www.example.com\\n 12\\n \\n lb-bp1mxu5r8lau****\\n \\n TestKey\\n TestValue\\n \\n","errorExample":""}]',
'title' => '查询HTTPS监听配置',
'description' => '- 您已经创建传统型负载均衡,具体操作,请参见[CreateLoadBalancer](~~27577~~)。'."\n"
.'- 您已经创建HTTPS监听,具体操作,请参见[CreateLoadBalancerHTTPSListener](~~27593~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateRules' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1ca0zt07t934w******',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的监听端口。'."\n"
."\n"
.'取值范围:**1~65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'example' => '443',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
."\n"
.'> 相同端口存在不同协议监听时,此字段必选。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
[
'name' => 'RuleList',
'in' => 'query',
'schema' => [
'description' => '要添加的转发规则。一次请求中,最多可添加10条转发规则。每条转发规则包含以下参数:'."\n"
."\n"
.'- **RuleName**(必选):String类型。转发规则名称,长度为1~40个字符,支持字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)这些字符。同一个监听内不同规则的名称必须唯一。'."\n"
."\n"
.'- **Domain**(可选): String类型。转发规则关联的请求域名,与**Url**参数至少选择一个。'."\n"
."\n"
.'- **Url**(可选):String类型,可选,访问路径,长度限制为1~80个字符,只能使用中文、字母、数字和短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、问号(?)、井号(#)和and(&)这些字符。 URL不能只为正斜线(/),但必须以正斜线(/)开头,与**Domain**参数至少选择一个。'."\n"
."\n"
.'- **VServerGroupId**(必选):String类型。该转发规则的目标虚拟服务器组ID。'."\n"
."\n"
.'> `Domain`和`Url`两者必须指定一个,也可以同时指定。`Domain`和`Url`的组合在同一个监听内必须唯一。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{"RuleName":"Rule2","Domain":"test.com","VServerGroupId":"rsp-bp114ni******"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
'Rules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Rule' => [
'description' => '转发规则列表。',
'type' => 'array',
'items' => [
'description' => '转发规则列表。',
'type' => 'object',
'properties' => [
'RuleName' => [
'description' => '转发规则名称。',
'type' => 'string',
'example' => 'Rule2',
],
'RuleId' => [
'description' => '转发规则ID。',
'type' => 'string',
'example' => 'rule-bp12jzy0*****',
],
],
'enumValueTitles' => [],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified VServerGroupId does not belong to the LoadBalancerId of the rule.',
],
[
'errorCode' => 'InvalidParameterValue.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter value, %s.',
],
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
[
'errorCode' => 'DomainExist',
'errorMessage' => 'rule with same domain and url already exists in specified vip',
],
[
'errorCode' => 'OperationFailed.ListenerStatusNotSupport',
'errorMessage' => 'The status of the listener does not support this operation. Please try again later.',
],
[
'errorCode' => 'OperationFailed.ActionNotSupport',
'errorMessage' => 'The loadbalancer does not support such action.',
],
[
'errorCode' => 'MissingParameter.RuleName',
'errorMessage' => 'The parameter RuleName is required.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\",\\n \\"Rules\\": {\\n \\"Rule\\": [\\n {\\n \\"RuleName\\": \\"Rule2\\",\\n \\"RuleId\\": \\"rule-bp12jzy0*****\\"\\n }\\n ]\\n }\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n\\tD63E42FB-F963-4EE5-9B32-05602BF351F3\\n\\t\\n\\t\\t\\n\\t\\t\\trule-bp12jzy******\\n\\t\\t\\tRule3\\n\\t\\t\\n\\t\\n","errorExample":""}]',
'title' => '为HTTP或HTTPS监听添加转发规则',
'summary' => '为指定的HTTP或HTTPS监听添加转发规则。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetRule' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '转发规则ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rule-3ejhkt****',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '转发规则的目标服务器组ID。',
'type' => 'string',
'required' => false,
'example' => 'rsp-cige6****',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '转发规则名称,长度限制为1~40个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)这些字符。'."\n"
."\n"
.'> 同一个监听内不同规则的名称必须唯一。',
'type' => 'string',
'required' => false,
'example' => 'doctest',
],
],
[
'name' => 'ListenerSync',
'in' => 'query',
'schema' => [
'description' => '是否继承监听的健康检查、会话保持和调度算法配置。取值:'."\n"
."\n"
.'- **on**:继承监听配置。'."\n"
."\n"
.'- **off**:不继承监听配置。转发规则自定义健康检查及会话保持配置。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'Scheduler',
'in' => 'query',
'schema' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'* **wrr**:权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'* **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'>在**ListenerSync**为**off**时必选且有效。',
'type' => 'string',
'required' => false,
'example' => 'wrr',
],
],
[
'name' => 'StickySession',
'in' => 'query',
'schema' => [
'description' => '是否开启会话保持,取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
."\n"
.'- **off**:不开启。'."\n"
."\n"
.'在**ListenerSync**为**off**时必选且有效。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'StickySessionType',
'in' => 'query',
'schema' => [
'description' => 'Cookie的处理方式。取值:'."\n"
."\n"
.'- **insert**:植入Cookie。'."\n"
.' 客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP或HTTPS响应报文中插入后端服务器ID),客户端下次携带此Cookie访问时,负载均衡服务会将请求定向转发给第一次访问时记录到的后端服务器上。'."\n"
."\n"
.'- **server**:重写Cookie。'."\n"
.' 负载均衡发现用户自定义Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问时,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'>**StickySession**为**on**时必选且有效。',
'type' => 'string',
'required' => false,
'example' => 'insert',
],
],
[
'name' => 'CookieTimeout',
'in' => 'query',
'schema' => [
'description' => 'Cookie超时时间。单位:秒。取值范围:**1**~**86400**。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**insert**时必选且有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '86400',
'minimum' => '1',
'example' => '123',
],
],
[
'name' => 'Cookie',
'in' => 'query',
'schema' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200个字符,只能包含ASCII英文字母和数字字符,不能包含半角逗号(,)、半角分号(;)或空格,也不能以美元($)开头。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**server**时必选且有效。',
'type' => 'string',
'required' => false,
'example' => '23ffsa',
],
],
[
'name' => 'HealthCheck',
'in' => 'query',
'schema' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**:开启。'."\n"
.'- **off**:不开启。'."\n"
."\n"
.'> **ListenerSync**为**off**时必选且有效,其他情况会忽略此参数。',
'type' => 'string',
'required' => false,
'example' => 'off',
],
],
[
'name' => 'HealthCheckDomain',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的域名,取值:'."\n"
."\n"
.'* **$_ip**: 后端服务器的私网IP。当指定了$_ip或HealthCheckDomain未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'* **domain**:域名长度为1~80字符,只能包含字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'>** HealthCheck**为**on**时有效。',
'type' => 'string',
'required' => false,
'example' => '$_ip',
],
],
[
'name' => 'HealthCheckURI',
'in' => 'query',
'schema' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'>**HealthCheck**为**on**时必选且有效。',
'type' => 'string',
'required' => false,
'example' => '/example',
],
],
[
'name' => 'HealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值范围:**2**~**10**。'."\n"
."\n"
.'> **HealthCheck**为**on**时必选且有效。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'UnhealthyThreshold',
'in' => 'query',
'schema' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**成功**判定为**失败**。'."\n"
."\n"
.'取值范围:**2**~**10**。'."\n"
."\n"
.'> **HealthCheck**为**on**时必选且有效。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '10',
'minimum' => '1',
'example' => '4',
],
],
[
'name' => 'HealthCheckTimeout',
'in' => 'query',
'schema' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。取值范围:**1**~**300**。'."\n"
."\n"
.'> **HealthCheck**为**on**时必选且有效。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '300',
'minimum' => '1',
'example' => '20',
],
],
[
'name' => 'HealthCheckInterval',
'in' => 'query',
'schema' => [
'description' => '健康检查的时间间隔。单位:秒。取值范围:**1**~**50**。'."\n"
."\n"
.'> **HealthCheck**为**on**时必选且有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '20',
],
],
[
'name' => 'HealthCheckConnectPort',
'in' => 'query',
'schema' => [
'description' => '健康检查使用的端口。取值范围:**1**~**65535**。'."\n"
."\n"
.'> **HealthCheck**为**on**时有效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'HealthCheckHttpCode',
'in' => 'query',
'schema' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。'."\n"
."\n"
.'取值:**http_2xx**或**http_3x**x或**http_4xx**或**http_5xx**。'."\n"
."\n"
.'> **HealthCheck**为**on**时必选且有效。',
'type' => 'string',
'required' => false,
'example' => 'http_2xx',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified VServerGroupId does not belong to the LoadBalancerId of the rule.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n","errorExample":""}]',
'title' => '修改目标虚拟服务器组的转发规则',
'summary' => '修改目标虚拟服务器组的转发规则。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteRules' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleIds',
'in' => 'query',
'schema' => [
'description' => '要删除的转发规则列表。'."\n"
."\n"
.'> 要删除的转发规则列表不能为空,并且可删除的转发规则条目数不能超过10条。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '["rule-bp1z9ce******","rule-bp1tuc******4"]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'The specified rules must be in the same listener.',
],
[
'errorCode' => 'OperationFailed.ListenerStatusNotSupport',
'errorMessage' => 'The status of the listener does not support this operation. Please try again later.',
],
[
'errorCode' => 'OperationFailed.ListenerConflict',
'errorMessage' => 'The rule does not support this operation because of same port listener.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\"\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n","errorExample":""}]',
'title' => '删除转发规则',
'summary' => '删除转发规则。',
'description' => '要删除的转发规则列表不能为空,并且可删除的转发规则条目数不能超过10条。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeRuleAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '转发规则ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rule-bp1efemp9****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '转发规则关联的服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j****',
],
'Cookie' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200个字符,只能包含ASCII英文字母和数字字符,不能包含半角逗号(,)、半角分号(;)或空格,也不能以美元符号($)开头。'."\n"
."\n"
.'当**StickySession**为**on**且**StickySessionType**为**server**时,该参数必选且有效。',
'type' => 'string',
'example' => 'wwe',
],
'LoadBalancerId' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1ca0zt07t934wxe****',
],
'RuleId' => [
'description' => '转发规则ID。',
'type' => 'string',
'example' => 'rule-hfgnd*****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的后端服务器的端口。'."\n"
."\n"
.'取值:**1**~**65535**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。若为空且**HealthCheck**为**on**,表明默认使用监听后端端口配置。',
'type' => 'integer',
'format' => 'int32',
'example' => '23',
],
'HealthCheckTimeout' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。'."\n"
."\n"
.'取值:**1**~**300**秒。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '34',
],
'CookieTimeout' => [
'description' => 'Cookie超时时间。'."\n"
."\n"
.'取值:**1~86400**秒。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**insert**时,该参数必选且有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '12',
],
'HealthCheckDomain' => [
'description' => '用于健康检查的域名,取值:'."\n"
."\n"
.'* **$_ip**: 后端服务器的私网IP。当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'* **domain**:域名长度为1~80字符,只能包含字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'string',
'example' => 'www.example.com',
],
'UnhealthyThreshold' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值:**2**~**10**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用逗号分隔。默认值为**http_2xx**。'."\n"
."\n"
.'取值:**http_2xx**或**http_3xx**或**http_4xx**或**http_5xx**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'string',
'example' => 'http_3xx ',
],
'Domain' => [
'description' => '转发规则域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'ListenerPort' => [
'description' => '负载均衡实例前端使用的监听端口。',
'type' => 'string',
'example' => '90',
],
'Url' => [
'description' => '转发规则路径。',
'type' => 'string',
'example' => '/cache',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔。'."\n"
."\n"
.'取值:**1**~**50**秒。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '34',
],
'HealthCheckURI' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'string',
'example' => '/rest',
],
'RuleName' => [
'description' => '转发规则名称。',
'type' => 'string',
'example' => 'Rule1',
],
'StickySessionType' => [
'description' => 'Cookie的处理方式。取值:'."\n"
."\n"
.'* **insert**:植入Cookie。客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP/HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'* **server**:重写Cookie。负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'> 当**StickySession**的值为**on**时,该参数有效。',
'type' => 'string',
'example' => 'insert',
],
'Scheduler' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'* **wrr**(默认值):权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'* **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'> **ListenerSync**为**off**时有效,为**on**时表明与监听配置一致。',
'type' => 'string',
'example' => 'wrr',
],
'ListenerSync' => [
'description' => '转发规则是否从监听上继承健康检查、会话保持和调度算法配置。'."\n"
."\n"
.'取值:**on**或**off**。'."\n"
."\n"
.'* **off**:不继承监听配置,转发规则自定义健康检查及会话保持配置。'."\n"
.'* **on**:继承监听配置。',
'type' => 'string',
'example' => 'off',
],
'HealthyThreshold' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**fail**判定为**success**。'."\n"
."\n"
.'取值:**1**~**10**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'StickySession' => [
'description' => '是否开启会话保持。取值:'."\n"
."\n"
.'- **on**:开启'."\n"
.'- **off**:不开启'."\n"
."\n"
.'> 在**ListenerSync**为**off**时必选且有效,为**on**时表明与监听配置一致。'."\n",
'type' => 'string',
'example' => 'off',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'- **on**:开启'."\n"
.'- **off**:不开启'."\n"
."\n"
.'> **ListenerSync**为**off**时有效,为**on**时表明与监听配置一致。',
'type' => 'string',
'example' => 'off',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6j****\\",\\n \\"Cookie\\": \\"wwe\\",\\n \\"LoadBalancerId\\": \\"lb-bp1ca0zt07t934wxe****\\",\\n \\"RuleId\\": \\"rule-hfgnd*****\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\",\\n \\"HealthCheckConnectPort\\": 23,\\n \\"HealthCheckTimeout\\": 34,\\n \\"CookieTimeout\\": 12,\\n \\"HealthCheckDomain\\": \\"www.example.com\\",\\n \\"UnhealthyThreshold\\": 3,\\n \\"HealthCheckHttpCode\\": \\"http_3xx \\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"ListenerPort\\": \\"90\\",\\n \\"Url\\": \\"/cache\\",\\n \\"HealthCheckInterval\\": 34,\\n \\"HealthCheckURI\\": \\"/rest\\",\\n \\"RuleName\\": \\"Rule1\\",\\n \\"StickySessionType\\": \\"insert\\",\\n \\"Scheduler\\": \\"wrr\\",\\n \\"ListenerSync\\": \\"off\\",\\n \\"HealthyThreshold\\": 2,\\n \\"StickySession\\": \\"off\\",\\n \\"HealthCheck\\": \\"off\\"\\n}","errorExample":""},{"type":"xml","example":"\\n rsp-cige6j****\\n wwe\\n lb-bp1ca0zt07t934wxe****\\n rule-hfgnd*****\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n 23\\n 34\\n 12\\n www.example.com\\n 3\\n http_3xx \\n www.example.com\\n 90\\n /cache\\n 34\\n 10.21.22.1\\n Rule1\\n insert\\n wrr\\n off\\n 2\\n off\\n off\\n","errorExample":""}]',
'title' => '查询指定转发规则的配置详情',
'summary' => '查询指定转发规则的配置详情。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeRules' => [
'summary' => '查询指定监听已配置的转发规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1ca0zt07t934****',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。取值:'."\n"
."\n"
.'**TCP**:协议类型为TCP。'."\n"
."\n"
.'**UDP**:协议类型为UDP。'."\n"
."\n"
.'**HTTP**:协议类型为HTTP。'."\n"
."\n"
.'**HTTPS**:协议类型为HTTPS。'."\n"
."\n"
.'>相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'http',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的监听端口。'."\n"
."\n"
.'取值范围:**1~65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'example' => '90',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
'Rules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Rule' => [
'description' => '转发规则列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'HealthCheckHttpCode' => [
'description' => '健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分隔。默认值为**http_2xx**。'."\n"
."\n"
.'取值:**http_2xx**、**http_3xx**、**http_4xx**或**http_5xx**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'string',
'example' => 'http_3xx',
],
'VServerGroupId' => [
'description' => '转发规则绑定的目标虚拟服务器组ID。',
'type' => 'string',
'example' => 'rsp-6cejjzl****',
],
'Domain' => [
'description' => '转发规则绑定的请求域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'Cookie' => [
'description' => '服务器上配置的Cookie。'."\n"
."\n"
.'长度为1~200个字符,只能包含ASCII英文字母和数字字符,不能包含逗号(,)、半角分号(;)或空格,也不能以美元符号($)开头。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**server**时,该参数必选且有效。',
'type' => 'string',
'example' => '23',
],
'HealthCheckInterval' => [
'description' => '健康检查的时间间隔。单位:秒。'."\n"
."\n"
.'取值范围:**1~50**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'Url' => [
'description' => '转发规则绑定的请求路径。',
'type' => 'string',
'example' => '/cache',
],
'HealthCheckURI' => [
'description' => '用于健康检查的URI。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'string',
'example' => '/example',
],
'StickySessionType' => [
'description' => 'Cookie的处理方式。取值:'."\n"
."\n"
.'* **insert**:植入Cookie。客户端第一次访问时,负载均衡会在返回请求中植入Cookie(即在HTTP或HTTPS响应报文中插入SERVERID),下次客户端携带此Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器上。'."\n"
."\n"
.'* **server**:重写Cookie。 负载均衡发现用户自定义了Cookie,将会对原来的Cookie进行重写,下次客户端携带新的Cookie访问,负载均衡服务会将请求定向转发给之前记录到的后端服务器。'."\n"
."\n"
.'> 当**StickySession**的值为**on**时,该参数有效。',
'type' => 'string',
'example' => 'insert',
],
'RuleName' => [
'description' => '转发规则名称,长度为1~80个字符,只能使用字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)这些字符。'."\n"
."\n"
.'> 同一个监听内不同规则的名称必须唯一。',
'type' => 'string',
'example' => 'Rule2',
],
'RuleId' => [
'description' => '转发规则ID。',
'type' => 'string',
'example' => 'rule-tybqi6****',
],
'HealthCheckConnectPort' => [
'description' => '健康检查的后端服务器的端口。'."\n"
."\n"
.'取值范围:**1~65535**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。若为空且**HealthCheck**为**on**表明默认使用监听后端端口配置。',
'type' => 'integer',
'format' => 'int32',
'example' => '45',
],
'Scheduler' => [
'description' => '调度算法。取值:'."\n"
."\n"
.'* **wrr**(默认值):权重值越高的后端服务器,被轮询到的次数(概率)也越高。'."\n"
."\n"
.'* **rr**:按照访问顺序依次将外部请求依序分发到后端服务器。'."\n"
."\n"
.'> **ListenerSync**为**off**时有效,为**on**时表明与监听配置一致。',
'type' => 'string',
'example' => 'wrr',
],
'HealthCheckTimeout' => [
'description' => '接收来自运行状况检查的响应需要等待的时间。如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。'."\n"
."\n"
.'取值范围:**1~300**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '34',
],
'ListenerSync' => [
'description' => '转发规则是否从监听上继承健康检查、会话保持和调度算法配置。取值:'."\n"
."\n\n"
.'* **off**:不继承监听配置,转发规则自定义健康检查及会话保持配置。'."\n"
."\n"
.'* **on**:继承监听配置。',
'type' => 'string',
'example' => 'off',
],
'HealthyThreshold' => [
'description' => '健康检查连续成功多少次后,将后端服务器的健康检查状态由**失败**判定为**成功**。'."\n"
."\n"
.'取值范围:**2~10**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'CookieTimeout' => [
'description' => 'Cookie超时时间。单位:秒。取值范围:**1~86400**。'."\n"
."\n"
.'> 当**StickySession**为**on**且**StickySessionType**为**insert**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '56',
],
'HealthCheckDomain' => [
'description' => '用于健康检查的域名,取值:'."\n"
."\n"
.'* **$_ip**: 后端服务器的私网IP。'."\n"
."\n"
.' 当指定了IP或该参数未指定时,负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。'."\n"
."\n"
.'* **domain**:域名长度为1~80字符,只能包含字母、数字、半角句号(.)和短划线(-)。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'string',
'example' => 'www.example.com',
],
'UnhealthyThreshold' => [
'description' => '健康检查连续失败多少次后,将后端服务器的健康检查状态由**success**判定为**fail**。'."\n"
."\n"
.'取值范围:**2~10**。'."\n"
."\n"
.'> **HealthCheck**为**on**时,该参数有效。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'StickySession' => [
'description' => '是否开启会话保持。取值:'."\n"
."\n"
.'* **on**:开启。'."\n"
."\n"
.'* **off**:不开启。'."\n"
."\n"
.'> 在**ListenerSync**为**off**时有效,为**on**时表明与监听配置一致。',
'type' => 'string',
'example' => 'off',
],
'HealthCheck' => [
'description' => '是否开启健康检查。取值:'."\n"
."\n"
.'* **on**:开启。'."\n"
."\n"
.'* **off**:不开启。'."\n"
."\n"
.'> **ListenerSync**为**off**时有效,为**on**时表明与监听配置一致。',
'type' => 'string',
'example' => 'off',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\",\\n \\"Rules\\": {\\n \\"Rule\\": [\\n {\\n \\"HealthCheckHttpCode\\": \\"http_3xx\\",\\n \\"VServerGroupId\\": \\"rsp-6cejjzl****\\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"Cookie\\": \\"23\\",\\n \\"HealthCheckInterval\\": 5,\\n \\"Url\\": \\"/cache\\",\\n \\"HealthCheckURI\\": \\"/example\\",\\n \\"StickySessionType\\": \\"insert\\",\\n \\"RuleName\\": \\"Rule2\\",\\n \\"RuleId\\": \\"rule-tybqi6****\\",\\n \\"HealthCheckConnectPort\\": 45,\\n \\"Scheduler\\": \\"wrr\\",\\n \\"HealthCheckTimeout\\": 34,\\n \\"ListenerSync\\": \\"off\\",\\n \\"HealthyThreshold\\": 5,\\n \\"CookieTimeout\\": 56,\\n \\"HealthCheckDomain\\": \\"www.example.com\\",\\n \\"UnhealthyThreshold\\": 2,\\n \\"StickySession\\": \\"off\\",\\n \\"HealthCheck\\": \\"off\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n \\n http_3xx\\n rsp-6cejjzl****\\n www.example.com\\n 23\\n 5\\n /cache\\n /example\\n insert\\n Rule2\\n rule-tybqi6****\\n 45\\n wrr\\n 34\\n off\\n 5\\n 56\\n www.example.com\\n 2\\n off\\n off\\n \\n","errorExample":""}]',
'title' => '查询指定监听已配置的转发规则',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddBackendServers' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例所属地域的ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)获取地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-beijing',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-2ze7o5h52g02kkzz******',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '要添加的后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.' '."\n"
.' 如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ECS、ENI或者ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。'."\n"
."\n\n"
."\n\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'LoadBalancerId' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-2ze7o5h52g02kkzz****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '34B82C81-F13B-4EEB-99F6-A048C67CC830',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型。取值:'."\n"
."\n"
.'- **ecs**:ECS实例(默认)。'."\n"
.'- **eni**:弹性网卡实例。'."\n"
.'- **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重。'."\n"
."\n"
.'取值:**0~100**。默认值:**100**。'."\n"
."\n"
.'如果值为**0**,则不会将请求转发给该后端服务器。',
'type' => 'string',
'example' => '100',
],
'Description' => [
'description' => '后端服务器描述。',
'type' => 'string',
'example' => '后端服务器',
],
'ServerId' => [
'description' => 'ECS、ENI、或者ECI实例ID。',
'type' => 'string',
'example' => 'i-2zej4lxhjoq1icu*****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified load balancer does not support the network type of the ECS instance.',
],
[
'errorCode' => 'Mismatched.ZoneId',
'errorMessage' => 'The zone of the server is not matched with the cloud box loadbalancer.',
],
[
'errorCode' => 'BackendServerProcessing',
'errorMessage' => 'Backend Server is adding, please try again later.',
],
[
'errorCode' => 'InvalidBackendServers.ServerIpConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationUnsupported.AddBackendServers',
'errorMessage' => 'This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.',
],
[
'errorCode' => 'IncorrectStatus.RSByPassToas',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationFailed.ActionNotSupport',
'errorMessage' => 'The loadbalancer does not support such action.',
],
[
'errorCode' => 'NetworkConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"LoadBalancerId\\": \\"lb-2ze7o5h52g02kkzz****\\",\\n \\"RequestId\\": \\"34B82C81-F13B-4EEB-99F6-A048C67CC830\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": \\"100\\",\\n \\"Description\\": \\"后端服务器\\",\\n \\"ServerId\\": \\"i-2zej4lxhjoq1icu*****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n lb-2ze7o5h52g02kkzz****\\n 34B82C81-F13B-4EEB-99F6-A048C67CC830\\n \\n ecs\\n 100\\n 后端服务器\\n i-2zej4lxhjoq1icu*****\\n \\n","errorExample":""}]',
'title' => '添加后端服务器',
'summary' => '添加后端服务器。',
'description' => '> 如果一次请求中添加多个相同的ECS实例,只会取第一个,其他相同实例会被忽略。新增后端服务器不能与同监听下已有服务器重复,否则会报错。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeHealthStatus' => [
'summary' => '查询后端服务器的健康状态。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => [
'FEATUREslb1HTJST',
'FEATUREslbZCBC3S',
'FEATUREslbMJJFN5',
'FEATUREslb2W3JY0',
'FEATUREslbQ7A0BW',
],
],
'parameters' => [
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例 ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1qjwo61pqz3ah****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。'."\n"
.'取值:**1~65535**'."\n"
."\n"
.'> 不设置该参数表示获取所有端口的健康检查状态。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '65535',
'minimum' => '0',
'example' => '80',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。',
'type' => 'string',
'required' => false,
'example' => 'http',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域 ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF******',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Protocol' => [
'description' => '负载均衡实例前端使用的协议。',
'type' => 'string',
'example' => 'http',
],
'ServerHealthStatus' => [
'description' => '后端服务器的健康状况。'."\n"
."\n"
.'- normal:后端服务器健康。'."\n"
.'- abnormal:后端服务器不健康。'."\n"
.'- unavailable:未完成健康检查。',
'type' => 'string',
'example' => 'abnormal',
],
'ListenerPort' => [
'description' => '负载均衡实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'ServerIp' => [
'description' => '后端服务器IP地址。',
'type' => 'string',
'example' => '192.XX.XX.11',
],
'Port' => [
'description' => '负载均衡实例后端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'ServerId' => [
'description' => '后端服务器实例ID。',
'type' => 'string',
'example' => 'i-bp1h5u3fv54ytf***',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF******\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Protocol\\": \\"http\\",\\n \\"ServerHealthStatus\\": \\"abnormal\\",\\n \\"ListenerPort\\": 80,\\n \\"ServerIp\\": \\"192.XX.XX.11\\",\\n \\"Port\\": 80,\\n \\"ServerId\\": \\"i-bp1h5u3fv54ytf***\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询后端服务器的健康状态',
],
'RemoveBackendServers' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp15lbk8uja8rvm4a****',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '要移除的后端服务器。'."\n"
."\n"
.'- **ServerId**:后端服务器ID,必填,String类型。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
.' - **ecs**(默认值): 云服务器ECS实例。'."\n"
."\n"
.' - **eni**:弹性网卡ENI实例。'."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值范围:**0**~**100**,Integer类型。'."\n"
."\n"
.'一次调用最多可以移除20个后端服务器。示例说明如下:'."\n"
."\n"
.'- 移除ECS:'."\n"
."\n"
.' `[{"ServerId":"i-bp1fq61enf4loa5i****", "Type": "ecs","Weight":"100"}]`'."\n"
."\n"
.'- 移除ENI:'."\n"
.' '."\n"
.' `[{"ServerId":"eni-2ze1sdp5****","Type": "eni","Weight":"100"}]`'."\n"
."\n"
.'- 移除ECI:'."\n"
.' '."\n"
.' `[{"ServerId":"eci-2ze1sdp5****","Type": "eci","Weight":"100"}]`',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{"ServerId":"i-bp1fq61enf4loa5i****", "Type": "ecs","Weight":"100"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'LoadBalancerId' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp15lbk8uja8rvm4a****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34******',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。 ',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。 ',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**:ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重,范围为**0~100**。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '后端服务器组描述。',
'type' => 'string',
'example' => 'BackendServer1',
],
'ServerId' => [
'description' => '后端服务器的实例ID。',
'type' => 'string',
'example' => 'i-bp1fq61enf4loa5i****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"LoadBalancerId\\": \\"lb-bp15lbk8uja8rvm4a****\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34******\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"BackendServer1\\",\\n \\"ServerId\\": \\"i-bp1fq61enf4loa5i****\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '移除后端服务器',
'summary' => '移除后端服务器。',
'description' => '> 如果要移除的后端服务器不在指定的负载均衡实例的服务器列表中,调用时会直接忽略,不会报错。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetBackendServers' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1qjwo61pqz3a******',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '要添加的后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => false,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'LoadBalancerId' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1qjwo61pqz3a******',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7F******',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => ' 后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'eni',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'string',
'example' => '100',
],
'Description' => [
'description' => '后端服务器描述。',
'type' => 'string',
'example' => '后端服务器',
],
'ServerId' => [
'description' => '后端服务器ID。',
'type' => 'string',
'example' => 'eni-hhshhs****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Mismatched.ZoneId',
'errorMessage' => 'The zone of the server is not matched with the cloud box loadbalancer.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"LoadBalancerId\\": \\"lb-bp1qjwo61pqz3a******\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7F******\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"eni\\",\\n \\"Weight\\": \\"100\\",\\n \\"Description\\": \\"后端服务器\\",\\n \\"ServerId\\": \\"eni-hhshhs****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n lb-bp1qjwo61pqz3a******\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n \\n eni\\n 100\\n 后端服务器\\n eni-hhshhs****\\n \\n","errorExample":""}]',
'title' => '设置后端服务器权重',
'summary' => '设置后端服务器权重。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateVServerGroup' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88537',
'abilityTreeNodes' => [
'FEATUREslb1HTJST',
],
],
'parameters' => [
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1qjwo61pqz3ahl******',
],
],
[
'name' => 'VServerGroupName',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组名称。'."\n"
."\n"
.'长度限制为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、英文句点(.)和下划线(_)。',
'type' => 'string',
'required' => false,
'example' => 'Group1',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '要添加的后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => false,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '后端服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6******',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => ' 后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'eni',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '后端服务器组描述。',
'type' => 'string',
'example' => '后端服务器组',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '70',
],
'ServerId' => [
'description' => 'ECS实例ID或ENI实例ID。',
'type' => 'string',
'example' => 'eni-hhshhs****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'LBNotSupportIpv6Backend',
'errorMessage' => 'The specified loadbalancer does not support ipv6 backend.',
],
[
'errorCode' => 'Mismatched.ZoneId',
'errorMessage' => 'The zone of the server is not matched with the cloud box loadbalancer.',
],
[
'errorCode' => 'InvalidBackendServers.ServerIpConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationUnsupported.CreateVServerGroup',
'errorMessage' => 'This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.',
],
[
'errorCode' => 'IncorrectStatus.RSByPassToas',
'errorMessage' => '%s.',
],
[
'errorCode' => 'BackendServer.InvalidType',
'errorMessage' => 'The specified Type is invalid.',
],
[
'errorCode' => 'BackendServer.ServerRegionIdNotEqual',
'errorMessage' => 'The specified ServerRegionId must be equal.',
],
[
'errorCode' => 'OperationFailed.InvalidCen',
'errorMessage' => 'The cen related with this loadbalancer is invalid.',
],
[
'errorCode' => 'IncorrectStatus.CenNotAssociated',
'errorMessage' => 'The action is invalid because the loadbalancer is not associated with cen.',
],
[
'errorCode' => 'InvalidBackendServers.MissingCenBandWidth',
'errorMessage' => 'The bandwidth is missing between loadbalancer and backendServers in cen.',
],
[
'errorCode' => 'InvalidBackendServers.VpcNotInCen',
'errorMessage' => 'The BackendServers is not in the cen associated with the loadbalancer.',
],
[
'errorCode' => 'InvalidServerId.NotExist',
'errorMessage' => 'The specified ServerId is not exist.',
],
[
'errorCode' => 'MissingParameter.ServerRegionId',
'errorMessage' => 'The parameter ServerRegionId is required.',
],
[
'errorCode' => 'MissingParameter.VbrId',
'errorMessage' => 'The parameter VbrId is required.',
],
[
'errorCode' => 'InvalidParameter.ServerRegionId',
'errorMessage' => 'The parameter ServerRegionId is invalid for crossborder.',
],
[
'errorCode' => 'InvalidVbrId.NotInCen',
'errorMessage' => 'The VbrId is not in the cen associated with the loadbalancer.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'NetworkConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'VpcSystemBusy',
'errorMessage' => 'Invoke vpc system busy, please retry later.',
],
[
'errorCode' => 'OperationFailed.Endpoint',
'errorMessage' => 'The operation failed because of the RegionId is unavailable in this endpoint.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6******\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"eni\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"后端服务器组\\",\\n \\"Port\\": 70,\\n \\"ServerId\\": \\"eni-hhshhs****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n rsp-cige6******\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n \\n Type\\n 100\\n 后端服务器组\\n 70\\n vm-2****\\n \\n","errorExample":""}]',
'title' => '创建虚拟服务器组并添加后端服务器',
'summary' => '创建虚拟服务器组并向指定的服务器组中添加后端服务器。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteVServerGroup' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。'."\n"
."\n"
.'> 如果已有监听绑定了该虚拟服务器组,将无法删除。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6j*****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'RspoolVipExist',
'errorMessage' => 'there are vips associating with this vServer group.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B******\\"\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n\\t9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n","errorExample":""}]',
'title' => '删除虚拟服务器组',
'summary' => '删除虚拟服务器组。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetVServerGroupAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡地域ID,不可更改。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID,不可更改。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6****',
],
],
[
'name' => 'VServerGroupName',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组名称,可自定义更改。',
'type' => 'string',
'required' => false,
'example' => 'Group1',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '后端服务器列表,该接口只能用于修改后端服务器的权重和虚拟服务器组名称。'."\n"
.'包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => false,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.XX.XX.6", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.XX.XX.6", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6****',
],
'VServerGroupName' => [
'description' => ' 虚拟服务器组名称。',
'type' => 'string',
'example' => 'Group1',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => ' 后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '后端服务器组描述。',
'type' => 'string',
'example' => '后端服务器组描述。',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '70',
],
'ServerId' => [
'description' => '后端服务器实例ID。',
'type' => 'string',
'example' => 'i-bp1ek6yd7jvkx****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'MissingParameter',
'errorMessage' => 'The VServerGroupName or BackendServers is required at lease one.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6****\\",\\n \\"VServerGroupName\\": \\"Group1\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"后端服务器组描述。\\",\\n \\"Port\\": 70,\\n \\"ServerId\\": \\"i-bp1ek6yd7jvkx****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\nrsp-cige6****\\n9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\nGroup1\\n\\n \\n ecs\\n 后端服务器组描述。\\n i-bp1ek6yd7jvkx****\\n 70\\n 100\\n \\n\\n","errorExample":""}]',
'title' => '修改虚拟服务器组的配置',
'summary' => '修改虚拟服务器组的配置。',
'description' => '该接口只能用于修改后端服务器的权重和虚拟服务器组名称:'."\n"
."\n"
.'- 如果您需要修改后端服务器,请参见接口[ModifyVServerGroupBackendServers](~~35220~~)。'."\n"
."\n"
.'- 如果您需要添加后端服务器,请参见接口[AddVServerGroupBackendServers](~~35218~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeVServerGroups' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口获取地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1o94dp5i6ea*******',
],
],
[
'name' => 'IncludeRule',
'in' => 'query',
'schema' => [
'description' => '是否返回关联的转发规则信息。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**(默认值):否。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'IncludeListener',
'in' => 'query',
'schema' => [
'description' => '是否返回关联的监听信息。取值:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**(默认值):否。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '资源标签。',
'type' => 'array',
'items' => [
'description' => '资源标签。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'Description',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '虚拟服务器组名称。',
'type' => 'string',
'required' => false,
'example' => 'Group3',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08******',
],
'VServerGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'VServerGroup' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '服务器组ID。',
'type' => 'string',
'example' => 'rsp-0bf******',
],
'VServerGroupName' => [
'description' => '服务器组名称。',
'type' => 'string',
'example' => 'Group3',
],
'AssociatedObjects' => [
'description' => '关联信息。',
'type' => 'object',
'properties' => [
'Listeners' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Listener' => [
'description' => '监听列表。',
'type' => 'array',
'items' => [
'description' => '监听列表。',
'type' => 'object',
'properties' => [
'Port' => [
'description' => '监听端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'Protocol' => [
'description' => '监听协议。取值:**tcp**、**udp**、**http**或**https**。',
'type' => 'string',
'example' => 'tcp',
],
],
],
],
],
],
'Rules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Rule' => [
'description' => '转发规则列表。',
'type' => 'array',
'items' => [
'description' => '转发规则列表。',
'type' => 'object',
'properties' => [
'Url' => [
'description' => '访问路径。',
'type' => 'string',
'example' => '/example',
],
'Domain' => [
'description' => '请求域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'RuleName' => [
'description' => '转发规则名称。',
'type' => 'string',
'example' => 'test',
],
'RuleId' => [
'description' => '转发规则ID。',
'type' => 'string',
'example' => 'rule-a3x3pg1******',
],
],
],
],
],
],
],
],
'ServerCount' => [
'description' => '服务器个数。'."\n"
."\n"
.'该参数对应的功能默认不开放,如需使用请联系销售或提交工单。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
'CreateTime' => [
'description' => '传统型负载均衡实例的创建时间,格式:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2022-08-31T02:49:05Z',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '资源的标签键。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '资源的标签值。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param of TagKey is missing.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08******\\",\\n \\"VServerGroups\\": {\\n \\"VServerGroup\\": [\\n {\\n \\"VServerGroupId\\": \\"rsp-0bf******\\",\\n \\"VServerGroupName\\": \\"Group3\\",\\n \\"AssociatedObjects\\": {\\n \\"Listeners\\": {\\n \\"Listener\\": [\\n {\\n \\"Port\\": 80,\\n \\"Protocol\\": \\"tcp\\"\\n }\\n ]\\n },\\n \\"Rules\\": {\\n \\"Rule\\": [\\n {\\n \\"Url\\": \\"/example\\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"RuleName\\": \\"test\\",\\n \\"RuleId\\": \\"rule-a3x3pg1******\\"\\n }\\n ]\\n }\\n },\\n \\"ServerCount\\": 1,\\n \\"CreateTime\\": \\"2022-08-31T02:49:05Z\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n \\n rsp-0bfucwuotx\\n Group3\\n \\n \\n 80\\n tcp\\n \\n \\n /example\\n www.example.com\\n test\\n rule-a3x3pg1yohq3lq****\\n \\n \\n 1\\n 2022-08-31T02:49:05Z\\n \\n TestKey\\n TestValue\\n \\n \\n","errorExample":""}]',
'title' => '查询虚拟服务器组列表',
'summary' => '查询虚拟服务器组列表。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeVServerGroupAttribute' => [
'summary' => '查询虚拟服务器组的详细信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '88613',
'abilityTreeNodes' => [
'FEATUREslb1HTJST',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6****',
],
'VServerGroupName' => [
'description' => '虚拟服务器组的名称。',
'type' => 'string',
'example' => 'Group1',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B******',
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-jfakd****',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'- **ecs**:ECS实例(默认)。'."\n"
.'- **eni**:弹性网卡实例。'."\n"
.'- **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '服务器组描述。'."\n"
."\n"
.'> 若用户未设置Description,则该参数不返回。',
'type' => 'string',
'example' => '服务器组描述。',
],
'ServerIp' => [
'description' => '后端服务器实例IP。',
'type' => 'string',
'example' => '192.XX.XX.11',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '90',
],
'ServerId' => [
'description' => '后端服务器实例ID。',
'type' => 'string',
'example' => 'vm-233',
],
],
],
],
],
],
'CreateTime' => [
'description' => '传统型负载均衡实例的创建时间,格式:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2022-08-31T02:49:05Z',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '服务器上配置的标签。',
'type' => 'array',
'items' => [
'description' => '服务器上配置的标签。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '实例的标签键。N的取值范围:**1**~**20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '实例的标签值。N的取值范围:**1**~**20**。一旦输入该值,可以为空字符串。'."\n"
."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6****\\",\\n \\"VServerGroupName\\": \\"Group1\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B******\\",\\n \\"LoadBalancerId\\": \\"lb-jfakd****\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"服务器组描述。\\",\\n \\"ServerIp\\": \\"192.XX.XX.11\\",\\n \\"Port\\": 90,\\n \\"ServerId\\": \\"vm-233\\"\\n }\\n ]\\n },\\n \\"CreateTime\\": \\"2022-08-31T02:49:05Z\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n rsp-cige6****\\n Group1\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n lb-jfakd****\\n \\n ecs\\n 100\\n 服务器组描述。\\n 192.XX.XX.11\\n 90\\n vm-233\\n \\n 2022-08-31T02:49:05Z\\n","errorExample":""}]',
'title' => '查询虚拟服务器组的详细信息',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddVServerGroupBackendServers' => [
'summary' => '向指定的虚拟服务器组中添加后端服务器。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6******',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '要添加的后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j******',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B******',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'eni',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '后端服务器组描述。',
'type' => 'string',
'example' => '后端服务器组',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '70',
],
'ServerId' => [
'description' => 'ECS实例ID或者ENI的实例ID。',
'type' => 'string',
'example' => 'eni-hhshhs****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidBackendServers.ServerIpConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'Mismatched.ZoneId',
'errorMessage' => 'The zone of the server is not matched with the cloud box loadbalancer.',
],
[
'errorCode' => 'OperationUnsupported.AddVServerGroupBackendServers',
'errorMessage' => 'This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.',
],
[
'errorCode' => 'IncorrectStatus.RSByPassToas',
'errorMessage' => '%s.',
],
[
'errorCode' => 'BackendServer.InvalidType',
'errorMessage' => 'The specified Type is invalid.',
],
[
'errorCode' => 'BackendServer.ServerRegionIdNotEqual',
'errorMessage' => 'The specified ServerRegionId must be equal.',
],
[
'errorCode' => 'OperationFailed.InvalidCen',
'errorMessage' => 'The cen related with this loadbalancer is invalid.',
],
[
'errorCode' => 'IncorrectStatus.CenNotAssociated',
'errorMessage' => 'The action is invalid because the loadbalancer is not associated with cen.',
],
[
'errorCode' => 'InvalidBackendServers.MissingCenBandWidth',
'errorMessage' => 'The bandwidth is missing between loadbalancer and backendServers in cen.',
],
[
'errorCode' => 'InvalidBackendServers.VpcNotInCen',
'errorMessage' => 'The BackendServers is not in the cen associated with the loadbalancer.',
],
[
'errorCode' => 'InvalidServerId.NotExist',
'errorMessage' => 'The specified ServerId is not exist.',
],
[
'errorCode' => 'MissingParameter.ServerRegionId',
'errorMessage' => 'The parameter ServerRegionId is required.',
],
[
'errorCode' => 'MissingParameter.VbrId',
'errorMessage' => 'The parameter VbrId is required.',
],
[
'errorCode' => 'InvalidParameter.ServerRegionId',
'errorMessage' => 'The parameter ServerRegionId is invalid for crossborder.',
],
[
'errorCode' => 'InvalidVbrId.NotInCen',
'errorMessage' => 'The VbrId is not in the cen associated with the loadbalancer.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'MasterSlaveServerConflict',
'errorMessage' => 'The servers are conflict for MasterSlaveGroup.',
],
[
'errorCode' => 'OperationFailed.ServiceGroupProcessing',
'errorMessage' => 'The specified service group is processing.',
],
[
'errorCode' => 'NetworkConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
[
'errorCode' => 'SignatureNonceUsed',
'errorMessage' => 'Specified signature nonce was used already.',
],
[
'errorCode' => 'VpcSystemBusy',
'errorMessage' => 'Invoke vpc system busy, please retry later.',
],
[
'errorCode' => 'OperationDeny.LbNotSupportIPv6Server',
'errorMessage' => 'The specified loadbalancer does not support ipv6 server.',
],
[
'errorCode' => 'OperationBusy',
'errorMessage' => 'The operation is busy.',
],
],
404 => [
[
'errorCode' => 'ResourceNotFound.vServers',
'errorMessage' => 'The specified enis %s does not exist.',
],
[
'errorCode' => 'ResourceNotFound.Cen',
'errorMessage' => 'The specified resource Cen %s not Exists.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6j******\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B******\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"eni\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"后端服务器组\\",\\n \\"Port\\": 70,\\n \\"ServerId\\": \\"eni-hhshhs****\\"\\n }\\n ]\\n }\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n rsp-cige6*****\\n \\n \\n vm-233\\n 80\\n 100\\n \\n \\n vm-232\\n 90\\n 100\\n \\n \\n vm-231\\n 70\\n 100\\n \\n \\n","errorExample":""}]',
'title' => '向指定的虚拟服务器组中添加后端服务器',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyVServerGroupBackendServers' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '服务器组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6j****',
],
],
[
'name' => 'OldBackendServers',
'in' => 'query',
'schema' => [
'description' => '要被替换的后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => false,
'example' => '[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]',
],
],
[
'name' => 'NewBackendServers',
'in' => 'query',
'schema' => [
'description' => '新的后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => false,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08******',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '后端服务器描述。',
'type' => 'string',
'example' => '后端服务器描述。',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '70',
],
'ServerId' => [
'description' => 'ECS实例ID或ENI的实例ID。',
'type' => 'string',
'example' => 'i-bp1ge5hrp****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified BackendServers contain duplicated value of ServerID and Port.',
],
[
'errorCode' => 'Mismatched.ZoneId',
'errorMessage' => 'The zone of the server is not matched with the cloud box loadbalancer.',
],
[
'errorCode' => 'InvalidBackendServers.ServerIpConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationUnsupported.ModifyVServerGroupBackendServers',
'errorMessage' => 'This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.',
],
[
'errorCode' => 'IncorrectStatus.RSByPassToas',
'errorMessage' => '%s.',
],
[
'errorCode' => 'BackendServer.InvalidType',
'errorMessage' => 'The specified Type is invalid.',
],
[
'errorCode' => 'BackendServer.ServerRegionIdNotEqual',
'errorMessage' => 'The specified ServerRegionId must be equal.',
],
[
'errorCode' => 'OperationFailed.InvalidCen',
'errorMessage' => 'The cen related with this loadbalancer is invalid.',
],
[
'errorCode' => 'IncorrectStatus.CenNotAssociated',
'errorMessage' => 'The action is invalid because the loadbalancer is not associated with cen.',
],
[
'errorCode' => 'InvalidBackendServers.MissingCenBandWidth',
'errorMessage' => 'The bandwidth is missing between loadbalancer and backendServers in cen.',
],
[
'errorCode' => 'InvalidBackendServers.VpcNotInCen',
'errorMessage' => 'The BackendServers is not in the cen associated with the loadbalancer.',
],
[
'errorCode' => 'InvalidServerId.NotExist',
'errorMessage' => 'The specified ServerId is not exist.',
],
[
'errorCode' => 'MissingParameter.ServerRegionId',
'errorMessage' => 'The parameter ServerRegionId is required.',
],
[
'errorCode' => 'MissingParameter.VbrId',
'errorMessage' => 'The parameter VbrId is required.',
],
[
'errorCode' => 'InvalidParameter.ServerRegionId',
'errorMessage' => 'The parameter ServerRegionId is invalid for crossborder.',
],
[
'errorCode' => 'InvalidVbrId.NotInCen',
'errorMessage' => 'The VbrId is not in the cen associated with the loadbalancer.',
],
[
'errorCode' => 'InvalidParameter.ZoneNotSupport',
'errorMessage' => 'The zone does not support the parameter %s.',
],
[
'errorCode' => 'MasterSlaveServerConflict',
'errorMessage' => 'The servers are conflict for MasterSlaveGroup.',
],
[
'errorCode' => 'NetworkConflict',
'errorMessage' => '%s.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6j****\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08******\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"后端服务器描述。\\",\\n \\"Port\\": 70,\\n \\"ServerId\\": \\"i-bp1ge5hrp****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\nrsp-cige6j****\\n9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n\\n \\n ecs\\n 后端服务器描述。\\n i-bp1ge5hrp****\\n 70\\n 100\\n \\n\\n","errorExample":""}]',
'title' => '替换虚拟服务器组中的后端服务器',
'summary' => '替换虚拟服务器组中的后端服务器。',
'description' => '该接口只用于替换虚拟服务器组中的后端服务器,如果您需要修改后端服务器的权重等配置,请参见[SetVServerGroupAttribute](~~2401723~~)。',
],
'RemoveVServerGroupBackendServers' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'VServerGroupId',
'in' => 'query',
'schema' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6****',
],
],
[
'name' => 'BackendServers',
'in' => 'query',
'schema' => [
'description' => '后端服务器列表,包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'示例说明如下:'."\n"
."\n"
.'* 挂载ECS示例:'."\n"
.' '."\n"
.' `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" }]`'."\n"
."\n"
.'* 挂载ENI多IP:'."\n"
."\n"
.' `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]`'."\n"
."\n"
.'* 挂载ECI:'."\n"
."\n"
.' `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-114" }]`'."\n"
."\n"
.'> 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'VServerGroupId' => [
'description' => '虚拟服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6j****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B0******',
],
'BackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BackendServer' => [
'description' => '后端服务器列表。',
'type' => 'array',
'items' => [
'description' => '后端服务器列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'eni',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'ServerId' => [
'description' => '后端服务器实例ID。',
'type' => 'string',
'example' => 'eni-hhshhs****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'LbStatusNotSupport',
'errorMessage' => 'The status of specified loadbalancer does not support..',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"VServerGroupId\\": \\"rsp-cige6j****\\",\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B0******\\",\\n \\"BackendServers\\": {\\n \\"BackendServer\\": [\\n {\\n \\"Type\\": \\"eni\\",\\n \\"Weight\\": 100,\\n \\"Port\\": 80,\\n \\"ServerId\\": \\"eni-hhshhs****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\nrsp-cige6j****\\n9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n\\n \\n ecs\\n vm-230\\n 80\\n 100\\n \\n\\n","errorExample":""}]',
'title' => '从指定的虚拟服务器组中移除后端服务器',
'summary' => '从指定的虚拟服务器组中移除后端服务器。',
'description' => '> 如果**BackendServers**中参数的某些后端服务器不存在于这个虚拟服务器组中,会直接忽略,不会报错。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMasterSlaveServerGroup' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1hv944r69al4j******',
],
],
[
'name' => 'MasterSlaveServerGroupName',
'in' => 'query',
'schema' => [
'description' => '主备服务器组名称。',
'type' => 'string',
'required' => false,
'example' => 'Group1',
],
],
[
'name' => 'MasterSlaveBackendServers',
'in' => 'query',
'schema' => [
'description' => '主备服务器组列表。一个主备服务器组只能包含2个后端服务器。'."\n"
."\n"
.'包含以下参数:'."\n"
."\n"
.'- **ServerId**:String类型,必选,后端服务器的实例ID,分为ECS实例ID、ENI实例ID和ECI实例ID,当**ServerId**参数值为ENI实例ID或ECI实例ID时,**Type**参数值必选。'."\n"
."\n"
.'- **Weight**:后端服务器的权重,取值:**0**~**100**。默认值:**100**。'."\n"
.'如果值为0,则不会将请求转发给该后端服务器。'."\n"
."\n"
.'- **Description**:String类型,非必选,后端服务器描述,长度为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)。'."\n"
."\n"
.'- **Type**:后端服务器类型,取值:'."\n"
."\n"
.' - **ecs**:ECS实例(默认)。'."\n"
.' '."\n"
.' - **eni**:弹性网卡实例。'."\n"
."\n"
.' - **eci**:弹性容器实例。'."\n"
."\n"
.'> 只有性能保障型实例支持添加eni和eci类型的后端服务器。'."\n"
."\n"
.'* **ServerIp**:ENI或ECI的实例IP。'."\n"
."\n"
.'* **Port**:用来接收请求的后端端口。'."\n"
."\n"
.'* **ServerType**:String类型,表示后端服务器的主备类型,取值:'."\n"
.' * **Master**:主服务器。'."\n"
.' * **Slave**:备服务器。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => '[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"82","ServerType":"Master","Description":"test-112" }, { "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"84","ServerType":"Slave","Description":"test-112" }]',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源标签键。N的取值范围:**1**~**20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'MasterSlaveServerGroupId' => [
'description' => '主备服务器组ID。',
'type' => 'string',
'example' => 'rsp-bp19au4******',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '7CA4DB76-4D32-523B-822E-5C9******',
],
'MasterSlaveBackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MasterSlaveBackendServer' => [
'description' => '主备服务器组列表。',
'type' => 'array',
'items' => [
'description' => '主备服务器组列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**:ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'ecs',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '主备服务器组描述。',
'type' => 'string',
'example' => 'test-112',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '82',
],
'ServerId' => [
'description' => '要添加的后端服务器实例ID。',
'type' => 'string',
'example' => 'i-bp1fq61enf4loa5i****',
],
'ServerType' => [
'description' => '服务器类型。'."\n"
."\n"
.'取值:**Master**或**Slave**。',
'type' => 'string',
'example' => 'Master',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'BACKEND_SERVERS_NUM_MUST_BE_TWO',
'errorMessage' => 'Backend servers num must be 2.',
],
[
'errorCode' => 'Mismatched.ZoneId',
'errorMessage' => 'The zone of the server is not matched with the cloud box loadbalancer.',
],
[
'errorCode' => 'BACKEND_SERVERS_HAVE_SAME_PORT_AND_SERVERID',
'errorMessage' => 'Backend servers have same port and serverId.',
],
[
'errorCode' => 'BACKEND_SERVERS_CAN_ONLY_CONTAIN_ONE_MASTER_AND_ONE_SLAVE',
'errorMessage' => 'Backend servers can only contain one master and one slave.',
],
[
'errorCode' => 'BACKEND_SERVER_ID_CAN_NOT_EMPTY',
'errorMessage' => 'Backend server id can not empty.',
],
[
'errorCode' => 'INVALID_SERVER_TYPE',
'errorMessage' => 'Invalid server type.',
],
[
'errorCode' => 'BACKEND_SERVER_PORT_CAN_NOT_EMPTY',
'errorMessage' => 'Backend server port can not empty.',
],
[
'errorCode' => 'RealServerPortNotSupport',
'errorMessage' => 'Real server port not support.',
],
[
'errorCode' => 'OperationUnsupported.CreateMasterSlaveServerGroup',
'errorMessage' => 'This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.',
],
[
'errorCode' => 'IncorrectStatus.RSByPassToas',
'errorMessage' => '%s.',
],
[
'errorCode' => 'OperationFailed.ActionNotSupport',
'errorMessage' => 'The loadbalancer does not support such action.',
],
[
'errorCode' => 'RsTunnelIp2VmNameConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'NetworkConflict',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"MasterSlaveServerGroupId\\": \\"rsp-bp19au4******\\",\\n \\"RequestId\\": \\"7CA4DB76-4D32-523B-822E-5C9******\\",\\n \\"MasterSlaveBackendServers\\": {\\n \\"MasterSlaveBackendServer\\": [\\n {\\n \\"Type\\": \\"ecs\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"test-112\\",\\n \\"Port\\": 82,\\n \\"ServerId\\": \\"i-bp1fq61enf4loa5i****\\",\\n \\"ServerType\\": \\"Master\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n rsp-bp19au4******\\n 7CA4DB76-4D32-523B-822E-5C9494613D46\\n \\n ecs\\n 100\\n test-112\\n 82\\n i-bp1fq61enf4loa5i****\\n Master\\n \\n","errorExample":""}]',
'title' => '创建主备服务器组',
'summary' => '创建主备服务器组。一个主备服务器组只能包含两个后端服务器,一个为主服务器,另一个为备服务器。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteMasterSlaveServerGroup' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'MasterSlaveServerGroupId',
'in' => 'query',
'schema' => [
'description' => '主备服务器组ID。'."\n"
."\n"
.'> 如果主备服务器组正在使用中,无法删除。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'RspoolVipExist',
'errorMessage' => 'there are vips associating with this vServer group.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\"\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n\\t9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n","errorExample":""}]',
'title' => '删除指定的主备服务器组',
'summary' => '删除指定的主备服务器组。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMasterSlaveServerGroupAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'MasterSlaveServerGroupId',
'in' => 'query',
'schema' => [
'description' => '主备服务器组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rsp-cige6j******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B0******',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '关联的标签类型。',
'type' => 'array',
'items' => [
'description' => '关联的标签类型。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '实例的标签键。N的取值范围:**1**~**20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '实例的标签值。N的取值范围:**1**~**20**。一旦输入该值,可以为空字符串。'."\n"
."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
'LoadBalancerId' => [
'description' => '关联的传统型负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-14fadafw4343a******',
],
'MasterSlaveServerGroupName' => [
'description' => '主备服务器组的名称。',
'type' => 'string',
'example' => 'Group1',
],
'MasterSlaveServerGroupId' => [
'description' => '主备服务器组ID。',
'type' => 'string',
'example' => 'rsp-cige6******',
],
'MasterSlaveBackendServers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MasterSlaveBackendServer' => [
'description' => '主备服务器组列表。',
'type' => 'array',
'items' => [
'description' => '主备服务器组列表。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '后端服务器类型,取值:'."\n"
."\n"
.'* **ecs**(默认):ECS实例。'."\n"
."\n"
.'* **eni**:弹性网卡实例。'."\n"
."\n"
.'* **eci**:弹性容器实例。',
'type' => 'string',
'example' => 'eni',
],
'Weight' => [
'description' => '后端服务器的权重。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
'Description' => [
'description' => '主备服务器组描述。',
'type' => 'string',
'example' => '主备服务器组描述。',
],
'Port' => [
'description' => '后端服务器使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '90',
],
'ServerId' => [
'description' => '后端服务器实例ID。',
'type' => 'string',
'example' => 'eni-hhshhs****',
],
'ServerType' => [
'description' => '服务器类型,取值:**Master**或**Slave**。',
'type' => 'string',
'example' => 'Slave',
],
],
],
],
],
],
'CreateTime' => [
'description' => '传统型负载均衡实例创建时间,格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2022-12-02T02:49:05Z',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B0******\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n },\\n \\"LoadBalancerId\\": \\"lb-14fadafw4343a******\\",\\n \\"MasterSlaveServerGroupName\\": \\"Group1\\",\\n \\"MasterSlaveServerGroupId\\": \\"rsp-cige6******\\",\\n \\"MasterSlaveBackendServers\\": {\\n \\"MasterSlaveBackendServer\\": [\\n {\\n \\"Type\\": \\"eni\\",\\n \\"Weight\\": 100,\\n \\"Description\\": \\"主备服务器组描述。\\",\\n \\"Port\\": 90,\\n \\"ServerId\\": \\"eni-hhshhs****\\",\\n \\"ServerType\\": \\"Slave\\"\\n }\\n ]\\n },\\n \\"CreateTime\\": \\"2022-12-02T02:49:05Z\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n lb-14fadafw4343a******\\n Group1\\n rsp-cige6******\\n \\n ecs\\n 100\\n 主备服务器组描述。\\n 90\\n vm-hrf******\\n Slave\\n \\n 2022-12-02T02:49:05Z\\n","errorExample":""}]',
'title' => '查询指定主备服务器组的详细信息',
'summary' => '查询指定主备服务器组的详细信息。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMasterSlaveServerGroups' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp14zi0n66zpg6o******',
],
],
[
'name' => 'IncludeListener',
'in' => 'query',
'schema' => [
'description' => '是否返回关联的监听信息,取值:'."\n"
."\n"
.'- **true**:返回。'."\n"
.'- **false**:不返回。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '资源标签。',
'type' => 'array',
'items' => [
'description' => '资源标签。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
'example' => '[{"Key":"TestKey","Value":"TestValue"}]',
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'Description',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '主备服务器组名称。',
'type' => 'string',
'required' => false,
'example' => 'Group3',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C',
],
'MasterSlaveServerGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MasterSlaveServerGroup' => [
'description' => '主备服务器组列表。',
'type' => 'array',
'items' => [
'description' => '主备服务器组列表。',
'type' => 'object',
'properties' => [
'MasterSlaveServerGroupId' => [
'description' => '主备服务器组ID。',
'type' => 'string',
'example' => 'rsp-0bfuc******',
],
'MasterSlaveServerGroupName' => [
'description' => '主备服务器组的名称。',
'type' => 'string',
'example' => 'Group3',
],
'AssociatedObjects' => [
'description' => '关联信息。',
'type' => 'object',
'properties' => [
'Listeners' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Listener' => [
'description' => '监听列表。',
'type' => 'array',
'items' => [
'description' => '监听列表。',
'type' => 'object',
'properties' => [
'Port' => [
'description' => '监听端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'Protocol' => [
'description' => '监听协议。',
'type' => 'string',
'example' => 'tcp',
],
],
],
],
],
],
],
],
'CreateTime' => [
'description' => '传统型负载均衡实例创建时间,格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2022-12-02T02:49:05Z',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => '资源的标签键。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => '资源的标签值。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param of TagKey is missing.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\",\\n \\"MasterSlaveServerGroups\\": {\\n \\"MasterSlaveServerGroup\\": [\\n {\\n \\"MasterSlaveServerGroupId\\": \\"rsp-0bfuc******\\",\\n \\"MasterSlaveServerGroupName\\": \\"Group3\\",\\n \\"AssociatedObjects\\": {\\n \\"Listeners\\": {\\n \\"Listener\\": [\\n {\\n \\"Port\\": 80,\\n \\"Protocol\\": \\"tcp\\"\\n }\\n ]\\n }\\n },\\n \\"CreateTime\\": \\"2022-12-02T02:49:05Z\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C\\n \\n rsp-0bfuc******\\n Group3\\n \\n \\n 80\\n tcp\\n \\n \\n 2022-12-02T02:49:05Z\\n \\n TestKey\\n TestValue\\n \\n \\n","errorExample":""}]',
'title' => '查询主备服务器组列表',
'summary' => '查询主备服务器组列表。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteCACertificate' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => 'CA证书的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'CACertificateId',
'in' => 'query',
'schema' => [
'description' => 'CA证书ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '123157908xxxxxxx_15c73d77203_-986300114_-2110544xxx',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'CertificateAndPrivateKeyIsRefered',
'errorMessage' => 'The specified certificate is bound to listeners. You cannot delete it.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","type":"json"}]',
'title' => '删除CA证书',
'summary' => '删除CA证书。',
'description' => '无法删除正在使用的CA证书。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteServerCertificate' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '服务器证书ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '123157xxxxxxx_166f8204689_1714763408_7099*******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'CertificateRelatedDomainExtensionExist',
'errorMessage' => 'The domainExtension related with this ServerCertificate exists.',
],
[
'errorCode' => 'CertificateAndPrivateKeyIsRefered',
'errorMessage' => 'The specified certificate is bound to listeners. You cannot delete it.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n\\t\\tCEF72CEB-54B6-4AE8-B225-F876FF7BA984","errorExample":""}]',
'title' => '删除服务器证书',
'summary' => '删除服务器证书。',
'description' => '> 如果指定删除的证书被引用,无法删除。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetCACertificateName' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => 'CA证书的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-east-hangzhou-01',
],
],
[
'name' => 'CACertificateId',
'in' => 'query',
'schema' => [
'description' => 'CA证书ID。',
'type' => 'string',
'required' => true,
'example' => '139a0******-cn-east-hangzhou-01',
],
],
[
'name' => 'CACertificateName',
'in' => 'query',
'schema' => [
'description' => 'CA证书名称。'."\n"
."\n"
.'名称长度为1~80个英文或中文字符,必须以大小字母或中文开头,可包含数字,英文句号(.),下划线(_)和短横线(-)。',
'type' => 'string',
'required' => true,
'example' => 'mycacert02',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FE7BA984',
],
],
],
],
],
'errorCodes' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FE7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\n CEF72CEB-54B6-4AE8-B225-F876FE7BA984\\n"}]',
'title' => '设置CA证书名称',
'summary' => '设置CA证书名称。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetServerCertificateName' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域。您可以通过调用[DescribeRegions](~~2401682~~) 接口查询地域ID。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '服务器证书ID。',
'type' => 'string',
'required' => true,
'example' => ' 123157xxxxxxx_166f8204689_1714763408_7099*******',
],
],
[
'name' => 'ServerCertificateName',
'in' => 'query',
'schema' => [
'description' => '要上传的非阿里云签发的服务器证书的名称。长度限制为1~80个字符,允许包含中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)、下划线(_)和星号(*)。',
'type' => 'string',
'required' => true,
'example' => 'mycert01',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FE7BA984',
],
],
],
],
],
'errorCodes' => [],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FE7BA984\\"\\n}","type":"json"}]',
'title' => '设置服务器证书名称',
'summary' => '设置服务器证书名称。',
],
'DescribeCACertificates' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => 'CA证书的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'CACertificateId',
'in' => 'query',
'schema' => [
'description' => 'CA证书ID。',
'type' => 'string',
'required' => false,
'example' => '139a00604bd-cn-east-hangzho****',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-atstuj3rtop****',
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF******',
],
'CACertificates' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'CACertificate' => [
'description' => 'CA证书信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'CreateTimeStamp' => [
'description' => 'CA证书创建的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'ExpireTime' => [
'description' => 'CA证书的过期时间。格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2024-11-21T06:04:25Z',
],
'CreateTime' => [
'description' => 'CA证书的创建时间。格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2021-08-31T02:49:05Z',
],
'ExpireTimeStamp' => [
'description' => 'CA证书过期的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1732169065000',
],
'CACertificateId' => [
'description' => 'CA证书ID。',
'type' => 'string',
'example' => '139a00604bd-cn-east-hangzho****',
],
'RegionId' => [
'description' => 'CA证书所属地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'Fingerprint' => [
'description' => ' CA证书的指纹。 ',
'type' => 'string',
'example' => '79:43:fb:7d:a4:7f:44:32:61:16:57:17:e3:e8:b7:36:03:57:f6:89',
],
'ResourceGroupId' => [
'description' => '资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3rtop****',
],
'CommonName' => [
'description' => 'CA证书的域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'CACertificateName' => [
'description' => ' CA证书名称。',
'type' => 'string',
'example' => 'test',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '标签。',
'type' => 'array',
'items' => [
'description' => '标签。',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '资源的标签值。',
'type' => 'string',
'example' => '1',
],
'TagKey' => [
'description' => '资源的标签键。',
'type' => 'string',
'example' => 'test',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Abs.CACertificateIdAndResourceGroupId.MissMatch',
'errorMessage' => 'CACertificateId or ResourceGroupId miss match.',
],
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF******\\",\\n \\"CACertificates\\": {\\n \\"CACertificate\\": [\\n {\\n \\"CreateTimeStamp\\": 1504147745000,\\n \\"ExpireTime\\": \\"2024-11-21T06:04:25Z\\",\\n \\"CreateTime\\": \\"2021-08-31T02:49:05Z\\",\\n \\"ExpireTimeStamp\\": 1732169065000,\\n \\"CACertificateId\\": \\"139a00604bd-cn-east-hangzho****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Fingerprint\\": \\"79:43:fb:7d:a4:7f:44:32:61:16:57:17:e3:e8:b7:36:03:57:f6:89\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3rtop****\\",\\n \\"CommonName\\": \\"www.example.com\\",\\n \\"CACertificateName\\": \\"test\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagValue\\": \\"1\\",\\n \\"TagKey\\": \\"test\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n \\n 1504147745000\\n 2024-11-21T06:04:25Z\\n 2021-08-31T02:49:05Z\\n 1732169065000\\n 139a00604bd-cn-east-hangzho****\\n cn-hangzhou\\n 79:43:fb:7d:a4:7f:44:32:61:16:57:17:e3:e8:b7:36:03:57:f6:89\\n rg-atstuj3rtop****\\n www.example.com\\n test\\n \\n 1\\n test\\n \\n \\n","errorExample":""}]',
'title' => '查询CA证书列表',
'summary' => '查询CA证书列表。',
'description' => '> 为了保证安全性,只返回证书的指纹和名称,不返回证书的内容。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeServerCertificates' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。'."\n"
."\n"
.'> 当您所选地域的Enpoint(服务地址)为slb.aliyuncs.com时,`RegionId`必填。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '服务器证书ID。',
'type' => 'string',
'required' => false,
'example' => '12315790*******_166f8204689_1714763408_709981430',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-atstuj3rtop****',
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'ServerCertificates' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ServerCertificate' => [
'description' => '服务器证书列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'CreateTimeStamp' => [
'description' => '服务器证书上传的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'AliCloudCertificateName' => [
'description' => '阿里云证书服务的服务器证书名称。',
'type' => 'string',
'example' => 'testcertkey',
],
'ExpireTime' => [
'description' => '过期时间。',
'type' => 'string',
'example' => '2023-01-26T23:59:59Z',
],
'CreateTime' => [
'description' => '服务器证书上传的时间。',
'type' => 'string',
'example' => '2021-08-31T02:49:05Z',
],
'ServerCertificateId' => [
'description' => '服务器证书ID。',
'type' => 'string',
'example' => '123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02',
],
'ExpireTimeStamp' => [
'description' => '过期时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '15041477450',
],
'RegionId' => [
'description' => '服务器证书的地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'ServerCertificateName' => [
'description' => '服务器证书名称。',
'type' => 'string',
'example' => 'slb',
],
'Fingerprint' => [
'description' => '服务器证书的指纹。',
'type' => 'string',
'example' => '68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d',
],
'CommonName' => [
'description' => '域名,对应证书的`CommonName`字段。',
'type' => 'string',
'example' => 'www.example.com',
],
'ResourceGroupId' => [
'description' => '企业资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3rtop****',
],
'IsAliCloudCertificate' => [
'description' => '是否是阿里云证书服务中的证书:'."\n"
."\n"
.'- **1**:是。'."\n"
.'- **0**:不是。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'AliCloudCertificateId' => [
'description' => '阿里云证书服务的服务器证书ID。',
'type' => 'string',
'example' => '7309********_15d97e7709a_71445759hr_789289731',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '资源标签。',
'type' => 'array',
'items' => [
'description' => '资源标签。',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '资源的标签值。',
'type' => 'string',
'example' => '1',
],
'TagKey' => [
'description' => '资源的标签键。',
'type' => 'string',
'example' => 'test',
],
],
],
],
],
],
'SubjectAlternativeNames' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SubjectAlternativeName' => [
'description' => '数组格式,返回证书的备用域名列表,对应证书的`Subject Alternative Name`字段。',
'type' => 'array',
'items' => [
'description' => '数组格式,返回证书的备用域名列表,对应证书的`Subject Alternative Name`字段。',
'type' => 'string',
'example' => '["demo.aliyundoc.com","example.aliyundoc.com"]',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Abs.ServerCertificateIdAndResourceGroupId.MissMatch',
'errorMessage' => 'ServerCertificateId or ResourceGroupId miss match.',
],
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"ServerCertificates\\": {\\n \\"ServerCertificate\\": [\\n {\\n \\"CreateTimeStamp\\": 1504147745000,\\n \\"AliCloudCertificateName\\": \\"testcertkey\\",\\n \\"ExpireTime\\": \\"2023-01-26T23:59:59Z\\",\\n \\"CreateTime\\": \\"2021-08-31T02:49:05Z\\",\\n \\"ServerCertificateId\\": \\"123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02\\",\\n \\"ExpireTimeStamp\\": 15041477450,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ServerCertificateName\\": \\"slb\\",\\n \\"Fingerprint\\": \\"68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d\\",\\n \\"CommonName\\": \\"www.example.com\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3rtop****\\",\\n \\"IsAliCloudCertificate\\": 0,\\n \\"AliCloudCertificateId\\": \\"7309********_15d97e7709a_71445759hr_789289731\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagValue\\": \\"1\\",\\n \\"TagKey\\": \\"test\\"\\n }\\n ]\\n },\\n \\"SubjectAlternativeNames\\": {\\n \\"SubjectAlternativeName\\": [\\n \\"[\\\\\\"demo.aliyundoc.com\\\\\\",\\\\\\"example.aliyundoc.com\\\\\\"]\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n \\n 1504147745000\\n testcertkey\\n 2023-01-26T23:59:59Z\\n 2021-08-31T02:49:05Z\\n 123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02\\n 15041477450\\n cn-hangzhou\\n slb\\n 68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d\\n www.example.com\\n rg-atstuj3rtop****\\n 0\\n 7309********_15d97e7709a_71445759hr_789289731\\n \\n 1\\n test\\n \\n [\\"demo.aliyundoc.com\\",\\"example.aliyundoc.com\\"]\\n \\n","errorExample":""}]',
'title' => '查询指定地域的服务器证书列表',
'summary' => '查询指定地域的服务器证书列表。',
'description' => '> 为了保证安全性,只返回证书的指纹和名称,不返回证书和私钥的内容。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'UploadCACertificate' => [
'summary' => '上传CA证书。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88694',
'abilityTreeNodes' => [
'FEATUREslbFSBXXR',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '实例的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceJoshua',
],
],
'required' => false,
],
'required' => false,
'example' => 'UploadCACertificate',
'maxItems' => 20,
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => 'CA证书的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'CACertificate',
'in' => 'query',
'schema' => [
'description' => '要上传CA证书的内容。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'test',
],
],
[
'name' => 'CACertificateName',
'in' => 'query',
'schema' => [
'description' => 'CA证书名称。',
'type' => 'string',
'required' => false,
'example' => 'mycacert01',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '企业资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-atst******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'CreateTimeStamp' => [
'description' => 'CA证书上传的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF******',
],
'ExpireTime' => [
'description' => 'CA证书的过期时间。',
'type' => 'string',
'example' => '2024-11-21T06:04:25Z',
],
'Fingerprint' => [
'description' => 'CA证书的指纹。',
'type' => 'string',
'example' => '02:DF:AB:ED',
],
'CreateTime' => [
'description' => 'CA证书上传的时间。',
'type' => 'string',
'example' => '2017-08-31T02:49:05Z',
],
'CommonName' => [
'description' => 'CA证书的域名。',
'type' => 'string',
'example' => 'example.com',
],
'ResourceGroupId' => [
'description' => '企业资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3******',
],
'CACertificateName' => [
'description' => 'CA证书的名称。',
'type' => 'string',
'example' => 'mycacert01',
],
'ExpireTimeStamp' => [
'description' => 'CA证书的过期时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1732169065000',
],
'CACertificateId' => [
'description' => 'CA证书ID。',
'type' => 'string',
'example' => '139a0******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"CreateTimeStamp\\": 1504147745000,\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF******\\",\\n \\"ExpireTime\\": \\"2024-11-21T06:04:25Z\\",\\n \\"Fingerprint\\": \\"02:DF:AB:ED\\",\\n \\"CreateTime\\": \\"2017-08-31T02:49:05Z\\",\\n \\"CommonName\\": \\"example.com\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3******\\",\\n \\"CACertificateName\\": \\"mycacert01\\",\\n \\"ExpireTimeStamp\\": 1732169065000,\\n \\"CACertificateId\\": \\"139a0******\\"\\n}","type":"json"}]',
'title' => '上传CA证书',
'description' => '一次只能上传一份CA证书内容。添加成功后,返回该用户的该证书的ID、名称和指纹。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'UploadServerCertificate' => [
'summary' => '上传服务器证书。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '88695',
'abilityTreeNodes' => [
'FEATUREslbFSBXXR',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '服务器证书部署的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AliCloudCertificateId',
'in' => 'query',
'schema' => [
'description' => '阿里云签发证书ID。'."\n"
."\n"
.'>如果使用阿里云签发证书,该参数必选。',
'type' => 'string',
'required' => false,
'example' => '775****',
],
],
[
'name' => 'AliCloudCertificateName',
'in' => 'query',
'schema' => [
'description' => '阿里云签发证书名称。'."\n"
."\n"
.'您可以通过调用[GetUserCertificateDetail - 获取证书详情](~~465112~~)接口查询证书名称。'."\n"
."\n"
.'>如果使用阿里云签发证书,该参数必选。'."\n",
'type' => 'string',
'required' => false,
'example' => 'cloudcertificate',
],
],
[
'name' => 'AliCloudCertificateRegionId',
'in' => 'query',
'schema' => [
'description' => '阿里云签发证书所属的地域ID。'."\n"
.'>如果使用阿里云签发证书,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ServerCertificate',
'in' => 'query',
'schema' => [
'description' => '需要上传的公钥证书。'."\n"
."\n"
.'>如果上传非阿里云签发证书,该参数必选。',
'type' => 'string',
'required' => false,
'example' => '-----BEGIN CERTIFICATE----- MIIGDTCC****** -----END CERTIFICATE-----',
],
],
[
'name' => 'PrivateKey',
'in' => 'query',
'schema' => [
'description' => '需要上传的私钥。 '."\n"
."\n"
.'>如果上传非阿里云签发证书,该参数必选。',
'type' => 'string',
'required' => false,
'example' => '-----BEGIN RSA PRIVATE KEY----- MIIEogIB****** -----END RSA PRIVATE KEY-----',
],
],
[
'name' => 'ServerCertificateName',
'in' => 'query',
'schema' => [
'description' => '要上传的非阿里云签发的服务器证书的名称。长度限制为1~80个字符,允许包含中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)、下划线(_)和星号(*)。'."\n"
."\n"
.'>如果上传非阿里云签发证书,该参数必选。',
'type' => 'string',
'required' => false,
'example' => 'mycert01',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '资源组ID。 ',
'type' => 'string',
'required' => false,
'example' => 'rg-atstuj3rto****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回数据结构体。',
'type' => 'object',
'properties' => [
'AliCloudCertificateName' => [
'description' => '阿里云签发证书名称。'."\n",
'type' => 'string',
'example' => 'cloudcertificate****',
],
'CreateTimeStamp' => [
'description' => '证书创建的时间戳。 ',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'ExpireTime' => [
'description' => '证书过期时间。',
'type' => 'string',
'example' => '2022-10-18T23:59:59Z',
],
'CreateTime' => [
'description' => '证书创建时间。 ',
'type' => 'string',
'example' => '2022-02-21T02:49:05Z',
],
'ServerCertificateId' => [
'description' => '服务器证书ID。',
'type' => 'string',
'example' => '1321932713******_17f1b4b696b_1114720822_-1671******',
],
'ExpireTimeStamp' => [
'description' => '证书过期的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1504147745000',
],
'RegionId' => [
'description' => '服务器证书部署的地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
'Fingerprint' => [
'description' => '服务器证书的指纹。',
'type' => 'string',
'example' => '8f:7d:cb:e5:f8:c8:33:9c:17:65:c1:92:30:9e:45:55:9c:3a:85:60',
],
'ServerCertificateName' => [
'description' => '非阿里云签发的服务器证书的名称。',
'type' => 'string',
'example' => 'mycert01',
],
'CommonName' => [
'description' => '域名,对应证书的`Common Name`字段。',
'type' => 'string',
'example' => 'example.com',
],
'ResourceGroupId' => [
'description' => '资源组ID。',
'type' => 'string',
'example' => 'rg-atstuj3rt****',
],
'AliCloudCertificateId' => [
'description' => '阿里云签发证书ID。',
'type' => 'string',
'example' => '775****',
],
'IsAliCloudCertificate' => [
'description' => '是否为阿里云证书服务中的证书。'."\n"
."\n"
.'- **0**:不是阿里云证书。'."\n"
.'- **1**:是阿里云证书。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'SubjectAlternativeNames' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SubjectAlternativeName' => [
'description' => '返回证书的备用域名列表。',
'type' => 'array',
'items' => [
'description' => '数组格式,返回证书的备用域名列表,对应证书的`Subject Alternative Name`字段。',
'type' => 'string',
'example' => '["example.com","www.example.com"]',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'IllegalParam.ServerCertificate',
'errorMessage' => 'The specified server certificate is illegal.',
],
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified ServerCertificate and PrivateKey fail to validate.',
],
[
'errorCode' => 'ServerCertificate.NotSupport',
'errorMessage' => 'The specified Region Not support ServerCertificate.',
],
[
'errorCode' => 'InvalidParameter.AliCloudCertificateId',
'errorMessage' => 'The specified AliCloudCertificateId is invalid.',
],
[
'errorCode' => 'OperationDenied.IllegalKeyLength',
'errorMessage' => 'The operation is not allowed because the key length of certificate is illegal.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
[
'errorCode' => 'EccCertificateNotSupport',
'errorMessage' => 'The ECC certificate is not support.',
],
[
'errorCode' => 'CertificateFormatInvalid',
'errorMessage' => 'The certificate format is invalid.',
],
],
403 => [
[
'errorCode' => 'UnauthorizedRegion',
'errorMessage' => 'The specified region of is not authorized.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"AliCloudCertificateName\\": \\"cloudcertificate****\\",\\n \\"CreateTimeStamp\\": 1504147745000,\\n \\"ExpireTime\\": \\"2022-10-18T23:59:59Z\\",\\n \\"CreateTime\\": \\"2022-02-21T02:49:05Z\\",\\n \\"ServerCertificateId\\": \\"1321932713******_17f1b4b696b_1114720822_-1671******\\",\\n \\"ExpireTimeStamp\\": 1504147745000,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\",\\n \\"Fingerprint\\": \\"8f:7d:cb:e5:f8:c8:33:9c:17:65:c1:92:30:9e:45:55:9c:3a:85:60\\",\\n \\"ServerCertificateName\\": \\"mycert01\\",\\n \\"CommonName\\": \\"example.com\\",\\n \\"ResourceGroupId\\": \\"rg-atstuj3rt****\\",\\n \\"AliCloudCertificateId\\": \\"775****\\",\\n \\"IsAliCloudCertificate\\": 0,\\n \\"SubjectAlternativeNames\\": {\\n \\"SubjectAlternativeName\\": [\\n \\"[\\\\\\"example.com\\\\\\",\\\\\\"www.example.com\\\\\\"]\\"\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n cloudcertificate****\\n 1504147745000\\n 2022-10-18T23:59:59Z\\n 2022-02-21T02:49:05Z\\n 1321932713******_17f1b4b696b_1114720822_-1671******\\n 1504147745000\\n cn-hangzhou\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n 8f:7d:cb:e5:f8:c8:33:9c:17:65:c1:92:30:9e:45:55:9c:3a:85:60\\n mycert01\\n example.com\\n rg-atstuj3rt****\\n 775****\\n 0\\n [\\"example.com\\",\\"www.example.com\\"]\\n","errorExample":""}]',
'title' => '上传服务器证书',
'description' => '- 一次只能上传一份服务器证书和对应的私钥。'."\n"
."\n"
.'- 上传成功后,返回该用户的所有服务器证书列表的指纹信息。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => '## 相关文档'."\n"
.'- [UploadCACertificate](~~34935~~):上传CA证书。'."\n"
.'- [证书要求](~~85968~~)'."\n"
.'- [上传证书失败FAQ](~~372506~~)',
],
'CreateDomainExtension' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1o94dp5i6earrxxxxxx',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例HTTPS监听的前端端口。'."\n"
."\n"
.'取值:**1-65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'example' => '443',
],
],
[
'name' => 'Domain',
'in' => 'query',
'schema' => [
'description' => '域名。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '*.example1.com',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '与域名对应的证书ID。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => '123157xxxxxxx_166f820xxxxxx_1714763408_709981xxxx',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'ListenerPort' => [
'description' => '负载均衡实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'A6E7EFC9-0938-40CA-877D-9BE******',
],
'DomainExtensionId' => [
'description' => '创建的扩展域名ID。',
'type' => 'string',
'example' => 'de-bp1rp7ta19******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidAction.RegionNotSupport',
'errorMessage' => 'The region does not support this action.',
],
[
'errorCode' => 'InvalidParameter.ServerCertificateId',
'errorMessage' => 'The specified ServerCertificateId does not exist.',
],
[
'errorCode' => 'InvalidParameter.Domain',
'errorMessage' => 'The specified Domain exists.',
],
[
'errorCode' => 'DomainExtensionProcessing',
'errorMessage' => 'A previous configuration of the DomainExtension is pending, please try again later.',
],
[
'errorCode' => 'DomainExtensionNumberOverLimit',
'errorMessage' => 'The number of domainExtension has reached to the quota limit of this listener.',
],
[
'errorCode' => 'DomainExtensionNotSupport',
'errorMessage' => 'The instance with shared loadBalancerSpec does not support domainExtension.',
],
[
'errorCode' => 'InvalidParameter.CertificateId',
'errorMessage' => 'The specified CertificateId contains duplicate certificate EncryptionAlgorithm.',
],
[
'errorCode' => 'InvalidParamSize.CertificateId',
'errorMessage' => 'The size of parameter CertificateId is invalid.',
],
[
'errorCode' => 'MissingParameter.CertificateId',
'errorMessage' => 'The parameter CertificateId is required.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'CertificateTypeMismatched',
'errorMessage' => 'The certificate type does not match.',
],
[
'errorCode' => 'SPEC_NOT_SUPPORT_PARAMETER',
'errorMessage' => 'The loadbalancer with share spec does not support the parameter.',
],
[
'errorCode' => 'CnCertificateNotSupport',
'errorMessage' => 'The cn certificate is not support.',
],
[
'errorCode' => 'InvalidParam.CertificateBindingType',
'errorMessage' => 'The param is invalid.',
],
[
'errorCode' => 'MissingParam.ServerCertificates',
'errorMessage' => 'The param ServerCertificates is missing.',
],
[
'errorCode' => 'InvalidParamSize.ServerCertificates',
'errorMessage' => 'The size of param ServerCertificates is invalid.',
],
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"ListenerPort\\": 80,\\n \\"RequestId\\": \\"A6E7EFC9-0938-40CA-877D-9BE******\\",\\n \\"DomainExtensionId\\": \\"de-bp1rp7ta19******\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\n\\tA6E7EFC9-0938-40CA-877D-9BEDBD21D357\\n\\tde-bp1rp7t******\\n\\t443\\n\\n\\t","errorExample":""}]',
'title' => '创建扩展域名',
'summary' => '创建扩展域名。',
'description' => '>性能共享型实例的监听不支持扩展域名。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetDomainExtensionAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DomainExtensionId',
'in' => 'query',
'schema' => [
'description' => '需要修改的扩展域名ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'de-bp1rp7ta*****',
],
],
[
'name' => 'ServerCertificateId',
'in' => 'query',
'schema' => [
'description' => '新的证书ID。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => '1231579xxxxxxxx_166f8204689_1714763408_709981xxx',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '149A2470-F010-4437-BF68-343******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter.DomainExtensionId',
'errorMessage' => 'The specified DomainExtensionId does not exist.',
],
[
'errorCode' => 'InvalidParameter.ServerCertificateId',
'errorMessage' => 'The specified ServerCertificateId does not exist.',
],
[
'errorCode' => 'DomainExtensionProcessing',
'errorMessage' => 'A previous configuration of the DomainExtension is pending, please try again later.',
],
[
'errorCode' => 'IncorrectStatus.DomainExtension',
'errorMessage' => 'The listener to which the domain extension belongs is being configured, please try again later.',
],
[
'errorCode' => 'InvalidParameter.CertificateId',
'errorMessage' => 'The specified CertificateId contains duplicate certificate EncryptionAlgorithm.',
],
[
'errorCode' => 'InvalidParamSize.CertificateId',
'errorMessage' => 'The size of parameter CertificateId is invalid.',
],
[
'errorCode' => 'MissingParameter.CertificateId',
'errorMessage' => 'The parameter CertificateId is required.',
],
[
'errorCode' => 'InvalidParameter.RegionNotSupport',
'errorMessage' => 'The region does not support the parameter: %s.',
],
[
'errorCode' => 'CertificateTypeMismatched',
'errorMessage' => 'The certificate type does not match.',
],
[
'errorCode' => 'SPEC_NOT_SUPPORT_PARAMETER',
'errorMessage' => 'The loadbalancer with share spec does not support the parameter.',
],
[
'errorCode' => 'CnCertificateNotSupport',
'errorMessage' => 'The cn certificate is not support.',
],
[
'errorCode' => 'InvalidParam.CertificateBindingType',
'errorMessage' => 'The param is invalid.',
],
[
'errorCode' => 'MissingParam.ServerCertificates',
'errorMessage' => 'The param ServerCertificates is missing.',
],
[
'errorCode' => 'InvalidParamSize.ServerCertificates',
'errorMessage' => 'The size of param ServerCertificates is invalid.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"149A2470-F010-4437-BF68-343******\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\n 149A2470-F010-4437-BF68-xxxxx\\n\\n","errorExample":""}]',
'title' => '修改扩展域名的证书',
'summary' => '修改扩展域名的证书。',
'description' => '>性能共享型实例的监听不支持扩展域名。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteDomainExtension' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的所属地域。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DomainExtensionId',
'in' => 'query',
'schema' => [
'description' => '要删除的扩展域名ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'de-bp1rp7ta1****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '149A2470-F010-4437-BF68-343******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter.DomainExtensionId',
'errorMessage' => 'The specified DomainExtensionId does not exist.',
],
[
'errorCode' => 'DomainExtensionProcessing',
'errorMessage' => 'A previous configuration of the DomainExtension is pending, please try again later.',
],
[
'errorCode' => 'DomainExtensionRelatedRuleExist',
'errorMessage' => 'The DomainExtension is related with rules.',
],
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"149A2470-F010-4437-BF68-343******\\"\\n}","type":"json"}]',
'title' => '删除扩展域名',
'summary' => '删除扩展域名。',
],
'DescribeDomainExtensionAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'DomainExtensionId',
'in' => 'query',
'schema' => [
'description' => '扩展域名ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'de-bp1r******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Domain' => [
'description' => '域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '48C1B671-C6DB-4DDE-9B30-1055******',
],
'LoadBalancerId' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1o95i6*****',
],
'ListenerPort' => [
'description' => '负载均衡实例HTTPS监听的前端端口,取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'example' => '443',
],
'ServerCertificateId' => [
'description' => '域名使用的服务器证书ID。',
'type' => 'string',
'example' => '231579085529123_166f82******_1714763408_709981430',
],
'DomainExtensionId' => [
'description' => '扩展域名ID。',
'type' => 'string',
'example' => 'de-bp1rp******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter.DomainExtensionId',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParameter.DomainExtensionId',
'errorMessage' => 'The param DomainExtensionId is missing',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Domain\\": \\"www.example.com\\",\\n \\"RequestId\\": \\"48C1B671-C6DB-4DDE-9B30-1055******\\",\\n \\"LoadBalancerId\\": \\"lb-bp1o95i6*****\\",\\n \\"ListenerPort\\": 443,\\n \\"ServerCertificateId\\": \\"231579085529123_166f82******_1714763408_709981430\\",\\n \\"DomainExtensionId\\": \\"de-bp1rp******\\"\\n}","errorExample":""},{"type":"xml","example":"\\n443\\nde-bp1rp7ta191dv\\n48C1B671-C6DB-4DDE-9B30-10557E36CDE0\\n231579085529123_166f82******_1714763408_709981430\\nlb-bp1o94dp5i6*****earr9g6d1l\\nwww.example.com\\n","errorExample":""}]',
'title' => '查询已添加的扩展域名属性',
'summary' => '查询已添加的扩展域名属性。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeDomainExtensions' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1b6c08ex****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例HTTPS监听的前端端口,取值:**1-65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'example' => '443',
],
],
[
'name' => 'DomainExtensionId',
'in' => 'query',
'schema' => [
'description' => '扩展域名ID。',
'type' => 'string',
'required' => false,
'example' => 'de-bp1rp7ta1****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '48C1B671-C6DB-4DDE-9B30-1055*****',
],
'DomainExtensions' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'DomainExtension' => [
'description' => '扩展域名列表。',
'type' => 'array',
'items' => [
'description' => '扩展域名列表。',
'type' => 'object',
'properties' => [
'ServerCertificateId' => [
'description' => '域名使用的证书ID。',
'type' => 'string',
'example' => '12315790****3_166f8****9_1714****08_70998****',
],
'Domain' => [
'description' => '域名。',
'type' => 'string',
'example' => 'www.example.com',
],
'DomainExtensionId' => [
'description' => '扩展域名ID。',
'type' => 'string',
'example' => 'de-bp1rp7ta1****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"48C1B671-C6DB-4DDE-9B30-1055*****\\",\\n \\"DomainExtensions\\": {\\n \\"DomainExtension\\": [\\n {\\n \\"ServerCertificateId\\": \\"12315790****3_166f8****9_1714****08_70998****\\",\\n \\"Domain\\": \\"www.example.com\\",\\n \\"DomainExtensionId\\": \\"de-bp1rp7ta1****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"48C1B671-C6DB-4DDE-9B30-10557E36CDE0\\n\\n \\n de-bp1rp7ta1****\\n 1231579085529123_166f8204689_1714763408_70998****\\n www.example.com\\n \\n","errorExample":""}]',
'title' => '查询已添加的扩展域名',
'summary' => '查询已添加的扩展域名。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateTLSCipherPolicy' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例所在的地域ID。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => 'TLS 策略名称。长度为 2~200 个英文或中文字符,必须以大小字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'TLSPolicy-test',
],
],
[
'name' => 'Ciphers',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '支持的加密套件列表,具体依赖TLSVersion值。最多支持添加32个加密套件。'."\n"
."\n"
.'TLSv1.0和TLSv1.1 支持:'."\n"
.'- **ECDHE-ECDSA-AES128-SHA**'."\n"
.'- **ECDHE-ECDSA-AES256-SHA**'."\n"
.'- **ECDHE-RSA-AES128-SHA**'."\n"
.'- **ECDHE-RSA-AES256-SHA**'."\n"
.'- **AES128-SHA**'."\n"
.'- **AES256-SHA**'."\n"
.'- **DES-CBC3-SHA**'."\n"
."\n"
.'TLSv1.2支持:'."\n"
.'- **ECDHE-ECDSA-AES128-SHA**'."\n"
.'- **ECDHE-ECDSA-AES256-SHA**'."\n"
.'- **ECDHE-RSA-AES128-SHA**'."\n"
.'- **ECDHE-RSA-AES256-SHA**'."\n"
.'- **AES128-SHA**'."\n"
.'- **AES256-SHA**'."\n"
.'- **DES-CBC3-SHA**'."\n"
.'- **ECDHE-ECDSA-AES128-GCM-SHA256**'."\n"
.'- **ECDHE-ECDSA-AES256-GCM-SHA384**'."\n"
.'- **ECDHE-ECDSA-AES128-SHA256**'."\n"
.'- **ECDHE-ECDSA-AES256-SHA384**'."\n"
.'- **ECDHE-RSA-AES128-GCM-SHA256**'."\n"
.'- **ECDHE-RSA-AES256-GCM-SHA384**'."\n"
.'- **ECDHE-RSA-AES128-SHA256**'."\n"
.'- **ECDHE-RSA-AES256-SHA384**'."\n"
.'- **AES128-GCM-SHA256**'."\n"
.'- **AES256-GCM-SHA384**'."\n"
.'- **AES128-SHA256**'."\n"
.'- **AES256-SHA256**'."\n"
."\n"
.'TLSv1.3支持:'."\n"
.'- **TLS_AES_128_GCM_SHA256**'."\n"
.'- **TLS_AES_256_GCM_SHA384**'."\n"
.'- **TLS_CHACHA20_POLY1305_SHA256**'."\n"
.'- **TLS_AES_128_CCM_SHA256**'."\n"
.'- **TLS_AES_128_CCM_8_SHA256**'."\n",
'type' => 'array',
'items' => [
'description' => '支持的加密套件列表,具体依赖TLSVersion值。最多支持添加32个加密套件。'."\n"
."\n"
.'TLSv1.0和TLSv1.1 支持:'."\n"
.'- **ECDHE-ECDSA-AES128-SHA**'."\n"
.'- **ECDHE-ECDSA-AES256-SHA**'."\n"
.'- **ECDHE-RSA-AES128-SHA**'."\n"
.'- **ECDHE-RSA-AES256-SHA**'."\n"
.'- **AES128-SHA**'."\n"
.'- **AES256-SHA**'."\n"
.'- **DES-CBC3-SHA**'."\n"
."\n"
.'TLSv1.2支持:'."\n"
.'- **ECDHE-ECDSA-AES128-SHA**'."\n"
.'- **ECDHE-ECDSA-AES256-SHA**'."\n"
.'- **ECDHE-RSA-AES128-SHA**'."\n"
.'- **ECDHE-RSA-AES256-SHA**'."\n"
.'- **AES128-SHA**'."\n"
.'- **AES256-SHA**'."\n"
.'- **DES-CBC3-SHA**'."\n"
.'- **ECDHE-ECDSA-AES128-GCM-SHA256**'."\n"
.'- **ECDHE-ECDSA-AES256-GCM-SHA384**'."\n"
.'- **ECDHE-ECDSA-AES128-SHA256**'."\n"
.'- **ECDHE-ECDSA-AES256-SHA384**'."\n"
.'- **ECDHE-RSA-AES128-GCM-SHA256**'."\n"
.'- **ECDHE-RSA-AES256-GCM-SHA384**'."\n"
.'- **ECDHE-RSA-AES128-SHA256**'."\n"
.'- **ECDHE-RSA-AES256-SHA384**'."\n"
.'- **AES128-GCM-SHA256**'."\n"
.'- **AES256-GCM-SHA384**'."\n"
.'- **AES128-SHA256**'."\n"
.'- **AES256-SHA256**'."\n"
."\n"
.'TLSv1.3支持:'."\n"
.'- **TLS_AES_128_GCM_SHA256**'."\n"
.'- **TLS_AES_256_GCM_SHA384**'."\n"
.'- **TLS_CHACHA20_POLY1305_SHA256**'."\n"
.'- **TLS_AES_128_CCM_SHA256**'."\n"
.'- **TLS_AES_128_CCM_8_SHA256**'."\n",
'type' => 'string',
'required' => false,
'example' => 'ECDHE-ECDSA-AES128-SHA',
],
'required' => true,
'example' => 'AES256-SHA256',
'maxItems' => 30,
],
],
[
'name' => 'TLSVersions',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '支持的TLS协议版本。取值:**TLSv1.0**、**TLSv1.1**、**TLSv1.2**和**TLSv1.3**。最多支持添加4个TLS协议版本。',
'type' => 'array',
'items' => [
'description' => '支持的TLS协议版本。取值:**TLSv1.0**、**TLSv1.1**、**TLSv1.2**和**TLSv1.3**。最多支持添加4个TLS协议版本。',
'type' => 'string',
'required' => false,
'example' => 'TLSv1.0',
],
'required' => true,
'example' => 'TLSv1.0',
'maxItems' => 5,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TLSCipherPolicyId' => [
'description' => '策略ID。',
'type' => 'string',
'example' => 'tls-bp14bb1e7dll4f****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'D7A8875F-373A-5F48-8484-25B07A61F2AF',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'MissingParam.Name',
'errorMessage' => 'The param Name is missing.',
],
[
'errorCode' => 'MissingParam.TlsVersions',
'errorMessage' => 'The param TlsVersions is missing.',
],
[
'errorCode' => 'MissingParam.Ciphers',
'errorMessage' => 'The param Ciphers is missing.',
],
[
'errorCode' => 'ParamDuplicateError.TlsVersions',
'errorMessage' => 'The param TlsVersions is duplicate in request.',
],
[
'errorCode' => 'ParamDuplicateError.Ciphers',
'errorMessage' => 'The param Ciphers is duplicate in request.',
],
[
'errorCode' => 'TLSPolicyNoSupportVersion',
'errorMessage' => 'The specified TLS version is not supported.',
],
[
'errorCode' => 'TLSPolicyNoSupportCipher',
'errorMessage' => 'The specified TLS cipher is not supported.',
],
[
'errorCode' => 'TLSCipherPolicyOverLimit',
'errorMessage' => 'The TLSCipherPolicy is over the limit.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TLSCipherPolicyId\\": \\"tls-bp14bb1e7dll4f****\\",\\n \\"RequestId\\": \\"D7A8875F-373A-5F48-8484-25B07A61F2AF\\"\\n}","errorExample":""},{"type":"xml","example":"\\n tls-bp14bb1e7dll4f****\\n D7A8875F-373A-5F48-8484-25B07A61F2AF\\n","errorExample":""}]',
'title' => '创建TLS策略',
'summary' => '创建TLS策略。',
'description' => '该功能默认不开放,建议您使用ALB或NLB。特殊情况请联系销售或提交工单。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteTLSCipherPolicy' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例所在的地域ID。'."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'TLSCipherPolicyId',
'in' => 'query',
'schema' => [
'description' => 'TLS策略实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'tls-bp1lp2076qx4ebridp******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'MissingParam.TLSCipherPolicyId',
'errorMessage' => 'The param TLSCipherPolicyId is missing.',
],
[
'errorCode' => 'TLSPolicyConfiguring',
'errorMessage' => 'The specified TLS cipher policy is configuring.',
],
[
'errorCode' => 'TLSPolicyBeingUsed',
'errorMessage' => 'The specified TLS cipher policy is being used.',
],
[
'errorCode' => 'InvalidTLSPolicyId.NotExist',
'errorMessage' => 'The specified TLS cipher policy does not exist.',
],
[
'errorCode' => 'TLSPolicyRelated',
'errorMessage' => 'The specified TLS cipher policy is related with listeners.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\nCEF72CEB-54B6-4AE8-B225-F876FF7BA984\\r\\n","errorExample":""}]',
'title' => '删除TLS策略',
'summary' => '删除TLS策略。',
'description' => '该功能默认不开放,建议您使用ALB或NLB。特殊情况请联系销售或提交工单。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetTLSCipherPolicyAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'TLSCipherPolicyId',
'in' => 'query',
'schema' => [
'description' => 'TLS策略ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'tls-bp1lp2076qx4e******bridp',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => 'TLS策略名称。长度为2~200个英文或中文字符,必须以大小字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'tls-policy*****-test',
],
],
[
'name' => 'TLSVersions',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '支持的TLS协议版本。取值:**TLSv1.0**、**TLSv1.1**、**TLSv1.2**和**TLSv1.3**。',
'type' => 'array',
'items' => [
'description' => '支持的TLS协议版本。取值:**TLSv1.0**、**TLSv1.1**、**TLSv1.2**和**TLSv1.3**。',
'type' => 'string',
'required' => false,
'example' => 'TLSv1.0',
],
'required' => true,
'example' => 'TLSv1.0',
'maxItems' => 5,
],
],
[
'name' => 'Ciphers',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '支持的加密套件,具体依赖TLSVersions的取值。'."\n"
."\n"
.'Cipher只要被任何一个传入的TLSVersions支持即可,例如选择了TLSv1.3,那么Cipher列表必须包含TLSv1.3支持的Cipher。'."\n"
."\n"
.'TLSv1.0和TLSv1.1 支持:'."\n"
."\n"
.'- ECDHE-ECDSA-AES128-SHA'."\n"
.'- ECDHE-ECDSA-AES256-SHA'."\n"
.'- ECDHE-RSA-AES128-SHA'."\n"
.'- ECDHE-RSA-AES256-SHA'."\n"
.'- AES128-SHA AES256-SHA'."\n"
.'- DES-CBC3-SHA'."\n"
."\n"
.'TLSv1.2支持:'."\n"
."\n"
.'- ECDHE-ECDSA-AES128-SHA'."\n"
.'- ECDHE-ECDSA-AES256-SHA'."\n"
.'- ECDHE-RSA-AES128-SHA'."\n"
.'- ECDHE-RSA-AES256-SHA'."\n"
.'- AES128-SHA AES256-SHA'."\n"
.'- DES-CBC3-SHA'."\n"
.'- ECDHE-ECDSA-AES128-GCM-SHA256'."\n"
.'- ECDHE-ECDSA-AES256-GCM-SHA384'."\n"
.'- ECDHE-ECDSA-AES128-SHA256'."\n"
.'- ECDHE-ECDSA-AES256-SHA384'."\n"
.'- ECDHE-RSA-AES128-GCM-SHA256'."\n"
.'- ECDHE-RSA-AES256-GCM-SHA384'."\n"
.'- ECDHE-RSA-AES128-SHA256'."\n"
.'- ECDHE-RSA-AES256-SHA384'."\n"
.'- AES128-GCM-SHA256'."\n"
.'- AES256-GCM-SHA384'."\n"
.'- AES128-SHA256 AES256-SHA256'."\n"
."\n"
.'TLSv1.3支持:'."\n"
."\n"
.'- TLS_AES_128_GCM_SHA256'."\n"
.'- TLS_AES_256_GCM_SHA384'."\n"
.'- TLS_CHACHA20_POLY1305_SHA256'."\n"
.'- TLS_AES_128_CCM_SHA256'."\n"
.'- TLS_AES_128_CCM_8_SHA256',
'type' => 'array',
'items' => [
'description' => '支持的加密套件,具体依赖TLSVersions的取值。'."\n"
."\n"
.'Cipher只要被任何一个传入的TLSVersions支持即可,例如选择了TLSv1.3,那么Cipher列表必须包含TLSv1.3支持的Cipher。'."\n"
."\n"
.'TLSv1.0和TLSv1.1 支持:'."\n"
."\n"
.'- ECDHE-ECDSA-AES128-SHA'."\n"
.'- ECDHE-ECDSA-AES256-SHA'."\n"
.'- ECDHE-RSA-AES128-SHA'."\n"
.'- ECDHE-RSA-AES256-SHA'."\n"
.'- AES128-SHA AES256-SHA'."\n"
.'- DES-CBC3-SHA'."\n"
."\n"
.'TLSv1.2支持:'."\n"
."\n"
.'- ECDHE-ECDSA-AES128-SHA'."\n"
.'- ECDHE-ECDSA-AES256-SHA'."\n"
.'- ECDHE-RSA-AES128-SHA'."\n"
.'- ECDHE-RSA-AES256-SHA'."\n"
.'- AES128-SHA AES256-SHA'."\n"
.'- DES-CBC3-SHA'."\n"
.'- ECDHE-ECDSA-AES128-GCM-SHA256'."\n"
.'- ECDHE-ECDSA-AES256-GCM-SHA384'."\n"
.'- ECDHE-ECDSA-AES128-SHA256'."\n"
.'- ECDHE-ECDSA-AES256-SHA384'."\n"
.'- ECDHE-RSA-AES128-GCM-SHA256'."\n"
.'- ECDHE-RSA-AES256-GCM-SHA384'."\n"
.'- ECDHE-RSA-AES128-SHA256'."\n"
.'- ECDHE-RSA-AES256-SHA384'."\n"
.'- AES128-GCM-SHA256'."\n"
.'- AES256-GCM-SHA384'."\n"
.'- AES128-SHA256 AES256-SHA256'."\n"
."\n"
.'TLSv1.3支持:'."\n"
."\n"
.'- TLS_AES_128_GCM_SHA256'."\n"
.'- TLS_AES_256_GCM_SHA384'."\n"
.'- TLS_CHACHA20_POLY1305_SHA256'."\n"
.'- TLS_AES_128_CCM_SHA256'."\n"
.'- TLS_AES_128_CCM_8_SHA256',
'type' => 'string',
'required' => false,
'example' => 'ECDHE-ECDSA-AES128-SHA',
],
'required' => true,
'example' => 'DES-CBC3-SHA',
'maxItems' => 30,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'TaskId' => [
'description' => '异步任务ID。',
'type' => 'string',
'example' => '72dcd26b-f12d-4c27-b3af****-18f6aed5',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876*******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'MissingParam.Name',
'errorMessage' => 'The param Name is missing.',
],
[
'errorCode' => 'MissingParam.TlsVersions',
'errorMessage' => 'The param TlsVersions is missing.',
],
[
'errorCode' => 'MissingParam.Ciphers',
'errorMessage' => 'The param Ciphers is missing.',
],
[
'errorCode' => 'ParamDuplicateError.TlsVersions',
'errorMessage' => 'The param TlsVersions is duplicate in request.',
],
[
'errorCode' => 'ParamDuplicateError.Ciphers',
'errorMessage' => 'The param Ciphers is duplicate in request.',
],
[
'errorCode' => 'TLSPolicyNoSupportVersion',
'errorMessage' => 'The specified TLS version is not supported.',
],
[
'errorCode' => 'TLSPolicyNoSupportCipher',
'errorMessage' => 'The specified TLS cipher is not supported.',
],
[
'errorCode' => 'MissingParam.TLSCipherPolicyId',
'errorMessage' => 'The param TLSCipherPolicyId is missing.',
],
[
'errorCode' => 'TLSPolicyConfiguring',
'errorMessage' => 'The specified TLS cipher policy is configuring.',
],
[
'errorCode' => 'TLSPolicyBeingUsed',
'errorMessage' => 'The specified TLS cipher policy is being used.',
],
[
'errorCode' => 'InvalidTLSPolicyId.NotExist',
'errorMessage' => 'The specified TLS cipher policy does not exist.',
],
[
'errorCode' => 'TLSPolicyUnchanged',
'errorMessage' => 'The specified TLS cipher policy is unchanged.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"TaskId\\": \\"72dcd26b-f12d-4c27-b3af****-18f6aed5\\",\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876*******\\"\\n}","errorExample":""},{"type":"xml","example":"\\n72dcd26b-f12d-4c27-b3af****-18f6aed5\\nCEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '设置TLS策略',
'summary' => '设置TLS策略。',
'description' => '该功能默认不开放,建议您使用ALB或NLB。特殊情况请联系销售或提交工单。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListTLSCipherPolicies' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'TLSCipherPolicyId',
'in' => 'query',
'schema' => [
'description' => 'TLS策略ID。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'tls-bp17elso1h323r****',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => 'TLS策略名称。长度为2~200个英文或中文字符,必须以大小写字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。',
'type' => 'string',
'required' => false,
'example' => 'TLSPolicy-test****',
],
],
[
'name' => 'IncludeListener',
'in' => 'query',
'schema' => [
'description' => '是否返回关联的监听信息。取值:'."\n"
."\n"
.'- **true**:返回。'."\n"
.'- **false**(默认):不返回。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
'default' => 'false',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '是否拥有下一次查询的令牌(Token)。取值:'."\n"
.'- 第一次查询和没有下一次查询时,均无需填写。'."\n"
.'- 如果有下一次查询,取值为上一次API调用返回的NextToken值。',
'type' => 'string',
'required' => false,
'example' => 'FFmyTO70tTpLG6I3FmYAXGKPd****',
],
],
[
'name' => 'MaxItems',
'in' => 'query',
'schema' => [
'description' => '本次读取的最大TLS策略数,取值:**1**~**100**。设置为空时,默认值为**20**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '20',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '是否拥有下一次查询的令牌(Token)。取值:'."\n"
.'- 如果**NextToken**为空表示没有下一次查询。'."\n"
.'- 如果**NextToken**有返回值,该取值表示下一次查询开始的令牌。',
'type' => 'string',
'example' => 'FFmyTO70tTpLG6I3FmYAXGKPd****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
'TotalCount' => [
'description' => '本次请求条件下的TLS策略总数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1000',
],
'IsTruncated' => [
'description' => '是否结束。取值:'."\n"
."\n"
.'- **true**:表示当前页是最后一页。'."\n"
."\n"
.'- **false**:表示还有下一页。',
'type' => 'boolean',
'example' => 'false',
],
'TLSCipherPolicies' => [
'description' => 'TLS策略列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Status' => [
'description' => 'TLS策略实例状态。取值:'."\n"
."\n"
.'- **configuring**:配置中。'."\n"
."\n"
.'- **normal**: 正常。',
'type' => 'string',
'example' => 'normal',
],
'InstanceId' => [
'description' => 'TLS策略实例ID。',
'type' => 'string',
'example' => 'tls-bp17elso1h323r****',
],
'Name' => [
'description' => 'TLS策略名称。',
'type' => 'string',
'example' => 'TLSPolicy-test****',
],
'CreateTime' => [
'description' => '创建时间的时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1608273800000',
],
'RelateListeners' => [
'description' => '关联的监听。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Port' => [
'description' => '监听端口。取值:**1**~**65535**。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'Protocol' => [
'description' => '监听协议。取值:'."\n"
.'- **TCP** '."\n"
.'- **UDP**'."\n"
.'- **HTTP**'."\n"
.'- **HTTPS**',
'type' => 'string',
'example' => 'HTTPS',
],
'LoadBalancerId' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'example' => 'lb-bp1b6c719dfa08ex****',
],
],
],
],
'TLSVersions' => [
'type' => 'array',
'items' => [
'description' => '支持的TLS协议版本。',
'type' => 'string',
'example' => 'TLSv1.0',
],
],
'Ciphers' => [
'type' => 'array',
'items' => [
'description' => '支持的加密套件,具体依赖TLSVersions的取值。'."\n"
."\n"
.'TLSv1.0和TLSv1.1 支持: '."\n"
."\n"
.'- ECDHE-ECDSA-AES128-SHA '."\n"
.'- ECDHE-ECDSA-AES256-SHA'."\n"
.'- ECDHE-RSA-AES128-SHA '."\n"
.'- ECDHE-RSA-AES256-SHA '."\n"
.'- AES128-SHA AES256-SHA '."\n"
.'- DES-CBC3-SHA'."\n"
."\n"
.'TLSv1.2支持:'."\n"
."\n"
.'- ECDHE-ECDSA-AES128-SHA '."\n"
.'- ECDHE-ECDSA-AES256-SHA '."\n"
.'- ECDHE-RSA-AES128-SHA '."\n"
.'- ECDHE-RSA-AES256-SHA '."\n"
.'- AES128-SHA AES256-SHA '."\n"
.'- DES-CBC3-SHA '."\n"
.'- ECDHE-ECDSA-AES128-GCM-SHA256 '."\n"
.'- ECDHE-ECDSA-AES256-GCM-SHA384 '."\n"
.'- ECDHE-ECDSA-AES128-SHA256 '."\n"
.'- ECDHE-ECDSA-AES256-SHA384 '."\n"
.'- ECDHE-RSA-AES128-GCM-SHA256 '."\n"
.'- ECDHE-RSA-AES256-GCM-SHA384 '."\n"
.'- ECDHE-RSA-AES128-SHA256 '."\n"
.'- ECDHE-RSA-AES256-SHA384 '."\n"
.'- AES128-GCM-SHA256 '."\n"
.'- AES256-GCM-SHA384 '."\n"
.'- AES128-SHA256 AES256-SHA256'."\n"
."\n"
.'TLSv1.3支持: '."\n"
."\n"
.'- TLS_AES_128_GCM_SHA256'."\n"
.'- TLS_AES_256_GCM_SHA384'."\n"
.'- TLS_CHACHA20_POLY1305_SHA256'."\n"
.'- TLS_AES_128_CCM_SHA256'."\n"
.'- TLS_AES_128_CCM_8_SHA256',
'type' => 'string',
'example' => 'ECDHE-ECDSA-AES128-SHA',
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'QueryTokenInvalid',
'errorMessage' => 'The specified token is invalid.',
],
[
'errorCode' => 'QueryTokenNotExist',
'errorMessage' => 'The specified token is not exist.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"NextToken\\": \\"FFmyTO70tTpLG6I3FmYAXGKPd****\\",\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\",\\n \\"TotalCount\\": 1000,\\n \\"IsTruncated\\": false,\\n \\"TLSCipherPolicies\\": [\\n {\\n \\"Status\\": \\"normal\\",\\n \\"InstanceId\\": \\"tls-bp17elso1h323r****\\",\\n \\"Name\\": \\"TLSPolicy-test****\\",\\n \\"CreateTime\\": 1608273800000,\\n \\"RelateListeners\\": [\\n {\\n \\"Port\\": 80,\\n \\"Protocol\\": \\"HTTPS\\",\\n \\"LoadBalancerId\\": \\"lb-bp1b6c719dfa08ex****\\"\\n }\\n ],\\n \\"TLSVersions\\": [\\n \\"TLSv1.0\\"\\n ],\\n \\"Ciphers\\": [\\n \\"ECDHE-ECDSA-AES128-SHA\\"\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n FFmyTO70tTpLG6I3FmYAXGKPd****\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n 1000\\n false\\n \\n normal\\n tls-bp17elso1h323r****\\n TLSPolicy-test****\\n 1608273800000\\n \\n 80\\n HTTPS\\n lb-bp1b6c719dfa08ex****\\n \\n TLSv1.0\\n ECDHE-ECDSA-AES128-SHA\\n \\n","errorExample":""}]',
'title' => '查询TLS策略',
'summary' => '查询TLS策略。',
'description' => '该功能默认不开放,建议您使用ALB或NLB。特殊情况请联系销售或提交工单。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateAccessControlList' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'enumValueTitles' => [],
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclName',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组名称,长度限制为1~80个字符,只支持中文、字母、数字和半角句号(.)、短划线(-)、正斜线(/)和下划线(_)。访问控制策略组名称必须为地域内唯一。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rule1',
],
],
[
'name' => 'AddressIPVersion',
'in' => 'query',
'schema' => [
'description' => 'IP版本,可以设置为**ipv4**或者**ipv6**。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [],
'example' => 'ipv4',
'default' => 'ipv4',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组所在的资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-atstuj3rt******',
],
],
[
'name' => 'Tag',
'in' => 'query',
'allowEmptyValue' => true,
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '监听的标签键。N的取值范围:**1**~**20**。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以`aliyun`或`acs:`开头,不能包含`http://`或`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestKey',
],
'Value' => [
'description' => '监听的标签值。N的取值范围:**1**~**20**。一旦传入该值,可以为空字符串。最多支持128个字符,不能以`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'TestValue',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'example' => 'acl-rj9xpxzcwxrukois****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '988CB45E-1643-48C0-87B4-928DDF77EA49',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidAction.RegionNotSupport',
'errorMessage' => 'The region does not support this action.',
],
[
'errorCode' => 'AclNumberOverLimit',
'errorMessage' => 'The Acl number has reached to the max quota limit.',
],
[
'errorCode' => 'InvalidResourceGroupId.NotFound',
'errorMessage' => 'The specified ResourceGroupId is not found.',
],
[
'errorCode' => 'ResourceInConfiguring.Acl',
'errorMessage' => 'The specified resource is configuring, please try again later.',
],
[
'errorCode' => 'InvalidParam.TagValue ',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => '%s.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The param MissingParam.TagKey is missing.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"AclId\\": \\"acl-rj9xpxzcwxrukois****\\",\\n \\"RequestId\\": \\"988CB45E-1643-48C0-87B4-928DDF77EA49\\"\\n}","type":"json"}]',
'title' => '创建访问控制策略组',
'summary' => '创建访问控制策略组。',
'description' => '您可以创建多个访问控制策略组,每个策略组可包含多个IP地址条目或IP地址段条目。访问控制策略组的限制如下:'."\n"
."\n"
.'- 每个地域单账号最多可创建50个访问控制策略组。'."\n"
."\n"
.'- 单账号每次最多可添加50个IP地址或IP地址段条目。'."\n"
."\n"
.'- 每个访问控制策略组最多可添加300个IP地址或IP地址段条目。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddAccessControlListEntry' => [
'summary' => '在访问控制策略组中添加IP条目。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'acl-bp1l0kk4gxce43kze*****',
],
],
[
'name' => 'AclEntrys',
'in' => 'query',
'schema' => [
'description' => '设置访问控制策略组。取值:'."\n"
."\n"
.'* **entry**:访问控制策略组中要添加的IP条目,可以指定IP地址段(CIDR block),多个IP地址段之间用半角逗号(,)隔开。'."\n"
."\n"
.'* **comment**:访问控制策略组备注说明。'."\n"
."\n"
.'>每次最多可添加50个条目,如果添加的IP条目重复,则只会添加一条,其余重复条目会被忽略。IP条目必须是IP地址段。',
'type' => 'string',
'required' => false,
'example' => '[{"entry":"10.0.**.**/24","comment":"privaterule1"},{"entry":"192.168.**.**/16","comment":"privaterule2"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '988CB45E-1643-48C0-87B4-928DDF77EA4',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParam.AclEntryExists',
'errorMessage' => 'The specified aclEntry already exists in the acl.',
],
[
'errorCode' => 'IllegalEntry',
'errorMessage' => 'Entry version is conflict to the acl version.',
],
[
'errorCode' => 'AclEntryIllegal',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidEntry',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.Comment',
'errorMessage' => 'The specified comment is invalid.',
],
[
'errorCode' => 'AclEntryExceedLimit',
'errorMessage' => 'The maximum number of ACL entries is exceeded.',
],
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'Service is unavailable now.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"988CB45E-1643-48C0-87B4-928DDF77EA4\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 988CB45E-1643-48C0-87B4-928DDF77EA4\\n","errorExample":""}]',
'title' => '在访问控制策略组中添加IP条目',
'description' => '每个策略组可包含多个IP地址条目或IP地址段条目,访问控制策略组的条目限制如下:'."\n"
."\n"
.'- 单账号每次可添加的IP地址条目个数:50'."\n"
."\n"
.'- 每个访问控制策略组可包含的条目个数:300',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteAccessControlList' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acl-bp1l0kk4gxce43kz******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '988CB45E-1643-48C0-87B4-928DDF77EA49',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationFailed.AclBindedWithVip',
'errorMessage' => 'The ACL has binded with vip.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"988CB45E-1643-48C0-87B4-928DDF77EA49\\"\\n}","type":"json"}]',
'title' => '删除访问控制策略组',
'summary' => '删除访问控制策略组。',
'description' => '只有当要删除的访问控制策略组没有绑定任何监听时,才可以删除。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetAccessControlListAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acl-bp1l0kk4gxce43k******',
],
],
[
'name' => 'AclName',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'test1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '988CB45E-1643-48C0-87B4-928DDF77EA49',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"988CB45E-1643-48C0-87B4-928DDF77EA49\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 988CB45E-1643-48C0-87B4-928DDF77EA49\\n","errorExample":""}]',
'title' => '修改访问控制策略组的名称',
'summary' => '修改访问控制策略组的名称。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeAccessControlListAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeNodes' => [
'FEATUREslbEDXHGI',
'FEATUREslb3KZE2S',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '要查询的访问控制策略组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acl-bp1ut10zzvh1y8dfs****',
],
],
[
'name' => 'AclEntryComment',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的条目的备注信息。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'Page',
'in' => 'query',
'schema' => [
'description' => '分页查询页码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页查询时每页的行数。最大值:**50**。默认值:**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'example' => 'acl-bp1ut10zzvh1y8dfs****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => 'ACL的标签集合。',
'type' => 'array',
'items' => [
'description' => 'ACL的标签集合。',
'type' => 'object',
'properties' => [
'TagKey' => [
'description' => 'ACL的标签键。',
'type' => 'string',
'example' => 'TestKey',
],
'TagValue' => [
'description' => 'ACL的标签值。',
'type' => 'string',
'example' => 'TestValue',
],
],
],
],
],
],
'AddressIPVersion' => [
'description' => '关联的实例的IP类型。',
'type' => 'string',
'example' => 'ipv4',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C9906A1D-86F7-4C9C-A369-54DA42EF206A',
],
'ResourceGroupId' => [
'description' => '企业资源组ID。',
'type' => 'string',
'example' => 'rg-acfmz3jksig****',
],
'AclName' => [
'description' => '访问控制策略组名称。',
'type' => 'string',
'example' => 'doctest',
],
'AclEntrys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AclEntry' => [
'description' => '访问控制策略组的信息列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AclEntryComment' => [
'description' => '访问控制条目备注。',
'type' => 'string',
'example' => '访问控制条目。',
],
'AclEntryIP' => [
'description' => '访问控制条目IP。',
'type' => 'string',
'example' => '192.168.0.1',
],
],
],
],
],
],
'RelatedListeners' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'RelatedListener' => [
'description' => '该访问控制策略组已绑定的监听列表。',
'type' => 'array',
'items' => [
'description' => '该访问控制策略组已绑定的监听列表。',
'type' => 'object',
'properties' => [
'ListenerPort' => [
'description' => '绑定的监听的前端端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '443',
],
'AclType' => [
'description' => '访问控制的类型:'."\n"
."\n"
.'- **black**:黑名单'."\n"
."\n"
.'- **white**:白名单',
'type' => 'string',
'example' => 'white',
],
'Protocol' => [
'description' => '绑定的监听的协议类型。',
'type' => 'string',
'example' => 'https',
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'example' => 'lb-bp1qpzldlm38bnexl****',
],
],
],
],
],
],
'CreateTime' => [
'description' => '访问控制策略的创建时间,格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2022-08-31T02:49:05Z',
],
'TotalAclEntry' => [
'description' => '访问控制条目总数。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"AclId\\": \\"acl-bp1ut10zzvh1y8dfs****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagKey\\": \\"TestKey\\",\\n \\"TagValue\\": \\"TestValue\\"\\n }\\n ]\\n },\\n \\"AddressIPVersion\\": \\"ipv4\\",\\n \\"RequestId\\": \\"C9906A1D-86F7-4C9C-A369-54DA42EF206A\\",\\n \\"ResourceGroupId\\": \\"rg-acfmz3jksig****\\",\\n \\"AclName\\": \\"doctest\\",\\n \\"AclEntrys\\": {\\n \\"AclEntry\\": [\\n {\\n \\"AclEntryComment\\": \\"访问控制条目。\\",\\n \\"AclEntryIP\\": \\"192.168.0.1\\"\\n }\\n ]\\n },\\n \\"RelatedListeners\\": {\\n \\"RelatedListener\\": [\\n {\\n \\"ListenerPort\\": 443,\\n \\"AclType\\": \\"white\\",\\n \\"Protocol\\": \\"https\\",\\n \\"LoadBalancerId\\": \\"lb-bp1qpzldlm38bnexl****\\"\\n }\\n ]\\n },\\n \\"CreateTime\\": \\"2022-08-31T02:49:05Z\\",\\n \\"TotalAclEntry\\": 200\\n}","errorExample":""},{"type":"xml","example":"\\n acl-bp1ut10zzvh1y8dfs****\\n \\n TestKey\\n TestValue\\n \\n ipv4\\n C9906A1D-86F7-4C9C-A369-54DA42EF206A\\n rg-acfmz3jksig****\\n doctest\\n \\n 访问控制条目。\\n 192.168.0.1\\n \\n \\n 443\\n white\\n https\\n lb-bp1qpzldlm38bnexl****\\n \\n 2022-08-31T02:49:05Z\\n 200\\n","errorExample":""}]',
'title' => '查询访问控制策略组的配置',
'summary' => '查询访问控制策略组的配置。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeAccessControlLists' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'abilityTreeNodes' => [
'FEATUREslbEDXHGI',
'FEATUREslb3KZE2S',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。'."\n"
."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclName',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组名称。访问控制策略组名称。长度限制为1~80个字符,只支持中文、字母、数字和半角句号(.)、短划线(-)、正斜线(/)和下划线(_)。访问控制策略组名称必须为地域内唯一。访问控制策略组名称支持模糊查询。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'rule1',
],
],
[
'name' => 'AddressIPVersion',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组绑定的实例的IP类型。取值:'."\n"
."\n"
.'- **ipv4**:负载均衡实例的IP地址是IPv4类型。'."\n"
."\n"
.'- **ipv6**:负载均衡实例的IP地址是IPv6类型。',
'type' => 'string',
'required' => false,
'example' => 'ipv4',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页查询时每页的行数,最大值:**50**,默认值:**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '列表的页码,默认值:**1**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '企业资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-atstuj3rtop4****',
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。N的取值范围:**1~20**。一旦输入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Value' => [
'description' => '资源的标签值。N的取值范围:**1~20**。一旦输入该值,可以为空字符串。'."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'PageNumber' => [
'description' => '列表的页码,起始值**1**,默认值:**1**。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '分页查询时每页的行数,最大值:**50**,默认值:**10**。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3CB646EF-6147-4566-A9D9-CE8FBE86F971',
],
'TotalCount' => [
'description' => '已创建的访问控制组策略组个数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Count' => [
'description' => '当前页展示的访问控制策略组个数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Acls' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Acl' => [
'description' => '查询到的访问控制策略组列表。',
'type' => 'array',
'items' => [
'description' => '查询到的访问控制策略组列表。',
'type' => 'object',
'properties' => [
'AclId' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'example' => 'acl-bp1l0kk4gxce43k*****',
],
'AddressIPVersion' => [
'description' => '关联的负载均衡实例的IP地址类型。',
'type' => 'string',
'example' => 'ipv4',
],
'AclName' => [
'description' => '访问控制策略组名称。',
'type' => 'string',
'example' => 'rule1',
],
'ResourceGroupId' => [
'description' => '资源组ID。',
'type' => 'string',
'example' => 'rg-jfenfbp1lhl0****',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '访问控制策略组标签列表。取值:是一个Json string,其结构是一个JsonList。',
'type' => 'array',
'items' => [
'description' => '访问控制策略组标签列表。取值:是一个Json string,其结构是一个JsonList。',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '资源的标签值。',
'type' => 'string',
'example' => '1',
],
'TagKey' => [
'description' => '资源的标签键。',
'type' => 'string',
'example' => 'test',
],
],
'example' => '{"Key":"test","Value":"value"}',
],
],
],
],
'CreateTime' => [
'description' => '传统型负载均衡实例的创建时间,格式为:`YYYY-MM-DDThh:mm:ssZ`。',
'type' => 'string',
'example' => '2022-08-31T02:49:05Z',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidResourceGroupId.NotFound',
'errorMessage' => 'The specified ResourceGroupId is not found.',
],
[
'errorCode' => 'LocationServiceTimeout',
'errorMessage' => 'Location service connection timeout. Please try again later.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"3CB646EF-6147-4566-A9D9-CE8FBE86F971\\",\\n \\"TotalCount\\": 1,\\n \\"Count\\": 1,\\n \\"Acls\\": {\\n \\"Acl\\": [\\n {\\n \\"AclId\\": \\"acl-bp1l0kk4gxce43k*****\\",\\n \\"AddressIPVersion\\": \\"ipv4\\",\\n \\"AclName\\": \\"rule1\\",\\n \\"ResourceGroupId\\": \\"rg-jfenfbp1lhl0****\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"TagValue\\": \\"1\\",\\n \\"TagKey\\": \\"test\\"\\n }\\n ]\\n },\\n \\"CreateTime\\": \\"2022-08-31T02:49:05Z\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n 10\\n 3CB646EF-6147-4566-A9D9-CE8FBE86F971\\n 1\\n 1\\n \\n acl-bp1l0kk4gxce43k*****\\n ipv4\\n rule1\\n rg-jfenfbp1lhl0****\\n \\n 1\\n test\\n \\n 2022-08-31T02:49:05Z\\n \\n","errorExample":""}]',
'title' => '查询已创建的访问控制策略组',
'summary' => '查询已创建的访问控制策略组。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveAccessControlListEntry' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AclId',
'in' => 'query',
'schema' => [
'description' => '访问控制策略组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acl-bp1l0kk4gxce43k******',
],
],
[
'name' => 'AclEntrys',
'in' => 'query',
'schema' => [
'description' => '设置访问控制策略组。取值:'."\n"
."\n"
.'* **entry**:访问控制策略组中的IP条目,可以指定IP地址或IP地址段(CIDR block),多个IP地址或地址段之间用半角逗号(,)隔开。'."\n"
."\n"
.'* **comment**:访问控制策略组备注说明。'."\n",
'type' => 'string',
'required' => false,
'example' => '[{"entry":"10.0.10.0/24","comment":"privaterule1"}]',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '988CB45E-1643-48C0-87B4-928DDF77EA49',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'SystemBusy',
'errorMessage' => 'The system is busy.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"988CB45E-1643-48C0-87B4-928DDF77EA49\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 988CB45E-1643-48C0-87B4-928DDF77EA49\\n","errorExample":""}]',
'title' => '删除访问控制策略组中的IP条目',
'summary' => '删除访问控制策略组中的IP条目。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SetListenerAccessControlStatus' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-8vb86hxixo8lvsja8****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1-65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'AccessControlStatus',
'in' => 'query',
'schema' => [
'description' => '是否开启访问控制。取值:'."\n"
."\n"
.'- **open_white_list**:开启白名单访问控制。'."\n"
."\n"
.'- **close**:关闭白名单访问控制。'."\n"
."\n"
.'> 如果开启访问控制后,没有设置白名单则无法访问负载均衡服务。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'open_white_list',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
.'> 相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified',
],
[
'errorCode' => 'OperationFailed.ActionNotSupport',
'errorMessage' => 'The loadbalancer of ipv6 does not support such action.',
],
[
'errorCode' => 'OperationUnsupported.SetAccessControl',
'errorMessage' => 'The singleTunnel/anyTunnel loadbalancer does not support config AccessControlList.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '是否开启指定监听的白名单访问控制',
'summary' => '是否开启指定监听的白名单访问控制。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveListenerWhiteListItem' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'example' => 'lb-8vb86hxixo8lvsja8****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '监听端口。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'SourceItems',
'in' => 'query',
'schema' => [
'description' => '访问控制列表。支持输入IP地址或IP地址段(CIDR block形式),多个IP地址或地址段用逗号(,)分隔。'."\n"
."\n"
.'> 如果所有IP都被删除,则无法访问该监听。',
'type' => 'string',
'required' => true,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
."\n"
.'>相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":"{\\"Code\\":\\"InvalidParameter\\",\\"Message\\":\\"The specified parameter is not valid.\\",\\"HostId\\":\\"slb-pop.aliyuncs.com\\",\\"RequestId\\":\\"0669D684-69D8-408E-A4FA-B9011E0F4E66\\"}"},{"type":"xml","example":"\\n\\n\\t\\tCEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '删除监听白名单中的IP',
'summary' => '删除监听白名单中的IP。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddListenerWhiteListItem' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例所在的地域ID。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。 ',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1o94dp5i6ea*******',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'docRequired' => true,
'maximum' => '65535',
'minimum' => '1',
'example' => '80',
],
],
[
'name' => 'SourceItems',
'in' => 'query',
'schema' => [
'description' => '访问控制列表。'."\n"
."\n"
.'监听的**AccessControlStatus**为**open_white_list**时有效。'."\n"
."\n"
.'支持输入IP地址或IP地址段(CIDR block形式),多个IP地址或地址段用半角逗号(,)分割。'."\n"
."\n"
.'不允许输入**0.0.0.0**或**0.0.0.0/0**。您可以通过调用[SetListenerAccessControlStatus](~~27599~~)接口将**AccessControlStatus**的值设置为**close**来关闭访问控制。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '192.168.XX.XX',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
."\n"
.'>相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CEF72CEB-54B6-4AE8-B225-F876FF7BA984',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified',
],
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'WhiteList is Disabled while Acl is Enabled',
],
[
'errorCode' => 'InvalidAddress',
'errorMessage' => '%s,%s',
],
[
'errorCode' => 'InvalidParameter.SourceItems',
'errorMessage' => '%s.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\"\\n}","errorExample":""},{"type":"xml","example":"\\n CEF72CEB-54B6-4AE8-B225-F876FF7BA984\\n","errorExample":""}]',
'title' => '添加监听访问控制白名单',
'summary' => '添加监听访问控制白名单。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeListenerAccessControlAttribute' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域。'."\n"
."\n"
.'您可以从[地域和可用区](~~40654~~)列表或通过调用[DescribeRegions](~~25609~~)接口查询地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的ID。',
'type' => 'string',
'required' => true,
'example' => 'lb-8vb86hxixo8lvsja8****',
],
],
[
'name' => 'ListenerPort',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的端口。'."\n"
."\n"
.'取值:**1~65535**。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'example' => '80',
],
],
[
'name' => 'ListenerProtocol',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例前端使用的协议。'."\n"
."\n"
.'> 相同端口存在不同协议监听时,此字段必填。',
'type' => 'string',
'required' => false,
'example' => 'https',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'SourceItems' => [
'description' => '访问控制列表。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'AccessControlStatus' => [
'description' => '是否开启访问控制。取值:'."\n"
."\n"
.'- **open_white_list**:开启白名单访问控制功能。'."\n"
."\n"
.'- **close**:关闭访问控制功能。',
'type' => 'string',
'example' => 'open_white_list',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34B540710',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TooManyListeners',
'errorMessage' => 'More than 1 listener is found, please be more specified',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"SourceItems\\": \\"192.168.XX.XX\\",\\n \\"AccessControlStatus\\": \\"open_white_list\\",\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34B540710\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 192.168.XX.XX\\n open_white_list\\n 365F4154-92F6-4AE4-92F8-7FF34B540710\\n","errorExample":""}]',
'title' => '查询监听的白名单配置',
'summary' => '查询监听的白名单配置。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddTags' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1kuzyb******',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '需要添加的Tag列表。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{"TagKey":"Key1","TagValue":"Value1"},{"TagKey":"Key2","TagValue":"Value2"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF34******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter.TagValue',
'errorMessage' => 'The specified tag value is illegal.',
],
[
'errorCode' => 'QuotaExceeded.Tag',
'errorMessage' => 'The number of Tag exceeds the limit.',
],
[
'errorCode' => 'InvalidParameter.TagKey',
'errorMessage' => 'The specified tag key is invalid.',
],
[
'errorCode' => 'MissingParameter.Tags',
'errorMessage' => 'The parameter Tags should not be null.',
],
[
'errorCode' => 'Duplicate.TagKey',
'errorMessage' => 'The Tag.N.Key contain duplicate key.',
],
[
'errorCode' => 'NoPermission.Operator',
'errorMessage' => 'The operator is not permission for this operate.',
],
[
'errorCode' => 'QuotaExceed.TagsPerResource',
'errorMessage' => 'The maximum number of tags for each resource is exceeded.',
],
[
'errorCode' => 'InvalidOperation.ConcurrentModification',
'errorMessage' => 'The resource %s is modified concurrently.',
],
[
'errorCode' => 'InnerRateLimiting',
'errorMessage' => 'Internal service rate limiting, please try again later.',
],
[
'errorCode' => 'SystemError',
'errorMessage' => 'The request processing has failed due to unknow error, exception or failure.',
],
[
'errorCode' => 'InternalInvokeError',
'errorMessage' => 'The request processing has failed due to some unknown error, exception or failure.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF34******\\"\\n}","type":"json"}]',
'title' => '为指定的负载均衡实例添加标签',
'summary' => '为指定的负载均衡实例添加标签。',
'description' => '为指定的负载均衡实例添加标签。'."\n"
."\n"
.'调用该接口时,请注意:'."\n"
."\n"
.'* 每个负载均衡实例最多可绑定10个Tag。'."\n"
."\n"
.'* 单次绑定的标签数最多为5对。'."\n"
."\n"
.'* 一个负载均衡实例下的所有Tag和Key不能重复。'."\n"
."\n"
.'* 当添加的标签与原有标签Key相同,但Value不同时,则覆盖原有的标签。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeTags' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。 ',
'type' => 'string',
'required' => false,
'example' => 'lb-bp1kuzybm******',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '要查询的标签列表。',
'type' => 'string',
'required' => false,
'example' => '[{"TagKey":"Key1","TagValue":"Value1"},{"TagKey":"Key2","TagValue":"Value2"}]',
],
],
[
'name' => 'DistinctKey',
'in' => 'query',
'schema' => [
'description' => '是否为DistinctKey。 '."\n"
."\n"
.'取值:true或false。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
'default' => 'false',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '单页结果数量,接口默认50,最大100。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '50',
'default' => '50',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '实例列表页码,起始值1,默认值1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
'default' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF3******',
],
'PageSize' => [
'description' => '默认50,最大100。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'PageNumber' => [
'description' => '实例列表页码,起始值1,默认值1。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'TotalCount' => [
'description' => '根据过滤条件得到的实例总个数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'TagSets' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagSet' => [
'description' => 'Tag列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '标签Value。',
'type' => 'string',
'example' => 'api',
],
'InstanceCount' => [
'description' => '该标签绑定的实例总数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'TagKey' => [
'description' => '标签Key。',
'type' => 'string',
'example' => 'test',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'NoPermission.Operator',
'errorMessage' => 'The operator is not permission for this operate.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF3******\\",\\n \\"PageSize\\": 50,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 1,\\n \\"TagSets\\": {\\n \\"TagSet\\": [\\n {\\n \\"TagValue\\": \\"api\\",\\n \\"InstanceCount\\": 10,\\n \\"TagKey\\": \\"test\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询已有标签列表',
'summary' => '查询标签列表。',
'description' => '调用该接口时,请注意:'."\n"
."\n"
.'* 允许根据实例ID、Tagkey、Tagvalue等条件查询所有符合条件的Tags。'."\n"
."\n"
.'* 指定的条件为and关系,只有满足所有指定条件的TagSet才会被返回。'."\n"
."\n"
.'* 如果指定了Tagkey而没有指定Tagvalue,就查询所有该Tagkey关联的Tag。'."\n"
."\n"
.'* 不允许用户只指定Tagvalue而不指定Tagkey。'."\n"
."\n"
.'* 若指定了Tagkey/Tagvalue对,则精确匹配该Tag。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ListTagResources' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义,取值:'."\n"
."\n"
.'- **instance**:负载均衡实例。'."\n"
."\n"
.'- **certificate**:证书。'."\n"
."\n"
.'- **acl**:访问控制。'."\n"
."\n"
.'- **listener**:监听。'."\n"
."\n"
.'- **vservergroup**:虚拟服务器组。'."\n"
."\n"
.'- **masterslaveservergroup**:主备服务器组。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'instance',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '是否拥有下一次查询的令牌(Token)。取值:'."\n"
.'- 第一次查询和没有下一次查询时,均无需填写。'."\n"
.'- 如果有下一次查询,取值为上一次API调用返回的NextToken值。',
'type' => 'string',
'required' => false,
'example' => 'caeba0bbb2be03f84eb48b699f0a****',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '资源ID。最多支持添加20个资源。'."\n"
."\n"
.'> **listener**的**ResourceId**取值为**LoadBalancerId\\_监听协议\\_Port**,其中LoadBalancerId为实例ID,port为监听端口。示例:lb\\-bp1qnnvj18yy6h****\\_http\\_80。',
'type' => 'array',
'items' => [
'description' => '资源ID。最多支持添加20个资源。'."\n"
."\n"
.'> **listener**的**ResourceId**取值为**LoadBalancerId\\_监听协议\\_Port**,其中LoadBalancerId为实例ID,port为监听端口。示例:lb\\-bp1qnnvj18yy6h****\\_http\\_80。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp1qnnvj18yy6h****',
],
'required' => false,
'example' => 'lb-bp1qnnvj18yy6h******',
'maxItems' => 51,
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。最多支持添加20个标签键。'."\n"
."\n"
.'一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceDept',
],
'Value' => [
'description' => '资源的标签值。最多支持添加20个标签值。一旦传入该值,不可以为空字符串。'."\n"
."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceJoshua',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 21,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '是否拥有下一次查询的令牌(Token)。取值:'."\n"
.'- 如果**NextToken**为空表示没有下一次查询。'."\n"
.'- 如果**NextToken**有返回值,该取值表示下一次查询开始的令牌。',
'type' => 'string',
'example' => 'caeba0bbb2be03f84eb48b699f0a****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'DE65F6B7-7566-4802-9007-96F2494AC512',
],
'TagResources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagResource' => [
'description' => '绑定标签的资源信息。',
'type' => 'array',
'items' => [
'description' => '绑定标签的资源信息。',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'FinanceJoshua',
],
'ResourceType' => [
'description' => '资源类型。',
'type' => 'string',
'example' => 'instance',
],
'ResourceId' => [
'description' => '资源ID。',
'type' => 'string',
'example' => 'lb-bp16qjewdsunr4****',
],
'TagKey' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'FinanceDept',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TagTypeNotSame',
'errorMessage' => 'The category of tags in the same request must be the same.',
],
[
'errorCode' => 'ResourceNotExist',
'errorMessage' => '%s.',
],
[
'errorCode' => 'QueryTokenNotExist',
'errorMessage' => 'The specified NextToken does not exist.',
],
[
'errorCode' => 'InvalidParam.NextToken',
'errorMessage' => 'The specified NextToken is invalid.',
],
[
'errorCode' => 'InvalidParam.Scope',
'errorMessage' => 'The specified Scope is invalid.',
],
[
'errorCode' => 'InvalidParam.ResourceType',
'errorMessage' => 'The specified ResourceType is invalid.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => 'The specified TagKey is invalid.',
],
[
'errorCode' => 'InvalidParam.TagValue',
'errorMessage' => 'The specified TagValue is invalid.',
],
[
'errorCode' => 'InvalidParam.TagKeyOrValue',
'errorMessage' => 'The specified TagKey or TagValue is invalid.',
],
[
'errorCode' => 'InvalidParam.TagOwnerUid',
'errorMessage' => 'The specified TagOwnerUid is invalid.',
],
[
'errorCode' => 'InvalidParam.TagOwnerBid',
'errorMessage' => 'The specified TagOwnerBid is invalid.',
],
[
'errorCode' => 'MissingParam.Scope',
'errorMessage' => 'The parameter Scope is required.',
],
[
'errorCode' => 'MissingParam.TagOwnerUid',
'errorMessage' => 'The parameter TagOwnerUid is required.',
],
[
'errorCode' => 'MissingParam.TagOwnerBid',
'errorMessage' => 'The parameter TagOwnerBid is required.',
],
[
'errorCode' => 'InvalidParameter.RegionId',
'errorMessage' => 'The specified RegionId does not exist.',
],
[
'errorCode' => 'MissingParam.TagOrResourceId',
'errorMessage' => 'The parameter Tag or ResourceId is required at least one.',
],
[
'errorCode' => 'SizeLimitExceeded.ResourceId',
'errorMessage' => 'The maximum size of ResourceId is exceeded.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => 'The maximum size of Tag is exceeded.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"NextToken\\": \\"caeba0bbb2be03f84eb48b699f0a****\\",\\n \\"RequestId\\": \\"DE65F6B7-7566-4802-9007-96F2494AC512\\",\\n \\"TagResources\\": {\\n \\"TagResource\\": [\\n {\\n \\"TagValue\\": \\"FinanceJoshua\\",\\n \\"ResourceType\\": \\"instance\\",\\n \\"ResourceId\\": \\"lb-bp16qjewdsunr4****\\",\\n \\"TagKey\\": \\"FinanceDept\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n caeba0bbb2be03f84eb48b699f0a****\\n DE65F6B7-7566-4802-9007-96F2494AC512\\n \\n FinanceJoshua\\n instance\\n lb-bp16qjewdsunr4****\\n FinanceDept\\n \\n","errorExample":""}]',
'title' => '查询实例已绑定的标签列表',
'summary' => '查询实例已经绑定的标签列表。',
'description' => '- 请求中至少指定参数**ResourceId.N**或**Tag.N**(**Tag.N.Key**与**Tag.N.Value**),以确定检索对象。'."\n"
."\n"
.'- **Tag.N**是资源的标签,由一个键值对组成。仅指定**Tag.N.Key**时,则返回该标签键关联的所有标签值。仅指定**Tag.N.Value**会报错。'."\n"
."\n"
.'- 如果您同时指定**Tag.N**和**ResourceId.N**筛选标签,则**ResourceId.N**必须满足所有输入的标签键值对。'."\n"
."\n"
.'- 如果您同时指定多个标签键值对,返回结果为同时包含被指定的多个键值对的资源。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'TagResources' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例所在的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义,取值:'."\n"
."\n"
.'- **instance**:负载均衡实例。'."\n"
."\n"
.'- **certificate**:证书。'."\n"
."\n"
.'- **acl**:访问控制。'."\n"
."\n"
.'- **listener**:监听。'."\n"
."\n"
.'- **vservergroup**:虚拟服务器组。'."\n"
."\n"
.'- **masterslaveservergroup**:主备服务器组。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'instance',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '资源ID,最多支持20个资源ID。'."\n"
.'> **listener**的**ResourceId**取值为**LoadBalancerId\\_监听协议\\_Port**,其中LoadBalancerId为实例ID,port为监听端口。示例:lb\\-bp1snb10sbml4****\\_http\\_80。',
'type' => 'array',
'items' => [
'description' => '资源ID,最多支持20个资源ID。'."\n"
.'> **listener**的**ResourceId**取值为**LoadBalancerId\\_监听协议\\_Port**,其中LoadBalancerId为实例ID,port为监听端口。示例:lb\\-bp1snb10sbml4****\\_http\\_80。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp16qjewdsunr41m1****',
],
'required' => true,
'example' => 'lb-bp16qjewdsunr41m1****',
'maxItems' => 51,
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '资源的标签键。最多支持20个标签键。一旦传入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceDept',
],
'Value' => [
'description' => '资源的标签值。最多支持20个标签值。一旦传入该值,可以为空字符串。'."\n"
."\n"
.'最多支持128个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。',
'type' => 'string',
'required' => false,
'example' => 'FinanceJoshua',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 21,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C46FF5A8-C5F0-4024-8262-B16B639225A0',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TagTypeNotSame',
'errorMessage' => 'The category of tags in the same request must be the same.',
],
[
'errorCode' => 'ResourceNotExist',
'errorMessage' => '%s.',
],
[
'errorCode' => 'DeniedForNoneTagCreator',
'errorMessage' => '%s.',
],
[
'errorCode' => 'DeniedForScopeNotEqual',
'errorMessage' => '%s.',
],
[
'errorCode' => 'QuotaLimitExceeds',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.Scope',
'errorMessage' => 'The specified Scope is invalid.',
],
[
'errorCode' => 'InvalidParam.ResourceType',
'errorMessage' => 'The specified ResourceType is invalid.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => 'The specified TagKey is invalid.',
],
[
'errorCode' => 'InvalidParam.TagValue',
'errorMessage' => 'The specified TagValue is invalid.',
],
[
'errorCode' => 'InvalidParam.TagKeyOrValue',
'errorMessage' => 'The specified TagKey or TagValue is invalid.',
],
[
'errorCode' => 'InvalidParam.TagOwnerUid',
'errorMessage' => 'The specified TagOwnerUid is invalid.',
],
[
'errorCode' => 'InvalidParam.TagOwnerBid',
'errorMessage' => 'The specified TagOwnerBid is invalid.',
],
[
'errorCode' => 'MissingParam.TagKey',
'errorMessage' => 'The parameter TagKey is required.',
],
[
'errorCode' => 'MissingParam.Scope',
'errorMessage' => 'The parameter Scope is required.',
],
[
'errorCode' => 'MissingParam.TagOwnerUid',
'errorMessage' => 'The parameter TagOwnerUid is required.',
],
[
'errorCode' => 'MissingParam.TagOwnerBid',
'errorMessage' => 'The parameter TagOwnerBid is required.',
],
[
'errorCode' => 'InvalidParameter.RegionId',
'errorMessage' => 'The specified RegionId does not exist.',
],
[
'errorCode' => 'DeniedForOperateCustomTag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'MissingParam.ResourceId',
'errorMessage' => 'The parameter ResourceId is required.',
],
[
'errorCode' => 'Duplicate.TagKey',
'errorMessage' => 'The param TagKey has duplicate value.',
],
[
'errorCode' => 'SizeLimitExceeded.ResourceId',
'errorMessage' => 'The maximum size of ResourceId is exceeded.',
],
[
'errorCode' => 'SizeLimitExceeded.Tag',
'errorMessage' => 'The maximum size of Tag is exceeded.',
],
[
'errorCode' => 'MissingParam.RegionId',
'errorMessage' => 'The parameter RegionId is required.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C46FF5A8-C5F0-4024-8262-B16B639225A0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n C46FF5A8-C5F0-4024-8262-B16B639225A0\\n","errorExample":""}]',
'title' => '给资源添加标签',
'summary' => '为指定的资源列表统一创建并绑定标签。',
'description' => '> 单个实例最多可绑定20条标签。绑定标签前,阿里云会校验资源已有标签数量,超过限制值会返回报错信息。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'UntagResources' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口查询地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义,取值:'."\n"
."\n"
.'- **instance**:负载均衡实例。'."\n"
."\n"
.'- **certificate**:证书。'."\n"
."\n"
.'- **acl**:访问控制。'."\n"
."\n"
.'- **listener**:监听。'."\n"
."\n"
.'- **vservergroup**:虚拟服务器组。'."\n"
."\n"
.'- **masterslaveservergroup**:主备服务器组。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'instance',
],
],
[
'name' => 'All',
'in' => 'query',
'schema' => [
'description' => '是否全部删除,只针对**TagKey.N**为空时有效。'."\n"
."\n"
.'取值:**true**或**false**。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
'default' => 'false',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '资源ID,最多支持20个资源ID。'."\n"
.'> **listener**的**ResourceId**取值为**LoadBalancerId\\_监听协议\\_Port**,其中LoadBalancerId为实例ID,port为监听端口。',
'type' => 'array',
'items' => [
'description' => '资源ID,最多支持20个资源ID。'."\n"
.'> **listener**的**ResourceId**取值为**LoadBalancerId\\_监听协议\\_Port**,其中LoadBalancerId为实例ID,port为监听端口。示例:lb\\-bp1snb10sbml4****\\_http\\_80。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp16qjewdsunr41m1****',
],
'required' => true,
'example' => 'lb-bp16qjewdsunr41m1****',
'maxItems' => 51,
],
],
[
'name' => 'TagKey',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '资源的标签键。最多支持20个标签键。一旦传入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。'."\n"
.'> 如果不指定**TagKey**,这个实例的所有标签将被删除。',
'type' => 'array',
'items' => [
'description' => '资源的标签键。最多支持20个标签键。一旦传入该值,则不允许为空字符串。'."\n"
."\n"
.'最多支持64个字符,不能以`aliyun`和`acs:`开头,不能包含`http://`或者`https://`。'."\n"
.'> 如果不指定**TagKey**,这个实例的所有标签将被删除。',
'type' => 'string',
'required' => false,
'example' => 'FinanceDept',
],
'required' => false,
'example' => 'FinanceDept',
'maxItems' => 21,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C46FF5A8-C5F0-4024-8262-B16B******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'TagTypeNotSame',
'errorMessage' => 'The category of tags in the same request must be the same.',
],
[
'errorCode' => 'ResourceNotExist',
'errorMessage' => '%s.',
],
[
'errorCode' => 'DeniedForNoneTagCreator',
'errorMessage' => '%s.',
],
[
'errorCode' => 'DeniedForScopeNotEqual',
'errorMessage' => '%s.',
],
[
'errorCode' => 'InvalidParam.ResourceType',
'errorMessage' => 'The specified ResourceType is invalid.',
],
[
'errorCode' => 'InvalidParam.TagKey',
'errorMessage' => 'The specified TagKey is invalid.',
],
[
'errorCode' => 'InvalidParam.TagValue',
'errorMessage' => 'The specified TagValue is invalid.',
],
[
'errorCode' => 'InvalidParam.TagKeyOrValue',
'errorMessage' => 'The specified TagKey or TagValue is invalid.',
],
[
'errorCode' => 'InvalidParam.TagOwnerUid',
'errorMessage' => 'The specified TagOwnerUid is invalid.',
],
[
'errorCode' => 'InvalidParam.TagOwnerBid',
'errorMessage' => 'The specified TagOwnerBid is invalid.',
],
[
'errorCode' => 'MissingParam.TagOwnerUid',
'errorMessage' => 'The parameter TagOwnerUid is required.',
],
[
'errorCode' => 'MissingParam.TagOwnerBid',
'errorMessage' => 'The parameter TagOwnerBid is required.',
],
[
'errorCode' => 'InvalidParameter.RegionId',
'errorMessage' => 'The specified RegionId does not exist.',
],
[
'errorCode' => 'MissingParam.ResourceId',
'errorMessage' => 'The parameter ResourceId is required.',
],
[
'errorCode' => 'DeniedForOperateCustomTag',
'errorMessage' => '%s.',
],
[
'errorCode' => 'Duplicate.TagKey',
'errorMessage' => 'The param TagKey has duplicate value.',
],
[
'errorCode' => 'SizeLimitExceeded.ResourceId',
'errorMessage' => 'The maximum size of ResourceId is exceeded.',
],
[
'errorCode' => 'SizeLimitExceeded.TagKey',
'errorMessage' => 'The maximum size of TagKey is exceeded.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C46FF5A8-C5F0-4024-8262-B16B******\\"\\n}","errorExample":""},{"type":"xml","example":"\\n C46FF5A8-C5F0-4024-8262-B16B639225A0\\n","errorExample":""}]',
'title' => '为指定的资源列表统一解绑标签',
'summary' => '为指定的资源列表统一解绑标签。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveTags' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例所属地域的ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)获取地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-bp1l5j******',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '需要解绑的Tag列表。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{"TagKey":"Key1","TagValue":"Value1"},{"TagKey":"Key2","TagValue":"Value2"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '365F4154-92F6-4AE4-92F8-7FF3******',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter.TagKey',
'errorMessage' => 'The specified tag key is invalid.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"365F4154-92F6-4AE4-92F8-7FF3******\\"\\n}","type":"json"}]',
'title' => '解绑指定负载均衡实例下的标签',
'summary' => '解绑指定负载均衡实例下的标签。',
],
'DeleteAccessLogsDownloadAttribute' => [
'summary' => '删除指定传统型负载均衡实例的访问日志。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例绑定的标签列表,其结构是一个JSON dictionary,包含标签键和标签值。',
'type' => 'string',
'required' => false,
'example' => '[{"tagKey":"Key1","tagValue":"Value1"}]',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => false,
'example' => 'lb-uf68ps3rekbljmdb0****',
],
],
[
'name' => 'LogsDownloadAttributes',
'in' => 'query',
'schema' => [
'description' => '访问日志转发规则。组成参数:'."\n"
."\n"
.'- **LogProject**:日志服务LogProject的名称。'."\n"
.'- **LogStore**:日志服务LogStore的名称。'."\n"
.'- **LoadBalancerId**:传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{"logProject":"my-project", "LogStore":"my-log-store", "LoadBalancerId":"lb-uf68ps3rekbljmdb0****"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9C****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'The AccessLogDownloadAttribute not exists.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9C****\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9C****\\n","errorExample":""}]',
'title' => '删除访问日志下载任务',
],
'SetAccessLogsDownloadAttribute' => [
'summary' => '为传统型负载均衡实例添加访问日志转发规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例绑定的标签列表,其结构是一个JSON dictionary,包含标签键和标签值。'."\n"
."\n"
.'一次请求中,绑定的标签列表中最多支持10个标签。',
'type' => 'string',
'required' => false,
'example' => '[{"tagKey":"Key1","tagValue":"Value1"}]',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp1b6c719dfa08ex*****',
],
],
[
'name' => 'LogsDownloadAttributes',
'in' => 'query',
'schema' => [
'description' => '访问日志转发规则。组成参数:'."\n"
."\n"
.'- **LogProject**:日志服务LogProject的名称。'."\n"
.'- **LogStore**:日志服务LogStore的名称。'."\n"
.'- **LoadBalancerId**:传统型负载均衡实例ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '[{"logProject":"my-project", "LogStore":"my-log-store", "LoadBalancerId":"lb-uf68ps3rekbljmdb0****"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9DEC9C28-AB05-4DDF-9A78-6B08EC9C****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'Operation.NotAllowed',
'errorMessage' => 'The AccessLogDownloadAttribute already exists.',
],
[
'errorCode' => 'InvalidProject.NotExist',
'errorMessage' => 'The specified project does not exist.',
],
[
'errorCode' => 'NoPermission.AliyunServiceRoleForSlbLogDelivery',
'errorMessage' => 'You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForSlbLogDelivery. Service Name: logdelivery.slb.aliyuncs.com. Please ensure the user has been granted the ram:CreateServiceLinkedRole permission',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9DEC9C28-AB05-4DDF-9A78-6B08EC9C****\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9DEC9C28-AB05-4DDF-9A78-6B08EC9C****\\n","errorExample":""}]',
'title' => '修改访问日志的下载配置',
],
'DescribeAccessLogsDownloadAttribute' => [
'summary' => '查询指定传统型负载均衡实例的访问日志。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例绑定的标签列表,其结构是一个JSON dictionary,包含标签键和标签值。'."\n"
."\n"
.'一次请求中,绑定的标签列表中最多支持10个标签。',
'type' => 'string',
'required' => false,
'example' => '[{"tagKey":"Key1","tagValue":"Value1"}]',
],
],
[
'name' => 'LoadBalancerId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'required' => false,
'example' => 'lb-bp1b6c719dfa08ex*****',
],
],
[
'name' => 'LogType',
'in' => 'query',
'schema' => [
'description' => '访问日志类型。仅取值**layer7**,表示七层访问日志。',
'type' => 'string',
'required' => false,
'example' => 'layer7',
'default' => 'layer7',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '列表的页码。默认值:**1**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'minimum' => '1',
'example' => '1',
'default' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页查询时每页的行数。最大值:**50**。默认值:**10**。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'maximum' => '50',
'minimum' => '1',
'example' => '10',
'default' => '20',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'PageSize' => [
'description' => '分页查询时每页的行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'PageNumber' => [
'description' => '列表的页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E',
],
'TotalCount' => [
'description' => '列表条目数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'LogsDownloadAttributes' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'LogsDownloadAttribute' => [
'description' => '访问日志配置信息。',
'type' => 'array',
'items' => [
'description' => '访问日志配置信息。',
'type' => 'object',
'properties' => [
'LogProject' => [
'description' => '日志服务LogProject的名称。',
'type' => 'string',
'example' => 'test-log-project',
],
'LogStore' => [
'description' => '日志服务LogStore的名称。',
'type' => 'string',
'example' => 'test-log-store',
],
'LoadBalancerId' => [
'description' => '传统型负载均衡实例的ID。',
'type' => 'string',
'example' => 'lb-bp1b6c719dfa08ex*****',
],
'Region' => [
'description' => '传统型负载均衡实例所在的地域ID。 ',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'LogType' => [
'description' => '访问日志类型。仅取值**layer7**,表示七层访问日志。'."\n",
'type' => 'string',
'example' => 'layer7',
],
],
],
],
],
],
],
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"PageSize\\": 10,\\n \\"PageNumber\\": 1,\\n \\"RequestId\\": \\"8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E\\",\\n \\"TotalCount\\": 10,\\n \\"LogsDownloadAttributes\\": {\\n \\"LogsDownloadAttribute\\": [\\n {\\n \\"LogProject\\": \\"test-log-project\\",\\n \\"LogStore\\": \\"test-log-store\\",\\n \\"LoadBalancerId\\": \\"lb-bp1b6c719dfa08ex*****\\",\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"LogType\\": \\"layer7\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 10\\n 1\\n 8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E\\n 10\\n \\n test-log-project\\n test-log-store\\n lb-bp1b6c719dfa08ex*****\\n cn-hangzhou\\n layer7\\n \\n","errorExample":""}]',
'title' => '查询指定实例的访问日志',
],
'EnableHighDefinationMonitor' => [
'summary' => '启用当前地域的秒级监控功能。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '88622',
'abilityTreeNodes' => [
'FEATUREslbSG7ZOW',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '日志标签。其结构是一个JSON dictionary,包含标签键和标签值。',
'type' => 'string',
'required' => false,
'example' => '[{"tagKey":"Key1","tagValue":"Value1"}]',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡的地域ID。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LogProject',
'in' => 'query',
'schema' => [
'description' => '日志服务LogProject的名称。长度为4~63个字符,支持数字、小写字母,可包含短划线(-),开头和结尾必须为数字或字母。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'my-project',
],
],
[
'name' => 'LogStore',
'in' => 'query',
'schema' => [
'description' => '日志服务LogStore的名称。长度为2~64个字符,支持数字、小写字母,可包含短划线(-)和下划线(_),开头和结尾必须为数字或字母。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'my-log-store',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Success' => [
'description' => '本次调用是否成功。取值:'."\n"
."\n"
.'- **true**:成功。'."\n"
.'- **false**:失败。',
'type' => 'string',
'example' => 'true',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '2F398FF5-B349-5C01-8638-8E9A0BF1DBE6',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationNotAllowed.HighDefinitionMonitorEnabled',
'errorMessage' => 'The operation is not allowed because HighDefinitionMonitor is already enabled in this region.',
],
[
'errorCode' => 'UnsupportedFeature.User',
'errorMessage' => 'The feature of HighDefinationMonitor is not supported.',
],
[
'errorCode' => 'NoPermission.AliyunServiceRoleForSlbLogDelivery',
'errorMessage' => 'You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForSlbLogDelivery. Service Name: logdelivery.slb.aliyuncs.com. Please ensure the user has been granted the ram:CreateServiceLinkedRole permission',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Success\\": \\"true\\",\\n \\"RequestId\\": \\"2F398FF5-B349-5C01-8638-8E9A0BF1DBE6\\"\\n}","errorExample":""},{"type":"xml","example":"\\n true\\n 2F398FF5-B349-5C01-8638-8E9A0BF1DBE6\\n","errorExample":""}]',
'title' => '开启实例的秒级监控',
],
'ModifyHighDefinationMonitor' => [
'summary' => '修改高精度秒级监控的配置信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '121167',
'abilityTreeNodes' => [
'FEATUREslbSG7ZOW',
],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '传统型负载均衡实例所在的地域ID。 '."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'LogProject',
'in' => 'query',
'schema' => [
'description' => '修改后的日志服务LogProject的名称。日志服务LogProject的名称。长度为4~63个字符,支持数字、小写字母,可包含短划线(-),开头和结尾必须为数字或字母。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'my-project',
],
],
[
'name' => 'LogStore',
'in' => 'query',
'schema' => [
'description' => '修改后的日志服务LogStore的名称。长度为2~64个字符,支持数字、小写字母,可包含短划线(-)和下划线(_),开头和结尾必须为数字或字母。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'my-log-store',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Success' => [
'description' => '本次调用是否成功。取值:'."\n"
."\n"
.'- **true**:成功。'."\n"
.'- **false**:失败。',
'type' => 'string',
'example' => 'true',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'OperationNotAllowed.HighDefinitionMonitorEnabled',
'errorMessage' => 'The operation is not allowed because HighDefinitionMonitor is already enabled in this region.',
],
[
'errorCode' => 'UnsupportedFeature.User',
'errorMessage' => 'The feature of HighDefinationMonitor is not supported.',
],
[
'errorCode' => 'NoPermission.AliyunServiceRoleForSlbLogDelivery',
'errorMessage' => 'You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForSlbLogDelivery. Service Name: logdelivery.slb.aliyuncs.com. Please ensure the user has been granted the ram:CreateServiceLinkedRole permission',
],
[
'errorCode' => 'OperationDenied.HdMonitorListenerExist',
'errorMessage' => 'The operation is denied because there are still listeners enabling HighDefinitionMnitor.',
],
[
'errorCode' => 'OperationNotAllowed.HighDefinitionMonitorNotEnabled',
'errorMessage' => 'The operation is not allowed because HighDefinitionMonitor is not enabled in this region.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Success\\": \\"true\\",\\n \\"RequestId\\": \\"8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E\\"\\n}","errorExample":""},{"type":"xml","example":"\\n true\\n 8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E\\n","errorExample":""}]',
'title' => '修改秒级监控配置信息',
],
'DescribeHighDefinationMonitor' => [
'summary' => '查询指定地域的秒级监控配置信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
],
'parameters' => [
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => '日志标签。其结构是一个JSON dictionary,包含标签键和标签值。',
'type' => 'string',
'required' => false,
'example' => '[{"tagKey":"Key1","tagValue":"Value1"}]',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '需要查询秒级监控信息的地域ID。'."\n"
."\n"
.'您可以通过调用[DescribeRegions](~~27584~~)接口获取地域ID。 ',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'LogProject' => [
'description' => '日志服务LogProject的名称。',
'type' => 'string',
'example' => 'my-project',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '2F398FF5-B349-5C01-8638-8E9A0BF1DBE6',
],
'LogStore' => [
'description' => '日志服务LogStore的名称。',
'type' => 'string',
'example' => 'my-log-store',
],
'Success' => [
'description' => '本次调用是否成功。取值:'."\n"
."\n"
.'- **true**:成功。'."\n"
.'- **false**:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"LogProject\\": \\"my-project\\",\\n \\"RequestId\\": \\"2F398FF5-B349-5C01-8638-8E9A0BF1DBE6\\",\\n \\"LogStore\\": \\"my-log-store\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n my-project\\n 2F398FF5-B349-5C01-8638-8E9A0BF1DBE6\\n my-log-store\\n true\\n","errorExample":""}]',
'title' => '查询实例业务运行监控数据',
],
'MoveResourceGroup' => [
'summary' => '修改云资源所属的资源组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
'abilityTreeCode' => '88639',
'abilityTreeNodes' => [
'FEATUREslbPXSOQX',
],
],
'parameters' => [
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '负载均衡实例的地域ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cn-beijing',
],
],
[
'name' => 'ResourceId',
'in' => 'query',
'schema' => [
'description' => '需要修改资源组的目标资源的ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'lb-uf6ghek7ds2btzt65****',
],
],
[
'name' => 'ResourceType',
'in' => 'query',
'schema' => [
'description' => '资源类型定义,取值:'."\n"
."\n"
.'- **loadbalancer**:传统型负载均衡实例。'."\n"
."\n"
.'- **certificate**:证书。'."\n"
."\n"
.'- **acl**:访问控制。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'enumValueTitles' => [
'loadbalancer' => 'loadbalancer',
'certificate' => 'certificate',
'acl' => 'acl',
],
'example' => 'loadbalancer',
],
],
[
'name' => 'NewResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '新资源组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rg-aek2rpsek5h****',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '资源组ID。',
'type' => 'string',
'required' => false,
'example' => 'rg-aek2dmxj56z****',
],
],
[
'name' => 'access_key_id',
'in' => 'query',
'schema' => [
'description' => '阿里云颁发给用户的访问服务所用的密钥ID。',
'type' => 'string',
'required' => false,
'example' => 'yourAccessKeyID',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '18CAE30A-79CF-544C-86DB-EB36C739642E',
],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"18CAE30A-79CF-544C-86DB-EB36C739642E\\"\\n}","type":"json"}]',
'title' => '修改资源组',
],
],
'endpoints' => [
[
'regionId' => 'cn-qingdao',
'endpoint' => 'slb.cn-qingdao.aliyuncs.com',
],
[
'regionId' => 'cn-beijing',
'endpoint' => 'slb.cn-beijing.aliyuncs.com',
],
[
'regionId' => 'cn-zhangjiakou',
'endpoint' => 'slb.cn-zhangjiakou.aliyuncs.com',
],
[
'regionId' => 'cn-zhengzhou-jva',
'endpoint' => 'slb.cn-zhengzhou-jva.aliyuncs.com',
],
[
'regionId' => 'cn-huhehaote',
'endpoint' => 'slb.cn-huhehaote.aliyuncs.com',
],
[
'regionId' => 'cn-wulanchabu',
'endpoint' => 'slb.cn-wulanchabu.aliyuncs.com',
],
[
'regionId' => 'cn-hangzhou',
'endpoint' => 'slb.aliyuncs.com',
],
[
'regionId' => 'cn-shanghai',
'endpoint' => 'slb.cn-shanghai.aliyuncs.com',
],
[
'regionId' => 'cn-nanjing',
'endpoint' => 'slb.cn-nanjing.aliyuncs.com',
],
[
'regionId' => 'cn-fuzhou',
'endpoint' => 'slb.cn-fuzhou.aliyuncs.com',
],
[
'regionId' => 'cn-shenzhen',
'endpoint' => 'slb.cn-shenzhen.aliyuncs.com',
],
[
'regionId' => 'cn-heyuan',
'endpoint' => 'slb.cn-heyuan.aliyuncs.com',
],
[
'regionId' => 'cn-guangzhou',
'endpoint' => 'slb.cn-guangzhou.aliyuncs.com',
],
[
'regionId' => 'cn-chengdu',
'endpoint' => 'slb.cn-chengdu.aliyuncs.com',
],
[
'regionId' => 'cn-wuhan-lr',
'endpoint' => 'slb.cn-wuhan-lr.aliyuncs.com',
],
[
'regionId' => 'cn-hongkong',
'endpoint' => 'slb.cn-hongkong.aliyuncs.com',
],
[
'regionId' => 'ap-northeast-1',
'endpoint' => 'slb.ap-northeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-northeast-2',
'endpoint' => 'slb.ap-northeast-2.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-1',
'endpoint' => 'slb.ap-southeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-2',
'endpoint' => 'slb.ap-southeast-2.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-3',
'endpoint' => 'slb.ap-southeast-3.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-5',
'endpoint' => 'slb.ap-southeast-5.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-6',
'endpoint' => 'slb.ap-southeast-6.aliyuncs.com',
],
[
'regionId' => 'us-east-1',
'endpoint' => 'slb.us-east-1.aliyuncs.com',
],
[
'regionId' => 'us-west-1',
'endpoint' => 'slb.us-west-1.aliyuncs.com',
],
[
'regionId' => 'eu-west-1',
'endpoint' => 'slb.eu-west-1.aliyuncs.com',
],
[
'regionId' => 'eu-central-1',
'endpoint' => 'slb.eu-central-1.aliyuncs.com',
],
[
'regionId' => 'ap-south-1',
'endpoint' => 'slb.ap-south-1.aliyuncs.com',
],
[
'regionId' => 'me-east-1',
'endpoint' => 'slb.me-east-1.aliyuncs.com',
],
[
'regionId' => 'cn-hangzhou-finance',
'endpoint' => 'slb.aliyuncs.com',
],
[
'regionId' => 'cn-shanghai-finance-1',
'endpoint' => 'slb.aliyuncs.com',
],
[
'regionId' => 'cn-shenzhen-finance-1',
'endpoint' => 'slb.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-7',
'endpoint' => 'slb.ap-southeast-7.aliyuncs.com',
],
[
'regionId' => 'cn-beijing-finance-1',
'endpoint' => 'slb.cn-beijing-finance-1.aliyuncs.com',
],
[
'regionId' => 'me-central-1',
'endpoint' => 'slb.me-central-1.aliyuncs.com',
],
[
'regionId' => 'cn-heyuan-acdr-1',
'endpoint' => 'slb.cn-heyuan-acdr-1.aliyuncs.com',
],
[
'regionId' => 'na-south-1',
'endpoint' => 'slb.na-south-1.aliyuncs.com',
],
],
];