Unterstützte APIs

URL von IBM® Storage für Cloud-Partner lautet ibm.com/partnerhttps://graph.sp4c.storage-defender

GET api/v1.1/customers

Rufen Sie die allgemeinen Informationen der Kunden ab, die Sie verwalten.

Erforderliche Berechtigung: partner.customers.read.all

Antwortinformationen:
Element Beschreibung Typ
ID Die Tenanteigner-ID des Kunden. Zeichenfolge
Organisation Der Organisationsname des Kunden. Zeichenfolge
ownerEmail Die E-Mail-Adresse des Tenanteigners des Kunden. Zeichenfolge
jobStatus Der Status des Tenants des Kunden. Zeichenfolge
countryOrRegion Der Name des Landes oder der Region des Kunden Zeichenfolge

GET api/v1.1/customers( 'id')

Rufen Sie die allgemeinen Informationen eines bestimmten Kunden ab, den Sie verwalten.

Erforderliche Berechtigung: partner.customers.read.all

Antwortinformationen:

Element Beschreibung Typ
ID Die Tenanteigner-ID des Kunden. Zeichenfolge
Organisation Der Organisationsname des Kunden. Zeichenfolge
ownerEmail Die E-Mail-Adresse des Tenanteigners des Kunden. Zeichenfolge
jobStatus Der Status des Tenants des Kunden. Zeichenfolge
countryOrRegion Der Name des Landes oder der Region des Kunden Zeichenfolge

GET api/v1.1/customers('id') /protected

Rufen Sie die geschützten Dateninformationen Ihrer Kunden von IBM Storage Protect for Cloud Microsoft 365ab.
Hinweis: Nur der Service IBM Storage Protect for Cloud Microsoft 365 , für den Kunden das Abonnement haben, wird unterstützt.

Erforderliche Berechtigung: partner.cbprotected.read.all

Antwortinformationen:

Element Beschreibung Typ
customerId Die Tenanteigner-ID des Kunden. Zeichenfolge
Kunde Die E-Mail-Adresse des Tenanteigners des Kunden. Zeichenfolge
serviceType Der IBM Storage Protect for Cloud Microsoft 365 -Service, für den der Kunde Abonnements hat. Zeichenfolge
serviceModule Das Modul des Kundenservice. Zeichenfolge
totalScannedObjects Die Anzahl der überprüften Objekte. Ganze Zahl
totalProtectedObjects Die Anzahl der gesicherten Objekte. Ganze Zahl
dataSizeStoredInIBM Die Größe der gesicherten Objekte, die im IBM Speicher gespeichert sind. Zeichenfolge
dataSizeStoredInBYOS Die Größe der gesicherten Objekte, die in BYOS gespeichert sind. Zeichenfolge

GET api/v1.1/services

Rufen Sie die Lizenzdetails verschiedener Services für die von Ihnen verwalteten Kunden ab.
Hinweis: Es werden nur Services unterstützt, für die Kunden das Abonnement Enterprise haben.

Erforderliche Berechtigung: partner.license.read.all

Antwortinformationen:

Element Beschreibung Typ
customerId Die Tenanteigner-ID des Kunden. Zeichenfolge
Organisation Der Organisationsname des Kunden. Zeichenfolge
Kunde Der Tenanteigner des Kunden. Zeichenfolge
tenantId Die Tenant-ID des Kunden. Zeichenfolge
Produkte Eine Liste der Produkte, die der Kunde abonniert hat. Liste
Produktabonnements:
Element Beschreibung Typ
Service Der Service, für den der Kunde Abonnements hat. Zeichenfolge
subscriptionModel Das Abonnementmodell des Kundenservice. Zeichenfolge
purchasedUserSeats Die Anzahl der erworbenen Benutzerplätze des Kunden. Zeichenfolge
microsoftLicenseAssigned Die Anzahl der zugewiesenen Microsoft-Lizenzen des Kunden. Zeichenfolge
microsoftLicenseAvailable Die Anzahl der verfügbaren Microsoft-Lizenzen des Kunden. Zeichenfolge
purchasedCapacity Die gekaufte Kapazität des Kunden. Zeichenfolge
protectedCapacity Die geschützte Datengröße des Kunden. Zeichenfolge
Speicher Der Speichertyp des Kunden. Zeichenfolge
Aufbewahrungsdauer Der Datenaufbewahrungszeitraum des Kunden. Zeichenfolge
consumedStorage Die belegte Speichergröße des Kunden. Zeichenfolge
expirationDate Das Ablaufdatum des Kundenservices. Zeichenfolge
Änderung Der Benutzer hat sich in der Poollizenz im Vergleich zum ersten Tag des aktuellen Monats geändert. Zeichenfolge
Quelle Die Quelle des Abonnements. Zeichenfolge

