Obtaining the Event Channel List
Function
This API is used to obtain the list of event channels, including system and custom channels.
URI
GET /v1/{project_id}/channels
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Tenant resource space ID. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
offset |
No |
Integer |
Offset, which is the position where the query starts. The value must be greater than or equal to 0. |
limit |
No |
Integer |
Number of records displayed on each page. The value must be within the range [1, 1000]. |
sort |
No |
String |
Sorting mode of the query results. |
provider_type |
No |
String |
Type of the provider. |
name |
No |
String |
Name of the event channel. It is used for exact match. |
fuzzy_name |
No |
String |
Name of the event channel. It is used for fuzzy match. |
enterprise_project_id |
No |
String |
Enterprise project ID for exact match. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
total |
Integer |
Total number of records. |
size |
Integer |
Number of records displayed on the current page. |
items |
Array of ChannelInfo objects |
Object list. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
ID of the event channel. |
name |
String |
Name of the event channel. |
description |
String |
Description of the event channel. |
provider_type |
String |
Event channel provider type, which can be OFFICIAL (official event channel), CUSTOM (custom event channel), or PARTNER (partner event channel). |
created_time |
String |
UTC time when the event channel is created. |
updated_time |
String |
UTC time when the event channel is updated. |
enterprise_project_id |
String |
Enterprise project ID. |
Example Requests
Obtain the event channel list.
GET https://{endpoint}/v1/{project_id}/channels
Example Responses
Status code: 200
Operation successful.
{ "total" : 1, "size" : 1, "items" : [ { } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
Operation successful. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot