Mit der REST-API importieren

Dieser Abschnitt enthält Beispielanforderungen und Antworten, wenn Sie Benutzer, Gruppen und AppRoles mit der REST-API für Identitätsdomains in Ihre Umgebung importieren möchten.

Die folgenden Abschnitte führen Sie durch die Schritte:

Hinweis

Um den Import der CSV-Datei in eine IAM-Identitätsdomain sicher zu verarbeiten, werden die Anführungszeichen entfernt, wenn Zellenwerte maskiert sind, um eine CSV-Injection zu vermeiden. Beispiel: Wenn der Zellenwert beim Import '@test' lautet, lautet der tatsächliche Wert @test.

Unter: @
Plus: +
Minus: -
Gleich: =
Pipe: |
Prozentsatz: %

CSV-Datei in Speicher importieren

Um die CSV-Datei in den Speicher zu importieren, senden Sie eine POST-Anforderung an den Endpunkt /storage/v1/Files.

Hinweis

Weitere Informationen zur CSV-Datei finden Sie unter Benutzer, Gruppen und AppRoles importieren und exportieren.


Parameter	Beschreibung
`fileName`	Geben Sie den Namen ein, den die Datei beim Speichern haben soll.
`isPublic`	Zeigt an, ob die Datei privat oder öffentlich ist. Derzeit werden nur private Dateien unterstützt. Setzen Sie diesen Wert auf `false.`.
`contentType`	Dateien sind auf `contentType` von `text/csv` oder `application/directory.` begrenzt.
`file`	Geben Sie den Namen der Datei ein, die Sie hochladen möchten.

Beispielanforderung

$ curl
   -X POST
   -H "Authorization: Bearer <Access Token Value>"
   -H "Cache-Control: no-cache"
   -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"
   -F "fileName=UsersImp1.csv"
   -F "contentType=text/csv"
   -F "isPublic=false"
   -F file=@"C:/examplefilelocation/Users1.csv" "https://<domainURL>/storage/v1/Files"

Beispielantwort

Hinweis

Notieren Sie sich den Wert fileName (fett in der Beispielantwort).

{
    "fileName": "files/201608261841/Users1.csv",
    "isPublic": false,
    "fileUrl": "https://<domainURL>/v1/Storage-example2/90C63D43D7E226D7A8C5E9F8BF7A24291FA5876BDC413AF9F37A3D94B8A02C5F/files/201608261841/Users1.csv"
}

Job zum Importieren der CSV-Datei in Ihre Umgebung planen

Hinweis

Verwenden Sie die folgende Anforderung, um auf die vollständige Liste der zulässigen CSV-Spaltennamen und deren Beschreibungen zuzugreifen:

GET <domainURL>/admin/v1/ResourceTypeSchemaAttributes?filter=resourceType eq "User" and idcsCsvAttributeName pr&attributes=name,idcsCsvAttributeName,idcsDisplayName,description,type,required,canonicalValues,mutability,caseExact,multiValued,idcsMinLength,idcsMaxLength,idcsSearchable

Weitere Informationen zum globalen Laden mit der Identitätsdomainkonsole finden Sie unter Daten übertragen.

Um einen geplanten Job zu erstellen, senden Sie eine POST-Anforderung an den Endpunkt /job/v1/JobSchedules. Im JSON-Beispielanforderungsbody unten kann für ressourcenspezifische jobType-Importe der Wert für jobType je nach Datentyp, den Sie importieren möchten, UserImport, GroupImport oder AppRoleImport lauten.

Es ist auch eine generische Importoption verfügbar, bei der der Wert für jobType Import lautet und dann das Attribut resourceType hinzugefügt wird und die Werte je nach Typ der Daten, die Sie importieren möchten, User, Group oder Grant (für AppRole) lauten können.

Hinweis

Die Verwendung der resourceType von AppRole für den Import wird nicht unterstützt.

Die folgenden Beispiele zeigen sowohl den ressourcenspezifischen jobType-Import als auch die generischen Importoptionen.

Beispielanforderung für den ressourcenspezifischen jobType-Import

$ curl
-X POST
   -H "Content-Type: application/scim+json"
   -H "Authorization: Bearer <Access Token Value>"
   -H "Cache-Control: no-cache" 
    -d '{
   "schemas": [
     "urn:ietf:params:scim:schemas:oracle:idcs:JobSchedule"
   ],
  "jobType": "UserImport",
   "runNow": true,
   "parameters": [
    {
      "name": "fileLocation",
      "value": "files/201608261841/UsersImp1.csv"
     },
    {
       "name": "fileType",
       "value": "csv"
     }
   ]
 }' "https://<domainURL>/job/v1/JobSchedules"