GET api/v1.1/services('CustomerId' )

Rufen Sie die Lizenzdetails verschiedener Services für einen bestimmten Kunden ab, den Sie verwalten.
Hinweis: Es werden nur Services unterstützt, für die Kunden das Abonnement Enterprise haben.

Erforderliche Berechtigung: partner.license.read.all

Antwortinformationen:

Element Beschreibung Typ
customerId Die Tenanteigner-ID des Kunden. Zeichenfolge
Organisation Der Organisationsname des Kunden. Zeichenfolge
Kunde Die E-Mail-Adresse des Tenanteigners des Kunden. Zeichenfolge
tenantId Die Tenant-ID des Kunden. Zeichenfolge
Produkt Eine Liste der Produkte, die der Kunde abonniert hat. Liste
Produktabonnements :
Element Beschreibung Typ
Service Der Service, für den der Kunde Abonnements hat. Zeichenfolge
subscriptionModel Das Abonnementmodell des Kundenservice. Zeichenfolge
purchasedUserSeats Die Anzahl der erworbenen Benutzerplätze des Kunden. Zeichenfolge
microsoftLicenseAssigned Die Anzahl der zugewiesenen Microsoft-Lizenzen des Kunden. Zeichenfolge
microsoftLicenseAvailable Die Anzahl der verfügbaren Microsoft-Lizenzen des Kunden. Zeichenfolge
purchasedCapacity Die gekaufte Kapazität des Kunden. Zeichenfolge
Speicher Der Speichertyp des Kunden. Zeichenfolge
Aufbewahrungsdauer Der Datenaufbewahrungszeitraum des Kunden. Zeichenfolge
consumedStorage Die belegte Speichergröße des Kunden. Zeichenfolge
expirationDate Das Ablaufdatum des Kundenservices. Zeichenfolge

GET api/v1.1/customers('id') /jobs

Rufen Sie die Jobdetails der Sicherungsservices eines bestimmten Kunden ab, den Sie verwalten.

Hinweis: Es werden nur Jobdetails des Service unterstützt, für den der Kunde über das Abonnement verfügt.

Erforderliche Berechtigung: partner.jobs.read.all

Antwortinformationen:
Element Beschreibung Typ
jobType Der Servicetyp des Jobs. Zeichenfolge
jobModule Das Servicemodul des Jobs. Zeichenfolge
Status Der Jobstatus. Zeichenfolge
jobId Die Job-ID. Zeichenfolge
Name Der Jobname. Zeichenfolge
totalCount Die Anzahl der Objekte, die vom Job verarbeitet wurden. Zeichenfolge
failedCount Die Anzahl der fehlgeschlagenen Objekte. Zeichenfolge
successfulCount Die Anzahl der erfolgreichen Objekte. Zeichenfolge
skippedCount Die Anzahl der übersprungenen Objekte. Zeichenfolge
warningCount Die Anzahl der Warnungsobjekte. Zeichenfolge
backupSize Die Größe der gesicherten Objekte. Zeichenfolge
startTime Die Startzeit des Jobs. Zeichenfolge
endTime Die Endzeit des Jobs. Zeichenfolge
jobDuration Die Jobdauer. Zeichenfolge
lastModifyTime Der Zeitpunkt der letzten Änderung des Jobs Zeichenfolge

GET api/v1.1/customers('id')/jobsJobType='job type',JobModule='job module')

Rufen Sie die Jobdetails eines bestimmten Jobtyps und Moduls des Sicherungsservice für einen von Ihnen verwalteten Kunden ab.
Hinweis: Nur Jobdetails des Service, für den der Kunde über das Abonnement verfügt, werden unterstützt

Unterstützte Jobtypwerte: Microsoft 365, Google Workspace, Azure, Dynamics 365 oder Salesforce

Unterstützte Jobmodulwerte:
  • Microsoft 365: SharePoint Online, Exchange Online, Microsoft 365 Group, OneDrive, Project Online, Exchange Online Public Folders, Microsoft Teams, Microsoft Teams Chat, Viva Engage, Power BI, Power Automate, oder Power Apps
  • Google Workspace: Gmail, Kalender, Kontakte, Laufwerk oder gemeinsam genutzte Laufwerke
  • Azure: Einstellung für virtuelle Maschine, Microsoft-Entra-ID, Speicher oder Administratorportal
  • Dynamics 365: Dynamics Customer Engagement oder Dynamics Unified Operations
  • Salesforce: Salesforce

