ListSkillGroups-阿里云帮助中心

You can invoke ListSkillGroups to obtain the list of skill groups under a specified instance.

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
InstanceId	string	Yes	The instance ID.	ccc-test
SearchPattern	string	No	Performs fuzzy matching based on the skill group name or display name. This parameter is optional and defaults to empty, which means no filtering is applied.	测试技能组
PageNumber	integer	Yes	The page number, ranging from 1 to 100.	1
PageSize	integer	Yes	The paging size, ranging from 1 to 100.	10
MediaType	string	No	The media type. The default is AUDIO. Other options include CHAT and VIDEO.	Audio

Response elements

Element	Type	Description	Example
	object
Code	string	The response code.	OK
HttpStatusCode	integer	HTTP status code.	200
Message	string	Response message.	无
RequestId	string	Request ID.	BA03159C-E808-4FF1-B27E-A61B6E888D7F
Data	object	Data.
PageNumber	integer	Page number, ranging from 1 to 100.	1
PageSize	integer	Page size, ranging from 1 to 100.	10
TotalCount	integer	Total count.	1
List	array<object>	List of skill groups.
	object
DisplayName	string	The display name of the skill group.	测试技能组
Description	string	Description of the skill group.	云联络中心的测试技能组。
PhoneNumberCount	integer	Quantity of phone numbers associated with the skill group.	1
SkillGroupId	string	The skill group ID.	skillgroup@ccc-test
SkillGroupName	string	Name of the skill group.	skillgroup
UserCount	integer	The number of agents associated with the skill group.	2
InstanceId	string	Instance ID.	ccc-test
MediaType	string	The media type. The default is AUDIO. Other options include CHAT and VIDEO.	CHAT

Examples

Success response

JSON format

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "BA03159C-E808-4FF1-B27E-A61B6E888D7F",
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 1,
    "List": [
      {
        "DisplayName": "测试技能组",
        "Description": "云联络中心的测试技能组。",
        "PhoneNumberCount": 1,
        "SkillGroupId": "skillgroup@ccc-test",
        "SkillGroupName": "skillgroup",
        "UserCount": 2,
        "InstanceId": "ccc-test",
        "MediaType": "CHAT"
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message
400	Parameter.Maximum	The parameter %s must be less than or equal to %s.
400	Parameter.Minimum	The parameter %s must be greater than or equal to %s.
400	Parameter.Null	The parameter %s may not be null.
404	NotExists.InstanceId	The specified instance %s does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.