Get Assets by Organization


Get all the assets that a specified user can access under a specified organization.

Prerequisites


  • The associated application has been purchased by the organization.
  • The associated application must have access permissions (authorized by the organization administrator) for the assets.

Request Format


POST https://{apigw-address}/app-portal-service/v2.2/user/asset/list

Request Parameters (Body)


Name Mandatory/Optional Data Type Description
userId Mandatory String The user ID
orgId Mandatory String The organization ID which the asset belongs to. How to get orgId >>
pagination Optional Pagination Request Struct Lists the paging requirements in a request. If not specified, the default pagination size is 1000 pages, starting from 0. For more details, see Pagination Request Struct

Response Parameters


Name Data Type Description
data Data Struct The pagination and list of the assets’ information

Data Struct


Name Data Type Description
pagination Pagination Struct The pagination information
assets Assets Struct The list of the assets’ information

Pagination Struct


Name Data Type Description
pageNo Integer The request pages.
pageSize Integer The number of records in each page.
totalElements Long The total number of records.

Assets Struct


Name Data Type Description
id String The asset ID
name I18nString The asset’s name in its respective locale’s language. For more details on the structure and locales supported, see Internationalized name struct

Error Codes


Code Description
31400 User ID and OU ID are required
31403 The application has no access to user information or asset information
31404 The user is not found, or not in the organization

Samples

Request Sample


url: https://alpha-apim-cn4.eniot.io/app-portal-service/v2.2/user/asset/list
method: POST
requestBody:
{
  "userId": "yourUserId",
  "orgId": "yourOrgId",
  "pagination": {
    "pageNo": 0,
    "pageSize": 1000,
  }
}

Response Sample

{
  "code": 0,
  "message": "",
  "data": {
    "pagination": {
      "totalElements": 2,
      "pageNo": 0,
      "pageSize": 1000
    },
    "assets": [
      {
        "id": "2rVQ6zfF",
        "name": {
          "default": "wyf_asset_01",
          "en_US": "wyf_asset_01"
        }
      },
      {
        "id": "Sx0faZHR",
        "name": {
          "default": "12345678901234567890123456789012345678901234567890",
          "en_US": "12345678901234567890123456789012345678901234567890"
        }
      }
    ]
  }
}