Für die AppRoleImport jobType: ist ein zusätzlicher Parameter erforderlich

{
  "name": "appDisplayName",
  "value": "MyApp"
}

Beispielantwort für den ressourcenspezifischen jobType-Import

Hinweis

Notieren Sie sich den Wert id (fett in der Beispielantwort). Dies ist der Wert für die jobScheduleid, den Sie im nächsten Abschnitt angeben.

{
  "id": "ffecd68a-fc08-4177-8afc-84a1d523b911",
  "jobType": "UserImport",
  "nextFireTime": "2022-08-26T18:42:19.883Z",
  "runAt": "2022-08-26T18:42:19.883Z",
  "parameters": [
    {
      "name": "fileLocation",
      "value": "files/201608261841/Users1.csv"
    },
    {
      "name": "fileType",
      "value": "csv"
    }
  ],
  "schemas": [
    "urn:ietf:params:scim:schemas:oracle:idcs:JobSchedule"
  ]
}

Beispielanforderung für generischen Import

$ curl
-X POST
   -H "Content-Type: application/scim+json"
   -H "Authorization: Bearer <Access Token Value>"
   -H "Cache-Control: no-cache" 
   -d '{
  "schemas": [
    "urn:ietf:params:scim:schemas:oracle:idcs:JobSchedule"
  ],
  "jobType": "Import",
  "runNow": true,
  "parameters": [
    {
      "name": "fileLocation",
      "value": "files/201608261841/UsersImp1.csv"
    },
    {
      "name": "fileType",
      "value": "csv"
    },
    {
      "name": "resourceType",
      "value": "User"
    }
  ]
}' "https://<domainURL>/job/v1/JobSchedules""

Für die Grant ResourceType: ist ein zusätzlicher Parameter erforderlich

{
  "name": "appDisplayName",
  "value": "MyApp"
}

Beispielantwort für generischen Import

Hinweis

Notieren Sie sich den Wert id (fett in der Beispielantwort). Dies ist der Wert für die jobScheduleid, den Sie im nächsten Abschnitt angeben.

{
  "id": "ffecd68a-fc08-4177-8afc-84a1d523b911",
  "jobType": "Import",
  "nextFireTime": "2022-08-26T18:42:19.883Z",
  "runAt": "2022-08-26T18:42:19.883Z",
  "parameters": [
    {
      "name": "fileLocation",
      "value": "files/201608261841/Users1.csv"
    },
    {
      "name": "fileType",
      "value": "csv"
    },
    {
      "name": "resourceType",
      "value": "User"
    }
  ],
  "schemas": [
    "urn:ietf:params:scim:schemas:oracle:idcs:JobSchedule"
  ]
}

Stellen Sie sicher, dass der Job erfolgreich war

Um zu prüfen, ob der Importjob erfolgreich war, senden Sie eine GET-Anforderung mit jobScheduleid als ID an den Endpunkt /job/v1/JobHistories.

Beispielanforderung

$   curl
   - X GET
   - H "Content-Type: application/json"
   - H "Authorization: Bearer Access Token Value"
   - H "Cache-Control: no-cache"
   "https://<domainURL>/job/v1/JobHistories?filter=jobScheduleid%20eq%20%22ffecd68a-fc08-4177-8afc-84a1d523b911%22"

Beispielantwort

Hinweis

Notieren Sie sich den Wert id (fett in der Beispielantwort). Dies ist der Wert für die historyId, den Sie im nächsten Abschnitt angeben.

