Importation à l'aide de l'API REST

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez importer des utilisateurs, des groupes et AppRoles dans votre environnement à l'aide de l'API REST des domaines d'identité.

Les sections suivantes vous guident tout au long des étapes :

Note

Pour gérer l'importation du fichier CSV dans un domaine d'identité IAM en toute sécurité, si des valeurs de cellule sont échappées pour éviter l'injection CSV, les guillemets sont supprimés. Par exemple, lors de l'importation si la valeur de la cellule est '@test', la valeur réelle sera @test.

À : @
Plus : +
Moins : -
Égal à : =
Barre verticale : |
Pourcentage : %

Importer le fichier CSV dans le stockage

Pour importer le fichier CSV dans le stockage, envoyez une demande POST au point d'extrémité /storage/v1/Files.

Note

Pour plus d'informations sur le fichier CSV, voir Importation et exportation d'utilisateurs, de groupes et AppRoles.


Paramètre	Description
`fileName`	Entrez le nom du fichier lorsque vous l'enregistrez dans le stockage.
`isPublic`	Indique si le fichier est privé ou public. Actuellement, seuls les fichiers privés sont pris en charge. Réglez cette valeur à `false.`
`contentType`	Les fichiers sont limités à `contentType` de `text/csv` ou `application/directory.`
`file`	Entrez le nom du fichier à charger.

Exemple de demande

$ 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"

Exemple de réponse

Note

