You can call the CreateEdgeMachine operation to activate a cloud-native box.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request syntax

POST /edge_machines  HTTP/1.1
Content-type: application/json
{
   "hostname": "string",
   "sn": "string",
   "model": "string"
}

Request parameters

Table 1. Request body parameters
Parameter Type Required Example Description
hostname String Yes ACK-B-B010-****

The hostname of the cloud-native box.

Note After the cloud-native box is activated, the hostname is automatically modified. The hostname is a random string prefixed by the model name.
sn String Yes Q2CB5XZAFBFG****

The serial number of the cloud-native box.

model String Yes ACK-V-B010

The model name of the cloud-native box.

Response syntax

### Valid syntax
```
POST /edge_machines  HTTP/1.1
<Common request headers>
Content-type: application/json
{
   "request_id": "string",
   "edge_machine_id": "string"
}
```
### Invalid syntax

```
{
    "code": "400",
    "message": "EdgeMachine ACK-V-B010/zhangjie-werwer-123 has exist",
    "requestId": "bfd12953-31cb-42f1-8a36-7b80ec345094",
    "status": 400
}

Response parameters

Table 2. Response body parameters
Parameter Type Example Description
request_id String "request_id": "6e7b377a-c5ed-4388-8026-689e1b34****",

The ID of the request.

edge_machine_id String cc0725ddf688744979cd98445f67e****

The ID of the cloud-native box.

Sample requests

Submit the following sample request to activate a cloud-native box:

POST /edge_machines HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

{
  "hostname" : "ACK-B-B010-****",
  "sn" : "Q2CB5XZAFBFG****",
  "model" : "ACK-V-B010"
}

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateEdgeMachineResponse>
    <request_id>"request_id": "6e7b377a-c5ed-4388-8026-689e1b34****",</request_id>
    <edge_machine_id>cc0725ddf688744979cd98445f67e****</edge_machine_id>
</CreateEdgeMachineResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "request_id" : "\"request_id\": \"6e7b377a-c5ed-4388-8026-689e1b34****\",",
  "edge_machine_id" : "cc0725ddf688744979cd98445f67e****"
}

Error codes

For a list of error codes, visit the API Error Center.