QueryJobs-阿里云帮助中心

Queries a list of jobs.

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.	af81a389-91f0-4157-8d82-720edd02b66a
ScenarioId	string	No	The scenario ID. This is a legacy parameter and has been deprecated.	b0f35dd1-0337-402e-9c4f-3a6c2426950a
JobGroupId	string	No	The job group ID.	994b8baf-7ef8-480c-b141-b7b6db77c4df
StartTime	integer	No	The filter condition for the start time. Default value: 0, which indicates the start of the current day.	1579068424883
EndTime	integer	No	The filter condition for the end time. Default value: 0, which indicates the current time.	1579077794665
TimeAlignment	string	No	Specifies whether to query by start time, end time, or job creation time. Valid values: start, end, job_create.	start
ContactName	string	No	The filter condition for the contact name.	张三
PhoneNumber	string	No	The filter condition for the contact phone number.	135****8888
PageNumber	integer	Yes	The page number.	1
PageSize	integer	Yes	The page size.	10

Response elements

Element	Type	Description	Example
	object
HttpStatusCode	integer	The response code.	200
Code	string	The HTTP status code.	OK
Message	string	The response message.	Success
RequestId	string	The request ID.	254EB995-DEDF-48A4-9101-9CA5B72FFBCC
Success	boolean	Indicates whether the request was successful.	true
Jobs	object	The job data.
PageNumber	integer	The page number.	1
PageSize	integer	The page size.	10
TotalCount	integer	The total number of records.	1
List	array<object>	The list of jobs.
	array<object>
Status	string	The job status. Valid values: Scheduling(0): Scheduling. Executing(1): Executing. Succeeded(2): Completed - Reached. Paused(3): Paused. Failed(4): Completed - Not reached. Cancelled(5): Cancelled - Manual intervention. Drafted(6): Draft.	Succeeded
JobGroupId	string	The job group ID.	fce6c599-8ede-40e3-9f78-0928eda7b4e8
ScenarioId	string	The scenario ID. This is a legacy parameter and has been deprecated.	ade80092-03d9-4f4d-ad4f-ab8a247d3150
StrategyId	string	The strategy ID.	c8a2b7f2-ad1a-4865-b872-d0080d9802d9
JobId	string	The job ID.	fce6c599-8ede-40e3-9f78-0928eda7b4e8
Priority	integer	The priority.	1
FailureReason	string	The failure reason. Valid values: Unknown: Unknown error. NoAnswer: No answer. InvalidStrategy: Invalid strategy. The strategy configuration is incorrect. TimeUp: Timeout detected during scheduling. NoStrategy: The strategy is empty or not found. CallFailed: Call failed. PerDayCallCountLimit: Daily call count limit for the number reached. ContactBlockList: The number is on the blocked list. EmptyNumber: Nonexistent number. No further outbound calls. JobPerDayCallCountLimit: Daily call count limit for the number reached. VerificationCancelled: Pre-call verification failed and the call was cancelled. ContactSuspended: Call suspended. InArrears: Overdue payment. OutOfService: Out of service.	NoAnswer
ReferenceId	string	The associated business ID.	d5971d98-7312-4f0e-a918-a17d67133e28
Contacts	array<object>	The contact information. This parameter has been deprecated. Note You can retrieve this information by calling the DescribeJob operation.
	object
PhoneNumber	string	The phone number.	135****8888
State	string	The status. Valid values: Available: Normal. WrongNumber: Wrong number. DoesNotExist: Nonexistent number. Suspended: Call suspended.	Available
ContactId	string	The contact ID.	db3db762-e421-44c9-9a01-cb423470757c
Honorific	string	The honorific title.	张先生
JobId	string	The job ID.	fce6c599-8ede-40e3-9f78-0928eda7b4e8
ContactName	string	The contact name.	张三
Role	string	The role.	*
ReferenceId	string	The associated business ID.	2fa6bac3-06da-4315-82ab-72d6fd3a6f34
Extras	array<object>	The business data. Displays label collection results for large language model scenarios. Note Keys equal to TenantId or ServiceId are system parameters.
	object
Key	string	The business data key.	djrq
Value	string	The business data value.	2019-08-21 09:49:59.0
Summary	array<object>	The conversation summary. This is a legacy field and is no longer in use. Deprecated.
	object