Erforderliche Berechtigung: partner.jobs.read.all

Antwortinformationen:
Element Beschreibung Typ
jobType Der Servicetyp des Jobs. Zeichenfolge
jobModule Das Servicemodul des Jobs. Zeichenfolge
Status Der Jobstatus. Zeichenfolge
jobId Die Job-ID. Zeichenfolge
Name Der Jobname. Zeichenfolge
totalCount Die Anzahl der Objekte, die vom Job verarbeitet wurden. Zeichenfolge
failedCount Die Anzahl der fehlgeschlagenen Objekte. Zeichenfolge
successfulCount Die Anzahl der erfolgreichen Objekte. Zeichenfolge
skippedCount Die Anzahl der übersprungenen Objekte. Zeichenfolge
warningCount Die Anzahl der Warnungsobjekte. Zeichenfolge
backupSize Die Größe der gesicherten Objekte. Zeichenfolge
startTime Die Startzeit des Jobs. Zeichenfolge
endTime Die Endzeit des Jobs. Zeichenfolge
jobDuration Die Jobdauer. Zeichenfolge
lastModifyTime Der Zeitpunkt der letzten Änderung des Jobs Zeichenfolge

GET api/v1.1/customers('id') /scanprofiles

Rufen Sie die Informationen aller Scanprofile ab, die in IBM Storage Protect for Cloud für einen Kunden konfiguriert wurden.

Erforderliche Berechtigung: partner.scanprofiles.read.all

Antwortinformationen:
Element Beschreibung Typ
profileName Der Name des Scanprofils. Zeichenfolge
profileId Die ID des Scanprofils. Zeichenfolge
scanMode
Der Scanmodus des Scanprofils.
  • 0-Express-Modus
  • 1-Modus 'Erweitert'
 Ganze Zahl
modifiedTime Der Zeitpunkt der letzten Änderung des Scanprofils. Zeichenfolge

GET api/v1.1/customers('id')/ScanProfilesDetails(ProfileId='ProfileId' )

Abrufen von Informationen zu einem in IBM Storage Protect for Cloud konfigurierten Scanprofil für einen Kunden.

Erforderliche Berechtigung: partner.scanprofiles.read.all

Antwortinformationen:

Element Beschreibung Typ
profileId Die ID des Scanprofils. Zeichenfolge
profileName Der Name des Scanprofils. Zeichenfolge
Beschreibung Die Beschreibung des Scanprofils. Zeichenfolge
tenantId Die Tenant-ID des Scanprofils. Zeichenfolge
tenantDomain Die Tenantdomäne des Scanprofils Zeichenfolge
scanMode

Der Scanmodus des Scanprofils.

0-Express-Modus

1-Modus 'Erweitert'

 Zeichenfolge
modifiedTime Der Zeitpunkt der letzten Änderung des Scanprofils. Zeichenfolge
createdTime Die Erstellungszeit des Scanprofils. Zeichenfolge
impersonationAccount Das im Scanprofil konfigurierte Stellvertreterkonto. Zeichenfolge
scanInplaceArchivedMailboxes

Ob die Einstellung Archivierte Postfächer vor Ort scannen im Scanprofil aktiviert ist oder nicht.

True-Inplace-Scannen der archivierten Mailbox

False-Inplace-Archivmailbox nicht scannen

 Boolesch
isIgnoreLockedSiteEnabled

Ob die Einstellung Gesperrte Objekte bei der Aktualisierung des Auftragsstatus ignorieren im Scanprofil aktiviert ist oder nicht.

True-Aktiviert

Falsch-Inaktiviert

 Boolesch
enableDailyScan

Ob die Einstellung Tägliche Prüfung aktivieren im Prüfprofil aktiviert ist oder nicht.

Nein-Der tägliche Scan ist nicht aktiviert.

hh: mm-Die Zeit des täglichen Scans. Beispiel: 01:59.

 Zeichenfolge
isSendOutOfPolicyNotification

Ob die Einstellung E-Mail-Benachrichtigung an folgende Empfänger senden, wenn Objekte in andere Container verschoben oder aus einem Container entfernt werden im Scanprofil aktiviert ist oder nicht.

True-Aktiviert

