# Alibaba Cloud Edge Node Service API

> Alibaba Cloud Edge Node Service API on Apizie: 322 endpoints (Calls the AccosicateNetworkAcl operation to attach a network ACL to a network, Adds backend servers, Adds an IPv6 network interface controller (NIC). A public IP address is automatically assigned at the same…, Adds an elastic IP address (EIP) to a Source Network Address Translation (SNAT) entry, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-ens/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-ens`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/ens
- Page: https://zieapi.vercel.app/api/cloud/aliyun-ens
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-ens/openapi.json

Alibaba Cloud OpenAPI for Edge Node Service (ens, version 2017-11-10). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Calls the AccosicateNetworkAcl operation to attach a network ACL to a network
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/accosicate-network-acl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkAclId | string | yes | The ID of the network ACL |
| Resource | string | yes | The information about the associated resources (JSON-encoded) |

### Adds backend servers
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/add-backend-servers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| LoadBalancerId | string | yes | The frontend port used by the load balancing instance. Valid values: 1 to 65535 |
| BackendServers | string | yes | The list of backend servers to add. You can add up to 20 backend servers per invoke. Backend servers (ENS instances) must be in the… |

### Adds an IPv6 network interface controller (NIC). A public IP address is automatically assigned at the same…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/add-network-interface-to-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance |
| Networks | string | yes | The network. The value is a JSON string. Only IPv6 is supported. Sample code of an IPv6 network: [{ "ipType": "public", "ipAddressType":… |
| AutoStart | string | no | Specifies whether to automatically restart the instance |

### Adds an elastic IP address (EIP) to a Source Network Address Translation (SNAT) entry
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/add-snat-ip-for-snat-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SnatEntryId | string | yes | The ID of the SNAT entry |
| SnatIp | string | yes | The EIP specified in the SNAT entry |

### Assigns secondary private IP addresses to an elastic network interface (ENI)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/assign-private-ip-addresses` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkInterfaceId | string | yes | The ID of the ENI |
| VSwitchId | string | no | The ID of the vSwitch |

### Associates an Elastic IP Address (EIP) with a cloud product instance on the same edge node
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/associate-ens-eip-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AllocationId | string | yes | The ID of the EIP to be associated |
| InstanceId | string | yes | The ID of the cloud product instance to attach the EIP to. Load balancing (ELB) instance IDs are supported |
| InstanceType | string | no | The type of the EIP instance. Valid values: Nat: NAT gateway. SlbInstance: load balancing (ELB). NetworkInterface: secondary network… |
| Standby | string | no | Specifies whether the EIP is a standby EIP. Valid values: true: standby. false: not standby |

### Associates a high-availability virtual IP address (HAVIP) with an Edge Node Service (ENS) instance or…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/associate-ha-vip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| HaVipId | string | yes | The ID of the HAVIP |
| InstanceId | string | yes | The ID of the instance |
| InstanceType | string | no | The type of the instance to be associated with the HAVIP. Valid values: EnsInstance (default): ENS instance NetworkInterface: elastic… |

### Adds a secondary CIDR block to a network
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/associate-network-cidr-block` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkId | string | yes | The network ID |
| SecondaryCidrBlock | string | no | The secondary IPv4 CIDR block to be added. The CIDR block must meet the following requirements: The CIDR block must be within the… |
| IpVersion | string | no | The IP address version. Valid values: IPV4: IPv4 address. IPV6: IPv6 address |
| Ipv6Isp | string | no | The ISP of the IPv6 CIDR block. Valid values: cmcc unicom telecom |

### Attaches a disk to an Edge Node Service (ENS) instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/attach-disk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| DiskId | string | yes | The ID of the disk to be attached. The cloud disk and the instance must belong to the same node |
| InstanceId | string | yes | The ID of the instance |
| DeleteWithInstance | string | no | Specifies whether the disk to be attached is released with the instance. Valid values: true: The disk will be released when the ECS… |

### Add ENS instances to Container Service for Kubernetes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/attach-ens-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID. Only one ID is supported |
| Scripts | string | yes | The command to run on the instance, encoded in Base64 using UTF-8 |

### Attaches an SDG to the corresponding AIC instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/attach-instance-sdg` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceIds | string | yes | The list of instance IDs (JSON-encoded) |
| SDGId | string | yes | The ID of the SDG |
| DiskType | string | no | The type of the shared cloud disk to be created. Valid values: standard: standard cloud disk. rbd: rbd cloud disk. If no shared cloud disk… |
| DiskAccessProtocol | string | no | The cloud disk access protocol type. Valid values: iscsi: the default protocol for standard cloud disks. Both rbd cloud disks and standard… |
| LoadOpt | string | no | The file loading rate optimization parameter (JSON-encoded) |

### Adds existing instances to a node pool. You can call this operation to add existing Edge Node Service (ENS)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/attach-instances-to-node-pool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| NodepoolId | string | yes | The node pool ID |
| Instances | string | yes | The array of instances, including the instance information (JSON-encoded) |

### Attaches an SSH key pair to up to 30 instances in a single call
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/attach-key-pair` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| KeyPairName | string | no | The key pair name |
| InstanceIds | string | yes | A list of instance IDs (JSON-encoded) |
| KeyPairId | string | no | The unique ID of the key pair |

### Attaches an Elastic Network Interface (ENI) to an Edge Node Service (ECS) instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/attach-network-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance |
| NetworkInterfaceId | string | yes | The ID of the ENI |

### Calls AuthorizeSecurityGroup to configure inbound access permissions for a security group, allowing or…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/authorize-security-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| IpProtocol | string | yes | The transport-layer protocol. The value is case-sensitive. Valid values: tcp udp icmp gre all: all protocols are supported |
| PortRange | string | yes | The range of port numbers for the transport-layer protocol of the security group. Valid values: TCP/UDP protocol: valid values are 1 to… |
| SecurityGroupId | string | yes | The security group ID |
| Policy | string | no | Settings for access permissions. Valid values: accept: accepts access. drop: deny access without returning a rejection message. Default… |
| Priority | integer | no | The priority of the security group rule. Valid values: 1 to 100. Default value: 1 |
| SourceCidrIp | string | yes | The source IP address range. CIDR blocks and IPv4 addresses are supported. Default value: none |
| SourcePortRange | string | no | The range of port numbers for the transport-layer protocol of the source security group. Valid values: TCP/UDP protocol: valid values are… |

### Creates an outbound security group rule. This operation allows or denies the outbound traffic from the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/authorize-security-group-egress` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| IpProtocol | string | yes | The transport layer protocol. The value of this parameter is case-sensitive. Valid values: tcp udp icmp gre all: All protocols are supported |
| PortRange | string | yes | The range of destination ports that correspond to the transport layer protocol for security group rule N. Valid values: When the… |
| SecurityGroupId | string | yes | The ID of the security group |
| Policy | string | no | The action of the security group rule. Valid values: accept: allows access. This is the default value. drop: denies access and does not… |
| Priority | integer | no | The priority of security group rule N. Valid values: 1 to 100. Default value: 1 |
| DestCidrIp | string | yes | The destination IP addresses. CIDR blocks and IPv4 addresses are supported. This parameter is empty by default |
| SourcePortRange | string | no | The range of port numbers that correspond to the transport layer protocol for the source security group. Valid values: When the IpProtocol… |

### Batch migrates instances under a specified event. Supports immediate or scheduled execution
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/batch-event-migrate-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EventInfos | string | no | The list of events (JSON-encoded) |

### Batch restarts specified resources immediately or at a scheduled time
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/batch-event-reboot-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EventInfos | string | no | The list of events (JSON-encoded) |

### Batch redeploys specified resources immediately or at a scheduled time
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/batch-event-redeploy-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EventInfos | string | no | The list of events (JSON-encoded) |

### Copies an SDG across edge zones by calling CopySDG
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/copy-sdg` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SDGId | string | yes | The ID of the SDG to copy |
| DestinationRegionIds | string | yes | The list of destination edge zones (JSON-encoded) |

### Calls CopySnapshot to copy a snapshot across edge zones
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/copy-snapshot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SnapshotId | string | yes | The ID of the source snapshot |
| DestinationRegionIds | string | yes | The list of destination edge zone IDs (JSON-encoded) |
| DestinationSnapshotName | string | no | The display name of the snapshot. The name must be 2 to 128 characters in length. It must start with a letter or a Chinese character and… |
| DestinationSnapshotDescription | string | no | The description of the snapshot. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://` |
| InstanceBillingCycle | string | no | The billing cycle of the instance. Valid values: Hour Day Month |

### Creates ARM board card servers by calling CreateARMServerInstances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-armserver-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| PayType | string | yes | The billing type. Valid values: PrePaid (subscription) |
| EnsRegionId | string | yes | The ENS edge zone ID |
| ServerType | string | yes | The ARM board specification. Valid values: cas.cf53r cas.cf52r cas.cf52m1r cas.tg52g2 ens.afq-c2m3i.medium |
| InstanceType | string | yes | The instance type of the AIC container instance. Valid values: aic.cf52r.c1.np aic.cf52r.c2.np aic.cf53r.c2.np aic.cf52r.c4.np… |
| ImageId | string | yes | The image ID |
| Resolution | string | yes | The resolution. Valid values: 1920*864 1080*1920 1920*1080 720*1280 2400*1080 1080*2400 1280*720 864*1920 |
| Frequency | integer | no | The refresh rate, in Hz. Valid values: 30 and 60 |
| KeyPairName | string | no | The key pair name |
| Amount | integer | yes | The number of instances to create. Minimum value: 1. Maximum value: 100 |
| Period | integer | no | The duration for which you want to purchase the resource. If you do not specify PeriodUnit, the resource is purchased on a monthly basis… |
| PeriodUnit | string | no | The unit of the purchase duration |
| AutoRenew | string | no | Specifies whether to enable auto-renewal |
| NameSpace | string | no | The namespace |
| ServerName | string | no | The service name |
| AutoUseCoupon | string | no | Specifies whether to use coupons. Valid values: |
| EnvironmentVar | string | no | One or more environment variables to set during EAIS instance initialization |
| Cidr | string | no | The IPv4 CIDR block used by the instance, in CIDR notation |
| Tag | string | no | The list of tags bound to the instance (JSON-encoded) |
| InstanceBillingCycle | string | no | The instance billing cycle. Valid values: Hour Day |

### Creates an edge application that allows you to manage Edge Node Service (ENS) nodes in containers, bare…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| Template | string | yes | The edge application template. The value must be a JSON string that contains the following information: Basic information such as the name… |
| Timeout | integer | no | The timeout period for asynchronous processing. Unit: seconds. Default value: 1800 |

### Creates a classic network
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-classic-network` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | yes | The ID of the edge node |
| CidrBlock | string | yes | The CIDR block of the network. You can use one of the following CIDR blocks or their subnets as the CIDR block of the network: 10.0.0.0/8… |
| NetworkName | string | no | The name of the network. The name must meet the following requirements: The name must be 2 to 128 characters in length. The name must… |
| Description | string | no | The description of the network. The name must be 2 to 256 characters in length. It must start with a letter but cannot start with http\://… |

### Creates an edge container cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| Name | string | no | The name of the cluster |
| ClusterType | string | yes | Kubernetes or ManagedKubernetes. The former indicates an ECK cluster, and the latter indicates a serverless VC. This parameter must be… |
| Profile | string | yes | Default or Serverless. The former indicates an ECK cluster, and the latter indicates a serverless VC. This parameter must be used together… |
| EnsRegionId | string | no | The ID of the Edge Node Service (ENS) region where the cluster is deployed |
| KubernetesVersion | string | no | The Kubernetes version of the cluster. The version aligns with the Kubernetes community baseline version. We recommend that you select the… |
| VpcId | string | no | The ID of the virtual private cloud (VPC) used by the cluster |
| VswitchIds | string | no | The IDs of the vSwitches where the cluster nodes are deployed. The ENS region of the vSwitches must be the same as the ENS region… |
| PodVswitchIds | string | no | The IDs of the pod vSwitches. Each pod vSwitch corresponds to a worker node vSwitch. The pod vSwitch and the worker node vSwitch must be… |
| ContainerCidr | string | no | The CIDR block for pods. It must be a valid private CIDR block, such as 10.0.0.0/8, 172.16.0.0/12 to 172.31.0.0/16, or 192.168.0.0/16, and… |
| ServiceCidr | string | no | The CIDR block for Services. Valid ranges include 10.0.0.0/16 to 10.0.0.0/24, 172.16.0.0/16 to 172.31.0.0/24, and 192.168.0.0/16 to… |
| PublicAccess | string | no | Specifies whether to enable public network access. You can expose the API server by using an elastic IP address (EIP) to enable public… |
| LoadBalancerId | string | no | The ID of the Classic Load Balancer (CLB) instance used for API server access. If you specify this parameter, automatic creation of a CLB… |
| NatGatewayId | string | no | The ID of the NAT gateway used by the cluster. If you specify this parameter, automatic creation of a NAT gateway is skipped |
| Isp | string | no | The Internet service provider (ISP) information. Valid values: cmcc: China Mobile. unicom: China Unicom. telecom: China Telecom |
| ControlPlaneConfig | string | no | The control plane configuration (JSON-encoded) |

### A node pool is a logical collection of nodes with identical attributes that enables unified management and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-cluster-node-pool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| NodepoolInfo | string | yes | The node pool configurations (JSON-encoded) |
| ScalingGroup | string | yes | The scaling group configurations (JSON-encoded) |
| KubernetesConfig | string | no | The cluster-related configurations (JSON-encoded) |

### Creates a pay-as-you-go or subscription data cloud disk by calling CreateDisk
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-disk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceChargeType | string | yes | The billing method of the instance. Currently, only PostPaid (pay-as-you-go) is supported |
| EnsRegionId | string | yes | The edge zone ID |
| Category | string | yes | The type of the cloud disk. Valid values: |
| Size | string | no | The size of the cloud disk. Unit: GiB |
| SnapshotId | string | no | The snapshot used to create the cloud disk |
| Encrypted | string | no | Specifies whether to encrypt the cloud disk. Valid values: |
| KMSKeyId | string | no | The ID of the KMS key used by the cloud disk |
| DiskName | string | no | The name of the cloud disk |
| Tag | string | no | The list of tags. You can add up to 20 tags in a single call (JSON-encoded) |
| InstanceBillingCycle | string | no | The billing cycle of the instance. Valid values: Hour, Day, Month |

### Creates an elastic IP address (EIP) by calling the CreateEipInstance operation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-eip-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | yes | The ID of the Edge Node Service (ENS) edge zone |
| Bandwidth | integer | no | The peak bandwidth of the EIP. Default value: 5. Valid values: 5 to 10000. Unit: Mbit/s |
| InstanceChargeType | string | yes | Billable methods of the EIP. Currently, only PostPaid (pay-as-you-go billing method) is supported |
| InternetChargeType | string | yes | Billable methods of the EIP. Currently, only 95BandwidthByMonth (monthly 95th percentile bandwidth billing) is supported |
| Name | string | no | The name of the EIP instance |
| Isp | string | no | The Internet service provider (ISP). Valid values: cmcc: China Mobile. unicom: China Unicom. telecom: China Telecom |
| Description | string | no | The description |
| Tag | string | no | The resource tags (JSON-encoded) |
| ClientToken | string | no | Ensures the idempotence of the request to prevent duplicate operations caused by multiple retries. Generate a parameter value from your… |
| IpAddress | string | no | The IP address |
| InstanceId | string | no | The instance ID of the EIP |

### Creates a custom route entry
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-ens-route-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| RouteTableId | string | yes | The ID of the route table to which you want to add a custom route entry |
| DestinationCidrBlock | string | yes | The destination CIDR block of the custom route entry. Make sure that the following requirements are met: The destination CIDR block cannot… |
| NextHopType | string | no | The next hop type of the custom route. Valid values: Instance: an ENS instance. HaVip: a high-availability virtual IP address (HAVIP).… |
| NextHopId | string | yes | The ID of the next hop of the custom route entry |
| RouteEntryName | string | no | The name of the custom route entry that you want to add. The name must be 1 to 128 characters in length. It cannot start with http\:// or… |
| Description | string | no | The description of the custom route entry |
| SourceCidrBlock | string | no | The source CIDR block is available when you configure a route entry in the gateway route table, but is not unavailable when you configure… |

### Creates an edge service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-ens-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsServiceId | string | yes | The ID of the resource that you want to obtain. You can specify only one ID in a request |
| OrderType | string | yes | The operation to perform after you preview the created edge service. Valid values: Buy: create Upgrade: change |

### Creates an edge private network (EPN) instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-epn-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EPNInstanceType | string | yes | The type of the EPN instance. Set the value to EdgeToEdge |
| EPNInstanceName | string | no | The name of the EPN instance |
| InternetChargeType | string | yes | The billing method for network usage. Valid values: BandwidthByDay: Pay by daily peak bandwidth. 95BandwidthByMonth: Pay by monthly 95th… |
| NetworkingModel | string | yes | The networking mode. Valid values: SpeedUp: intelligent acceleration network (Internet) Connection: internal network SpeedUpAndConnection:… |
| InternetMaxBandwidthOut | integer | yes | The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 1 to 100 |

### Creates a NAS file system by calling the CreateFileSystem operation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-file-system` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| OrderDetails | string | yes | The list of orders. Each element in the list contains the details of an order (JSON-encoded) |

### Adds a DNAT entry by calling CreateForwardEntry
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-forward-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NatGatewayId | string | yes | The ID of the NAT gateway |
| ExternalIp | string | yes | The Elastic IP Address (EIP) that provides public network access. The EIP must not be occupied by an SNAT rule of the same NAT gateway.… |
| ExternalPort | string | yes | The external port or port range for port forwarding. The port range must be within 1 to 65535. To forward traffic within a port range,… |
| InternalIp | string | yes | The private IP address of the instance that communicates with the Internet through the DNAT entry |
| InternalPort | string | yes | The internal port or port range for port forwarding. The port range must be within 1 to 65535. To forward traffic within a port range,… |
| ForwardEntryName | string | no | The name of the DNAT rule. The name must be 2 to 128 characters in length and cannot start with `http://` or `https://` |
| IpProtocol | string | no | The protocol type. Valid values: TCP: forwards TCP packets. UDP: forwards UDP packets. Any (default): forwards all packets |
| HealthCheckPort | integer | no | The health check port for DNAT. The port must be within the internal port range. Default value: empty |
| StandbyExternalIp | string | no | The standby EIP that provides public network access. The standby EIP must be bound to the NAT gateway. After the DNAT entry is created,… |

### Creates a high-availability virtual IP address (HAVIP)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-ha-vip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| Description | string | no | The description of the HAVIP |
| Name | string | no | The name of the HAVIP |
| VSwitchId | string | no | The vSwitch ID of the HAVIP |
| IpAddress | string | no | The IP address of the HAVIP |
| Amount | integer | no | The number of HAVIPs that you want to create. Valid values: 1 to 10. The value can be only 1 if you specify an IP address. Default value: 1 |

### Creates an image from a specified instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| ImageName | string | yes | The image name. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (_), and hyphens… |
| DeleteAfterImageUpload | string | no | Specifies whether to enable automatic release of the instance after the image is packaged and uploaded. This parameter is supported only… |
| SnapshotId | string | no | The snapshot ID |
| TargetOSSRegionId | string | no | The region of the destination OSS bucket where the image is stored |
| WithDataDisks | string | no | Specifies whether to include data cloud disks when creating the image |

### Creates a subscription instance. This operation can be replaced by RunInstances. No new features will be…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceType | string | yes | The instance type. For details about instance types, see https://help.aliyun.com/document_detail/66124.html |
| EnsRegionId | string | yes | The region ID |
| Password | string | no | The password of the instance. The password must be 8 to 30 characters in length and must contain at least three of the following character… |
| Period | string | yes | The subscription duration. Valid values: 1 to 9 and 12. Unit: months |
| ImageId | string | no | The ID of the image that is used to start the instance |
| SystemDisk.Size | string | no | The size of the system cloud disk. Unit: GiB. The value must be a multiple of 10 and cannot be smaller than the image size. For the valid… |
| Quantity | string | yes | The number of instances |
| DataDisk.1.Size | string | no | The size of the first data cloud disk. Unit: GiB. The size must be at least 20 GiB and a multiple of 10 |
| InternetChargeType | string | no | This parameter is required when you create an instance for the first time. If you already have instance resources, the existing billing… |
| AutoRenewPeriod | string | no | The auto-renewal period. This parameter is required when AutoRenew is set to True. Valid values: 1 to 12. Unit: months |
| AutoRenew | string | no | Specifies whether to enable auto-renewal. Valid values: True / False (default) |
| IpType | string | no | The IP type. Valid values: ipv4 (default): IPv4. ipv6: IPv6. ipv4Andipv6: IPv4 and IPv6 |
| KeyPairName | string | no | The name of the key pair. Only a single name is supported |
| UserData | string | no | The custom data. The data must start with `#!`. The maximum length is 256 characters and the maximum size is 16 KB. Only custom data… |
| VSwitchId | string | no | The vSwitch ID |
| PrivateIpAddress | string | no | The private IP address. If you specify a private IP address, you must also specify the VSwitchId parameter. The vSwitch must be created in… |
| PaymentType | string | no | The payment method. Currently, this is a fixed value of Subscription (subscription instance). Modification is not supported |
| InstanceName | string | no | The name of the instance. Naming conventions: The name must be 2 to 128 characters in length and can contain letters and Chinese… |
| HostName | string | no | The hostname of the instance. General naming conventions: Periods (.) and hyphens (-) cannot be used as the first or last character and… |
| UniqueSuffix | string | no | Specifies whether to add sequential suffixes to HostName and InstanceName. The sequential suffixes start from 001 and cannot exceed 999.… |
| PublicIpIdentification | string | no | Specifies whether a public IP address can be assigned to the specified instance. Valid values: true (default): A public IP address can be… |
| PasswordInherit | string | no | Specifies whether to use the preset password of the image. Valid values: true: The preset password of the image is used. The Password… |

### Creates an SSH key pair
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-key-pair` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| KeyPairName | string | yes | The name of the key pair. The name must conform to the following naming conventions: The name must be 2 to 128 characters in length, and… |

### Creates a load balancing instance by calling the CreateLoadBalancer operation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-load-balancer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | yes | The ID of the ENS edge zone |
| LoadBalancerSpec | string | yes | The specification of the load balancing instance |
| LoadBalancerName | string | no | The name of the load balancing instance. The name must be 1 to 80 characters in length and can contain letters and Chinese characters. If… |
| PayType | string | yes | The billing type. PostPaid (currently the only supported type): pay-as-you-go |
| NetworkId | string | yes | The network ID of the Edge Load Balancing (ELB) instance to create |
| VSwitchId | string | yes | The ID of the vSwitch to which the VPC instance belongs |
| ClientToken | string | no | Ensures the idempotency of the request to avoid duplicate operations caused by multiple retries. Generate a parameter value from your… |
| BillingCycle | string | no | The billing cycle of the ELB instance |
| LoadBalancerType | string | no | The type of the Edge Load Balancing instance. CLB: Classic Load Balancing instance. InternetDR: Public pattern load balancing instance |

### Creates an HTTP listener
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-load-balancer-httplistener` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| LoadBalancerId | string | yes | The ID of the Edge Load Balancer (ELB) instance |
| ListenerPort | integer | yes | The listener port that is used by Edge Load Balancer (ELB) to receive requests and forward the requests to backend servers. Valid values:… |
| ListenerForward | string | no | Specifies whether to enable redirection from HTTP to HTTPS. Valid values: on off (default) |
| ForwardPort | integer | no | The listener port that is used to redirect HTTP requests to HTTPS |
| Description | string | no | The name of the listener. The value must be 1 to 80 characters in length. The value cannot start with `http://` or `https://` |
| XForwardedFor | string | no | Specifies whether to use the X-Forwarded-For header to obtain the real IP address of the client. Valid values: on off (default) |
| Scheduler | string | no | The scheduling algorithm. Valid values: wrr (default): Backend servers with higher weights receive more requests than backend servers with… |
| HealthCheck | string | yes | Specifies whether to enable the health check feature. Valid values: on off (default) |
| HealthCheckDomain | string | no | The domain name that you want to use for health checks. This parameter takes effect only if you set HealthCheck to on |
| HealthCheckURI | string | no | The URI used for health checks. The URI must be 1 to 80 characters in length. A URL must start with a forward slash (`/`) but cannot… |
| HealthyThreshold | integer | no | The number of consecutive successful health checks that must occur before an unhealthy and inaccessible backend server is declared healthy… |
| UnhealthyThreshold | integer | no | The number of consecutive failed health checks that must occur before a healthy and accessible backend server is declared unhealthy and… |
| HealthCheckTimeout | integer | no | The timeout period of a health check response. If a backend server does not respond within the specified timeout period, the server fails… |
| HealthCheckConnectPort | integer | no | The backend port that is used for health checks. Valid values: 1 to 65535. This parameter takes effect only if you set HealthCheck to on |
| HealthCheckInterval | integer | no | The interval at which health checks are performed. Valid values: 1 to 50. Default value: 2. Unit: seconds. This parameter takes effect… |
| HealthCheckHttpCode | string | no | The HTTP status code for a successful health check. Valid values: http_2xx (default) http_3xx http_4xx http_5xx This parameter takes… |
| IdleTimeout | integer | no | The timeout period for idle connections. Default value: 15. Valid values: 1 to 60. Unit: seconds. If no request is received within the… |
| RequestTimeout | integer | no | The timeout period of a request. Default value: 60. Valid values: 1 to 180. Unit: seconds. If no response is received from the backend… |
| HealthCheckMethod | string | no | The HTTP request method for health checks. Valid values: head (default) get This parameter takes effect only if the HealthCheck parameter… |
| BackendServerPort | integer | no | The port used by the backend server of the ELB instance. Valid values: 1 to 65535 |

### Creates an HTTPS listener
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-load-balancer-httpslistener` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| LoadBalancerId | string | yes | The ID of the Edge Load Balancer (ELB) instance |
| ListenerPort | integer | yes | The listening port that is used by Edge Load Balancer (ELB) to receive requests and forward the requests to backend servers. Valid values:… |
| ListenerForward | string | no | Specifies whether to enable redirection from HTTP to HTTPS. Valid values: on off (default) |
| ForwardPort | integer | no | The listener port that is used to redirect HTTP requests to HTTPS |
| Description | string | no | The description of the listener. The description must be 1 to 80 characters in length. The value cannot start with `http://` or `https://` |
| Scheduler | string | no | The scheduling algorithm. Valid values: wrr (default): Backend servers with higher weights receive more requests than backend servers with… |
| StickySessionType | string | no | The method that is used to handle cookies. Valid values: insert: inserts a cookie. ELB inserts a session cookie (SERVERID) into the first… |
| CookieTimeout | integer | no | The timeout period of a cookie. Valid values: 1 to 86400. Unit: seconds. This parameter is required if you set StickySession to on and… |
| Cookie | string | no | The cookie that is configured on the server. The cookie must be 1 to 200 characters in length and contain only ASCII characters and… |
| HealthCheck | string | yes | Indicates whether the health check feature is enabled. Valid values: on off |
| HealthCheckDomain | string | no | The domain name that you want to use for health checks. This parameter takes effect only if you set HealthCheck to on |
| HealthCheckURI | string | no | The URI used for health checks. The URI must be 1 to 80 characters in length. A URL must start with a forward slash (`/`) but cannot… |
| HealthyThreshold | integer | no | The number of consecutive successful health checks that must occur before an unhealthy and inaccessible backend server is declared healthy… |
| UnhealthyThreshold | integer | no | The number of consecutive failed health checks that must occur before a healthy and accessible backend server is declared unhealthy and… |
| HealthCheckTimeout | integer | no | The timeout period of a health check response. If a backend server does not respond within the specified timeout period, the server fails… |
| HealthCheckConnectPort | integer | no | The port that is used for health checks. Valid values: 1 to 65535. If you leave this parameter empty, the port specified by… |
| HealthCheckInterval | integer | no | The interval at which health checks are performed. Valid values: 1 to 50. Default value: 2. Unit: seconds. This parameter takes effect… |
| HealthCheckHttpCode | string | no | The HTTP status code for a successful health check. Valid values: http_2xx (default) http_3xx http_4xx http_5xx This parameter takes… |
| IdleTimeout | integer | no | The timeout period for idle connections. Default value: 15. Valid values: 1 to 60. Unit: seconds. If no request is received within the… |
| RequestTimeout | integer | no | The timeout period of requests. Default value: 60. Valid values: 1 to 180. Unit: seconds. If no response is received from the backend… |
| ServerCertificateId | string | yes | The ID of the server certificate |
| HealthCheckMethod | string | no | The HTTP request method for health checks. Valid values: head (default): requests the head of the page. get: requests the specified part… |
| BackendServerPort | integer | no | The backend port that is used by the ELB instance. Valid values: 1 to 65535 |

### To create a TCP listener, call `CreateLoadBalancerTCPListener`
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-load-balancer-tcplistener` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| LoadBalancerId | string | yes | The ID of the load balancer instance |
| ListenerPort | integer | yes | The listener port that receives and forwards requests to backend servers. Valid values: 1 to 65535 |
| Description | string | no | The description of the listener. The description must be 1 to 80 characters in length. The description cannot start with `http://` or… |
| Scheduler | string | no | The scheduling algorithm. Valid values: wrr (default): Weighted Round Robin. Requests are distributed to backend servers based on their… |
| PersistenceTimeout | integer | no | The timeout period for session persistence. Default value: 0, which indicates that session persistence is disabled. Valid values: 0 to… |
| EstablishedTimeout | integer | no | The timeout period for established connections, in seconds. Valid values: 10 to 900. Default value: 900 |
| HealthyThreshold | integer | no | The number of consecutive successful health checks required for a backend server to be considered healthy (from a `fail` to `success`… |
| UnhealthyThreshold | integer | no | The number of consecutive failed health checks required for a backend server to be considered unhealthy (from a `success` to `fail`… |
| HealthCheckConnectTimeout | integer | no | The maximum time to wait for a health check response. If a backend ENS instance does not respond within this timeout period, the health… |
| HealthCheckInterval | integer | no | The interval between health checks, in seconds. Valid values: 1 to 50. Default value: 2 |
| HealthCheckDomain | string | no | The domain name used for health checks |
| HealthCheckURI | string | no | The URI for health checks. The URI must be 1 to 80 characters in length. The URI must start with a forward slash (/) but cannot be only a… |
| HealthCheckHttpCode | string | no | The HTTP status codes that indicate a successful health check. Valid values: http_2xx (default) http_3xx http_4xx http_5xx |
| HealthCheckType | string | no | The health check type. Valid values: tcp (default) http |
| BackendServerPort | integer | no | The port used by backend servers. Valid values: 1 to 65535 |
| HealthCheckConnectPort | integer | no | The port used for health checks. Valid values: 1 to 65535. If you do not specify this parameter, the port specified by `BackendServerPort`… |
| EipTransmit | string | no | Specifies whether to enable EIP passthrough. Valid values: on: Enables EIP passthrough. off (default): Disables EIP passthrough |

### To create a UDP listener, call `CreateLoadBalancerUDPListener`
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-load-balancer-udplistener` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| LoadBalancerId | string | yes | The ID of the load balancer instance |
| ListenerPort | integer | yes | The listener port used to receive requests and forward them to backend servers. Valid values: 1 to 65535. For UDP listeners, ports 250,… |
| Description | string | no | The name of the listener. The name must be 1 to 80 characters long. The name cannot start with `http://` or `https://` |
| Scheduler | string | no | The scheduling algorithm. Valid values: wrr (default): Weighted Round Robin. Backend servers with a higher weight receive more requests.… |
| HealthyThreshold | integer | no | The number of consecutive successful health checks required for a backend server to be considered healthy. Valid values: 2 to 10. Default… |
| UnhealthyThreshold | integer | no | The number of consecutive failed health checks required for a backend server to be considered unhealthy. Valid values: 2 to 10. Default… |
| HealthCheckConnectTimeout | integer | no | The maximum time to wait for a response to a health check. A health check fails if a backend ENS instance does not respond within this… |
| HealthCheckInterval | integer | no | The interval between health checks, in seconds. Valid values: 1 to 50. Default value: 2 |
| BackendServerPort | integer | no | The port used by the backend servers. Valid values: 1 to 65535 |
| HealthCheckConnectPort | integer | no | The port used for health checks. Valid values: 1 to 65535. If you do not specify this parameter, the port specified by `BackendServerPort`… |
| HealthCheckReq | string | no | The request string for UDP health checks. The string must be up to 64 characters long and contain only letters and digits |
| HealthCheckExp | string | no | The expected response string for UDP health checks. The string must be up to 64 characters long and contain only letters and digits |
| EipTransmit | string | no | Specifies whether EIP pass-through is enabled. Valid values: on: Enables EIP pass-through. off (default): Disables EIP pass-through |
| EstablishedTimeout | integer | no | The timeout for established connections. Valid values: 10 to 900. Default value: 900. Unit: seconds |

### Creates a mount target
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-mount-target` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| FileSystemId | string | yes | The ID of the file system |
| EnsRegionId | string | yes | The ID of the region |
| NetWorkId | string | yes | The ID of the network |
| MountTargetName | string | yes | The name of the mount target |

### Creates a NAT gateway
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-nat-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| Name | string | no | The name of the NAT gateway. The name must be 1 to 128 characters in length and cannot start with `http://` or `https://` |
| EnsRegionId | string | yes | The ID of the ENS edge zone |
| NetworkId | string | yes | The network ID |
| VSwitchId | string | no | The vSwitch ID |
| InstanceType | string | no | The NAT gateway specification. Valid value: enat.default |
| Tag | string | no | The resource tags (JSON-encoded) |
| InstanceBillingCycle | string | no | The billing cycle of the instance. Valid values: Hour and Month |

### Creates a VPC
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-network` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | yes | The ID of the ENS edge zone |
| CidrBlock | string | yes | The CIDR block of the network. You can use one of the following CIDR blocks or their subsets as the CIDR block of the network: 10.0.0.0/8… |
| NetworkName | string | no | The name of the network. The name must meet the following requirements: The name must be 2 to 128 characters in length. The name must… |
| Description | string | no | The description of the network. The description must be 2 to 256 characters in length, and must start with a letter or a Chinese… |
| Tag | string | no | The resource tags (JSON-encoded) |
| EnableIpv6 | string | no | Specifies whether to enable IPv6. Valid values: false (default): disables IPv6. true: enables IPv6 |
| Ipv6Isp | string | no | The ISP of the IPv6 address. Valid values: cmcc telecom unicom |

### Creates a network access control list (ACL)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-network-acl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkAclName | string | no | Enter a name for the network ACL. The name must be 1 to 128 characters in length and cannot start with http\:// or https\:// |
| Description | string | no | The description of the network ACL. The description must be 1 to 256 characters in length and cannot start with http\:// or https\:// |

### You can invoke the CreateNetworkAclEntry API to create a network ACL rule
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-network-acl-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkAclId | string | yes | The ID of the network ACL |
| NetworkAclEntryName | string | no | The name of the rule. The name must be 1 to 128 characters in length and cannot start with http\:// or https\:// |
| Description | string | no | The description of the network ACL. The description must be 1 to 256 characters in length and cannot start with http\:// or https\:// |
| Direction | string | yes | The direction in which the rule is applied. Valid values: ingress egress |
| Policy | string | yes | The action that is performed on network traffic that matches the rule. Valid values: accept: allows network traffic. drop: blocks network… |
| CidrBlock | string | yes | The source CIDR block |
| Protocol | string | yes | The type of the protocol. Valid values: icmp: ICMP tcp: TCP udp: UDP all: all protocols |
| PortRange | string | yes | The port range. If you set Protocol to all or icmp, set this parameter to -1/-1, which specifies all ports. If you set Protocol to tcp or… |
| Priority | integer | yes | The priority of the rule. Valid values: 1 to 100. Default value: 1 |
| DestinationCidrBlock | string | no | The destination network |

### Create an Elastic Network Interface (ENI)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-network-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| VSwitchId | string | no | vSwitch ID |
| SecurityGroupIds | string | yes | Security group ID (JSON-encoded) |
| Name | string | no | ENI name |
| Description | string | no | Description of the ENI |

### Creates a Shared Data Group (SDG) on an Android in Container (AIC) instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-sdg` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AIC instance ID. You can call the [DescribeARMServerInstances](~~DescribeARMServerInstances~~) operation to obtain the InstanceId value |
| Size | string | no | The maximum capacity of the SDG. Unit: GB. To reduce costs, evaluate the required capacity as needed. If you are creating an SDG for the… |
| Description | string | no | The description of the SDG. Provide a detailed description for easier future queries |
| FromSDGId | string | no | The ID of an existing SDG. If you are creating an SDG for the first time, leave FromSDGId empty. If FromSDGId is invalid or the… |
| DiskType | string | no | The type of the source disk. Optional parameter values: standard: standard cloud disk. This is the default value. rbd: RBD disk. Limits:… |
| BillingCycle | string | no | The billing logic for SDG child disks. This parameter specifies the billing method for the RBD child disks produced by this SDG. This… |
| PerformanceLevel | integer | no | The SDG sharing ratio parameter. This parameter supports cloud disks with different maximum sharing ratios |

### Creates a security group
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-security-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SecurityGroupName | string | no | The name of the security group. The name must be 2 to 128 characters in length, and can contain digits, colons (:), underscores (_), and… |
| Description | string | no | The description of the security group. The description must be 2 to 256 characters in length. It must start with a letter and cannot start… |
| Permissions | string | no | The rules of the security group. Valid values of N: 0 to 200 (JSON-encoded) |

### Creates a security group rule for Edge Node Service (ENS)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-security-group-permissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SecurityGroupId | string | yes | The security group ID |
| Permissions | string | yes | The security group rules (JSON-encoded) |

### Creates a snapshot by calling CreateSnapshot
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-snapshot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| DiskId | string | yes | The cloud disk ID |
| EnsRegionId | string | yes | The ENS edge zone ID |
| SnapshotName | string | no | The display name of the snapshot. The name must be 2 to 128 characters in length and must start with a letter or a Chinese character. It… |
| Description | string | no | The description of the snapshot. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.… |
| InstanceBillingCycle | string | no | The billing cycle of the instance. Valid values: Hour Day Month |

### Adds a source network address translation (SNAT) entry to a specified SNAT table
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-snat-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NatGatewayId | string | yes | The ID of the Network Address Translation (NAT) gateway |
| SnatIp | string | yes | The elastic IP address (EIP) in the SNAT entry. Separate multiple EIPs with commas (,) |
| SourceVSwitchId | string | no | The ID of the vSwitch that you need to access over the Internet. This parameter specifies that Edge Node Service (ENS) instances in the… |
| SourceCIDR | string | no | The CIDR block. You can specify the CIDR block of a network, a vSwitch, or an instance. You can also specify a custom CIDR block. All… |
| SnatEntryName | string | no | The name of the SNAT entry. The name must be 1 to 128 characters in length. The name cannot start with `http://` or `https://` |
| SourceNetworkId | string | no | The ID of the network. This parameter specifies that all ENS instances in the network can use the SNAT entry to access the Internet. If… |
| StandbySnatIp | string | no | The secondary EIP in the SNAT entry. Separate multiple secondary EIPs with commas (,) |
| IdleTimeout | integer | no | The timeout period for idle connections. Valid values: 1 to 86400. Unit: seconds |
| IspAffinity | string | no | Whether to enable operator affinity. Value taking: false:Do not open. true:Open |
| EipAffinity | string | no | Specifies whether to enable IP affinity. If you do not specify this parameter, IP affinity is enabled by default. Valid values: false true… |

### Creates a storage gateway
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-storage-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| OrderDetails | string | yes | The array of orders (JSON-encoded) |

### Creates a storage volume
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-storage-volume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| GatewayId | string | yes | The ID of the gateway |
| StorageId | string | yes | The ID of the storage medium |
| EnsRegionId | string | yes | The ID of the node |
| IsEnable | string | no | Indicates whether the volume is enabled. Valid values: 1 (default): The volume is enabled. 0: The volume is disabled |
| IsAuth | string | no | Specifies whether to enable authentication. Valid values: 1: Authentication is enabled. 0 (default): Authentication is disabled |
| AuthProtocol | string | no | The authentication protocol. Set the value to CHAP |
| AuthUser | string | no | The username of the CHAP protocol |
| AuthPassword | string | no | The password of the CHAP protocol |
| VolumeName | string | no | The name of the volume. The name must be 2 to 128 characters in length. The name cannot start with `http://` or `https://`. The name can… |
| Description | string | no | The description of the volume. The description must be 2 to 128 characters in length. The description cannot start with `http://` or… |

### Creates a vSwitch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/create-vswitch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | yes | The ID of the ENS edge zone |
| CidrBlock | string | yes | The CIDR block of the vSwitch. The CIDR block must meet the following requirements: The subnet mask length of the vSwitch CIDR block must… |
| VSwitchName | string | no | The name of the vSwitch. The name must meet the following requirements: The name must be 2 to 128 characters in length. The name must… |
| Description | string | no | The description of the vSwitch. The description must be 2 to 256 characters in length. It must start with a letter or a Chinese character… |
| NetworkId | string | no | The ID of the network to which the new vSwitch belongs |
| Tag | string | no | The resource tags (JSON-encoded) |
| Ipv6CidrBlock | string | no | The IPv6 CIDR block of the vSwitch. You can specify this parameter to assign an IPv6 CIDR block to the vSwitch only when IPv6 is enabled… |

### Deletes a specified AIC public key. The public key can be deleted only when it is not associated with any…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-aicpublic-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| KeyName | string | yes | The name of the public key |

### Releases all containers and resource instances related to a specific application in an asynchronous manner
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AppId | string | yes | The ID of the application. To obtain the application ID, call the ListApplication operation |
| Timeout | integer | no | The timeout period for the asynchronous release. Unit: seconds. Default value: 300 |

### You can call the DeleteBucket operation to delete a bucket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-bucket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| BucketName | string | yes | The name of the bucket to delete. Only one bucket can be deleted at a time |

### Deletes the lifecycle rules of a bucket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-bucket-lifecycle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| BucketName | string | yes | The bucket name |
| RuleId | string | no | The rule ID. If this parameter is not specified, all rules are deleted |

### Deletes a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The ID of the cluster |
| RetainResources | string | no | Specifies whether to retain cloud resources. Default value: false |

### Deletes an unused node pool. When a node pool is deleted, all pods on the nodes in the node pool are…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-cluster-node-pool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The ID of the cluster |
| NodepoolId | string | yes | The ID of the node pool |

### Removes nodes from a cluster when the nodes are no longer needed. The ReleaseNode parameter specifies…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-cluster-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| Body | string | yes | The request body parameters (JSON-encoded) |
| ReleaseNode | string | no | Specifies whether to release the ENS instance where the node resides. Default value: true |

### Deletes a disk
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-disk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| DiskId | string | yes | The ID of the disk |

### Deletes a pay-as-you-go elastic IP address (EIP)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-eip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance |

### Deletes a custom route entry
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-ens-route-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| RouteEntryId | string | yes | The ID of the route that you want to delete |

### Deletes an edge private network (EPN) instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-epn-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EPNInstanceId | string | yes | The ID of the EPN instance |

### Calls DeleteFileSystem to delete a NAS service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-file-system` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | yes | The edge zone ID |
| FileSystemId | string | yes | The ID of the file system to delete |

### Deletes a Destination Network Address Translation (DNAT) entry from a specified DNAT table
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-forward-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ForwardEntryId | string | yes | The ID of the DNAT entry that you want to delete |

### Deletes a high-availability VIP (HAVIP)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-ha-vips` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| HaVipIds | string | yes | The IDs of high-availability virtual IP addresses (HAVIPs) (JSON-encoded) |

### Deletes a custom image
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ImageId | string | yes | The image ID. Only a single ID is supported. Only custom images are supported |

### Deletes SSH key pairs
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-key-pairs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| KeyPairName | string | no | The name of the key pair. The name must conform to the following naming conventions: The name must be 2 to 128 characters in length. The… |
| KeyPairId | string | no | The ID of the SSH key pair |

### Deletes a listener
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-load-balancer-listener` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ListenerPort | integer | yes | The frontend port that is used by the Edge Load Balance (ELB) instance. Valid values: 1 to 65535 |
| LoadBalancerId | string | yes | The ID of the ELB instance |
| ListenerProtocol | string | no | The frontend protocol that is used by the ELB instance. This parameter is required if the same port is used by listeners that use… |

### Deletes a mount target
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-mount-target` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| FileSystemId | string | yes | The ID of the file system |
| EnsRegionId | string | yes | The ID of the edge node |
| MountTargetName | string | yes | The name of the mount target |

### Deletes an Internet network address translation (NAT) gateway
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-nat-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NatGatewayId | string | yes | The ID of the NAT gateway that you want to delete |
| ForceDelete | string | no | Specifies whether to forcefully delete the NAT instance |

### Deletes a virtual private cloud (VPC)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-network` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkId | string | yes | The ID of the network |

### Deletes a network access control list (ACL)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-network-acl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkAclId | string | yes | The ID of the network ACL |

### Deletes a network access control list (ACL) rule
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-network-acl-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkAclEntryId | string | no | The ID of the network ACL for which you want to delete a rule |

### Deletes an elastic network interface (ENI)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-network-interfaces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetworkInterfaceIds | string | yes | The IDs of the elastic network interfaces (ENIs) (JSON-encoded) |

### Deletes a network peer connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-network-peer-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the network peer connection to delete |

### Deletes an object
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-object` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ObjectKey | string | yes | The name of the file |
| BucketName | string | yes | The name of the bucket |

### Deletes an SDG by calling DeleteSDG
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-sdg` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SDGId | string | yes | The list of SDGs to delete (JSON-encoded) |

### Deletes a security group
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-security-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SecurityGroupId | string | yes | The security group ID of the instance |

### Deletes an ENS security group rule
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-security-group-permissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SecurityGroupId | string | yes | The ID of the security group |
| Permissions | string | yes | The security group rules (JSON-encoded) |

### Deletes a snapshot
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-snapshot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SnapshotId | string | yes | The ID of the snapshot |

### Deletes a source network address translation (SNAT) entry from a specified SNAT table
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-snat-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SnatEntryId | string | yes | The ID of the SNAT entry that you want to delete |

### Deletes an elastic IP address (EIP) from a source network address translation (SNAT) entry
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-snat-ip-for-snat-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| SnatEntryId | string | yes | The ID of the SNAT entry |
| SnatIp | string | yes | The EIP that you want to delete from the SNAT entry |

### Deletes a storage gateway
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-storage-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| GatewayId | string | yes | The ID of the gateway |

### Deletes a storage volume
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-storage-volume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| VolumeId | string | yes | The ID of the volume |

### Deletes a vSwitch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/delete-vswitch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| VSwitchId | string | yes | The ID of the vSwitch |

### Deploys an SDG to compute instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/deploy-instance-sdg` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceIds | string | yes | The list of instance IDs. The value is a JSON array. A maximum of 100 IDs can be specified (JSON-encoded) |
| SDGId | string | yes | The ID of the SDG |
| DeploymentType | string | no | The SDG deployment type. Set the value to shared, which indicates read/write splitting shared deployment. In this mode, the SDG content is… |
| DiskType | string | no | The type of the shared cloud disk to be created. Valid values: standard: standard cloud disk. rbd: RBD cloud disk. If this parameter is… |
| DiskAccessProtocol | string | no | The access protocol type of the cloud disk. Valid values: iscsi: the default protocol for standard cloud disks. Both RBD cloud disks and… |

### Deploys an SDG
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/deploy-sdg` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceIds | string | yes | The list of device resource IDs to which the SDG is deployed. Batch deployment is supported, with a maximum of 100 instances per request… |
| SDGId | string | yes | The SDG ID. A cloud disk is created based on this SDG ID and mounted to the specified instance |
| DeploymentType | string | no | The SDG deployment type. Valid values: common: (default) read/write deployment. Data updates are written to the cloud disk. overlay:… |

### Retrieves image information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-aicimages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ImageId | string | no | The ID of the Android in Container (AIC) image |
| ImageUrl | string | no | The URL of the AIC image repository |
| PageNumber | string | no | The page number. The value starts from 1. Default value: 1 |
| PageSize | string | no | The number of entries per page for paging. Maximum value: 100. Default value: 10 |
| Status | string | no | The image status. Valid values: verifying: pending verification. disable: unavailable. available: available |
| MinDate | string | no | The start time of the query. Format: "2006-01-02". By default, no time limit is applied |
| MaxDate | string | no | The end time of the query. Format: "2006-01-02". By default, no time limit is applied |
| ImageType | string | no | The image type. Valid values: public: public image. private: custom image |
| Description | string | no | The description of the image |

### Retrieves information about ARM servers and AIC instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-armserver-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ServerIds | string | no | The list of server instance IDs (JSON-encoded) |
| EnsRegionIds | string | no | The list of ENS edge zone IDs (JSON-encoded) |
| PageNumber | integer | no | The page number of the query list. Minimum value: 1. Default value: 1 |
| PageSize | integer | no | The number of entries per page for a paged query. Maximum value: 100. Default value: 10 |
| MinDate | string | no | The start time of the query. Format: "2006-01-02". By default, no time limit is applied |
| MaxDate | string | no | The end time of the query. Format: "2006-01-02". By default, no time limit is applied |
| States | string | no | The list of operation states (JSON-encoded) |
| AICSpecs | string | no | The list of container specifications (JSON-encoded) |
| ServerSpecs | string | no | The list of server specifications (JSON-encoded) |
| Name | string | no | The server name |
| Namespace | string | no | The namespace |
| Tags | string | no | The list of tags (JSON-encoded) |
| OrderByParams | string | no | The sorting method for query results. You can sort results by one or more of the following fields: ServerIdSort (server ID),… |
| DescribeAICInstances | string | no | Specifies whether the query results include container information. Valid values: true: Included. false: Not included |

### Queries the details of a specified add-on
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-addon` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AddonName | string | yes | The name of the add-on |
| AddonVersion | string | no | The version of the add-on. If you do not specify a version, all available versions are returned by default |

### Queries the basic properties, resources, and container status of an application
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AppId | string | yes | The ID of the application. You can call the ListApplications operation to obtain the application ID |
| AppVersions | string | no | The version number of the application. Separate multiple version numbers with commas (,). If you want to query data of all versions of… |
| Level | string | no | The region level by which edge resources of the application are collected. The value is of the enumeration type. Valid values: National:… |
| OutDetailStatParams | string | no | Specifies whether to return other information about the application, such as statistics on resource instances and pods. The value must be… |
| ResourceSelector | string | no | The resource filtering condition |

### Queries the instance resources that can be created by calling DescribeAvailableResource
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-available-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |

### You can call DescribeAvailableResourceInfo to query the specifications of purchasable resources for instance…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-available-resource-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |

### Queries available bandwidth metering methods
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-band-withd-charge-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |

### Queries the metering method for the bandwidth
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-bandwitdh-by-internet-charge-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| StartTime | string | yes | The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be… |
| EndTime | string | yes | The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.… |
| Isp | string | no | The Internet service provider (ISP). Valid values: cmcc: China Mobile telecom: China Telecom unicom: China Unicom multiCarrier: multi-line… |
| EnsRegionId | string | no | The region ID of the instance |

### Queries the available resources in a region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cloud-disk-available-resource-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |

### The specifications of available resources are queried when you create a disk
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cloud-disk-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | no | The ID of the edge node |
| EnsRegionIds | string | no | The edge nodes (JSON-encoded) |

### Queries edge container clusters
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |

### To add an existing ENS instance to an ECK cluster as a worker node or re-add a node to a node pool, call the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster-attach-scripts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The ID of the ECK cluster |
| NodepoolId | string | yes | The ID of the node pool to which the node will be added |
| Options | string | no | Optional parameters for the script, provided as a JSON string |

### Queries the details of a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID. Only ECK cluster IDs with the eck- prefix are accepted. Legacy short hexadecimal cluster IDs are not supported. You can… |

### Queries the certificate of an edge container cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster-kube-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID. This parameter is essentially required. If it is not provided, the service returns BadRequest. The target cluster must… |

### Queries all node pools in a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster-node-pools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | A short description of struct |
| PageNumber | integer | no | The page number. Pages start from 1 |
| PageSize | integer | no | The number of entries per page |

### Queries a list of nodes that meet specific conditions
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| NodepoolId | string | no | The node pool ID |
| PageNumber | integer | no | The page number. Pages start from 1 |
| PageSize | integer | no | The number of entries per page |

### Retrieves the KubeConfig of a specified cluster. KubeConfig is used to configure access credentials for an…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-cluster-user-kubeconfig` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| PrivateIpAddress | string | no | Specifies whether the internal-facing access address of the private network is used. Default value: false |

### Queries a list of clusters
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-clusters-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| Name | string | no | The name of the cluster |
| ClusterId | string | no | The ID of the cluster |
| EnsRegionId | string | no | The ENS region ID of the cluster |
| ClusterType | string | no | The cluster type. Valid values: Kubernetes and ManagedKubernetes. A value of Kubernetes indicates an ECK cluster. A value of… |
| Profile | string | no | The cluster profile. Valid values: Default and Serverless. A value of Default indicates an ECK cluster. A value of Serverless indicates a… |

### Queries the results of creating an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-create-pre-paid-instance-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance. You can call the CreateIntance operation to create an instance |

### Retrieves the distribution status of data files across edge resource instances of an application by calling…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-data-dist-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AppId | string | yes | The application ID |
| DataNames | string | no | The data file names. This parameter is a filter condition. You can specify multiple names separated by commas (,). By default, all data… |
| DataVersions | string | no | The data file version numbers. This parameter is a filter condition. You can specify multiple versions separated by commas (,). By… |
| InstanceIds | string | no | The list of edge instance IDs. This parameter is a filter condition. You can specify multiple IDs separated by commas (,). By default, all… |
| MinDate | string | no | The start date of the query in the format "2006-01-02". By default, no time limit is applied |
| MaxDate | string | no | The end date of the query in the format "2006-01-02". By default, no time limit is applied |
| PageNumber | integer | no | The page number, starting from 1. You do not need to specify this parameter when exporting all data |
| PageSize | integer | no | The number of entries per page for paging queries. This parameter is not required when exporting all data |
| EnsRegionIds | string | no | The list of ENS edge zone IDs (JSON-encoded) |

### Retrieves the download URL of application data from file servers and returns the list of file servers to…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-data-download-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AppId | string | yes | The application ID. You can call ListApplications to obtain the AppId. The call chain is as follows: call CreateApplication to create an… |
| DataName | string | yes | The name of the data file |
| DataVersion | string | yes | The version number of the data |
| ServerFilterStrategy | string | no | The filter condition for file servers. Multiple canary release strategies are supported. By default, all file servers are queried |
| ExpireTimeout | integer | no | A reserved parameter |

### Queries the pre-push status of data files for an application on edge nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-data-push-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AppId | string | yes | The application ID |
| DataNames | string | no | The names of the data files. This is a filter condition for the query. Multiple values are supported and separated by commas (,). By… |
| DataVersions | string | no | The version numbers of the data files. This is a filter condition for the query. Multiple values are supported and separated by commas… |
| MinDate | string | no | The start time of the query. Format: YYYY-MM-DD. By default, there is no time limit |
| MaxDate | string | no | The end time of the query. Format: YYYY-MM-DD. By default, there is no time limit |
| PageNumber | integer | no | The page number. Pages start from 1. This parameter is not required when you export all information |
| PageSize | integer | no | The number of entries per page set in Settings for paging during a paged query. This parameter is not required when you export all entries |
| RegionIds | string | no | The IDs of the edge nodes. This is a filter condition for the query. Multiple values are supported and separated by commas (,). By… |

### Queries the list of basic property information such as instances and virtual device network status under an…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-device-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| ServiceId | string | no | Service ID |
| InstanceId | string | no | The instance ID |
| RegionId | string | no | The ID of the ENS edge node |
| AppId | string | no | The application ID |
| EnsRegionId | string | no | Invalid parameter |
| OrderId | string | no | The order ID |

### Queries disk IOPS monitoring data
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-disk-iops-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| StartTime | string | yes | The start time in the format of yyyy-MM-dd HH:mm:ss |
| EndTime | string | yes | The end time in the format of yyyy-MM-dd HH:mm:ss. The time span between the start time and end time cannot exceed one day |
| DiskId | string | yes | The disk ID in the format of d-*********** |

### Queries information about one or more created disks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-disks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| EnsRegionId | string | no | The ID of the ENS edge zone |
| DiskId | string | no | The ID of the cloud disk |
| DiskName | string | no | The name of the disk |
| PageNumber | string | no | The page number of the query list. Minimum value: 1. Default value: 1 |
| PageSize | string | no | The number of entries per page for a paged query. Maximum value: 50. Default value: 10 |
| Status | string | no | The disk status. In-use: in use Available: to be mounted Attaching: being mounted Detaching: being unmounted Creating: being created… |
| Type | string | no | The disk property. system: system cloud disk data: data cloud disk |
| Category | string | no | The disk category. cloud_efficiency: ultra cloud disk cloud_ssd: all-flash cloud disk local_hdd: local HDD local_ssd: local SSD |
| DiskChargeType | string | no | The billing type. prepay: subscription postpay: pay-as-you-go |
| EnsRegionIds | string | no | The list of edge zones |
| DiskIds | string | no | The disk IDs |
| OrderByParams | string | no | The sorting parameter. Format example: {"EnsRegionId":"desc"}. By default, results are sorted by edge zone ID in descending order |
| DiskType | string | no | The disk purchase method. ServiceDisk: disk created by an edge service ResoureDisk: purchased with an instance PostPayDisk: purchased… |
| InstanceId | string | no | The instance to which the cloud disk is mounted |
| SnapshotId | string | no | The snapshot ID |

### Queries the specifications of available resources for purchase when you create an instance by calling…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-elb-available-resource-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |

### Queries elastic IP addresses (EIPs)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-ens-eip-addresses` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| AllocationId | string | no | The ID of the EIP instance. You can specify up to 50 EIP instance IDs. Separate multiple instance IDs with commas (,) |
| EipAddress | string | no | The IP address of the EIP. You can specify up to 50 IP addresses. Separate multiple IP addresses with commas (,) |
| AssociatedInstanceId | string | no | The instance ID of the cloud service |
| AssociatedInstanceType | string | no | The type of the cloud service instance to attach. Valid values: EnsInstance: ENS instance in a VPC. SlbInstance: load balancing instance |
| Status | string | no | The status of the EIP. Valid values: Associating: The EIP is being associated. Unassociating: The EIP is being disassociated. InUse: The… |
| EnsRegionId | string | no | The ID of the ENS edge zone |
| EipName | string | no | The name of the EIP |
| Standby | string | no | Specifies whether the EIP is a standby EIP. Valid values: true: The EIP is a standby EIP. false: The EIP is not a standby EIP |
| IcmpReplyEnabled | string | no | Specifies whether to enable ICMP echo reply. Valid values: true: ICMP echo reply is enabled. This is the default value. false: ICMP echo… |
| EnsRegionIds | string | no | The array of ENS edge zone IDs. The array must contain 1 to 100 IDs (JSON-encoded) |
| PageNumber | integer | no | The page number. Default value: 1 |
| PageSize | integer | no | The number of entries per page in a paging query. Maximum value: 100. Default value: 10 |
| LockReason | string | no | The lock reason. Valid values: financial: The EIP is locked due to an overdue payment |

### Invoke DescribeEnsNetDistrict to query the regions where edge service resources can be created
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/describe-ens-net-district` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ens.ap-southeast-1.aliyuncs.com |
| NetLevelCode | string | yes | The level of the region. Big: area Middle: province Small: city |
| NetDistrictCode | string | no | The code of the region. If you do not specify this parameter, only nodes in the regions of the level that is specified by the NetLevelCode… |
| NetDistrictCodeNode | string | no | Region code |

…and 202 more. See the OpenAPI spec.

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-ens/accosicate-network-acl" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Edge Node Service API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-ens/accosicate-network-acl with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Edge Node Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Edge Node Service itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Edge Node Service API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-ens.

### What is the status of the Alibaba Cloud Edge Node Service API?
Needs your own provider key (bring your own key)