SummaryName	string	The summary name.	score
GroupId	string	The job group ID.	ba1ba502-d044-48c0-b710-0f1f840a7c53
JobId	string	The job ID.	b72425bd-7871-4050-838e-033d80d754b7
Category	string	The category.	{}
TaskId	string	The call ID.	9fdf7a81-6781-4ab8-92fb-1d4231ef365e
Content	string	The content.	5
ConversationDetailId	string	The call record ID.	098b9b09-9223-4a8b-a422-99726f0457f3
SummaryId	string	The summary ID.	dc67d544-df06-4625-ae48-13e3c9f72d8a
Tasks	array<object>	The call list. This parameter has been deprecated. Note You can retrieve this information by calling the searchTask operation.
	array<object>
Status	string	The task status. Note: The Succeeded status has been subdivided into specific reason types. The Succeeded: 1 (Connected) status is no longer returned. Instead, the specific sub-reason type is returned. Valid values: Executing: 0 (Dialing). Succeeded: 1 (Connected). NoAnswer: 2 (Not connected - No answer). NotExist: 3 (Not connected - Nonexistent number). Busy: 4 (Not connected - Busy). Cancelled: 5 (Not dialed - Task stopped). Failed: 6 (Failed). NotConnected: 7 (Not connected - Unreachable). PoweredOff: 8 (Not connected - Powered off). OutOfService: 9 (Not connected - Called party out of service). InArrears: 10 (Not connected - Called party has overdue payment). EmptyNumber: 11 (Not dialed - Nonexistent number). PerDayCallCountLimit: 12 (Not dialed - Daily limit exceeded). ContactBlockList: 13 (Not dialed - Blocked list). CallerNotRegistered: 14 (Not dialed - Caller number not registered). Terminated: 15 (Not dialed - Terminated). VerificationCancelled: 16 (Not dialed - Pre-call verification failed). OutOfServiceNoCall: 17 (Not dialed - Called party out of service). InArrearsNoCall: 18 (Not dialed - Called party has overdue payment). CallingNumberNotExist: 19 (Not dialed - Caller number does not exist). SucceededFinish: 20 (Connected - Completed normally). SucceededChatbotHangUpAfterNoAnswer: 21 (Connected - Robot hung up after no recognition). SucceededChatbotHangUpAfterSilence: 22 (Connected - Hung up due to silence timeout). SucceededClientHangUpAfterNoAnswer: 23 (Connected - User hung up after no recognition). SucceededClientHangUp: 24 (Connected - User hung up without reason). SucceededTransferByIntent: 25 (Connected - Transferred to agent by intent). SucceededTransferAfterNoAnswer: 26 (Connected - Transferred to agent after no recognition). SucceededInoInterAction: 27 (Connected - No interaction from user). SucceededError: 28 (Connected - System error interruption). SucceededSpecialInterceptVoiceAssistant: 29 (Connected - Special intercept - Voice assistant). SucceededSpecialInterceptExtensionNumberTransfer: 30 (Connected - Special intercept - Extension number transfer). SucceededSpecialInterceptCustomSpecialIntercept: 31 (Connected - Special intercept - Custom intercept). HighRiskSipCode: 32 (Not dialed - High risk).	Succeeded
PlanedTime	integer	The planned outbound call time.	1579068424883
ChatbotId	string	The robot ID.	1234
ActualTime	integer	The actual outbound call time.	1579068424883
CalledNumber	string	The called number.	135****8888
ScenarioId	string	The scenario ID.	ade80092-03d9-4f4d-ad4f-ab8a247d3150
JobId	string	The job ID.	b72425bd-7871-4050-838e-033d80d754b7
CallId	string	SIP call ID。	1528189846043
CallingNumber	string	The calling number.	0571****3106
Brief	string	The summary. This is a legacy field and is no longer in use.	1
Duration	integer	The call duration.	120
TaskId	string	The call ID.	ff44709e-39a6-43ba-959b-20fcabe3e496
Contact	object	The contact information.
PhoneNumber	string	The contact phone number.	135****8888
State	string	The status.	Available
ContactId	string	The contact ID.	db3db762-e421-44c9-9a01-cb423470757c
Honorific	string	The honorific title.	张先生
JobId	string	The job ID.	b72425bd-7871-4050-838e-033d80d754b7
ContactName	string	The contact name.	张三
Role	string	The role.	*
ReferenceId	string	The associated business ID.	2fa6bac3-06da-4315-82ab-72d6fd3a6f34
CallingNumbers	array	The list of calling numbers.
	string	The list of calling numbers.	["0571****3106"]
