Verwalten von Webhooks

Als Administrator können Sie Webhooks aktualisieren und verwalten, indem Sie ihre Konfiguration aktualisieren (z. B. die Ereignis-Trigger, die vom Webhook abonniert wurden) sowie zuvor konfigurierte Webhooks deaktivieren und löschen.

Aktualisieren von Webhooks

Sie können die für Webhooks konfigurierten Parameter nach der Erstellung aktualisieren. In den folgenden Abschnitten wird beschrieben, wie Sie die Eigenschaften für Organisations-, Geoverarbeitungsservice- und Feature-Service-Webhooks aktualisieren.

Aktualisieren von Organisations-Webhooks im ArcGIS Portal Directory

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über das ArcGIS Portal Directory zu aktualisieren:

Hinweis:

Eine Beispiel-POST-Anforderung für die Aktualisierung einer Webhook-Konfiguration finden Sie unter Update Webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Portal Directory, und melden Sie sich als ein Mitglied mit Administratorrolle an.

    Organisations-Webhooks können nur von Administratoren mit der Berechtigung "Organisations-Webhooks" oder von Mitgliedern, denen die Standard-Administratorrolle zugewiesen wurde, erstellt und verwaltet werden.

    https://organization.domain.com/context/sharing/rest
    

    Nachdem Sie sich angemeldet haben, wird der Ressourcenendpunkt User für Ihr Konto angezeigt.

  2. Klicken Sie auf den Hyperlink Org ID, oder erstellen Sie eine Anforderung im folgenden Format, um zur Ressourcenseite Portal Self zu gelangen:
    https://organization.domain.com/context/sharing/rest/portals/self
    
  3. Führen Sie einen Bildlauf zum Ende des Ressourcenendpunkts Self durch, und klicken Sie auf Webhook > [Webhook] > Update Webhook, wobei [Webhook] die ID oder den Namen eines bestimmten Webhooks darstellt, um den Vorgang Update Webhook aufzurufen.
  4. Ändern Sie auf dem Endpunkt Update Webhook die folgenden Informationen:
    1. Geben Sie zum Aktualisieren des Webhook-Namens einen eindeutigen Namen für den Webhook in das Textfeld Name ein.
    2. Wenn Sie einen neuen Webhook-Empfänger verwenden oder die Payload-URL für einen vorhandenen Empfänger aktualisieren müssen, geben Sie die neue URL in das Textfeld Payload URL ein.

      Die Payload-URL wird während der Aktualisierung des Webhooks abgerufen, um sicherzustellen, dass eine erfolgreiche Verbindung zwischen dem Empfänger und dem ArcGIS Enterprise-Portal hergestellt werden kann. Im Folgenden finden Sie eine Beispiel-Payload:

      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow
      
    3. Fügen Sie optional eine alphanumerische Zeichenfolge hinzu, die als Secret für den Webhook verwendet wird, oder aktualisieren Sie ein bereits vorhandenes Secret, um Webhook-Nachrichten beim Empfänger zu authentifizieren. Geben Sie das neue oder aktualisierte Secret in das Textfeld Secret (optional) ein.
    4. Aktualisieren Sie optional die Deaktivierungsinformationen für den Webhook im Textfeld Configuration Properties.

      Standardmäßig wird der Webhook deaktiviert, wenn im Verlauf von fünf Tagen fünf Fehler aufgetreten sind.

    5. Wählen Sie eine der folgenden Optionen aus, um die Ereignis-Trigger für einen Webhook zu aktualisieren oder Webhooks für alle Ereignis-Trigger zu erhalten:
      • Klicken Sie auf Let me define manually, um die Liste der Trigger-Ereignisse, die für diesen Webhook verwendet werden, im Textfeld Send me changes for these comma separated events zu ändern. Um beispielsweise alle Ereignisse, die zu einer bestimmten Gruppe in der Organisation gehören, zu abonnieren, geben Sie einen Ereignis-Trigger ähnlich dem unten gezeigten an, wobei [groupID] die mit einer bestimmten Gruppe verknüpfte eindeutige ID darstellt.
        /groups/[groupID]/update
        
      • Klicken Sie auf Alles senden, um alle unterstützten Ereignis-Trigger zu abonnieren und Benachrichtigungen für Ereignisse zu erhalten, sobald diese eintreten.
  5. Klicken Sie nach dem Konfigurieren der obenstehenden Parameter auf Update Webhook, um die Anforderung zu senden und die Änderungen zu übernehmen.

