Updating an Edge Site

Function

This API is used to update an edge site.

Only the edge site description and location information can be updated.
This API supports fine-grained permissions for enterprise projects. For details, see ies:edgeSite:update.

URI

PUT /v1/{domain_id}/edge-sites/{site_id}

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

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	UpdateEdgeSite object	Edge site information to be updated.

**Table 4** UpdateEdgeSite
Parameter	Mandatory	Type	Description
description	No	String	Site description. The description can contain a maximum of 255 bytes and cannot contain angle brackets (<>).
location	No	UpdateLocation object	Location information.

**Table 5** UpdateLocation
Parameter	Mandatory	Type	Description
name	No	String	Location name (discarded). This parameter is invalid even if it is transferred and will not be returned for new sites.
condition	No	UpdateCondition object	Location conditions.
description	No	String	Location description. The description can contain a maximum of 255 bytes and cannot contain angle brackets (<>).

**Table 6** UpdateCondition
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. 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 parameters
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

Updating an edge site

PUT https://{ies_endpoint}/v1/{domain_id}/edge-sites/{site_id}

{
  "edge_site" : {
    "description" : "Updating an edge site",
    "location" : {
      "description" : "Location information",
      "condition" : {
        "environment" : 0,
        "space" : 0,
        "transport" : 0,
        "installation" : "SUPPORT"
      }
    }
  }
}

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,
    "status" : "initial",
    "location" : {
      "description" : "Location information",
      "zone_code" : "CN",
      "address" : "Yaohai District in Hefei, Anhui",
      "condition" : {
        "environment" : 0,
        "space" : 0,
        "transport" : 0,
        "installation" : "SUPPORT"
      }
    },
    "enterprise_project_id" : "06fb8917-442d-4d4d-bcdb-79eb3e7b7b5d",
    "created_at" : "2022-04-15T07:59:20.641Z",
    "updated_at" : "2022-04-15T08:59:20.641Z"
  }
}