Querying Details About a Model
Function
This API is used to query the workspace details of a physical or logical model.
URI
GET /v2/{project_id}/design/workspaces/{model_id}
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        Yes  | 
      
        String  | 
      
        Project ID  | 
     
| 
        model_id  | 
      
        Yes  | 
      
        String  | 
      
        Parameters for querying workspaces by ID  | 
     
Request Parameters
None
Response Parameters
Status code: 200
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        id  | 
      
        Long  | 
      
        ID  | 
     
| 
        name  | 
      
        String  | 
      
        Workspace name Maximum: 250  | 
     
| 
        description  | 
      
        String  | 
      
        Maximum: 600  | 
     
| 
        is_physical  | 
      
        Boolean  | 
      
        Whether the table is a physical table Default: true  | 
     
| 
        frequent  | 
      
        Boolean  | 
      
        Whether the workspace is frequently used Default: true  | 
     
| 
        top  | 
      
        Boolean  | 
      
        Hierarchical governance Default: true  | 
     
| 
        level  | 
      
        String  | 
      
        Data governance level Enumeration values: 
  | 
     
| 
        dw_type  | 
      
        String  | 
      
        Data connection type  | 
     
| 
        create_time  | 
      
        String  | 
      
        Creation time  | 
     
| 
        update_time  | 
      
        String  | 
      
        Update time  | 
     
| 
        create_by  | 
      
        String  | 
      
        Creator  | 
     
| 
        update_by  | 
      
        String  | 
      
        User who updated the workspace  | 
     
| 
        type  | 
      
        String  | 
      
        Workspace types Enumeration values: 
  | 
     
| 
        biz_catalog_ids  | 
      
        String  | 
      
        IDs of business catalogs, including l1Ids, l2Ids, and l3Ids  | 
     
| 
        databases  | 
      
        Array of strings  | 
      
        Array of database names  | 
     
Status code: 400
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Error code, for example, DS.000 which indicates that the request was successfully processed.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Error message  | 
     
| 
        data  | 
      
        Object  | 
      
        Returned data  | 
     
Status code: 401
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Error code, for example, DS.000 which indicates that the request was successfully processed.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Error message  | 
     
| 
        data  | 
      
        Object  | 
      
        Returned data  | 
     
Status code: 403
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Error code, for example, DS.000 which indicates that the request was successfully processed.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Error message  | 
     
| 
        data  | 
      
        Object  | 
      
        Returned data  | 
     
Example Requests
None
Example Responses
Status code: 200
The operation succeeds. WorkspaceVO is returned.
{
  "id" : "1014218815216717824",
  "name" : "test",
  "description" : "abc123",
  "is_physical" : true,
  "frequent" : false,
  "top" : true,
  "level" : "SDI",
  "dw_type" : "DLI",
  "create_time" : "2022-08-30T17:03:29+08:00",
  "update_time" : "2022-08-30T17:05:08.773+08:00",
  "create_by" : "abc",
  "update_by" : "abc",
  "type" : "THIRD_NF",
  "biz_catalog_ids" : null,
  "databases" : null
}
 Status Codes
| 
        Status Code  | 
      
        Description  | 
     
|---|---|
| 
        200  | 
      
        The operation succeeds. WorkspaceVO is returned.  | 
     
| 
        400  | 
      
        BadRequest  | 
     
| 
        401  | 
      
        Unauthorized  | 
     
| 
        403  | 
      
        Forbidden  | 
     
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.