Aktualisieren von Organisations-Webhooks auf der ArcGIS Enterprise-Portal-Website

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu aktualisieren:

  1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
  2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
  3. Suchen Sie den Organisations-Webhook, die Sie aktualisieren möchten.
  4. Klicken Sie auf die Schaltfläche Optionen, und klicken Sie auf Bearbeiten.
  5. Nehmen Sie im Fenster Webhook erstellen die folgenden Änderungen vor:
    1. Geben Sie zum Aktualisieren des Webhook-Namens einen eindeutigen Namen für den Webhook in das Textfeld Name ein.
    2. Klicken Sie zum Aktualisieren des Webhook-Typs auf das Dropdown-Menü Typ, und wählen Sie einen neuen Webhook-Typ aus.
      • Wenn Sie Alle auswählen, werden alle unterstützten Ereignis-Trigger abonniert. Sie erhalten Benachrichtigungen für die einzelnen Ereignisse, sobald diese eintreten.
      • Wenn Sie Elemente, Benutzer, Gruppen oder Rollen auswählen, können Sie manuell festlegen, welche Trigger-Ereignisse Sie abonnieren möchten.
    3. Wenn Sie einen anderen Webhook-Typ als Alle auswählen, wird ein zusätzliches Dropdown-Menü angezeigt, das sich auf den ausgewählten Webhook-Typ bezieht. Wenn Sie beispielsweise Elemente als Webhook-Typ ausgewählt haben, wird das Dropdown-Menü Elemente angezeigt, über das Sie ein bestimmtes Element für die Überwachung durch den Webhook auswählen können.
    4. Klicken Sie zum Aktualisieren der Ereignis-Trigger auf das Dropdown-Menü Ereignisse, und wählen Sie ein neues Trigger-Ereignis aus. Wenn beispielsweise der Webhook aufgerufen werden soll, sobald ein bestimmtes Element veröffentlicht wird, wählen Sie /items/<Element-ID>/publish aus.
    5. Wählen Sie zum Aktualisieren der Payload-URL Webhook-URL aus, und geben Sie die neue Payload-URL für den Webhook-Empfänger an.
    6. Fügen Sie optional eine alphanumerische Zeichenfolge hinzu, die als Secret für den Webhook verwendet wird, oder aktualisieren Sie ein bereits vorhandenes Secret, um Webhook-Nachrichten beim Empfänger zu authentifizieren. Geben Sie das neue oder aktualisierte Secret in das Textfeld Secret (optional) ein.
  6. Klicken Sie auf Webhook aktualisieren, um die Änderungen zu übernehmen.

Aktualisieren von Geoverarbeitungsservice-Webhooks

Führen Sie die folgenden Schritte aus, um die Eigenschaften eines Geoverarbeitungsservice-Webhooks zu aktualisieren:

Hinweis:

