Resetting an Activation Code as an Enterprise Administrator

Description

This API is used by an enterprise administrator to reset an activation code. After the resetting, the original device is unbound and must be activated again. If the mobile number or email address is not specified, the new activation code will not be sent.

Debugging

You can debug this API in API Explorer.

Prototype

**Table 1** Prototype
Request Method	PUT
Request Address	/v1/usg/dcs/corp/vision/activecode/{account}/reset
Transport Protocol	HTTPS

Request Parameters

**Table 2** Parameters
Parameter	Mandatory	Type	Location	Description
account	Yes	String	Path	Huawei Cloud Meeting account. Use the value of userAccount in the response to the request for Querying Users in Pages.
X-Access-Token	Yes	String	Header	Authorization token. Use the value of accessToken in the response to the request for Authenticating an App ID.
X-Request-Id	No	String	Header	Request ID, which is used for fault tracing and locating. You are advised to use a UUID. If this parameter is not carried, a request ID is automatically generated.
Accept-Language	No	String	Header	Language. Values: zh-CN for Chinese (default) and en-US for English.
country	No	String	Body	Country or region that the mobile number belongs to. Default value: chinaPR. maxLength: 255 minLength: 0
emailAddr	No	String	Body	Email address. maxLength: 255 minLength: 0
smsNumber	No	String	Body	Number information. If the value is a mobile number, the country/region code must be specified. For example, if a mobile number is +86xxxxxxx in the Chinese mainland, the country parameter is mandatory. The mobile number is in the format of (^$\|^[+]?[0-9]+$). maxLength: 32 minLength: 0

Status Codes

**Table 3** Status codes
HTTP Status Code	Description
200	Operation successful.
400	Invalid parameters.
401	Authentication is not performed or fails.
403	Insufficient permissions.
500	Server exception.

Response Parameters

**Table 4** Response parameter
Parameter	Type	Description
activeCode	String	Activation code.

Example Request

POST /v1/usg/dcs/corp/vision/activecode/test_account/reset
Connection: keep-alive
X-Access-Token: stbWbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOD
content-type: application/json
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191))

{
    "country": "chinaPR",
    "emailAddr": "email@huawei.com",
    "smsNumber": "+86173****9092"
}

Example Response

HTTP/1.1 200 
Date: Mon, 13 Jul 2020 02:20:32 GMT
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 6032547386ab1e2e6a24842e9e1abea3

{
    "activeCode": "08535646662"
}

Error Codes

If an error code starting with MMC or USG is returned when you use this API, rectify the fault by following the instructions provided in Huawei Cloud API Error Center.

Example cURL Command

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token: stbWbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOD' -d '{"country": "chinaPR","emailAddr": "email@huawei.com","smsNumber": "+86173****9092"}'
https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/vision/activecode/test_account/reset

Parent topic: Managing Activation Codes

Previous topic: Deleting Activation Codes as an Enterprise Administrator

Next topic: Querying Activation Codes by Page as an Enterprise Administrator