ListDataServiceApiAuthorities

Updated at:

Retrieves the list of APIs that have been authorized to other users.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ProjectId

integer

Yes

The workspace ID.

10000

PageNumber

integer

No

The page number. Pages start from 1. Default value: 1.

1

PageSize

integer

No

The number of entries per page. Default value: 10. Maximum value: 50.

10

TenantId

integer

No

[Deprecated] The tenant ID.

10001

ApiNameKeyword

string

No

The keyword in the API name. This parameter is used to filter APIs whose names contain the specified keyword.

MyAPIName

Response elements

Element

Type

Description

Example

object

The response structure.

HttpStatusCode

integer

The HTTP status code.

200

RequestId

string

The request ID. A unique identifier for the request.

0000-ABCD-EFG****

ErrorMessage

string

The error message.

Normal

Success

boolean

Indicates whether the call was successful.

true

ErrorCode

string

The error code.

0

Data

object

The list of APIs authorized to other users.

PageNumber

integer

The page number, which is the same as the PageNumber value in the request.

1

PageSize

integer

The number of entries per page. Default value: 10. Maximum value: 100.

10

TotalCount

integer

The total number of records.

100

ApiAuthorizationList

array<object>

The response structure.

array<object>

The response structure.

ApiStatus

integer

The status of the API. Valid values: 0: unpublished. 1: published.

0

ApiId

integer

The API ID.

10002

ModifiedTime

string

The time when the API was last modified, in the yyyy-MM-dd'T'HH:mm:ssZ format (the example time zone is +0800).

2020-06-23T00:21:01+0800

GroupId

string

The group ID.

ab123

ProjectId

integer

The workspace ID.

10000

CreatorId

string

The Alibaba Cloud ID of the API owner.

12345

CreatedTime

string

The time when the API was created, in the yyyy-MM-dd'T'HH:mm:ssZ format (the example time zone is +0800).

2020-06-23T00:21:01+0800

ApiName

string

The name of the API.

MyAPIName

TenantId

integer

The tenant ID.

10001

ApiPath

string

The path of the API.

/test/1

AuthorizationRecords

array<object>

The list of authorization details for APIs authorized to other users.

object

The response structure.

EndTime

string

The end time of the authorization validity period, in the yyyy-MM-dd'T'HH:mm:ssZ format (the example time zone is +0800).

2020-06-24T00:21:01+0800

CreatorId

string

The Alibaba Cloud ID of the API owner.

12345

CreatedTime

string

The authorization time, in the yyyy-MM-dd'T'HH:mm:ssZ format (the example time zone is +0800).

2020-06-23T00:21:01+0800

ProjectId

integer

The workspace ID that has been granted the authorization.

10004

Examples

Success response

JSON format

{
  "HttpStatusCode": 200,
  "RequestId": "0000-ABCD-EFG****",
  "ErrorMessage": "Normal",
  "Success": true,
  "ErrorCode": "0",
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "ApiAuthorizationList": [
      {
        "ApiStatus": 0,
        "ApiId": 10002,
        "ModifiedTime": "2020-06-23T00:21:01+0800",
        "GroupId": "ab123",
        "ProjectId": 10000,
        "CreatorId": "12345",
        "CreatedTime": "2020-06-23T00:21:01+0800",
        "ApiName": "MyAPIName",
        "TenantId": 10001,
        "ApiPath": "/test/1",
        "AuthorizationRecords": [
          {
            "EndTime": "2020-06-24T00:21:01+0800",
            "CreatorId": "12345",
            "CreatedTime": "2020-06-23T00:21:01+0800",
            "ProjectId": 10004
          }
        ]
      }
    ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. No permission, please authorize
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.