CreateEndpointGroups_全球加速_API文档-阿里云OpenAPI开发者门户

接口说明

本接口用于批量创建终端节点组，但不支持同时创建默认终端节点组与虚拟终端节点组。
本接口不支持为四层协议监听创建虚拟终端节点组。如需为四层协议监听创建虚拟终端节点组，请使用 CreateEndpointGroup 。
CreateEndpointGroups 接口属于异步接口，即系统会先返回一个请求 ID，但终端节点组并未批量创建完成，系统后台的创建任务仍在进行。您可以调用 DescribeEndpointGroup 或 ListEndpointGroups 查询终端节点组的状态：
- 当存在终端节点组处于 init 状态时，表示终端节点组正在批量创建中，在该状态下，您只能执行查询操作，不能执行其他操作。
- 当所有终端节点组处于 active 状态时，表示终端节点组批量创建完成。
CreateEndpointGroups 接口不支持在同一个全球加速实例内并发创建终端节点组。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ga:CreateEndpointGroups	Create	EndpointGroup acs:ga:{#regionId}:{#accountId}:endpointgroup/* Accelerator acs:ga:{#regionId}:{#accountId}:ga/{#acceleratorId} Listener acs:ga:{#regionId}:{#accountId}:listener/{#listenerId}	ga:AcceleratorMainland	无

请求参数

字段名称	字段详情
RegionIdstring	全球加速实例所属地域 ID，仅取值cn-hangzhou。示例值:cn-hangzhou
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:1F4B6A4A-C89E-489E-BAF1-52777EE148EF
DryRunboolean	是否只预检此次请求，取值：展开详情示例值:true
AcceleratorIdstring	全球加速实例 ID。示例值:ga-bp1odcab8tmno0hdq****参考取值来源: ListAccelerators CreateAccelerator UpdateAcceleratorAutoRenewAttribute
ListenerIdstring	监听 ID。展开详情示例值:lsr-bp1bpn0kn908w4nbw****参考取值来源: ListListeners CreateListener AssociateAclsWithListener DissociateAclsFromListener
EndpointGroupConfigurationsarray<object>	终端节点组信息。展开详情子级条数 <= 200

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:6FEA0CF3-D3B9-43E5-A304-D217037876A8
EndpointGroupIdsarray<string>	终端节点组 ID 列表。

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Domain.NotFit	The domain is not fit the rule	诊断
400	Resource.QuotaFull	The resource quota is exceeded.	诊断
400	NoPermission.EnableHealthCheck	You do not have permission to enable health check.	诊断
400	NotSupportHealthCheck.Accelerator	Currently Accelerator does not support health check.	诊断
400	EndpointGroupExclusive.Listener	All endpoint group must under the same listener.	诊断
400	RegionConflict.EndpointGroup	Endpoint group under the same listener must have different region.	诊断
400	ListenerProtocolIllegal.EndpointGroup	Listener protocol is illegal, the https/http listener instance is only allowed to have one default endpoint group.	诊断
400	QuotaExceeded.EndpointGroup	The number of endpoint group exceeds the limit.	诊断
400	ParamExclusive.EndpointGroupType	All endpoint group type group must be consistent.	诊断
400	HealthCheckPath.Illegal	Health check path illegal.	诊断
400	NotExist.Listener	The listener does not exist.	诊断
400	NotActive.Listener	The state of the listener is not active.	诊断
400	NotExist.Accelerator	The accelerated instance does not exist.	诊断
400	StateError.Accelerator	The state of the accelerated instance is invalid.	诊断
400	NotExist.BusinessRegion	The business region does not exist.	诊断
400	NotExist.BasicBandwidthPackage	You must specify the basic bandwidth package.	诊断
400	QuotaExceeded.EndPoint	The maximum number of endpoints is exceeded.	诊断
400	NoPermission.VpcEndpoint	You are not authorized to perform the operation.	诊断
400	EndPointRequestProtocolIllegal.EndpointGroup	endpoint group request protoco is illegal	诊断
400	QuotaExceeded.PortOverride	The number of port override exceeds the limit.	诊断
400	NotExist.ListenerPort	listener port %s is not exist	诊断
400	MixedVpc.EndPoint	VPC Endpoint cannot be mixed with other types of Endpoints.	诊断
400	IllegalPublicIp.EndPoint	The public IP address configured for the endpoint is invalid. Only an Alibaba Cloud public IP address in the region of the endpoint can be configured.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-12-23	变更请求参数EndpointGroupConfigurations
	2024-07-19	变更请求参数EndpointGroupConfigurations
	2024-04-22	变更请求参数EndpointGroupConfigurations
	2023-10-27	变更请求参数EndpointGroupConfigurations
	2023-09-14	变更请求参数EndpointGroupConfigurations
	2023-04-13	变更错误码400

CreateEndpointGroups_全球加速_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例