Import à 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 :

Remarque

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

A l'adresse : @
Plus : +
Moins : -
Est égal à : =
Barre verticale : |
Pourcentage : %

Import du fichier CSV vers le stockage

Pour importer le fichier CSV dans le stockage, envoyez une demande POST à l'adresse /storage/v1/Files.

Remarque

Pour plus d'informations sur le fichier CSV, reportez-vous à Import et export d'utilisateurs, de groupes et de AppRoles.


Paramètre	Description
`fileName`	Saisissez le nom que vous souhaitez que le fichier porte 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. Définissez cette valeur sur `false.`.
`contentType`	Les fichiers sont limités à une valeur `contentType` de `text/csv` ou `application/directory.`
`file`	Entrez le nom du fichier à télé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

Remarque

Notez la valeur fileName (en 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"
}

Programmation du travail d'import du fichier CSV dans votre environnement

Remarque

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

Pour plus d'informations sur le chargement en masse à l'aide de la console de domaine d'identité, reportez-vous à Transfert de données.

Pour créer un travail programmé, envoyez une demande POST à l'adresse /job/v1/JobSchedules. Dans l'exemple de corps de demande JSON ci-dessous, pour les imports jobType propres à la ressource, la valeur de jobType peut être UserImport, GroupImport ou AppRoleImport, en fonction du type de données que vous essayez d'importer.

Une option d'import générique est également 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), en fonction du type de données que vous essayez d'importer.

Remarque

L'utilisation de la valeur resourceType de AppRole pour l'import n'est pas prise en charge.

Les exemples ci-dessous présentent à la fois l'import jobType spécifique à la ressource et les options d'import générique.

Exemple de demande d'import jobType spécifique à une 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'import jobType spécifique à la ressource

Remarque

Notez la valeur id (en gras dans l'exemple de réponse). Il s'agit de la valeur de jobScheduleid que vous indiquez 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

Remarque

Notez la valeur id (en gras dans l'exemple de réponse). Il s'agit de la valeur de jobScheduleid que vous indiquez 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érification de la réussite du travail

Pour vérifier que le travail d'import a réussi, envoyez une demande GET à l'adresse /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

Remarque

Notez la valeur id (en gras dans l'exemple de réponse). Il s'agit de la valeur de historyId que vous indiquez 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
}

Vérifier l'état des travaux

Pour vérifier le statut du travail d'import, envoyez une demande GET à l'adresse /job/v1/JobReports en utilisant historyId comme identificateur. En cas d'échec du processus d'importation, il répertorie ces échecs sous la forme d'un fichier CSV dans le stockage.

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

En cas d'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 capturer les journaux opérationnels lors de l'opération de chargement en masse. Vous pouvez ensuite afficher ces journaux pour vous aider à déterminer la cause du problème. Pour plus d'informations, reportez-vous à Exécution du rapport sur les données de diagnostic.

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

Accédez à la page Travaux en cliquant sur Travaux dans la console Identity Cloud Service.
Cliquez sur Visualiser les détails du travail en échec.
Cliquez sur 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 n'importe quel gestionnaire de fichiers .csv, tel que Microsoft Excel. Le fichier exporté contient toutes les lignes en échec et le motif de l'échec dans la colonne Message d'erreur.
Corrigez les erreurs, puis enlevez les colonnes Type et Message d'erreur du fichier.
Réimportez le fichier.

Pour plus d'informations, reportez-vous à Affichage des travaux et des détails des travaux.

Remplacer des valeurs existantes par des attributs multivaleurs complexes (CMVA)

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

Par exemple, supposons qu'un utilisateur ait défini son adresse électronique professionnelle sur alice@myservice.invalid. Le courriel est un attribut à valeurs multiples. 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 d'e-mail. Par exemple, pour mettre à jour la valeur de courriel sur alice1@myservice.invalid, transmettez l'attribut replaceExistingMultiValuedValues lors de la programmation d'un travail d'import.

Exemple de charge utile 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"
    }
  ]
}

Affichage d'un rapport sur les travaux d'import d'utilisateurs

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez afficher un rapport de travail d'import d'utilisateur lorsque vous importez des utilisateurs dans votre environnement à l'aide de l'API REST des domaines d'identité.

Exemple de demande

Pour vérifier le travail d'import utilisateur, envoyez une demande GET à l'adresse /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 travaux d'import de groupes

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez afficher un rapport de travail récapitulatif d'import de groupe et un rapport de travail détaillé d'import de groupe lorsque vous importez des groupes dans votre environnement à l'aide de l'API REST des domaines d'identité.

Exemple de demande de travail de récapitulatif d'import

Pour vérifier le travail récapitulatif d'import de groupe, envoyez une demande GET à l'adresse /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 au travail de récapitulatif d'import

{
    "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 travail détaillée d'importation

Pour vérifier le travail détaillé d'import de groupe, envoyez une demande GET à l'adresse /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 de travail détaillé d'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
}

Affichage des états des travaux d'import d'appartenance AppRole

Cette section fournit des exemples de demandes et de réponses lorsque vous voulez visualiser un rapport de travail récapitulatif d'import d'appartenance AppRole et un rapport de travail détaillé d'import 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 travail de récapitulatif d'import

Pour vérifier le travail récapitulatif d'import d'appartenance AppRole, envoyez une demande GET à l'adresse /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 au travail de récapitulatif d'import

{
  "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 travail détaillée d'importation

Pour vérifier le travail détaillé d'import d'appartenance AppRole, envoyez une demande GET à l'adresse /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 de travail détaillé d'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
}

Documentation Oracle Cloud Infrastructure

Import à l'aide de l'API REST

Import du fichier CSV vers le stockage

Programmation du travail d'import du fichier CSV dans votre environnement

Vérification de la réussite du travail

Vérifier l'état des travaux

En cas d'erreurs

Remplacer des valeurs existantes par des attributs multivaleurs complexes (CMVA)

Affichage d'un rapport sur les travaux d'import d'utilisateurs

Exemple de demande

Exemple de réponse

Affichage des rapports sur les travaux d'import de groupes

Exemple de demande de travail de récapitulatif d'import

Exemple de réponse au travail de récapitulatif d'import

Exemple de demande de travail détaillée d'importation

Exemple de réponse de travail détaillé d'import

Affichage des états des travaux d'import d'appartenance AppRole

Exemple de demande de travail de récapitulatif d'import

Exemple de réponse au travail de récapitulatif d'import

Exemple de demande de travail détaillée d'importation

Exemple de réponse de travail détaillé d'import