Job Scheduler - List Item Schedules

Αναφορά

Υπηρεσία:: Core

Έκδοση API:: v1

Λάβετε ρυθμίσεις προγραμματισμού για ένα συγκεκριμένο στοιχείο.
Αυτό το API υποστηρίζει σελιδοποίησης .

Απαιτούμενες εμβέλειες με ανάθεση

Για τα API στοιχείων χρησιμοποιήστε αυτούς τους τύπους εμβέλειας:

Γενική εμβέλεια: Item.ReadWrite.All ή Item.Read.All
Συγκεκριμένη εμβέλεια: itemType. ReadWrite.All ή itemType. Read.All (για παράδειγμα: Notebook.ReadWrite.All)

Για περισσότερες πληροφορίες σχετικά με τις εμβέλειες, ανατρέξτε στο άρθρο για τις εμβέλειες.

Υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα	Υποστηρίζω
Χρήστης	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Όχι

Διεπαφή

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/jobs/{jobType}/schedules

Με προαιρετικές παραμέτρους:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/jobs/{jobType}/schedules?continuationToken={continuationToken}

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
itemId	path	True	string uuid	Το αναγνωριστικό στοιχείου.
jobType	path	True	string	Ο τύπος εργασίας.
workspaceId	path	True	string uuid	Το αναγνωριστικό χώρου εργασίας.
continuationToken	query		string	Ένα διακριτικό για την ανάκτηση της επόμενης σελίδας αποτελεσμάτων.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
200 OK	ItemSchedules	Ανακτήσατε με επιτυχία όλα τα χρονοδιαγράμματα στοιχείων.
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: InsufficientPrivileges - Ο καλών δεν διαθέτει επαρκή δικαιώματα για πρόσβαση στο στοιχείο ItemNotFound - Το αναγνωριστικό στοιχείου που ζητήθηκε δεν βρέθηκε

Όνομα

Τύπος

Περιγραφή

200 OK

ItemSchedules

Ανακτήσατε με επιτυχία όλα τα χρονοδιαγράμματα στοιχείων.

Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

InsufficientPrivileges - Ο καλών δεν διαθέτει επαρκή δικαιώματα για πρόσβαση στο στοιχείο
ItemNotFound - Το αναγνωριστικό στοιχείου που ζητήθηκε δεν βρέθηκε

Παραδείγματα

List item schedules example

Δείγμα αίτησης

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/3546052c-ae64-4526-b1a8-52af7761426f/jobs/DefaultJob/schedules

Δείγμα απόκρισης

Κωδικός κατάστασης:: 200

{
  "value": [
    {
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "enabled": true,
      "createdDateTime": "2024-04-28T05:35:20.5366667",
      "configuration": {
        "startDateTime": "2024-04-28T00:00:00",
        "endDateTime": "2024-04-30T23:59:00",
        "localTimeZoneId": "Central Standard Time",
        "type": "Cron",
        "interval": 10
      },
      "owner": {
        "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
        "type": "User"
      }
    },
    {
      "id": "96f3f0ff-4fe2-4712-b61b-05a456ba9357",
      "enabled": true,
      "createdDateTime": "2024-04-28T05:35:20.5366667",
      "configuration": {
        "startDateTime": "2024-04-28T00:00:00",
        "endDateTime": "2024-04-30T23:59:00",
        "localTimeZoneId": "Central Standard Time",
        "type": "Weekly",
        "weekdays": [
          "Monday",
          "Tuesday"
        ],
        "times": [
          "18:09",
          "17:12"
        ]
      },
      "owner": {
        "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
        "type": "User"
      }
    },
    {
      "id": "c0ed1d27-32dc-49e6-90ba-cac9b6248c7f",
      "enabled": true,
      "createdDateTime": "2024-04-28T05:35:20.5366667",
      "configuration": {
        "startDateTime": "2024-04-28T00:00:00",
        "endDateTime": "2024-04-30T23:59:00",
        "localTimeZoneId": "Central Standard Time",
        "type": "Daily",
        "times": [
          "18:09",
          "17:12"
        ]
      },
      "owner": {
        "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
        "type": "User"
      }
    }
  ]
}

