Verwaltung der Salesforce-API-Nutzung

Übersicht

Effiziente API-Nutzung ist entscheidend für die Integration von Flosum Backup & Archive mit Salesforce zur Verarbeitung von Daten. Dieses Handbuch bietet wichtige Informationen zum Verständnis und zur Optimierung der API-Nutzung.

Backup & Archive verwendet REST-, Bulk-, Bulk mit PK Chunking- und Metadata-APIs und wählt die effizienteste API für die jeweilige Aufgabe aus. Obwohl Salesforce der Backup & Archive-Integration keine Einschränkungen auferlegt, ist es wichtig, die API-Limits Ihrer Organisation zu berücksichtigen, da Backup & Archive zu diesen beiträgt. Weitere Informationen zu den API-Limits von Salesforce finden Sie im folgenden Artikel.

• API-Anforderungsgrenzen und Zuweisungen

Wie beantrage ich eine Erhöhung des API-Limits?

Am Ende dieses Artikels finden Sie Anweisungen zum Kontaktieren des Salesforce-Supports, um eine vorübergehende Erhöhung des API-Limits für Ihre Organisation zu beantragen. Überspringen Sie zum folgenden Abschnitt, um diese Anweisungen zu sehen.

Verwaltung der Salesforce-API-Nutzung

Verwendete APIs basierend auf der Anzahl der Datensätze

Flosum hält sich an die Empfehlung von Salesforce, soweit angemessen die Bulk API v1 mit PK Chunking zu verwenden. Die folgende Tabelle zeigt, welche APIs abhängig von der Anzahl der Datensätze im Auftrag eingesetzt werden. Bulk API v2 wird nicht verwendet, da sie PK Chunking nicht unterstützt.

Anzahl der Datensätze	API-Typ
0 bis 999.999	REST
1.000.000 bis 9.999.999	Bulk v1
10,000,000+	Bulk v1 pk-chunking

Bulk API v1 wird immer für binäre Objekte verwendet.

Backup & Archive API-Kontingente

Um das Überschreiten der API-Limits Ihrer Salesforce-Organisation zu verhindern, ermöglicht Flosum Ihnen, Ihr Backup & Archive API-Kontingente. Überprüfen Sie die Salesforce-Ressourcen für Nutzungsdetails, um Ihr bevorzugtes API-Kontingente für REST- und Bulk-APIs festzulegen. Sie können diese Kontingente individuell für jede Organisation in den Allgemeinen Einstellungen Bereich von Backup & Archive anpassen. Beispielsweise stellt das Festlegen eines API-Kontingents von 80 % sicher, dass Backup & Archive innerhalb dieses Limits bleibt. Befolgen Sie den folgenden Artikel, um Anweisungen zum Ändern dieses Limits zu erhalten. Überblick über allgemeine Einstellungen

Ermittlung der API-Nutzung

Salesforce-Administratoren sollten zunächst die API-Nutzung in ihrer Umgebung bewerten, um das geeignete API-Kontingent festzulegen. Die Gesamtzahl der pro 24-Stunden-Zeitraum verwendeten Bulk- und REST-APIs ist je nach Lizenztyp von Salesforce begrenzt. Es ist wichtig, andere Anwendungen in Ihrer Organisation zu berücksichtigen, die API-Aufrufe verwenden.

Um die API-Nutzung und -Limits Ihrer Organisation effektiv zu überwachen, bietet Salesforce nützliche Ressourcen:

• Abschnitt API-Nutzung auf der Seite Systemübersicht in Setup.

• Punkt API-Anfragen, letzte 24 Stunden im Abschnitt Organisationsdetails der Seite Systemübersicht in Setup.

• API-Anforderungsgrenze pro Monat, ein nutzungsbasiertes Recht, zeigt die aggregierten API-Aufrufe Ihrer Organisation über 30 Tage an. Diese Informationen sind auf der Seite Unternehmensinformationen in Setup verfügbar.

• Die Seiten Unternehmensinformationen, Speichernutzung und Bulk-Datenladung bieten Einblicke in die Anzahl der verwendeten APIs, tägliche Limits und die Gesamtzahl von Dateien und Anhängen.

Diese Ressourcen helfen Ihnen, das Muster der API-Nutzung Ihrer Salesforce-Organisation zu verstehen und fundierte Entscheidungen zur API-Kontingentstrategie mit Backup & Archive zu treffen.

---

Erstellen einer Anfrage zur Erhöhung des Salesforce-API-Limits

Um ein reibungsloses erstes vollständiges Backup mit Flosum Backup & Archive zu gewährleisten, müssen Sie möglicherweise vorübergehend Ihre Salesforce-API-Limits erhöhen, insbesondere für BULK-API-Aufrufe. Dieser Artikel enthält eine Schritt-für-Schritt-Anleitung zum Einreichen einer Anfrage zur Erhöhung des API-Limits beim Salesforce-Support.

Warum das wichtig ist