Notez la valeur fileName (gras dans l'exemple de réponse).

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

Programmer la tâche d'importation du fichier CSV dans votre environnement

Note

Pour accéder à la liste complète des noms de colonne CSV autorisés et à leur description, utilisez la demande suivante :

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

Voir Transfert de données pour plus d'informations sur le chargement en masse à l'aide de la console du domaine d'identité.

Pour créer une tâche programmée, envoyez une demande POST au point d'extrémité /job/v1/JobSchedules. Dans l'exemple de corps de demande JSON ci-dessous, pour les importations jobType propres à la ressource, la valeur de jobType peut être UserImport, GroupImport ou AppRoleImport, selon le type de données que vous tentez d'importer.

Il existe également une option d'importation générique disponible où la valeur de jobType est Import, puis l'attribut resourceType est ajouté et les valeurs peuvent être User, Group ou Grant (pour AppRole), selon le type de données que vous tentez d'importer.

Note

L'utilisation de resourceType de AppRole pour l'importation n'est pas prise en charge.

Les exemples ci-dessous présentent à la fois l'importation jobType propre à la ressource et les options d'importation génériques.

Exemple de demande pour l'importation jobType propre à la ressource

$ 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"

Un paramètre supplémentaire est requis pour AppRoleImport jobType:

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

Exemple de réponse pour l'importation jobType propre à la ressource

Note

Notez la valeur id (gras dans l'exemple de réponse). Il s'agit de la valeur pour jobScheduleid que vous spécifiez dans la section suivante.

{
  "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"
  ]
}

Exemple de demande d'importation générique

$ 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""

Un paramètre supplémentaire est requis pour Grant ResourceType:

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

Exemple de réponse pour l'importation générique

Note

Notez la valeur id (gras dans l'exemple de réponse). Il s'agit de la valeur pour jobScheduleid que vous spécifiez dans la section suivante.

{
  "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"
  ]
}

Vérifier que le travail a réussi

Pour vérifier que la tâche d'importation a réussi, envoyez une demande GET au point d'extrémité /job/v1/JobHistories en utilisant jobScheduleid comme identificateur.

Exemple de demande

$   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"

Exemple de réponse

Note

Notez la valeur id (gras dans l'exemple de réponse). Il s'agit de la valeur pour historyId que vous spécifiez dans la section suivante.

{{
  "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
}

Réviser le rapport sur les emplois

Pour vérifier le statut de la tâche d'importation, envoyez une demande GET au point d'extrémité /job/v1/JobReports en utilisant historyId comme identificateur. S'il y a des échecs dans le processus d'importation, il liste ces échecs sous la forme d'un fichier CSV en stockage.

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

Lorsqu'il y a des erreurs

Si vous rencontrez des erreurs lors d'une opération de chargement en masse et que vous ne pouvez pas les corriger en modifiant les entrées du fichier d'importation, vous pouvez définir un niveau de diagnostic pour saisir les journaux opérationnels lors de l'opération de chargement en masse. Vous pouvez ensuite consulter ces journaux pour vous aider à déterminer la cause du problème. Pour plus d'informations, voir Exécution du rapport Données de diagnostic.

Si vous rencontrez des erreurs après une opération de chargement en masse, utilisez la page Tâches pour vous aider à résoudre les erreurs.

Accédez à la page Tâches en sélectionnant Tâches dans la console Identity Cloud Service.
Sélectionnez Voir les détails pour la tâche en échec.
Sélectionnez Exporter les erreurs, puis téléchargez le fichier d'erreurs exporté.
Ouvrez le fichier d'erreurs de valeurs séparées par des virgules à l'aide de tout gestionnaire de fichiers .csv, tel que Microsoft Excel. Le fichier exporté contient toutes les rangées en échec, ainsi que le motif de l'échec dans la colonne Message d'erreur.
Corrigez les erreurs, puis supprimez les colonnes Type et Message d'erreur du fichier.
Réimportez le fichier.

Pour plus d'informations, voir Consultation des tâches et des détails de la tâche.

Remplacement de valeurs existantes par des attributs multivaleurs complexes (CMVA)

Lorsque les administrateurs mettent à jour les utilisateurs à l'aide de l'option Importer, de nouvelles valeurs sont ajoutées par défaut aux attributs multivaleurs existants.

Par exemple, supposons qu'un utilisateur ait réglé son courriel professionnel à alice@myservice.invalid. Le courriel est un attribut multivaleur. Lorsqu'un administrateur importe un fichier CSV avec la valeur de courriel mise à jour (par exemple, administrator@myservice.invalid), le nouveau courriel est ajouté à l'instance de courriel existante et les deux valeurs sont enregistrées.

Vous pouvez également mettre à jour les valeurs de courriel. Par exemple, pour mettre à jour la valeur du courriel à alice1@myservice.invalid, transmettez l'attribut replaceExistingMultiValuedValues lors de la programmation d'une tâche d'importation.

Exemple de données utiles JSON :

{
  "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"
    }
  ]
}

Consultation d'un rapport sur une tâche d'importation d'utilisateurs

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez voir un rapport de tâche d'importation d'utilisateurs lorsque vous importez des utilisateurs dans votre environnement à l'aide de l'API REST des domaines d'identité.

Exemple de demande

Pour vérifier la tâche d'importation d'utilisateur, envoyez une demande GET au point d'extrémité /job/v1/UserImportJobReports en utilisant historyId comme identificateur.

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

Exemple de réponse

{
  "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
}

Affichage des rapports sur les tâches d'importation de groupes

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez voir un rapport sommaire sur les tâches d'importation de groupe et un rapport détaillé sur les tâches d'importation de groupe lorsque vous importez des groupes dans votre environnement à l'aide de l'API REST des domaines d'identité.

Exemple de demande de tâche sommaire d'importation

Pour vérifier la tâche sommaire d'importation de groupe, envoyez une demande GET au point d'extrémité /job/v1/GroupImportSummaryJobReports en utilisant historyId comme identificateur.

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

Exemple de réponse à la tâche sommaire d'importation

{
    "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
}

Exemple de demande de tâche détaillée d'importation

Pour vérifier la tâche détaillée d'importation de groupe, envoyez une demande GET au point d'extrémité /job/v1/GroupImportDetailedJobReports en utilisant historyId comme identificateur.

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

Exemple de réponse détaillée à la tâche d'importation

{
    "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
}

Affichage des rapports sur les tâches d'importation d'appartenance AppRole

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez voir un rapport de tâche sommaire d'importation d'appartenance AppRole et un rapport de tâche détaillé d'importation d'appartenance AppRole lorsque vous importez des appartenances AppRole dans votre environnement à l'aide de l'API REST des domaines d'identité.

Exemple de demande de tâche sommaire d'importation

Pour vérifier la tâche sommaire d'importation d'appartenance à AppRole, envoyez une demande GET au point d'extrémité /job/v1/AppRoleMembershipImportSummaryJobReports en utilisant historyId comme identificateur.

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

Exemple de réponse à la tâche sommaire d'importation

{
  "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
}

Exemple de demande de tâche détaillée d'importation

Pour vérifier la tâche détaillée d'importation d'appartenance à AppRole, envoyez une demande GET au point d'extrémité /job/v1/AppRoleMembershipImportDetailedJobReports en utilisant historyId comme identificateur.

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

Exemple de réponse détaillée à la tâche d'importation

{
  "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
}

Documentation sur Oracle Cloud Infrastructure

Importation à l'aide de l'API REST

Importer le fichier CSV dans le stockage

Programmer la tâche d'importation du fichier CSV dans votre environnement

Vérifier que le travail a réussi

Réviser le rapport sur les emplois

Lorsqu'il y a des erreurs

Remplacement de valeurs existantes par des attributs multivaleurs complexes (CMVA)

Consultation d'un rapport sur une tâche d'importation d'utilisateurs

Exemple de demande

Exemple de réponse

Affichage des rapports sur les tâches d'importation de groupes

Exemple de demande de tâche sommaire d'importation

Exemple de réponse à la tâche sommaire d'importation

Exemple de demande de tâche détaillée d'importation

Exemple de réponse détaillée à la tâche d'importation

Affichage des rapports sur les tâches d'importation d'appartenance AppRole

Exemple de demande de tâche sommaire d'importation

Exemple de réponse à la tâche sommaire d'importation

Exemple de demande de tâche détaillée d'importation

Exemple de réponse détaillée à la tâche d'importation