Geoverarbeitungsservice-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis erstellt werden. Eine Beispiel-POST-Anforderung für das Aktualisieren eines Geoverarbeitungsservice-Webhooks finden Sie unter Edit webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Geoverarbeitung", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zum Vorgang Edit für einen Geoverarbeitungsservice, indem Sie auf Services > [ServiceName] > Webhooks > [Webhook] > Edit klicken, wobei [ServiceName] den betreffenden Geoverarbeitungsservice darstellt und [Webhook] den Webhook, der aktualisiert wird. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks > [Webhook] > Edit, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Ändern Sie auf dem Endpunkt Bearbeiten die folgenden Informationen:
    1. Geben Sie zum Aktualisieren des Webhook-Namens einen eindeutigen Namen für den Webhook in das Textfeld Name ein. Der Name darf nur alphanumerische Zeichen enthalten, da die Verwendung von Sonderzeichen zu einer Fehlermeldung führt.
    2. Fügen Sie optional eine alphanumerische Zeichenfolge hinzu, die als Secret für den Webhook verwendet wird, oder aktualisieren Sie ein bereits vorhandenes Secret, um Webhook-Nachrichten beim Empfänger zu authentifizieren. Geben Sie das neue oder aktualisierte Secret in das Textfeld Signature Key ein.
    3. Wenn Sie einen neuen Empfänger verwenden oder die Payload-URL aktualisieren müssen, geben Sie die neue URL im Textfeld Hook URL ein. Sie wird bei der Aktualisierung des Webhooks abgerufen, um sicherzustellen, dass eine erfolgreiche Verbindung zwischen dem Empfänger und dem ArcGIS Server der Bereitstellung hergestellt werden kann.

      Im Folgenden finden Sie eine Beispiel-Payload-URL:

      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow
      
    4. Um einen neuen Wert für den Medientyp des Webhooks einzurichten, wählen Sie eine der folgenden Optionen aus dem Dropdown-Feld Content Type aus:
      • application/json (Standardeinstellung)
      • application/x-www-form-urlencoded
    5. Um das Format einer Payload zu aktualisieren, wählen Sie eines der folgenden Elemente aus dem Dropdown-Feld Payload Format aus:
      • JSON (Standardeinstellung)
      • PJSON
    6. Aktivieren oder deaktivieren Sie Rückrufe für den Webhook, indem Sie den für den Parameter Active ausgewählten Wert ändern. Wählen Sie zur Aktivierung true aus. Wählen Sie zur Deaktivierung false aus.
  4. Klicken Sie nach dem Konfigurieren der obenstehenden Parameter auf Edit, um die Anforderung zu senden und die Änderungen zu übernehmen.
Hinweis:
Im Gegensatz zu Organisations- und Feature-Service-Webhooks verfügen Geoverarbeitungsservice-Webhooks über keine benutzerdefinierten Ereignis-Trigger. Geoverarbeitungsservice-Webhooks übermitteln Payloads, sobald ein Geoverarbeitungsauftrag abgeschlossen wurde. Weitere Informationen zu den für Geoverarbeitungsservices übermittelten Payloads finden Sie unter Payloads.

Aktualisieren von Feature-Service-Webhooks

Führen Sie die folgenden Schritte aus, um die Eigenschaften eines Feature-Service-Webhooks zu aktualisieren:

Hinweis:

Feature-Service-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis erstellt werden. Eine Beispiel-POST-Anforderung für das Aktualisieren eines Feature-Service-Webhooks finden Sie unter Edit webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Feature-Layer", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.

    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zur Ressource Webhooks für einen Feature-Service, indem Sie auf Services > [ServiceName] > Webhooks > Create klicken, wobei [ServiceName] den Service darstellt, für den der Webhook erstellt wird. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks > Create, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Geben Sie auf dem Endpunkt Create Webhook die folgenden Informationen an:
    1. Geben Sie zum Aktualisieren des Webhook-Namens einen eindeutigen Namen für den Webhook in das Textfeld Name ein. Der Name darf nur alphanumerische Zeichen enthalten, da die Verwendung von Sonderzeichen zu einer Fehlermeldung führt.
    2. Um die Ereignis-Trigger für einen Webhook zu aktualisieren, listen Sie die für diesen Webhook verwendeten Ereignis-Trigger im Textfeld Change Type auf. Verwenden Sie beispielsweise den folgenden Ereignis-Trigger, um den aufzurufenden Webhook bei jeder Erstellung eines Feature-Service zu aktualisieren:

      FeaturesCreated
      
      Eine Liste aller unterstützten Ereignis-Trigger für Feature-Service-Webhooks finden Sie unter Ereignis-Trigger.
    3. Fügen Sie optional eine alphanumerische Zeichenfolge hinzu, die als Secret für den Webhook verwendet wird, oder aktualisieren Sie ein bereits vorhandenes Secret, um Webhook-Nachrichten beim Empfänger zu authentifizieren. Geben Sie das neue oder aktualisierte Secret in das Textfeld Signature Key ein.
    4. Wenn Sie einen neuen Empfänger verwenden oder die Payload-URL aktualisieren müssen, geben Sie die neue URL im Textfeld Hook URL ein. Sie wird bei der Aktualisierung des Webhooks abgerufen, um sicherzustellen, dass eine erfolgreiche Verbindung zwischen dem Empfänger und dem ArcGIS Server der Bereitstellung hergestellt werden kann.

      Im Folgenden finden Sie eine Beispiel-Payload-URL:

      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow
      
    5. Um einen neuen Wert für den Medientyp des Webhooks einzurichten, wählen Sie eine der folgenden Optionen aus dem Dropdown-Feld Content Type aus:
      • application/json (Standardeinstellung)
      • application/x-www-form-urlencoded
    6. Um das Format der Payload zu aktualisieren, wählen Sie eines der folgenden Elemente aus dem Dropdown-Feld Payload Format aus:
      • JSON (Standardeinstellung)
      • PJSON
    7. Aktivieren oder deaktivieren Sie Rückrufe für den Webhook, indem Sie den für den Parameter Active ausgewählten Wert ändern. Wählen Sie zur Aktivierung true aus. Wählen Sie zur Deaktivierung false aus.
    8. Passen Sie die Planung für Webhooks an, indem Sie die Information Seconds im Textfeld Schedule bearbeiten. Senken Sie den Wert Seconds bei Feature-Services mit vielen regelmäßig vorgenommenen Änderungen, um häufiger Webhooks zu empfangen, die dafür weniger Ereignisinformationen in der Payload enthalten. Heben Sie den Wert der Eigenschaft Seconds bei Feature-Services, die keinen regelmäßigen Änderungen unterliegen, an, um seltener Webhooks zu empfangen, die mehr Ereignisinformationen in der Payload enthalten.

      Der Mindest- und Standardwert für die Planung liegt bei 20 Sekunden.

  4. Klicken Sie nach dem Konfigurieren der obenstehenden Parameter auf Edit, um die Anforderung zu senden und die Änderungen zu übernehmen.

Deaktivieren von Webhooks

Webhooks können manuell bzw. im Fall von Organisations-Webhooks nach Erfüllung der Deaktivierungsrichtlinie, die während der Erstellung des Webhooks festgelegt wird, deaktiviert werden. Sobald ein Webhook deaktiviert wird, wird er unterbrochen und kann keine Payloads übermitteln, wenn diese ausgelöst werden. In den folgenden Abschnitten wird beschrieben, wie Sie Organisations-, Geoverarbeitungsservice- und Feature-Service-Webhooks deaktivieren.

Deaktivieren von Organisations-Webhooks im ArcGIS Portal Directory

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über das ArcGIS Portal Directory zu deaktivieren:

Hinweis:

Eine Beispiel-POST-Anforderung für die Deaktivierung eines Webhooks finden Sie unter Deactivate Webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Portal Directory, und melden Sie sich als ein Mitglied mit Administratorrolle an.

    Organisations-Webhooks können nur von Administratoren mit der Berechtigung "Organisations-Webhooks" oder von Mitgliedern, denen die Standard-Administratorrolle zugewiesen wurde, erstellt und verwaltet werden.

    https://organization.domain.com/context/sharing/rest
    

    Nachdem Sie sich angemeldet haben, wird der Ressourcenendpunkt User für Ihr Konto angezeigt.

  2. Klicken Sie auf den Hyperlink Org ID, oder erstellen Sie eine Anforderung im folgenden Format, um zur Ressourcenseite Portal Self zu gelangen:
    https://organization.domain.com/context/sharing/rest/portals/self
    
  3. Führen Sie einen Bildlauf zum Ende des Ressourcenendpunkts Self durch, und klicken Sie auf Webhook > [Webhook] > Deactivate, wobei [Webhook] die ID oder den Namen eines bestimmten Webhooks darstellt, um den Vorgang Deactivate aufzurufen.
  4. Klicken Sie auf dem Endpunkt Deactivate auf Deactivate, um den Webhook zu unterbrechen.

