FIFO-Nachrichten von Amazon SQS ausführen

Die First-in, First-out (FIFO)-Warteschlangen sollen sicherstellen, dass die Reihenfolge, in der Nachrichten gesendet und empfangen werden, strikt eingehalten wird und dass jede Amazon SQS-Nachricht genau einmal verarbeitet wird.

Die FIFO-Warteschlange hält Transaktionen innerhalb einer Amazon SQS-Nachrichtengruppe immer in der Reihenfolge ihres Eingangs.

Um die Verarbeitung von Amazon SQS-Nachrichten anzufordern, wählen Sie einen der folgenden Verbindungstypen und folgen Sie den untenstehenden Schritten.

Um festzustellen, ob es sich um eine FIFO-Warteschlange handelt, prüfen Sie, ob die Amazon SQS-Nachricht mit der Dateiendung fifo endet.

Methoden: Push-, Pull- und Purge-Aktionen.

Option 1 - FIFO-Nachrichten von Amazon SQS mit vordefinierter Verbindung ausführen

Nachrichten per Push verschieben

Um Nachrichten mit einer vordefinierten Amazon SQS-FIFO-Nachricht per Push zu verschieben, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine neue Nachricht.

  2. Gehen Sie im Abschnitt Connection auf Manage, um eine Amazon SQS-Verbindung zu erstellen.

  3. Wählen Sie im Aufklappmenü „Connection“ Ihre Verbindung aus.

  4. Wählen Sie im Aufklappmenü Action die Option Push. Im Feld Endpoint wird die ARN angezeigt.

  5. Geben Sie im Feld Payload Ihre Nachricht ein.

  6. Klicken Sie auf das Symbol auf der rechten Seite des Nachrichtenabschnitts. Doppelklicken Sie auf die entsprechenden Zeilen, um folgende Werte der Header zu bearbeiten:

    • MessageGroupID: Verwenden Sie diesen Schlüssel, um mehrere geordnete Nachrichtengruppen innerhalb einer einzigen Warteschlange anzugeben.

    • MessageDeduplicationID: Optional können Sie diesen Schlüssel verwenden, um die Deduplizierung gesendeter Nachrichten zu verwalten.

    Weitere Informationen zu MessageGroupID und MessageDeduplicationID finden Sie in der AWS-Dokumentation.

  7. Klicken Sie auf Run im Menü API Scan, um Ihre Nachricht an die angegebene Warteschlange zu senden.

FIFO-Nachricht von Amazon SQS im API Scan per Push verschieben

Nachrichten per Pull abrufen

Um Nachrichten mit einer vordefinierten FIFO-Nachricht von Amazon SQS per Pull abzurufen, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine neue Nachricht.

  2. Gehen Sie im Abschnitt Connection auf Manage, um eine Amazon SQS-Verbindung zu erstellen.

  3. Wählen Sie im Aufklappmenü Connection Ihre Verbindung aus.

  4. Wählen Sie im Aufklappmenü Action die Option Pull. Im Feld Endpoint wird die ARN angezeigt.

  5. Klicken Sie auf das Symbol auf der rechten Seite des Nachrichtenabschnitts. Doppelklicken Sie auf die entsprechenden Zeilen, um folgende Werte der Header zu bearbeiten:

    • MessageGroupID: Verwenden Sie diesen Schlüssel, um mehrere geordnete Nachrichtengruppen innerhalb einer einzigen Warteschlange anzugeben.

    • MessageDeduplicationID: Optional können Sie diesen Schlüssel verwenden, um die Deduplizierung gesendeter Nachrichten zu verwalten.

    Weitere Informationen zu MessageGroupID und MessageDeduplicationID finden Sie in der AWS-Dokumentation.

  6. Klicken Sie auf Run im Menü API Scan, um Ihre Nachricht in der angegebenen Warteschlange zu erhalten. Es wird jeweils nur eine Nachricht abgerufen. Um mehrere Nachrichten abzurufen, erstellen Sie eine Schleife. Siehe auch Amazon SQS Zeitbeschränkung für die Sichtbarkeit.

FIFO-Nachricht von Amazon SQS im API Scan per Pull abrufen

Warteschlange leeren

Um eine Amazon SQS-Warteschlange mit einer vordefinierten Verbindung zu leeren, führen Sie die folgenden Schritte aus:

  1. Gehen Sie im Abschnitt Connection auf Manage, um eine Amazon SQS-Verbindung zu erstellen.

  2. Wählen Sie im Aufklappmenü Connection Ihre Verbindung aus.

  3. Wählen Sie im Aufklappmenü Action die Option Purge. Im Feld Endpoint wird die ARN angezeigt.

  4. Klicken Sie auf Run im Menü API Scan, um die angegebene Warteschlange zu leeren. Die Warteschlange wird dann von allen Nachrichten geleert.

FIFO-Warteschlange von Amazon SQS im API Scan leeren

Option 2 - FIFO-Nachrichten von Amazon SQS mit nicht vordefinierter Verbindung ausführen

Nachrichten per Push verschieben

