Registering an Edge Site

Function

This API is used to register an edge site.

An edge site is associated with a Huawei Cloud region.
This API supports fine-grained permissions for enterprise projects. For details, see ies:edgeSite:create.

URI

POST /v1/{domain_id}/edge-sites

**Table 1** URI parameter
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID in the URI.

Request Parameters

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token.

**Table 3** Request body parameter
Parameter	Mandatory	Type	Description
edge_site	Yes	CreateEdgeSite object	Edge site parameters.

**Table 4** CreateEdgeSite
Parameter	Mandatory	Type	Description
name	Yes	String	Edge site name. Maximum Length: 64 bytes. Only letters (a-z and A-Z), digits (0-9), underscores (_), and hyphens (-) are allowed.
region_id	Yes	String	ID of the region that the edge site is associated with. Maximum length: 64 bytes. Only letters (a-z and A-Z), digits (0-9), underscores (_), and hyphens (-) are allowed.
project_id	No	String	ID of the project that the edge site belongs to.
description	No	String	Edge site description. The description can contain a maximum of 255 bytes and cannot contain angle brackets (<>).
location	Yes	CreateLocation object	Location information.
enterprise_project_id	No	String	Enterprise project ID.

**Table 5** CreateLocation
Parameter	Mandatory	Type	Description
name	No	String	Location name (discarded). This parameter will not be stored persistently and will not be returned for new sites.
address	No	String	Province or state of the location.
zone_code	No	String	Area where the location is located.
condition	Yes	Condition object	Location conditions.
description	No	String	Location description. The description can contain a maximum of 255 bytes and cannot contain angle brackets (<>).

**Table 6** Condition
Parameter	Mandatory	Type	Description
environment	No	Integer	Equipment room environment. Options: 0: None 1: This is a modular data center. 2: The data center has earned national or industry-level certifications.
space	No	Integer	Rack space. Options: 0: There is no space available. 1: There is room for more than three racks. 2: There is room for up to three racks.
transport	No	Integer	Rack transportation conditions. Options: 0: The height or width of the transportation passages or doors in the equipment room does not meet requirements. 1: The passages, freight elevators, or doors in the equipment room allow racks to be transported on their rollers. 2: The passages, freight elevators, or doors in the equipment room do not allow racks to be transported on their rollers. There are steps along the way.
installation	No	String	Rack installation. Options: UNCLEAR: Unknown UNSUPPORT: Devices need to be installed in existing racks. SUPPORT: New racks can be added to a rack group.

Response Parameters

Status code: 200

**Table 7** Response body parameter
Parameter	Type	Description
edge_site	EdgeSiteDetail object	Edge site details.

**Table 8** EdgeSiteDetail
Parameter	Type	Description
id	String	Edge site ID.
domain_id	String	ID of the account that the edge site belongs to.
name	String	Edge site name.
description	String	Edge site description.
region_id	String	ID of the region to which the edge site belongs.
project_id	String	ID of the project that the edge site belongs to.
availability_zone_id	String	AZ ID of the edge site.
status	String	Edge site deployment status. Options: - initial: To be deployed - deploying: Deploying - available: Available - unavailable: Unavailable
location	LocationDetail object	Location details.
enterprise_project_id	String	ID of the enterprise project that the edge site belongs to.
created_at	String	Time when an edge site was registered.
updated_at	String	Time when an edge site was updated.

**Table 9** LocationDetail
Parameter	Type	Description
name	String	Location name (discarded). This parameter is invalid even if it is transferred and will not be returned for new sites.
description	String	Location description.
zone_code	String	Area where the location is located.
address	String	Deployment location.
condition	Condition object	Location conditions.

**Table 10** Condition
Parameter	Type	Description
environment	Integer	Equipment room environment. Options: 0: None 1: This is a modular data center. 2: The data center has earned national or industry-level certifications.
space	Integer	Rack space. Options: 0: There is no space available. 1: There is room for more than three racks. 2: There is room for up to three racks.
transport	Integer	Rack transportation conditions. Options: 0: The height or width of the transportation passages or doors in the equipment room does not meet requirements. 1: The passages, freight elevators, or doors in the equipment room allow racks to be transported on their rollers. 2: The passages, freight elevators, or doors in the equipment room do not allow racks to be transported on their rollers. There are steps along the way.
installation	String	Rack installation. Options: UNCLEAR: Unknown UNSUPPORT: Devices need to be installed in existing racks. SUPPORT: New racks can be added to a rack group.

Example Request

Example request for registering an edge site in cn-north-4 (Beijing 4) in Yaohai District in Hefei, Anhui, China. It is uncertain whether the equipment room meets requirements. Rack expansion is not planned. The height or width of the transportation passages and equipment room doors does not meet requirements. New racks can be added to an existing rack group.

POST https://{ies_endpoint}/v1/{domain_id}/edge-sites

{
  "edge_site" : {
    "name" : "Test site",
    "description" : "The test site is located in Anhui.",
    "region_id" : "cn-north-4",
    "location" : {
      "description" : "Location of the test site",
      "zone_code" : "CN",
      "address" : "Yaohai District in Hefei, Anhui",
      "condition" : {
        "environment" : 0,
        "space" : 0,
        "transport" : 0
      }
    }
  }
}

Example Response

Status code: 200

successful operation

{
  "edge_site" : {
    "id" : "cc89b1e5-521d-4a85-be83-e6f7217fc63e",
    "domain_id" : "2b76febbe5d34eac85d26435c1f15809",
    "name" : "Test site",
    "description" : "The test site is located in Anhui.",
    "region_id" : "cn-north-4",
    "project_id" : "060576838600d5762f2dc000470eb164",
    "availability_zone_id" : null,
    "enterprise_project_id" : "0",
    "status" : "initial",
    "location" : {
      "description" : "Location of the test site",
      "zone_code" : "CN",
      "address" : "Yaohai District in Hefei, Anhui",
      "condition" : {
        "environment" : 0,
        "space" : 0,
        "transport" : 0,
        "installation" : "SUPPORT"
      }
    },
    "created_at" : "2022-04-15T07:59:20.641Z",
    "updated_at" : null
  }
}