Deaktivieren von Organisations-Webhooks auf der ArcGIS Enterprise-Portal-Website

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu deaktivieren:

  1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
  2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
  3. Suchen Sie den Organisations-Webhook, die Sie deaktivieren möchten, und klicken Sie auf Aktiv.
  4. Klicken Sie auf Bestätigen, um den Webhook anzuhalten.

Deaktivieren von Geoverarbeitungsservice-Webhooks

Führen Sie die folgenden Schritte aus, um alle für einen Geoverarbeitungsservice konfigurierten Webhooks zu deaktivieren:

Hinweis:

Geoverarbeitungsservice-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis verwaltet werden. Ein Beispiel für eine POST-Anforderung, mit der alle Webhooks für einen Geoverarbeitungsservice deaktiviert werden, finden Sie unter Deactivate webhooks in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Geoverarbeitung", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zum Vorgang deactivateAll für einen Geoverarbeitungsservice, indem Sie auf Services > [ServiceName] > Webhooks > deactivateAll klicken, wobei [ServiceName] den spezifischen Geoverarbeitungsservice darstellt. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks > deactivateAll, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Klicken Sie auf dem Endpunkt deactivateAll auf Deactivate All, um alle konfigurierten Webhooks zu unterbrechen.

Deaktivieren von Feature-Service-Webhooks

Führen Sie die folgenden Schritte aus, um alle für einen Feature-Service konfigurierten Webhooks zu deaktivieren.

Hinweis:

Feature-Service-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis verwaltet werden. Ein Beispiel für eine POST-Anforderung, mit der alle Webhooks für einen Feature-Service deaktiviert werden, finden Sie unter Deactivate webhooks in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Feature-Layer", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zum Vorgang deactivateAll für einen Feature-Service, indem Sie auf Services > [ServiceName] > Webhooks > deactivateAll klicken, wobei [ServiceName] den spezifischen Feature-Service darstellt. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks > deactivateAll, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Klicken Sie auf dem Endpunkt deactivateAll auf Deactivate All, um alle konfigurierten Webhooks zu unterbrechen.

Aktivieren von Webhooks

Wenn ein Webhook deaktiviert wurde, können keine Payloads mehr über ihn übermittelt werden. Nach der Reaktivierung eines Webhooks wird dieser neu gestartet und kann beim nächsten Aufruf des Webhooks wieder Payloads übermitteln. In den folgenden Abschnitten wird beschrieben, wie Sie zuvor deaktivierte Organisations-, Geoverarbeitungsservice- und Feature-Service-Webhooks aktivieren.

Aktivieren von Organisations-Webhooks über das ArcGIS Portal Directory

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über das ArcGIS Portal Directory zu aktivieren:

Hinweis:

Eine Beispiel-POST-Anforderung für die Aktivierung eines Webhooks finden Sie unter Activate Webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Portal Directory, und melden Sie sich als ein Mitglied mit Administratorrolle an.

    Organisations-Webhooks können nur von Administratoren mit der Berechtigung "Organisations-Webhooks" oder von Mitgliedern, denen die Standard-Administratorrolle zugewiesen wurde, erstellt und verwaltet werden.

    https://organization.domain.com/context/sharing/rest
    

    Nachdem Sie sich angemeldet haben, wird der Ressourcenendpunkt User für Ihr Konto angezeigt.

  2. Klicken Sie auf den Hyperlink Org ID, oder erstellen Sie eine Anforderung im folgenden Format, um zur Ressourcenseite Portal Self zu gelangen:
    https://organization.domain.com/context/sharing/rest/portals/self
    
  3. Führen Sie einen Bildlauf zum Ende des Ressourcenendpunkts Self durch, und klicken Sie auf Webhook > [Webhook] > Activate, wobei [Webhook] die ID oder den Namen eines bestimmten Webhooks darstellt, um den Vorgang Activate aufzurufen.
  4. Klicken Sie auf dem Endpunkt Activate auf Activate, um den Webhook neu zu starten.

