メニュー

Expand
ページを評価:

Job Resource

The Job resource allows you to view and delete the requests for exports of arbitrary date ranges, submitted through the ExportCustom Job.

Job properties

Resource Properties in REST API format
resource_type
文字列 Not PII

The type of communication – Messages, Calls, Conferences, and Participants

friendly_name
文字列 Not PII

The friendly name specified when creating the job

details
オブジェクト Not PII

The details of a job which is an object that contains an array of status grouped by status state. Each status object has a status string, a count which is the number of days in that status, and list of days in that status. The day strings are in the format yyyy-MM-dd. As an example, a currently running job may have a status object for COMPLETED and a status object for SUBMITTED each with its own count and list of days.

start_day
文字列 Not PII

The start time for the export specified when creating the job

end_day
文字列 Not PII

The end time for the export specified when creating the job

job_sid
sid<JS> Not PII

The job_sid returned when the export was created

webhook_url
文字列 Not PII

The optional webhook url called on completion

webhook_method
文字列 Not PII

This is the method used to call the webhook

email
文字列 Not PII

The optional email to send the completion notification to

url
url Not PII

job_queue_position
文字列 Not PII

This is the job position from the 1st in line. Your queue position will never increase. As jobs ahead of yours in the queue are processed, the queue position number will decrease

estimated_completion_time
文字列 Not PII

this is the time estimated until your job is complete. This is calculated each time you request the job list. The time is calculated based on the current rate of job completion (which may vary) and your job queue position

ENUM:STATUS possible values in REST API format
ErrorDuringRun

The Job was attempted, but an error prevented completion. This is not a final status, the job will be retried.

Submitted

The Job has been successfully submitted and is in the queue to execute.

Running

The job is currently running. The output should be available shortly. Multiple Jobs may run at the same time. You can use the ‘estimated_completion_time’ to get a sense of when your job will be complete.

CompletedEmptyRecords

The Job has completed, however, no records for the requested resource have been found. An empty file will be available at the Day endpoint.

Completed

The Job is successfully completed, and the result files are available at the Day endpoint.

Failed

The Job was attempted, but an error prevented completion. This is a final status, as the job has already been tried multiple times and has not been successful. Try submitting the job again, or reach out to your Twilio support team if problem continues to persist.

RunningToBeDeleted

The Job is currently running, but it has been marked for deletion, and will be deleted soon.

DeletedByUserRequest

The Job has been marked for deletion. So system will not attempt to run it.

Fetch a Job resource

GET
https://bulkexports.twilio.com/v1/Exports/Jobs/{JobSid}
パラメーター
Parameters in REST API format
job_sid
Path
GET sid<JS> Not PII

The unique string that that we created to identify the Bulk Export job

例 1
        
        
        

        Delete a Job resource

        削除する
        https://bulkexports.twilio.com/v1/Exports/Jobs/{JobSid}
        パラメーター
        Parameters in REST API format
        job_sid
        Path
        削除する sid<JS> Not PII

        The unique string that that we created to identify the Bulk Export job

        例 1
              
              
              
              ページを評価:

              ヘルプが必要ですか?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.

                    
                    
                    

                    フィードバックくださりありがとうございます!

                    We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    Refer us and get $10 in 3 simple steps!

                    ステップ1

                    Get link

                    Get a free personal referral link here

                    ステップ2:

                    Give $10

                    Your user signs up and upgrade using link

                    ステップ3

                    Get $10

                    1,250 free SMSes
                    OR 1,000 free voice mins
                    OR 12,000 chats
                    OR more