{{
  "schemas": [
    "urn:scim:api:messages:2.0:ListResponse"],
  "totalResults": 1,
  "Resources": [
    {
      "endTime": "2022-08-26T18:42:21.878Z",
      "jobType": "UserImport",
      "failureCount": 0,
      "successCount": 5,
      "percentage": 100,
      "status": "succeeded",
      "jobDisplayName": "User File Import Job",
      "startTime": "2022-08-26T18:42:19.883Z",
      "jobDisplayId": "44",
      "jobScheduleId": "ffecd68a-fc08-4177-8afc-84a1d523b911",
      "jobDescription": "A job for importing users into IDCS from a file",
      "instanceId": "qa1siteb-2105-jobsv1-114718228563211471822859774",
      "totalCount": 5,
      "id": "2071a27f549843a48e00cadbb8f4364e",
      "meta": {
        "created": "2022-08-26T18:42:19.973Z",
        "lastModified": "2022-08-26T18:42:21.889Z",
        "resourceType": "JobHistory",
        "location": "https://<domainURL>/job/v1/JobHistories/2071a27f549843a48e00cadbb8f4364e"
      },
      "schemas": [
        "urn:ietf:params:scim:schemas:oracle:idcs:JobHistory"
      ],
      "idcsCreatedBy": {
        "value": "3f461931ecde403c85bf367379b417d3",
        "display": "admin opc",
        "type": "User",
        "$ref": "https://<domainURL>/admin/v1/Users/3f461931ecde403c85bf367379b417d3"
      },
      "idcsLastModifiedBy": {
        "value": "3f461931ecde403c85bf367379b417d3",
        "display": "admin opc",
        "type": "User",
        "$ref": "https://<domainURL>/admin/v1/Users/3f461931ecde403c85bf367379b417d3"
      }
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 50
}

Tätigkeitsbericht prüfen

Um den Status des Importjobs zu prüfen, senden Sie eine GET-Anforderung mit historyId als ID an den Endpunkt /job/v1/JobReports. Bei Fehlern im Importprozess werden diese Fehler in Form einer CSV-Datei im Speicher aufgelistet.

   curl
   -X GET
   -H "Authorization: Bearer <AccessToken>"
   -H "Cache-Control: no-cache"
   "https://<domainURL>/job/v1/JobReports?filter=historyId%20eq%20%2071a27f549843a48e00cadbb8f4364e"

Wenn Fehler vorliegen

Wenn bei einem Bulk-Ladevorgang Fehler auftreten und Sie diese nicht beheben können, indem Sie die Einträge in der Importdatei ändern, können Sie eine Diagnoseebene festlegen, um während des Bulk-Ladevorgangs Betriebslogs zu erfassen. Sie können diese Logs dann anzeigen, um die Ursache des Problems zu ermitteln. Weitere Informationen finden Sie unter Diagnosedatenbericht ausführen.

Wenn nach einem Bulk Load-Vorgang Fehler auftreten, können Sie die Fehler auf der Seite "Jobs" beheben.

Rufen Sie die Seite "Jobs" auf, indem Sie in der Identity Cloud Service-Konsole auf Jobs klicken.
Klicken Sie für den nicht erfolgreichen Job auf Details anzeigen.
Klicken Sie auf Fehler exportieren, und laden Sie die exportierte Fehlerdatei herunter.
Öffnen Sie die Fehlerdatei mit durch Komma getrennten Werten mit einem beliebigen CSV-Dateimanager, wie Microsoft Excel. Die exportierte Datei enthält alle nicht erfolgreichen Zeilen und den Fehlergrund in der Spalte Fehlermeldung.
Korrigieren Sie die Fehler, und entfernen Sie dann die Spalten Typ und Fehlermeldung aus der Datei.
Importieren Sie die Datei erneut.

Weitere Informationen finden Sie unter Jobs und Jobdetails anzeigen.

Vorhandene Werte durch komplexe mehrwertige Attribute ersetzen (CMVA)

Wenn Administratoren Benutzer mit Import aktualisieren, werden standardmäßig neue Werte zu vorhandenen mehrwertigen Attributen hinzugefügt.

Beispiel: Ein Benutzer hat seine geschäftliche E-Mail-Adresse auf alice@myservice.invalid gesetzt. E-Mail ist ein mehrwertiges Attribut. Wenn ein Administrator eine CSV-Datei mit dem aktualisierten E-Mail-Wert importiert (z.B. administrator@myservice.invalid), wird die neue E-Mail der vorhandenen E-Mail-Instanz hinzugefügt, und beide Werte werden gespeichert.

Sie können auch die E-Mail-Werte aktualisieren. Beispiel: Um den E-Mail-Wert in alice1@myservice.invalid zu aktualisieren, übergeben Sie das Attribut replaceExistingMultiValuedValues beim Planen eines Importjobs.

Beispiel-JSON-Payload:

{
  "schemas": [
    "urn:ietf:params:scim:schemas:oracle:idcs:JobSchedule"
  ],
  "jobType": "UserImport",
  "runNow": true,
  "parameters": [
    {
      "name": "fileLocation",
      "value": "files/202003260936/User.csv"
    },
    {
      "name": "fileType",
      "value": "csv"
    },
    {
      "name": "replaceExistingMultiValuedValues",
      "value": "true"
    }
  ]
}

Benutzerimportjobbericht anzeigen

Dieser Abschnitt enthält Beispielanforderungen und Antworten, wenn Sie einen Benutzerimportjobbericht anzeigen möchten, wenn Sie Benutzer mit der REST-API für Identitätsdomains in Ihre Umgebung importieren.

Beispielanforderung

Um den Benutzerimportjob zu prüfen, senden Sie eine GET-Anforderung mit historyId als ID an den Endpunkt /job/v1/UserImportJobReports.

   curl
   -X GET
   -H "Authorization: Bearer <AccessToken>"
   -H "Cache-Control: no-cache"
"https://<domainURL>/job/v1/UserImportJobReports?filter=historyId eq "227ef1ba8068cf43409884ed96254575fa"

Beispielantwort

{
  "schemas": [
    "urn:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 9,
  "Resources": [{
      "idcsLastModifiedBy": {
        "type": "User",
        "value": "d8dfed8ecdcf4df0b3a02333ae47b0a5",
        "display": "file_import_export_testIdentityDomainAdmin file_import_export_testIdentityDomainAdmin",
        "$ref": "https://<domainURL>/admin/v1/Users/d8dfed8ecdcf4df0b3a02333ae47b0a5"
      },
      "idcsCreatedBy": {
        "type": "User",
        "display": "file_import_export_testIdentityDomainAdmin file_import_export_testIdentityDomainAdmin",
        "value": "d8dfed8ecdcf4df0b3a02333ae47b0a5",
        "$ref": "https://<domainURL>/admin/v1/Users/d8dfed8ecdcf4df0b3a02333ae47b0a5"
      },
      "type": "info",
      "historyId": "cb4069d9ca904a609807d743e7e177ca",
      "id": "2a25c3f4df9a4c21a95236675e5ea561",
      "jobType": "UserImport",
      "meta": {
        "created": "Apr 20, 2017 4:40:20 AM CDT",
        "lastModified": "Apr 20, 2017 4:40:20 AM CDT",
        "resourceType": "UserImportJobReport",
        "location": "https://<domainURL>/job/v1/UserImportJobReports/2a25c3f4df9a4c21a95236675e5ea561"
      },
      "message": "User Imported Successfully.",
      "urn:ietf:params:scim:schemas:oracle:idcs:extension:UserImport:JobReport": {
        "responseData": "{\"location\":\"https://<domainURL>/admin/v1/Users/1d7a37c58ff84efc96d75b2499f0441a\",\"method\":\"PATCH\",\"requestNumber\":\"6aafefea-ae2a-4e8d-a56e-6882524d4d54\",\"status\":\"200\"}",
        "requestData": "User ID=integ.usertsVooUEwqA,Password=,First Name=firstName1Changed,Middle Name=,Last Name=User001Changed,Honorific Prefix=Mr,Honorific Suffix=,Display Name=,Title=,Profile URL=,User Type=,Nick Name=,Preferred Language=en,Locale=en-US,TimeZone=America/Los_Angeles,Active=TRUE,Work Phone=121-123-2245,Mobile No=1111000000,Work Email=workEmailAdded@myservice.invalid,Home Email=homeEmailAdded@myservice.invalid,Work Street Address=Sec 127,Work City=DELHI,Work State=DEL,Work Postal Code=110065,Work Country=IN,Employee Number=56273,Organization=ST,Division=IDM,Department=IDCS,Cost Center=Noida,Manager Name=integ.usertQAWkZLGOb,Federated=FALSE,Primary Email Type=home",
        "status": "Update Succeeded",
        "email": "workEmailAdded@myservice.invalid",
        "lastName": "User001Changed",
        "firstName": "firstName1Changed",
        "userId": "integ.usertsVooUEwqA"
      },
      "schemas": [
        "urn:ietf:params:scim:schemas:oracle:idcs:JobReport",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:UserImport:JobReport"
      ]
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 48
}

Berichte zu Gruppenimportjobs anzeigen

Dieser Abschnitt enthält Beispielanforderungen und Antworten, wenn Sie einen Übersichtsjobbericht für den Gruppenimport und einen detaillierten Gruppenimportjobbericht anzeigen möchten, wenn Sie Gruppen mit der REST-API für Identitätsdomains in Ihre Umgebung importieren.

Beispiel für eine Jobanforderung für die Importübersicht

Um den Zusammenfassungsjob für den Gruppenimport zu prüfen, senden Sie eine GET-Anforderung mit historyId als ID an den Endpunkt /job/v1/GroupImportSummaryJobReports.

   curl
    -X GET
   -H "Authorization: Bearer <AccessToken>"
   -H "Cache-Control: no-cache"
   "https://<domainURL>/job/v1/GroupImportSummaryJobReports?filter=historyId eq "99a693e0bc89421484f7d4dcb2193725"

Beispiel für eine Jobantwort für die Importübersicht

{
    "schemas": [
        "urn:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 6,
    "Resources": [
        {
            "idcsLastModifiedBy": {
                "type": "User",
                "value": "9df357a9767c499ab22b7808da07a722",
                "display": "file_import_export_testUserAdmin file_import_export_testUserAdmin",
                "$ref": "https://<domainURL>/admin/v1/Users/9df357a9767c499ab22b7808da07a722"
            },
            "idcsCreatedBy": {
                "type": "User",
                "display": "file_import_export_testUserAdmin file_import_export_testUserAdmin",
                "value": "9df357a9767c499ab22b7808da07a722",
                "$ref": "https://<domainURL>/admin/v1/Users/9df357a9767c499ab22b7808da07a722"
            },
            "type": "info",
            "historyId": "99a693e0bc89421484f7d4dcb2193725",
            "id": "76d122a2e68c436ea195e5d8077c248a",
            "jobType": "GroupImport",
            "meta": {
                "created": "Apr 20, 2017 4:58:56 AM CDT",
                "lastModified": "Apr 20, 2017 4:58:56 AM CDT",
                "resourceType": "GroupImportSummaryJobReport",
                "location": "https://<domainURL>/job/v1/GroupImportSummaryJobReports/76d122a2e68c436ea195e5d8077c248a"
            },
            "message": "-",
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:groupImportSummary:JobReport": {
                "failRows": 0,
                "description": "This row is checked for re entrant quality",
                "displayName": "RandomGroupgMVlqkMewc",
                "succRows": 1,
                "failMembers": 0,
                "succMembers": 2,
                "totalMembers": 2
            },
            "schemas": [
                "urn:ietf:params:scim:schemas:oracle:idcs:JobReport",
                "urn:ietf:params:scim:schemas:oracle:idcs:extension:groupImportSummary:JobReport"
            ]
        }
    ],
    "startIndex": 1,
    "itemsPerPage": 48
}

Beispiel für eine detaillierte Jobanforderung für den Import

Um den detaillierten Job für den Gruppenimport zu prüfen, senden Sie eine GET-Anforderung mit historyId als ID an den Endpunkt /job/v1/GroupImportDetailedJobReports.

   curl
   -X GET
   -H "Authorization: Bearer <AccessToken>"
   -H "Cache-Control: no-cache"
"https://<domainURL>/job/v1/GroupImportDetailedJobReports?filter=historyId eq "99a693e0bc89421484f7d4dcb2193725"

Beispiel für eine detaillierte Jobantwort für den Import

{
    "schemas": [
        "urn:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 1,
    "Resources": [
        {
            "idcsLastModifiedBy": {
                "type": "User",
                "value": "9df357a9767c499ab22b7808da07a722",
                "display": "file_import_export_testUserAdmin file_import_export_testUserAdmin",
                "$ref": "https://<domainURL>/admin/v1/Users/9df357a9767c499ab22b7808da07a722"
            },
            "idcsCreatedBy": {
                "type": "User",
                "display": "file_import_export_testUserAdmin file_import_export_testUserAdmin",
                "value": "9df357a9767c499ab22b7808da07a722",
                "$ref": "https://<domainURL>/admin/v1/Users/9df357a9767c499ab22b7808da07a722"
            },
            "type": "info",
            "historyId": "99a693e0bc89421484f7d4dcb2193725",
            "id": "c76c5cc346d2461a89ecb66db9473a1e",
            "jobType": "GroupImport",
            "meta": {
                "created": "Apr 20, 2017 4:58:55 AM CDT",
                "lastModified": "Apr 20, 2017 4:58:55 AM CDT",
                "resourceType": "GroupImportDetailedJobReport",
                "location": "https://<domainURL>/job/v1/GroupImportDetailedJobReports/c76c5cc346d2461a89ecb66db9473a1e"
            },
            "message": "Group Imported Successfully.",
            "urn:ietf:params:scim:schemas:oracle:idcs:extension:groupImportDetailed:JobReport": {
                "description": "Employee Group5",
                "displayName": "RandomGroupfuJLZurEaY",
                "responseData": "{\"location\":\"https://<domainURL>/admin/v1/Groups/d44507d5747a46ea9fbf861cfd00549f\",\"method\":\"POST\",\"requestNumber\":\"a7655f03-cc86-4d22-9c7e-e9b398690775\",\"bulkId\":\"a7655f03-cc86-4d22-9c7e-e9b398690775\",\"status\":\"201\"}",
                "requestData": "Display Name=RandomGroupfuJLZurEaY,Description=Employee Group5,User Members=Gusty_HMtvdP.Rob@example.com;gusty_xputur.rob@example.com",
                "status": "Creation Succeeded",
                "members": "Gusty_HMtvdP.Rob@example.com;gusty_xputur.rob@example.com"
            },
            "schemas": [
                "urn:ietf:params:scim:schemas:oracle:idcs:JobReport",
                "urn:ietf:params:scim:schemas:oracle:idcs:extension:groupImportDetailed:JobReport"
            ]
        }
    ],
    "startIndex": 1,
    "itemsPerPage": 48
}

Berichte zu AppRole-Mitgliedschaftsimportjobs anzeigen

Dieser Abschnitt enthält Beispielanforderungen und Antworten, wenn Sie einen Übersichtsjobbericht zum AppRole-Mitgliedschaftsimport und einen detaillierten Jobbericht zum AppRole-Mitgliedschaftsimport anzeigen möchten, wenn Sie AppRole-Mitgliedschaften mit der REST-API für Identitätsdomains in Ihre Umgebung importieren.

Beispiel für eine Jobanforderung für die Importübersicht

Um den Übersichtsjob für den AppRole-Mitgliedschaftsimport zu prüfen, senden Sie eine GET-Anforderung mit historyId als ID an den Endpunkt /job/v1/AppRoleMembershipImportSummaryJobReports.

   curl -X GET
   -H "Authorization: Bearer <AccessToken>"
   -H "Cache-Control: no-cache"
"https://<domainURL>/job/v1/AppRoleMembershipImportSummaryJobReports? filter=historyId eq "258a235de81b4704bcbd1c03fb08d33b"

Beispiel für eine Jobantwort für die Importübersicht

{
  "schemas": [
    "urn:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 1,
  "Resources": [{
      "idcsLastModifiedBy": {
        "type": "User",
        "value": "2eee19172d154fd6a99a9761b158e469",
        "display": "file_import_export_testAppAdmin file_import_export_testAppAdmin",
        "$ref": "https://<domainURL>/admin/v1/Users/2eee19172d154fd6a99a9761b158e469"
      },
      "idcsCreatedBy": {
        "type": "User",
        "display": "file_import_export_testAppAdmin file_import_export_testAppAdmin",
        "value": "2eee19172d154fd6a99a9761b158e469",
        "$ref": "https://<domainURL>/admin/v1/Users/2eee19172d154fd6a99a9761b158e469"
      },
      "type": "info",
      "historyId": "258a235de81b4704bcbd1c03fb08d33b",
      "id": "d3c46c37cb5b49d9a431a3cb5503e57a",
      "jobType": "AppRoleImport",
      "meta": {
        "created": "Apr 13, 2017 5:38:44 AM CDT",
        "lastModified": "Apr 13, 2017 5:38:44 AM CDT",
        "resourceType": "AppRoleMembershipImportSummaryJobReport",
        "location": "https://<domainURL>/job/v1/AppRoleMembershipImportSummaryJobReports/d3c46c37cb5b49d9a431a3cb5503e57a"
      },
      "message": "-",
      "urn:ietf:params:scim:schemas:oracle:idcs:extension:AppRoleMembershipImportSummary:JobReport": {
        "succRows": 9,
        "failRows": 0,
        "AppRoleName": "JCSAppRoleEfHxHW",
        "appDisplayName": "JCSEfHxHW",
        "totalMembers": 9,
        "succUserMembers": 5,
        "failUserMembers": 0,
        "succGroupMembers": 4,
        "failGroupMembers": 0
      },
      "schemas": [
        "urn:ietf:params:scim:schemas:oracle:idcs:JobReport",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:AppRoleMembershipImportSummary:JobReport"
      ]
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 48
}

Beispiel für eine detaillierte Jobanforderung für den Import

Um den detaillierten Job für den AppRole-Mitgliedschaftsimport zu prüfen, senden Sie eine GET-Anforderung mit historyId als ID an den Endpunkt /job/v1/AppRoleMembershipImportDetailedJobReports.

   curl -X GET
   -H "Authorization: Bearer <AccessToken>"
   -H "Cache-Control: no-cache"
"https://<domainURL>/job/v1/AppRoleMembershipImportDetailedJobReports?filter=historyId eq "22258a235de81b4704bcbd1c03fb08d33b"

Beispiel für eine detaillierte Jobantwort für den Import

{
  "schemas": [
    "urn:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 9,
  "Resources": [{
      "idcsLastModifiedBy": {
        "type": "User",
        "value": "2eee19172d154fd6a99a9761b158e469",
        "display": "file_import_export_testAppAdmin file_import_export_testAppAdmin",
        "$ref": "https://<domainURL>/admin/v1/Users/2eee19172d154fd6a99a9761b158e469"
      },
      "idcsCreatedBy": {
        "type": "User",
        "display": "file_import_export_testAppAdmin file_import_export_testAppAdmin",
        "value": "2eee19172d154fd6a99a9761b158e469",
        "$ref": "https://<domainURL>/admin/v1/Users/2eee19172d154fd6a99a9761b158e469"
      },
      "type": "info",
      "historyId": "258a235de81b4704bcbd1c03fb08d33b",
      "id": "18452ef094be484491e8df9777ab4437",
      "jobType": "AppRoleImport",
      "meta": {
        "created": "Apr 13, 2017 5:38:44 AM CDT",
        "lastModified": "Apr 13, 2017 5:38:44 AM CDT",
        "resourceType": "AppRoleMembershipImportDetailedJobReport",
        "location": "https://<domainURL>/job/v1/AppRoleMembershipImportDetailedJobReports/18452ef094be484491e8df9777ab4437"
      },
      "message": "AppRole Membership Imported Successfully.",
      "urn:ietf:params:scim:schemas:oracle:idcs:extension:AppRoleMembershipImportDetailed:JobReport": {
        "memberType": "Group",
        "status": "Creation Succeeded",
        "member": "TestCvAwSWGroup1",
        "AppRoleDisplayName": "JCSAppRoleEfHxHW",
        "requestData": "Entitlement Value=JCSAppRoleEfHxHW,Grantee Name=TestCvAwSWGroup1,Grantee Type=Group",
        "responseData": "{\"location\":\"https://<domainURL>/admin/v1/Grants/7ce75f5132e44e5c91f1e8ef76521778\",\"method\":\"POST\",\"requestNumber\":\"23f0330e-c84b-40ec-b939-a40066c8b659\",\"bulkId\":\"23f0330e-c84b-40ec-b939-a40066c8b659\",\"status\":\"201\"}"
      },
      "schemas": [
        "urn:ietf:params:scim:schemas:oracle:idcs:JobReport",
        "urn:ietf:params:scim:schemas:oracle:idcs:extension:AppRoleMembershipImportDetailed:JobReport"
      ]
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 48
}

Oracle Cloud Infrastructure - Dokumentation

Mit der REST-API importieren

CSV-Datei in Speicher importieren

Job zum Importieren der CSV-Datei in Ihre Umgebung planen

Stellen Sie sicher, dass der Job erfolgreich war

Tätigkeitsbericht prüfen

Wenn Fehler vorliegen

Vorhandene Werte durch komplexe mehrwertige Attribute ersetzen (CMVA)

Benutzerimportjobbericht anzeigen

Beispielanforderung

Beispielantwort

Berichte zu Gruppenimportjobs anzeigen

Beispiel für eine Jobanforderung für die Importübersicht

Beispiel für eine Jobantwort für die Importübersicht

Beispiel für eine detaillierte Jobanforderung für den Import

Beispiel für eine detaillierte Jobantwort für den Import

Berichte zu AppRole-Mitgliedschaftsimportjobs anzeigen

Beispiel für eine Jobanforderung für die Importübersicht

Beispiel für eine Jobantwort für die Importübersicht

Beispiel für eine detaillierte Jobanforderung für den Import

Beispiel für eine detaillierte Jobantwort für den Import