Quoten-Endpunkt
Der /quota-Endpunkt in der Data Hygiene API ermöglicht es Ihnen, die Nutzung Ihres erweiterten Data Lifecycle Management in Bezug auf die Quotenbegrenzungen Ihres Unternehmens für jeden Vorgangstyp zu überwachen.
Die Kontingentnutzung wird für jeden Data Lifecycle-Vorgangstyp verfolgt. Ihre tatsächlichen Quotenbegrenzungen hängen von den Berechtigungen Ihres Unternehmens ab und können regelmäßig überprüft werden. Datensatzgültigkeiten unterliegen einer festen Begrenzung der Anzahl gleichzeitig aktiver Aufträge.
Erste Schritte
Der in diesem Handbuch verwendete Endpunkt ist Teil der Data Hygiene API. Bevor Sie fortfahren, lesen Sie eine Übersicht zu folgenden Themen:
- Links zur entsprechenden Dokumentation
- Eine Anleitung zum Lesen der Beispiel-API-Aufrufe in diesem Dokument
- Wichtige Informationen zu den erforderlichen Kopfzeilen, die für Aufrufe an eine Experience Platform-API erforderlich sind
Kontingente und Verarbeitungszeitpläne quotas
Löschanfragen für Datensätze unterliegen Kontingenten und Service-Level-Erwartungen, die auf Ihrer Lizenzberechtigung basieren. Diese Einschränkungen gelten sowohl für benutzeroberflächen- als auch für API-basierte Löschanfragen.
Aufrufen von Kontingenten list
Sie können die Kontingentinformationen Ihres Unternehmens anzeigen, indem Sie eine GET-Anfrage an den /quota-Endpunkt senden.
API-Format
GET /quota
GET /quota?quotaType={QUOTA_TYPE}
{QUOTA_TYPE}Ein optionaler Abfrageparameter, der den Typ des abzurufenden Kontingents angibt. Wenn kein quotaType-Parameter angegeben ist, werden alle Kontingentwerte in der API-Antwort zurückgegeben. Zu den akzeptierten Typwerten gehören:
datasetExpirationQuota: Dieses Objekt zeigt die Anzahl der gleichzeitig aktiven Datensatzgültigkeiten für Ihre Organisation sowie Ihr Gesamtlimit an Gültigkeiten an.dailyConsumerDeleteIdentitiesQuota: Dieses Objekt zeigt die Gesamtzahl der Löschanfragen für Datensätze an, die von Ihrer Organisation heute gestellt wurden, und das Tagegeld insgesamt.
Hinweis: Es werden nur akzeptierte Anfragen gezählt. Wenn ein Arbeitsauftrag abgelehnt wird, weil die Validierung fehlschlägt, werden diese Identitätslöschungen nicht auf Ihr Kontingent angerechnet.monthlyConsumerDeleteIdentitiesQuota: Dieses Objekt zeigt die Gesamtzahl der Löschanfragen für Datensätze an, die von Ihrer Organisation in diesem Monat gestellt wurden, und das gesamte monatliche Taschengeld.monthlyUpdatedFieldIdentitiesQuota: Dieses Objekt zeigt die Gesamtzahl der Anfragen zur Aktualisierung von Datensätzen an, die von Ihrer Organisation in diesem Monat gestellt wurden, und Ihre gesamte monatliche Vergütung.
Anfrage
curl -X GET \
https://platform.adobe.io/data/core/hygiene/quota \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'Content-Type: application/json'
Antwort
Eine erfolgreiche Antwort gibt die Details Ihrer Datenlebenszykluskontingente zurück.
{
"quotas": [
{
"name": "datasetExpirationQuota",
"description": "The number of concurrently active Expiration Dataset Delete in all workorder requests for the organization.",
"consumed": 12,
"quota": 50
},
{
"name": "dailyConsumerDeleteIdentitiesQuota",
"description": "The consumed number of deleted identities in all workorder requests for the organization for today.",
"consumed": 0,
"quota": 1000000
},
{
"name": "monthlyConsumerDeleteIdentitiesQuota",
"description": "The consumed number of deleted identities in all workorder requests for the organization for this month.",
"consumed": 841,
"quota": 2000000
},
{
"name": "monthlyUpdatedFieldIdentitiesQuota",
"description": "The consumed number of updated identities in all workorder requests for the organization for this month.",
"consumed": 0,
"quota": 0
}
]
}
quotasListet die Kontingentinformationen für jeden Datenlebenszyklus-Vorgangstyp auf. Jedes Kontingentobjekt enthält die folgenden Eigenschaften:
-
name: Der Datenlebenszyklus-Vorgangstyp:expirationDatasetQuota: DatensatzgültigkeitendeleteIdentityWorkOrderDatasetQuota: Löschen von Datensätzen
-
description: Eine Beschreibung des Datenlebenszyklus-Vorgangstyps. -
consumed: Die Anzahl der Vorgänge dieses Typs, die im aktuellen Zeitraum ausgeführt wird. Der Objektname gibt den Kontingentzeitraum an. -
quota: Die Zuteilung für diesen Vorgangstyp für Ihre Organisation. Beim Löschen und Aktualisieren von Datensätzen stellt das Kontingent die Anzahl der Aufträge dar, die für jeden Monatszeitraum ausgeführt werden können. Bei Datensatzgültigkeiten stellt das Kontingent die Anzahl der Aufträge dar, die gleichzeitig aktiv sein können.