Ορισμοί

Όνομα	Περιγραφή
CronScheduleConfig
DailyScheduleConfig
DayOfWeek	Μια λίστα εργάσιμων ημερών, το πολύ επτά στοιχεία επιτρέπονται.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.
ItemSchedule	Χρονοδιάγραμμα στοιχείου.
ItemSchedules	λίστα χρονοδιαγραμμάτων για αυτό το στοιχείο.
Principal	Αντιπροσωπεύει μια ταυτότητα ή μια ομάδα Microsoft Entra.
PrincipalType	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.
WeeklyScheduleConfig

CronScheduleConfig

Object

Όνομα	Τύπος	Περιγραφή
endDateTime	string date-time	Η ώρα λήξης για αυτό το χρονοδιάγραμμα. Η ώρα λήξης πρέπει να είναι μεταγενέστερη της ώρας έναρξης.
interval	integer int32	Το χρονικό διάστημα σε λεπτά. Ένας αριθμός μεταξύ 1 και 5270400 (10 έτη).
localTimeZoneId	string	Το μητρώο αναγνωριστικού ζώνης ώρας στον τοπικό υπολογιστή για Windows, ανατρέξτε στο θέμα Προεπιλεγμένες ζώνες ώρας
startDateTime	string date-time	Η ώρα έναρξης για αυτό το χρονοδιάγραμμα. Εάν η ώρα έναρξης είναι παλαιότερα, θα ενεργοποιήσει μια εργασία αμέσως.
type	string: Cron	Μια συμβολοσειρά αντιπροσωπεύει τον τύπο του σχεδίου. Πρόσθετοι τύποι planType μπορούν να προστεθούν με την πάροδο του χρόνου.

DailyScheduleConfig

Object

Όνομα	Τύπος	Περιγραφή
endDateTime	string date-time	Η ώρα λήξης για αυτό το χρονοδιάγραμμα. Η ώρα λήξης πρέπει να είναι μεταγενέστερη της ώρας έναρξης.
localTimeZoneId	string	Το μητρώο αναγνωριστικού ζώνης ώρας στον τοπικό υπολογιστή για Windows, ανατρέξτε στο θέμα Προεπιλεγμένες ζώνες ώρας
startDateTime	string date-time	Η ώρα έναρξης για αυτό το χρονοδιάγραμμα. Εάν η ώρα έναρξης είναι παλαιότερα, θα ενεργοποιήσει μια εργασία αμέσως.
times	string[]	Μια λίστα χρονικών διαστημάτων σε μορφή hh:mm, επιτρέπονται το πολύ 100 στοιχεία.
type	string: Daily	Μια συμβολοσειρά αντιπροσωπεύει τον τύπο του σχεδίου. Πρόσθετοι τύποι planType μπορούν να προστεθούν με την πάροδο του χρόνου.

DayOfWeek

Απαρίθμηση

Μια λίστα εργάσιμων ημερών, το πολύ επτά στοιχεία επιτρέπονται.

Τιμή	Περιγραφή
Friday	Παρασκευή
Monday	Δευτέρα
Saturday	Σάββατο
Sunday	Κυριακή
Thursday	Πέμπτη
Tuesday	Τρίτη
Wednesday	Τετάρτη

ErrorRelatedResource

Object

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Object

Η απόκριση σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Object

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GroupDetails

Object

Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι Group.

Όνομα	Τύπος	Περιγραφή
groupType	GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

GroupType

Απαρίθμηση

Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
DistributionList	Το Principal είναι μια λίστα διανομής.
SecurityGroup	Το Principal είναι μια ομάδα ασφαλείας.
Unknown	Ο κύριος τύπος ομάδας είναι άγνωστος.

ItemSchedule

Object

Χρονοδιάγραμμα στοιχείου.

