Statistiken zu Priority Job Slots abrufen
Gibt Statistiken zu Priority Job Slots für eine angegebene Region und einen Zeitraum zurück.
https://api2.transloadit.com/ priority_job_slot_statsRuft historische Nutzungsdaten für Priority Job Slots für die angeforderte Region und den angeforderten Zeitraum ab.
Für region: "all" werden die regionalen Minutenmaxima für jede Minute summiert. Anschließend wird für jeden Bucket und für maxSlotCount die größte
Minutensumme ausgewählt. Regionale Spitzenwerte können zu unterschiedlichen Zeitpunkten innerhalb derselben Minute auftreten,
sodass dieser Wert den tatsächlichen gleichzeitigen regionsübergreifenden Spitzenwert übersteigen kann.
Dieselbe Berechnung wird von slot_count verwendet, wenn aggregation: "max" gilt.
Anfragebeispiel
Führen Sie diese Anfrage in einer serverseitigen Shell mit curl und einem geeigneten Bearer-Token in TRANSLOADIT_TOKEN aus. Wenn Sie ein Token benötigen, klappen Sie die folgende Anleitung zur Einrichtung auf.
Dieses Beispiel verwendet außerdem jq, um dynamische Werte als JSON zu kodieren.
Benötigen Sie ein Bearer-Token?
Setzen Sie in einer vertrauenswürdigen serverseitigen Shell mit curl und jq die Variablen TRANSLOADIT_KEY und TRANSLOADIT_SECRET auf Ihren Auth Key bzw. Ihr Auth Secret. Halten Sie beide Zugangsdaten und das resultierende Token geheim; führen Sie diese Einrichtung niemals in Browsercode aus.
Erstellen Sie zunächst ein Token mit den für diesen Endpunkt erforderlichen Scopes. Ihr Auth Key muss diese Scopes bereits gewähren.
if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
--request POST \
--url 'https://api2.transloadit.com/token' \
--user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'aud=api2' \
--data-urlencode 'scope=queues:read')"; then
printf '%s\n' "$TOKEN_RESPONSE" >&2
exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
jq -er '.access_token | strings | select(length > 0)')" || exit 1
Lassen Sie diese Shell geöffnet und führen Sie die unten stehende Anfrage aus. Verwenden Sie das Token erneut, solange es gültig ist.
SINCE="$(date -u +%Y-%m-%dT00:00:00Z)"
PARAMS="$(jq -cn --arg since "${SINCE:?Set SINCE}" '{"region":"us-east-1","since":$since}')"
curl --fail-with-body -sS --request GET --get \
--url "https://api2.transloadit.com/priority_job_slot_stats" \
--header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
--data-urlencode "params=$PARAMS"
Authentifizierung
Dieser Endpunkt akzeptiert signierte params oder ein Bearer-Token. Anweisungen zur Einrichtung finden Sie unter Authentifizierung.
Erforderlicher Berechtigungsumfang für Auth Key oder Bearer-Token: queues:read.
Signierte Anfragen erfordern sowohl eine signature als auch einen in der Zukunft liegenden Zeitstempel für params.auth.expires. Bearer-Tokens erfordern keines von beiden.
Query-Parameter
params(JSON-Zeichenfolge), erforderlich. Ein JSON-codiertes Objekt, dessen unterstützte Schlüssel unten aufgeführt sind.signature(Zeichenfolge). Für signierte Anfragen erforderlich. Lassen Sie dieses Feld weg, wenn Sie ein Bearer-Token verwenden.
Unterstützte Schlüssel im Feld params
Die Authentifizierungsfelder in dieser Liste gelten für signierte Anfragen. Mit einem Bearer-Token können Sie params.auth und das separate Feld signature weglassen. Vergleichen Sie unten die Anfrageparameter der einzelnen Authentifizierungsmethoden.
Vollständiges JSON Schema
params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
| Feld | Typ und Beschreibung |
|---|---|
params. | "avg" | "max" | nullWählt die durchschnittliche oder maximale Slot-Nutzung aus. Wird der Wert weggelassen oder ist er null, wird standardmäßig die durchschnittliche Nutzung verwendet. |
params.für signierte Anfragen erforderlich; mit einem Bearer-Token optional | Enthält den Transloadit-API-Schlüssel und Metadaten für die Signature Authentication einer Priority-Job-Slots-Anfrage.
|
params.erforderlich | stringISO-8601-Ablaufzeitstempel in der Zukunft. Erforderlich, wenn eine Anfrage signiert ist oder Signaturauthentifizierung erfordert; mit Bearer authentifizierte Anfragen können ihn weglassen. |
params.erforderlich | stringTransloadit API-Schlüssel zur Authentifizierung von Anfragen |
params. | string | integerEindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann. |
params. | string | integerEindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann. |
params.erforderlich | string (minimale Länge: 1)Einzubeziehende Region oder |
params.erforderlich | string (minimale Länge: 1)Datum und Uhrzeit des Beginns des Statistikzeitraums, höchstens 91 Tage in der Vergangenheit. ISO 8601 wird empfohlen; API2 unterstützt weiterhin Datumszeichenfolgen, die sein bestehender Parser akzeptiert. Ein längerer Rückblick wird mit dem Fehler des Endpunkts für einen ungültigen Zeitraum abgelehnt. |
Anfrageparameter nach Authentifizierungsmethode
Mit signierten Parametern
Geben Sie Ihren Auth Key als params.auth.key an. Wenn Sie die Anfrage signieren, geben Sie einen in der Zukunft liegenden Zeitstempel für params.auth.expires an und senden Sie die Signature im separaten Feld signature. Die folgenden Felddefinitionen verwenden Pfade innerhalb von params.
Vollständiges JSON Schema
params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
Verwendet die oben angegebenen Felddefinitionen: params.aggregation, params.auth, params.nonce, params.region, params.since
Mit einem Bearer-Token
Senden Sie das Bearer-Token im Authorization-Header. Sie können params.auth und das separate Feld signature weglassen. Die übrigen erforderlichen Parameter müssen weiterhin angegeben werden. Die folgenden Felddefinitionen verwenden Pfade innerhalb von params.
Vollständiges JSON Schema
params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
Verwendet die oben angegebenen Felddefinitionen: params.aggregation, params.nonce, params.region, params.since
| Feld | Typ und Beschreibung |
|---|---|
params. | Enthält den Transloadit-API-Schlüssel und Metadaten für die Signature Authentication einer Priority-Job-Slots-Anfrage.
|
params. | stringISO-8601-Ablaufzeitstempel in der Zukunft. Erforderlich, wenn eine Anfrage signiert ist oder Signaturauthentifizierung erfordert; mit Bearer authentifizierte Anfragen können ihn weglassen. |
params. | stringTransloadit API-Schlüssel zur Authentifizierung von Anfragen |
params. | string | integerEindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann. |
Antwort
Hier sehen Sie ein Beispiel für einen Antworttext:
{
"aggregation": "avg",
"avgSlotCount": 2,
"granularity": 300,
"maxSlotCount": 4,
"ok": "PRIORITY_JOB_SLOT_STATS_FOUND",
"stats": [
{
"avg_slot_count": 2,
"data_from_ts": 1789200000,
"max_slot_count": 4,
"slot_count": 2
}
]
}2xx-Erfolg
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Die Antwort enthält nur die für dieses Objekt aufgeführten Felder.
| Feld | Typ und Beschreibung | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
aggregationerforderlich | "avg" | "max" | ||||||||||
avgSlotCounterforderlich | number (Minimum: 0) | ||||||||||
granularityerforderlich | integer (exklusives Minimum: 0)Dauer jedes Statistikintervalls in Sekunden. | ||||||||||
maxSlotCounterforderlich | integer (Minimum: 0) | ||||||||||
okerforderlich | string (immer: "PRIORITY_JOB_SLOT_STATS_FOUND") | ||||||||||
statserforderlich | Array<object>Schema eines Array-Elements
|
HTTP 400
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Benannte Fehler und das allgemeine Fehlerformat
error: "PRIORITY_JOB_SLOT_STATS_INVALID_AGGREGATION"
aggregation muss entweder "avg" oder "max" sein.
Die Antwort kann zusätzliche Felder enthalten.
error: "PRIORITY_JOB_SLOT_STATS_INVALID_TIME"
Die Zeitangabe since fehlt oder ist falsch.
Die Antwort kann zusätzliche Felder enthalten.
error: "PRIORITY_JOB_SLOT_STATS_MISSING_REGION"
Es muss eine bestimmte region oder „all“ angegeben werden.
Die Antwort kann zusätzliche Felder enthalten.
Allgemeines Fehlerformat
HTTP 500
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Benannte Fehler und das allgemeine Fehlerformat
error: "PRIORITY_JOB_SLOT_STATS_ERROR"
Priority Job Slot-Statistiken konnten nicht geladen werden.
Die Antwort kann zusätzliche Felder enthalten.
Allgemeines Fehlerformat
Fehlerantwort
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Die Antwort kann zusätzliche Felder enthalten.
| Feld | Typ und Beschreibung |
|---|---|
assembly_id | string |
error | string (minimale Länge: 1) |
http_code | number | string
|
message | stringMenschenlesbare Erklärung des Fehlers. Die Formulierung kann variieren; verwenden Sie den Code |
reason | null | string | number | boolean | Array<beliebiger Wert> | objectEines der folgenden Schemas kann gelten: nullnullstringstringnumbernumberbooleanbooleanArray<beliebiger Wert>Array<beliebiger Wert>Schema eines Array-Elementsbeliebiger WertobjectobjectSchema für zusätzliche Eigenschaftenbeliebiger Wert |