Um Nachrichten mit einer nicht vordefinierten Amazon SQS-FIFO-Nachricht per Push zu verschieben, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine neue Nachricht.

  2. Wählen Sie aus dem Aufklappmenü Connection die Option <explicit>.

  3. Kopieren Sie im Feld Endpoint den Amazon Resource Name (ARN) Ihrer ausgewählten SQS FIFO-Warteschlange aus der AWS-Konsole im Reiter Details.

  4. Wählen Sie im Aufklappmenü Action die Option Push.

  5. Wählen Sie auf dem Reiter Auth aus der Aufklappliste Authentication die Option AWS Signature und geben Sie die Access Key- und Secret Key-Anmeldedaten für Ihr AWS-Konto ein.

  6. Geben Sie optional Ihr Session Token ein, falls Sie über temporäre Anmeldedaten verfügen.

  7. Falls Ihr Endpunkt keinen Eintrag unter Region enthält, wählen Sie diesen optional aus dem Aufklappmenü aus. Der Standardwert ist US East (Ohio).

  8. Klicken Sie auf das Symbol auf der rechten Seite des Nachrichtenabschnitts. Doppelklicken Sie auf die entsprechenden Zeilen, um folgende Werte der Header zu bearbeiten:

    • MessageGroupID: Verwenden Sie diesen Schlüssel, um mehrere geordnete Nachrichtengruppen innerhalb einer einzigen Warteschlange anzugeben.

    • MessageDeduplicationID: Optional können Sie diesen Schlüssel verwenden, um die Deduplizierung gesendeter Nachrichten zu verwalten.

    Weitere Informationen zu MessageGroupID und MessageDeduplicationID finden Sie in der AWS-Dokumentation.

  9. Geben Sie im Feld Payload Ihre Nachricht ein.

  10. Klicken Sie auf Run im Menü API Scan, um Ihre Nachricht in der Warteschlange an die angegebene Warteschlange zu senden.

Push-Aktion: Auth-Reiter für FIFO-Nachricht von Amazon SQS im API Scan

Nachrichten per Pull abrufen

Um Nachrichten mit einer nicht vordefinierten FIFO-Nachricht von Amazon SQS per Pull abzurufen, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine neue Nachricht.

  2. Wählen Sie aus dem Aufklappmenü Connection die Option <explicit>.

  3. Kopieren Sie im Feld Endpoint den Amazon Resource Name (ARN) Ihrer ausgewählten SQS FIFO-Warteschlange aus der AWS-Konsole im Reiter Details.

  4. Wählen Sie im Aufklappmenü Action die Option Pull.

  5. Wählen Sie auf dem Reiter Auth aus der Aufklappliste Authentication die Option AWS Signature und geben Sie die Access Key- und Secret Key-Anmeldedaten für Ihr AWS-Konto ein.

  6. Geben Sie optional Ihr Session Token ein, falls Sie über temporäre Anmeldedaten verfügen.

  7. Falls Ihr Endpunkt keinen Eintrag unter Region enthält, wählen Sie diesen optional aus dem Aufklappmenü aus. Der Standardwert ist US East (Ohio).

  8. Klicken Sie auf das Symbol auf der rechten Seite des Nachrichtenabschnitts. Doppelklicken Sie auf die entsprechenden Zeilen, um folgende Werte der Header zu bearbeiten:

    • MessageGroupID: Verwenden Sie diesen Schlüssel, um mehrere geordnete Nachrichtengruppen innerhalb einer einzigen Warteschlange anzugeben.

    • MessageDeduplicationID: Optional können Sie diesen Schlüssel verwenden, um die Deduplizierung gesendeter Nachrichten zu verwalten.

    Weitere Informationen zu MessageGroupID und MessageDeduplicationID finden Sie in der AWS-Dokumentation.

  9. Klicken Sie auf Run im Menü API Scan, um Ihre Nachricht in der angegebenen Warteschlange zu erhalten. Es wird jeweils nur eine Nachricht abgerufen. Um mehrere Nachrichten abzurufen, erstellen Sie eine Schleife. Siehe auch Amazon SQS Zeitbeschränkung für die Sichtbarkeit.

Pull-Aktion: Auth-Reiter für FIFO-Nachricht von Amazon SQS im API Scan

Nachdem Sie Ihre FIFO-Nachrichten von Amazon SQS im API Scan ausgeführt haben, können Sie diese in den Tosca Commander exportieren. Auf diese Weise können Sie die Nachrichteninformationen verwenden, um Modulattribute zu definieren und deren Werte zu überprüfen. Je nachdem, was Sie testen möchten, können Sie die Nachrichten als API-Testfall exportieren.

Warteschlange leeren

Um eine Amazon SQS-Warteschlange mit einer nicht vordefinierten FIFO-Nachricht von Amazon SQS zu leeren, führen Sie die folgenden Schritte aus:

  1. Wählen Sie aus dem Aufklappmenü Connection die Option <explicit>.

  2. Kopieren Sie im Feld Endpoint den Amazon Resource Name (ARN) Ihrer ausgewählten SQS FIFO-Warteschlange aus der AWS-Konsole im Reiter Details.

  3. Wählen Sie im Aufklappmenü Action die Option Purge.

  4. Wählen Sie auf dem Reiter Auth aus der Aufklappliste Authentication die Option AWS Signature und geben Sie die Access Key- und Secret Key-Anmeldedaten für Ihr AWS-Konto ein.

  5. Geben Sie optional Ihr Session Token ein, falls Sie über temporäre Anmeldedaten verfügen.

  6. Wählen Sie optional eine Region aus dem Aufklappmenü. Der Standardwert ist US East (Ohio).

  7. Klicken Sie auf Run im Menü API Scan, um die angegebene Warteschlange zu leeren. Die Warteschlange wird dann von allen Nachrichten geleert.

Purge-Aktion: Auth-Reiter für FIFO-Nachricht von Amazon SQS im API Scan