Όνομα	Τύπος	Περιγραφή
configuration	ScheduleConfig: CronScheduleConfig DailyScheduleConfig WeeklyScheduleConfig	Τα πραγματικά δεδομένα περιέχουν την ώρα/εργάσιμες ημέρες αυτού του χρονοδιαγράμματος.
createdDateTime	string date-time	Η χρονική σήμανση αυτού του χρονοδιαγράμματος που δημιουργήθηκε σε Μορφή Utc.
enabled	boolean	Εάν αυτό το χρονοδιάγραμμα είναι ενεργοποιημένο. True - Ενεργοποιημένη, False - Απενεργοποιημένη.
id	string uuid	Το αναγνωριστικό χρονοδιαγράμματος.
owner	Principal	Η ταυτότητα χρήστη που δημιούργησε αυτό το χρονοδιάγραμμα ή τροποποιήθηκε τελευταία φορά.

ItemSchedules

Object

λίστα χρονοδιαγραμμάτων για αυτό το στοιχείο.

Όνομα	Τύπος	Περιγραφή
continuationToken	string	Το διακριτικό για την επόμενη δέσμη συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
continuationUri	string	Το URI της δέσμης επόμενου συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
value	ItemSchedule[]	λίστα χρονοδιαγραμμάτων για αυτό το στοιχείο.

Principal

Object

Αντιπροσωπεύει μια ταυτότητα ή μια ομάδα Microsoft Entra.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
groupDetails	GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
id	string uuid	Το αναγνωριστικό του διευθυντή.
servicePrincipalDetails	ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
type	PrincipalType	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
userDetails	UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.

PrincipalType

Απαρίθμηση

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Group	Το Principal είναι μια ομάδα ασφαλείας.
ServicePrincipal	Το Principal είναι μια κύρια υπηρεσία Microsoft Entra.
ServicePrincipalProfile	Το Principal είναι ένα προφίλ κύριας υπηρεσίας.
User	Το Principal είναι μια κύρια χρήστης του Microsoft Entra.

ServicePrincipalDetails

Object

Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipal.

Όνομα	Τύπος	Περιγραφή
aadAppId	string uuid	Το Microsoft Entra AppId της κύριας υπηρεσίας.

ServicePrincipalProfileDetails

Object

Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipalProfile.

Όνομα	Τύπος	Περιγραφή
parentPrincipal	Principal	Η γονική οντότητα του προφίλ κύριας υπηρεσίας.

UserDetails

Object

Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι User.

Όνομα	Τύπος	Περιγραφή
userPrincipalName	string	Το κύριο όνομα χρήστη.

WeeklyScheduleConfig

Object

Όνομα	Τύπος	Περιγραφή
endDateTime	string date-time	Η ώρα λήξης για αυτό το χρονοδιάγραμμα. Η ώρα λήξης πρέπει να είναι μεταγενέστερη της ώρας έναρξης.
localTimeZoneId	string	Το μητρώο αναγνωριστικού ζώνης ώρας στον τοπικό υπολογιστή για Windows, ανατρέξτε στο θέμα Προεπιλεγμένες ζώνες ώρας
startDateTime	string date-time	Η ώρα έναρξης για αυτό το χρονοδιάγραμμα. Εάν η ώρα έναρξης είναι παλαιότερα, θα ενεργοποιήσει μια εργασία αμέσως.
times	string[]	Μια λίστα χρονικών διαστημάτων σε μορφή hh:mm, επιτρέπονται το πολύ 100 στοιχεία.
type	string: Weekly	Μια συμβολοσειρά αντιπροσωπεύει τον τύπο του σχεδίου. Πρόσθετοι τύποι planType μπορούν να προστεθούν με την πάροδο του χρόνου.
weekdays	DayOfWeek[]	Μια λίστα εργάσιμων ημερών, το πολύ επτά στοιχεία επιτρέπονται.

Κοινή χρήση μέσω

Job Scheduler - List Item Schedules

Απαιτούμενες εμβέλειες με ανάθεση

Υποστηριζόμενες ταυτότητες Microsoft Entra

Διεπαφή

Παράμετροι URI

Αποκρίσεις

Παραδείγματα

List item schedules example

Δείγμα αίτησης

Δείγμα απόκρισης

Ορισμοί

CronScheduleConfig

DailyScheduleConfig

DayOfWeek

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

ItemSchedule

ItemSchedules

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails

WeeklyScheduleConfig

Πρόσθετοι πόροι