Create Permission¶

Create a permission for an application.

Operation Permissions¶

Applications assigned with the Application Registration Administrator policy in the OU.

Request Format¶

POST https://{apigw-address}/enos-app-service/v2.5/permissions

Request Parameters(URI)¶

Name	Location(Path/Query)	Required/Optional	Data Type	Description
orgId	Query	Required	String	The OU ID which the application belongs to. How to get orgId >>

Request Parameters(Header)¶

Name	Required/Optional	Data Type	Description
accept-language	Optional	String	The required language, such as “zh-CN” or “en-US”. If not specified, the default return message will include all available internationalized content. EnOS Supported Languages >>

Request Parameters(Body)¶

Name	Required/Optional	Data Type	Description
name	Required	StringI18n	The permission name. Internationalized field representation >>
description	Optional	StringI18n	The description of the permission. Internationalized field representation >>
appId	Required	String	The application ID that the permission belongs to.
keyword	Required	String	The custom unique identifier for the permission.

Response Parameters¶

Name	Data Type	Description
id	String	The permission identifier generated by the system.
appId	String	The application ID that the permission belongs to.
name	StringI18n	The permission name.
description	StringI18n	The permission description.
keyword	String	The custom unique identifier for the permission.
status	String	The permission authorization status, empty by default.

Samples¶

Request Sample¶

url: https://{apigw-address}/enos-app-service/v2.5/permissions?orgId=yourOrgId
method: POST
request Body:
{
  "appId": "yourApplicationId",
  "name": {
    "default": "permission1",
    "en-US":"permission1"
  },
  "description": {},
  "keyword": "permission1"
}

Return Sample¶

{
  "code": 0,
  "msg": "OK",
  "subMsg": null,
  "data": {
    "id": "systemPermissionId",
    "appId": "yourApplicationId",
    "name": {
      "default": "permission1",
      "en-US":"permission1"
    },
    "description": {},
    "keyword": "permission1",
    "status": null
  }
}