Aktivieren von Organisations-Webhooks über die ArcGIS Enterprise-Portal-Website

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu aktivieren:

  1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
  2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
  3. Suchen Sie den Organisations-Webhook, die Sie aktivieren möchten, und klicken Sie auf Nicht aktiv.
  4. Klicken Sie auf Bestätigen, um den Webhook neu zu starten.

Aktivieren von Geoverarbeitungsservice-Webhooks

Führen Sie die folgenden Schritte aus, um alle für einen Geoverarbeitungsservice konfigurierten Webhooks zu aktivieren:

Hinweis:

Geoverarbeitungsservice-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis verwaltet werden. Ein Beispiel für eine POST-Anforderung, mit der alle Webhooks für einen Geoverarbeitungsservice aktiviert werden, finden Sie unter Activate webhooks in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Geoverarbeitung", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zum Vorgang activateAll für einen Geoverarbeitungsservice, indem Sie auf Services > [ServiceName] > Webhooks > activateAll klicken, wobei [ServiceName] den spezifischen Geoverarbeitungsservice darstellt. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks > activateAll, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Klicken Sie auf dem Endpunkt activateAll auf Activate All, um alle unterbrochenen Webhooks fortzusetzen.

Aktivieren von Feature-Service-Webhooks

Führen Sie die folgenden Schritte aus, um alle für einen Feature-Service konfigurierten Webhooks zu aktivieren:

Hinweis:

Feature-Service-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis verwaltet werden. Ein Beispiel für eine POST-Anforderung, mit der alle Webhooks für einen Feature-Service aktiviert werden, finden Sie unter Activate webhooks in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Feature-Layer", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zum Vorgang activateAll für einen Feature-Service, indem Sie auf Services > [ServiceName] > Webhooks > activateAll klicken, wobei [ServiceName] den spezifischen Feature-Service darstellt. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks > activateAll, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Klicken Sie auf dem Endpunkt activateAll auf Activate All, um alle unterbrochenen Webhooks fortzusetzen.

Löschen von Webhooks

Wenn ein zuvor erstellter Webhook nicht mehr benötigt wird, können Sie ihn dauerhaft aus der Organisation entfernen, indem Sie ihn löschen. In den folgenden Abschnitten wird beschrieben, wie Sie Organisations-, Geoverarbeitungsservice- oder Feature-Service-Webhooks löschen.

Löschen von Organisations-Webhooks im ArcGIS Portal Directory

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über das ArcGIS Portal Directory zu löschen:

Hinweis:

Eine Beispiel-POST-Anforderung für das Löschen eines Webhooks finden Sie unter Delete Webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Portal Directory, und melden Sie sich als ein Mitglied mit Administratorrolle an.

    Organisations-Webhooks können nur von Mitgliedern mit der Standard-Administratorrolle oder mit der Berechtigung "Organisations-Webhooks" erstellt und verwaltet werden.

    https://organization.domain.com/context/sharing/rest
    

    Nachdem Sie sich angemeldet haben, wird der Ressourcenendpunkt User für Ihr Konto angezeigt.

  2. Klicken Sie auf den Hyperlink Org ID, oder erstellen Sie eine Anforderung im folgenden Format, um die Ressource Portal Self aufzurufen:
    https://organization.domain.com/context/sharing/rest/portals/self
    
  3. Führen Sie einen Bildlauf zum Ende des Ressourcenendpunkts Self durch, und klicken Sie auf Webhook > [Webhook] > Delete, wobei [Webhook] die ID oder den Namen eines bestimmten Webhooks darstellt, um den Vorgang Delete aufzurufen.
  4. Klicken Sie auf dem Endpunkt Delete auf Delete, um den Webhook dauerhaft zu entfernen.

