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
  }
}