Modifying an App

Function

This API is used to modify the information about a specified app. The following parameters can be modified: name and remark. If the function of customizing keys and secrets is enabled, app_key and app_secret can also be modified. Other parameters cannot be modified.

URI

The following table lists the HTTP/HTTPS request method and URI of the API.

**Table 1** HTTP/HTTPS request method and URI
Request Method	URI
PUT	/v1.0/apigw/apps/{id}

The following table lists the parameter in the URI.

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
id	Yes	String	App ID, which can be obtained by querying the app list

Request

**Table 3** Parameter description
Parameter	Mandatory	Type	Description
name	Yes	String	App name An app name consists of 3–64 characters, starting with a letter. Only letters, digits, and underscores (_) are allowed.
remark	No	String	Description of the app The description cannot exceed 255 characters.
app_key	No	String	AppKey An AppKey consists of 8–64 characters, starting with a letter or digit. Only letters, digits, underscores (_), and hyphens (-) are allowed. NOTE: This parameter is available in some regions.
app_secret	No	String	AppSecret An AppSecret consists of 8–64 characters, starting with a letter or digit. Only letters, digits, and the following special characters are allowed: _-!@#$% NOTE: This parameter is available in some regions.

Example request:

{
	"name": "app_001",
	"remark": "First app",
        "app_key": "app_key_sample",
        "app_secret": "app_secret_sample"
}

Response

**Table 4** Parameter description
Parameter	Type	Description
id	String	App ID
name	String	App name
status	Integer	App status
app_key	String	AppKey
app_secret	String	AppSecret
creator	String	App creator, which can be: USER: The app is created by the API user. MARKET: The app is allocated by the marketplace.
register_time	Timestamp	Time when the app is registered
remark	String	Description of the app
update_time	Timestamp	Time when the app was last updated
app_type	String	App type. The default value is apig.

Example response:

{
	"id": "14b399ac-967f-4115-bb62-c0346b4537e9",
	"name": "app_001",
	"status": 1,
	"app_key": "d49b1cbf-cc81-4a5f-b2a0-61b568e376eb",
	"app_secret": "******",
	"creator": "USER",
	"remark": "First app",
	"register_time": "2017-12-28T12:26:54Z",
	"update_time": "2017-12-28T12:28:07.2966182Z",
        "app_type": "apig"
}