Löschen von Organisations-Webhooks auf der ArcGIS Enterprise-Portal-Website

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu aktualisieren:

  1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
  2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
  3. Suchen Sie den Organisations-Webhook, die Sie aktualisieren möchten.
  4. Klicken Sie zunächst auf die Schaltfläche Optionen und dann auf Löschen.
  5. Klicken Sie im Fenster Löschen auf die Schaltfläche Bestätigen, um den Webhook dauerhaft zu entfernen.

Löschen von Geoverarbeitungsservice-Webhooks

Es gibt zwei Möglichkeiten, um Geoverarbeitungsservice-Webhooks zu löschen. Sie können alle für einen Geoverarbeitungsservice konfigurierten Webhooks oder einen bestimmten Webhook löschen. Führen Sie die folgenden Schritte aus, um Geoverarbeitungsservice-Webhooks zu löschen:

Hinweis:

Geoverarbeitungsservice-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis verwaltet werden. Eine Beispiel-POST-Anforderung für das Löschen eines Geoverarbeitungsservice-Webhooks finden Sie unter Delete webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Geoverarbeitung", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zur Ressource Webhooks, indem Sie auf Services > [ServiceName] > Webhooks klicken, wobei [ServiceName] den spezifischen Geoverarbeitungsservice darstellt. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Wählen Sie auf dem Endpunkt Webhooks aus, ob alle Webhooks gelöscht werden sollen oder nur ein bestimmter Webhook.
    • Um alle konfigurierten Webhooks für einen Geoverarbeitungsservice zu löschen, klicken Sie auf deleteAll, um den Endpunkt des Vorgangs aufzurufen. Klicken Sie dort auf Delete All.
    • Um einen bestimmten Webhook zu löschen, klicken Sie auf [Webhook] > Delete, wobei [Webhook] die ID für einen Webhook darstellt. Klicken Sie auf dem Endpunkt des Vorgangs Delete auf Delete.

Löschen von Feature-Service-Webhooks

Es gibt zwei Möglichkeiten, um Feature-Service-Webhooks zu löschen. Sie können alle für einen Feature-Service konfigurierten Webhooks oder einen bestimmten Webhook löschen. Führen Sie die folgenden Schritte aus, um Feature-Service-Webhooks zu löschen:

Hinweis:

Feature-Service-Webhooks können nur über das ArcGIS Server-Administratorverzeichnis verwaltet werden. Eine Beispiel-POST-Anforderung für das Löschen eines Feature-Service-Webhooks finden Sie unter Delete webhook in der REST-API-Dokumentation.

  1. Navigieren Sie zum ArcGIS Enterprise-Administratorverzeichnis, und melden Sie sich als ein Mitglied mit entsprechenden Administratorberechtigungen an.
    Webhooks können nur von Mitgliedern mit der Berechtigung "Feature-Layer", der Standard-Administratorrolle oder der Publisher-Rolle erstellt und verwaltet werden.
    https://organization.domain.com/context/admin
    
  2. Navigieren Sie nach der Anmeldung zur Ressource Webhooks, indem Sie auf Services > [ServiceName] > Webhooks klicken, wobei [ServiceName] den spezifischen Feature-Service darstellt. Klicken Sie bei Services, die sich in bestimmten Ordnern befinden, auf Services > [FolderName] > [ServiceName] > Webhooks, wobei [FolderName] den Ordner, in dem sich der Service befindet, darstellt.
  3. Wählen Sie auf dem Endpunkt Webhooks aus, ob alle Webhooks gelöscht werden sollen oder nur ein bestimmter Webhook.
    • Um alle konfigurierten Webhooks für einen Feature-Service zu löschen, klicken Sie auf deleteAll, um den Endpunkt des Vorgangs aufzurufen. Klicken Sie dort auf Delete All.
    • Um einen bestimmten Webhook zu löschen, klicken Sie auf [Webhook] > Delete, wobei [Webhook] die ID für einen Webhook darstellt. Klicken Sie auf dem Endpunkt des Vorgangs Delete auf Delete.