TagHits	array<object>	The tag hit information in small model scenarios.
	object
TagName	string	The tag name.	有意向
TagGroup	string	The tag group name.	意向收集

Examples

Success response

JSON format

{
  "HttpStatusCode": 200,
  "Code": "OK",
  "Message": "Success",
  "RequestId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
  "Success": true,
  "Jobs": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 1,
    "List": [
      {
        "Status": "Succeeded",
        "JobGroupId": "fce6c599-8ede-40e3-9f78-0928eda7b4e8",
        "ScenarioId": "ade80092-03d9-4f4d-ad4f-ab8a247d3150",
        "StrategyId": "c8a2b7f2-ad1a-4865-b872-d0080d9802d9",
        "JobId": "fce6c599-8ede-40e3-9f78-0928eda7b4e8",
        "Priority": 1,
        "FailureReason": "NoAnswer",
        "ReferenceId": "d5971d98-7312-4f0e-a918-a17d67133e28",
        "Contacts": [
          {
            "PhoneNumber": "135****8888",
            "State": "Available",
            "ContactId": "db3db762-e421-44c9-9a01-cb423470757c",
            "Honorific": "张先生",
            "JobId": "fce6c599-8ede-40e3-9f78-0928eda7b4e8\n",
            "ContactName": "张三",
            "Role": "*",
            "ReferenceId": "2fa6bac3-06da-4315-82ab-72d6fd3a6f34"
          }
        ],
        "Extras": [
          {
            "Key": "djrq",
            "Value": "2019-08-21 09:49:59.0"
          }
        ],
        "Summary": [
          {
            "SummaryName": "score",
            "GroupId": "ba1ba502-d044-48c0-b710-0f1f840a7c53",
            "JobId": "b72425bd-7871-4050-838e-033d80d754b7\n",
            "Category": "{}",
            "TaskId": "9fdf7a81-6781-4ab8-92fb-1d4231ef365e",
            "Content": "5",
            "ConversationDetailId": "098b9b09-9223-4a8b-a422-99726f0457f3",
            "SummaryId": "dc67d544-df06-4625-ae48-13e3c9f72d8a"
          }
        ],
        "Tasks": [
          {
            "Status": "Succeeded",
            "PlanedTime": 1579068424883,
            "ChatbotId": "1234",
            "ActualTime": 1579068424883,
            "CalledNumber": "135****8888",
            "ScenarioId": "ade80092-03d9-4f4d-ad4f-ab8a247d3150",
            "JobId": "b72425bd-7871-4050-838e-033d80d754b7",
            "CallId": "1528189846043",
            "CallingNumber": "0571****3106",
            "Brief": "1",
            "Duration": 120,
            "TaskId": "ff44709e-39a6-43ba-959b-20fcabe3e496",
            "Contact": {
              "PhoneNumber": "135****8888",
              "State": "Available",
              "ContactId": "db3db762-e421-44c9-9a01-cb423470757c",
              "Honorific": "张先生",
              "JobId": "b72425bd-7871-4050-838e-033d80d754b7",
              "ContactName": "张三",
              "Role": "*",
              "ReferenceId": "2fa6bac3-06da-4315-82ab-72d6fd3a6f34"
            }
          }
        ],
        "CallingNumbers": [
          "[\"0571****3106\"]"
        ],
        "TagHits": [
          {
            "TagName": "有意向",
            "TagGroup": "意向收集"
          }
        ]
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message
400	InvalidParameter	The specified parameter %s is invalid.
500	InternalError	An error occurred while processing your request. Please try again later. Submit a ticket if the error still exists.
404	NotExist.Instance	The specified Instance does not exist.
404	NotExist.JobGroup	The specified JobGroup does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.