Add 'orderby' to TransferClient.task_list

src/globus_sdk/services/transfer/client.py

@@ -1515,7 +1515,7 @@ def task_list(
         :param offset: offset used in paging
         :param orderby: One or more order-by options. Each option is
             either a field name or a field name followed by a space and 'ASC' or 'DESC'
-            for ascending or descending.
+            for ascending or descending. See example usage for details.
         :param filter: Only return task documents which match these filter clauses. For
             the filter syntax, see the **External Documentation** linked below. If a
             dict is supplied as the filter, it is formatted as a set of filter clauses.
@@ -1553,6 +1553,20 @@ def task_list(
                             f"{task['source_endpoint']} -> {task['destination_endpoint']}"
                         )
 
+                Fetch the last 5 failed tasks by submission time:
+
+                    tc = TransferClient(...)
+                    for task in tc.task_list(
+                        limit=5,
+                        orderby="request_time DESC",
+                        filter={"status": "FAILED"}
+                    ):
+                        print(
+                            f"Task({task['task_id']}) failed: "
+                            f"{task['source_endpoint']} -> {task['destination_endpoint']}"
+                        )
+
+
             .. tab-item:: Paginated Usage
 
                 .. paginatedusage:: task_list