Während des ersten vollständigen Backups verbraucht Backup & Archive ein großes Volumen an API-Aufrufen (REST und BULK). Kunden haben erlebt, dass Kontingentgrenzen erreicht wurden, was sowohl den Backup-Prozess als auch andere Integrationen unterbrechen kann. Eine vorübergehende Erhöhung des Limits verhindert diese Unterbrechung.

Wie Sie die Anfrage zur Erhöhung des API-Limits einreichen

Verweis auf Salesforce-Hilfeseite: Anfordern vorübergehender API-Erhöhungen

1

Gehen Sie zu Salesforce Hilfe

1. Besuchen Sie https://help.salesforce.com

2. Klicken Sie Support kontaktieren

3. Wählen Sie Einen Fall erstellen

2

Falldetails

Verwenden Sie die folgenden Informationen, um das Formular für den Fall auszufüllen:

• Betreff: Beantragung einer vorübergehenden Erhöhung des täglichen API-Anforderungslimits

• Produkt: Sales

• Thema: Feature-Aktivierung & Limits

• Instanztyp: Produktion

• Org-ID: [Geben Sie Ihre Org-ID an]

• Bevorzugte Zeitzone: [Ihre Zeitzone]

• Schweregrad: 2 (Wesentliche Funktionalität betroffen; kein kompletter Ausfall)

3

Vorgeschlagene Fallbeschreibung

Kopieren Sie dies und fügen Sie es in das Beschreibungsfeld Ihres Support-Falls ein:

Hallo Salesforce Support,

Ich möchte um eine vorübergehende Erhöhung unseres täglichen API-Limits bitten gemäß Salesforce-Artikel 000382675.

Wir führen einen Sicherungsprozess mithilfe der Flosum Backup & Archive-Appein, die REST- und BULK-APIs nutzt, um alle Datensätze und Dateien in unserer Salesforce-Organisation zu sichern.

Antworten auf erforderliche Fragen:

1. Sind Sie der Systemadministrator, der berechtigt ist, diese Anfrage zu stellen?

   ✔️ Ja.

2. Sind Sie sich des nutzungsbasierten Anspruchsrechts für dieses Limit bewusst?

   ✔️ Ja.

3. Wie lautet Ihre Organisations-ID?

   [Fügen Sie Ihre Produktions-Org-ID ein]

   (Navigieren Sie zu Setup > Unternehmensinformationen > Salesforce.com Organisations-ID)

4. Bitte beschreiben Sie den Notfall und die geschäftlichen Auswirkungen:

   Unsere Sicherungslösung und bestehende Integrationen sind auf die Verfügbarkeit der API angewiesen. Ohne erhöhte Limits riskieren wir Sicherungsfehler und potenzielle Geschäftsunterbrechungen.

5. Wie viele zusätzliche API-Aufrufe beantragen Sie?

   🔺 Vorübergehende Erhöhung um 40–50% über der aktuellen Zuweisung.

6. Wie wurde dieses Limit berechnet?

   • REST-API: ~1.000 Aufrufe pro 1 Mio. Datensätze

   • BULK-API: ~1 Aufruf pro 2 Mio. Datensätze

     (Schätzungen basierend auf unseren Objektgrößen und Sicherungsmustern)

7. Wie lange benötigen Sie diese Erhöhung?

   📅 Maximal 2 Wochen, um das anfängliche vollständige Backup zu ermöglichen.

8. Welche Maßnahmen werden Sie ergreifen, um dieses Problem künftig zu vermeiden?

   Wir werden weiterhin den Salesforce-Best-Practices folgen, benötigen aber diesen vorübergehenden Puffer aufgrund groß angelegter Datenoperationen.

4

Zusätzlich erforderliche Details

Integrationstyp:

• ✅ Integration (keine Datenmigration)

• Verwendete Anwendung: Flosum Backup & Archive

• Verwendete APIs: REST-API & BULK-API

• Betroffene Gesamtzahl der Datensätze: Alle Datensätze und Dateien in der Produktionsorganisation

• ETL-Tool: Nicht zutreffend

• Vorgangstyp: Abfrage

• Spitzenlast: Potentiell das gesamte Datenvolumen der Organisation

• Benötigte benutzerdefinierte Indizierung? Nein

• Verstehen Sie, dass dies ein F&E-Anfrageprogramm ist? ✔️ Ja

• Was wäre für die Einführung von Bulk API 2.0 erforderlich? Unterstützung für pk-chunking hinzufügen

• Batch-Größe: Standard

5

Abschließende Schritte

• Mitarbeiter hinzufügen (optional)

• Fall einreichen

• Nach dem Einreichen teilen Sie bitte die Fallnummer mit Ihrem Flosum Technical Architect zur Nachverfolgung.

Das Einreichen einer gut strukturierten Anfrage zur Erhöhung der API-Limits ist entscheidend für ein erfolgreiches vollständiges Organisations-Backup mit Flosum Backup & Archive. Befolgen Sie die obigen Hinweise, um die Genehmigung durch den Salesforce-Support zu beschleunigen und unerwartete API-bezogene Unterbrechungen zu vermeiden.