Falsch-Inaktiviert

 Boolesch
Container Die Containerdetails des Scanprofils. ContainersName Zeichenfolge
ObjectType Zeichenfolge
Hinweis: Um die Benutzerfreundlichkeit zu verbessern, haben wir isIgnoreLockedSiteEnabled hinzugefügt, um ignoreTheLockedObjectsWhenUpdatingTheJobStatus zu ersetzen und isSendOutOfPolicyNotification hinzugefügt, um sendAnemailNotificationToTheFollowIngRecipientsWhenObjectsAreMovedTooTherContainerOrRemovedFromAnyContainers zu ersetzen.

GET api/v1.1/Customers('id')/ScanProfilesDailyNew(ProfileId='ProfileId' )

Abrufen der täglichen Scanprofiländerungen in IBM Storage Protect for Cloud für einen Kunden.

Erforderliche Berechtigung: partner.scanprofiles.read.all

Antwortinformationen:

Element Beschreibung Typ
profileName Der Name des Scanprofils. Zeichenfolge
profileID Die ID des Scanprofils. Zeichenfolge
tenantDomain Die Tenantdomäne des Scanprofils Zeichenfolge
tenantID Die Tenant-ID des Scanprofils. Zeichenfolge
Beschreibung Die Beschreibung des Scanprofils. Zeichenfolge
scanMode

Der Scanmodus des Scanprofils.

0-Express-Modus

1-Modus 'Erweitert'

 Ganze Zahl
modifiedTime Der Zeitpunkt der letzten Änderung des Scanprofils. Zeichenfolge
lastUpdateTime Die Zeit, zu der der tägliche Bericht für das Scanprofil generiert wird Wenn kein täglicher Bericht generiert wurde, ist die Zeit die Zeit der letzten Änderung des Scanprofils. Zeichenfolge
lastScanStatus

Der Status des letzten Scanauftrags des Scanprofils.

1 - In Bearbeitung

2 - Beendet

3 - Gescheitert

4 - Beendet mit Ausnahme

5 - Übersprungen

10 - Angehalten

 Ganze Zahl
newRegisteredContentCount

Die Anzahl der neu registrierten Inhalte im Tagesbericht des Suchprofils.

 Ganze Zahl
movedToAnotherContainerObjects Die Anzahl der Objekte, die im Tagesbericht des Suchprofils in einen anderen Container verschoben wurden. Ganze Zahl
removedFromMicrosoft365OrOutofPolicy Die Anzahl der Objekte, die im täglichen Bericht des Scanprofils aus Microsoft 365 oder aus der Richtlinie entfernt wurden. Ganze Zahl
Hinweis: Um die Benutzerfreundlichkeit zu verbessern, haben wir newRegisteredContentCount anstelle von newRegistedContentCount hinzugefügt.

GET api/v1.1/Customers('id')/ScanProfilesDailyNewDetail(ProfileId='ProfileId' )

Abrufen der täglichen Scanprofil-Änderungsdetails in IBM Storage Protect for Cloud für einen Kunden.

Erforderliche Berechtigung: partner.scanprofiles.read.all

Antwortinformationen:

Element Beschreibung Typ
profileName Der Name des Scanprofils. Zeichenfolge
profileID Die ID des Scanprofils. Zeichenfolge
tenantDomain Die Tenantdomäne des Scanprofils Zeichenfolge
tenantID Die Tenant-ID des Scanprofils. Zeichenfolge
lastUpdateTime Die Zeit, zu der der tägliche Bericht für das Scanprofil generiert wird Wenn kein täglicher Bericht generiert wurde, ist die Zeit die Zeit der letzten Änderung des Scanprofils. Zeichenfolge
newRegisteredContent

Die Details des neu registrierten Inhalts im täglichen Bericht des Scanprofils.

 objectName Zeichenfolge
containerName Zeichenfolge
removedFromMicrosoft365OrOutOfPolicyObjects Die Details von Objekten, die im täglichen Bericht des Scanprofils in einen anderen Container verschoben wurden. objectName Zeichenfolge
containerName Zeichenfolge
movedToAnotherContainerObjects Die Details zu Objekten, die aus Microsoft 365 entfernt wurden oder aus der Richtlinie entfernt wurden, im täglichen Bericht des Scanprofils. objectName Zeichenfolge
containerName Zeichenfolge
Hinweis: Um die Benutzerfreundlichkeit zu verbessern, haben wir newRegisteredContent anstelle von newRegistedContent hinzugefügt.