Updating an Edge Ssite

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.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
ies:edgeSite:update	Write	edgeSite *	g:EnterpriseProjectId	-	-

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID in the path.
site_id	Yes	String	Edge site ID

Request Parameters

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

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
edge_site	Yes	UpdateEdgeSite object	Parameters of the edge site to be updated

**Table 4** UpdateEdgeSite
Parameter	Mandatory	Type	Description
description	No	String	Edge 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 will be invalid and will not be returned for new sites.
condition	No	UpdateCondition object	Conditions at the location.
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 conditions at the location. The value can be: 0: None of the above. 1: This is a modular data center. 2 The data center has earned national or industry-level certifications.
space	No	Integer	Rack space conditions. 0: No space is reserved for more racks in the equipment room. 1: Space is reserved for at least three more racks in the equipment room. 2: Space is reserved for one to three more racks in the equipment room.
transport	No	Integer	Rack transport conditions. The value can be: 0: The height or width of the passages or doors in the equipment does not meet the requirements. 1: The passages, freight elevators, or doors in the equipment room allow the racks to be transported on their rollers. 2: The passages, freight elevators, or doors in the equipment room do not allow the racks to be transported on their rollers. There are steps along the way.
installation	No	String	Rack installation. The value can be: UNCLEAR: Unknown. A detailed evaluation is required. UNSUPPORT: Rack installation is not allowed. Devices need to be installed in existing racks. SUPPORT: Rack installation is allowed. 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 information

**Table 8** EdgeSiteDetail
Parameter	Type	Description
id	String	Edge site ID
domain_id	String	Edge site account ID
name	String	Edge site name
description	String	Edge site description
region_id	String	Edge site region ID
project_id	String	Edge site project ID
availability_zone_id	String	Edge site AZ ID
status	String	Edge site deployment status
location	LocationDetail object	Details about the location.
enterprise_project_id	String	ID of the enterprise project that the edge site belongs to.
created_at	String	Time when an edge site was created
updated_at	String	Time when an edge site was updated

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

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

Example Requests

Example request for updating an edge site

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

{
  "application/json" : {
    "edge_site" : {
      "description" : "Update edgesite",
      "location" : {
        "description" : "Site location",
        "condition" : {
          "environment" : 0,
          "space" : 0,
          "transport" : 0,
          "installation" : "SUPPORT"
        }
      }
    }
  }
}

Example Responses

Status code: 200

successful operation

{
  "edge_site" : {
    "id" : "cc89b1e5-521d-4a85-be83-e6f7217fc63e",
    "domain_id" : "2b76febbe5d34eac85d26435c1f15809",
    "name" : "The 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" : "Site location.",
      "zone_code" : "CN",
      "address" : "Location of the test site: 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"
  }
}