Importando com a API REST

Esta seção fornece exemplos de solicitações e respostas quando você deseja importar usuários, grupos e AppRoles para seu ambiente usando a API REST dos domínios de identidades.

As seções a seguir orientam você pelas etapas:

Observação

Para tratar com segurança a importação do arquivo CSV para um domínio de identidades do serviço IAM, se algum valor de célula tiver escape para evitar a injeção de CSV, as aspas serão removidas. Por exemplo, durante a importação, se o valor da célula for '@test', o valor real será @test.

Em: @
Além disso: +
Menos: -
É igual a: =
Barra Vertical: |
Porcentagem: %

Importar o Arquivo CSV para o Armazenamento

Para importar o arquivo CSV para o armazenamento, envie uma solicitação POST para o ponto final /storage/v1/Files.

Observação

Consulte Importando e Exportando Usuários, Grupos e AppRoles para obter mais informações sobre o arquivo CSV.


Parâmetro	Descrição
`fileName`	Digite o nome que você deseja que o arquivo tenha ao salvá-lo no armazenamento.
`isPublic`	Indica se o arquivo é privado ou público. No momento, somente arquivos privados são suportados. Defina esse valor como `false.`
`contentType`	Os arquivos são limitados a `contentType` de `text/csv` ou `application/directory.`
`file`	Informe o nome do arquivo que você deseja carregar.

Exemplo de Solicitação

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

Exemplo de Resposta

Observação

Anote o valor fileName (negrito no exemplo de resposta).

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

Programar o Job para Importar o Arquivo CSV para o Seu Ambiente

Nota

Para acessar a lista completa de nomes de colunas CSV permitidos e suas descrições, use a seguinte solicitação:

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

Consulte Transferindo Dados para obter mais informações sobre o carregamento em massa usando a Console do domínio de identidades.

Para criar um job programado, envie uma solicitação POST ao ponto final /job/v1/JobSchedules. No exemplo de corpo de solicitação JSON abaixo, para importações de jobType específicas do recurso, o valor de jobType pode ser UserImport, GroupImport ou AppRoleImport, dependendo do tipo de dados que você está tentando importar.

Há também uma opção de importação genérica disponível em que o valor de jobType é Import e, em seguida, o atributo resourceType é adicionado e os valores podem ser User, Group ou Grant (para AppRole), dependendo do tipo de dados que você está tentando importar.

Observação

Não há suporte para o uso do resourceType de AppRole para importação.

Os exemplos abaixo mostram as opções de importação jobType específicas do recurso e as opções de importação genéricas.

Exemplo de Solicitação de Importação jobType Específica do Recurso

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

Um parâmetro adicional é necessário para o AppRoleImport jobType:

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

Exemplo de Resposta para Importação jobType Específica do Recurso

Observação

Anote o valor id (negrito no exemplo de resposta). Esse é o valor para jobScheduleid especificado na próxima seção.

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

Exemplo de Solicitação de Importação Genérica

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

Um parâmetro adicional é necessário para o Grant ResourceType:

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

Exemplo de Resposta para Importação Genérica

Observação

Anote o valor id (negrito no exemplo de resposta). Esse é o valor para jobScheduleid especificado na próxima seção.

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

Verifique se o Job foi Bem-sucedido

Para verificar se o job de importação foi bem-sucedido, envie uma solicitação GET para o ponto final /job/v1/JobHistories usando jobScheduleid como identificador.

Exemplo de Solicitação

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

Exemplo de Resposta

Observação

Anote o valor id (negrito no exemplo de resposta). Esse é o valor para historyId especificado na próxima seção.

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

Verificar o Relatório de Jobs

Para revisar o status do job de importação, envie uma solicitação GET para o ponto final /job/v1/JobReports usando historyId como identificador. Se houver alguma falha no processo de importação, ele listará essas falhas na forma de um arquivo CSV no armazenamento.

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

Quando há erros

Se você encontrar erros durante uma operação de carga em massa e não puder corrigi-los modificando as entradas no arquivo de importação, poderá definir um nível de diagnóstico para capturar logs operacionais durante a operação de carga em massa. Em seguida, você pode exibir esses logs para ajudá-lo a determinar a causa do problema. Consulte Executando o Relatório de Dados de Diagnóstico para obter mais informações.

Se você encontrar erros após uma operação de carregamento em massa, use a página Jobs para ajudá-lo a resolver os erros.

Acesse a página Jobs clicando em Jobs na console do Identity Cloud Service.
Clique em Exibir Detalhes do job com falha.
Clique em Erros de Exportação e faça download do arquivo de erro exportado.
Abra o arquivo de erro de valor separado por vírgula usando qualquer gerenciador de arquivos .csv, como o Microsoft Excel. O arquivo exportado contém todas as linhas com falha e o motivo da falha na coluna Mensagem de Erro.
Corrija os erros e remova as colunas Tipo e Mensagem de Erro do arquivo.
Reimportar o arquivo.

Consulte Exibindo Jobs e Detalhes do Job para obter mais informações.

Substituindo Valores Existentes por Atributos Complexos de Vários Valores (CMVA)

Quando os administradores atualizam os usuários usando a Importação, por padrão novos valores serão adicionados aos atributos de vários valores existentes.

Por exemplo, digamos que um usuário tenha definido seu e-mail comercial como alice@myservice.invalid. E-mail é um atributo de vários valores e, quando um administrador importa um arquivo CSV com o valor de e-mail atualizado (por exemplo, administrator@myservice.invalid), o novo e-mail é adicionado à instância de e-mail existente e os dois valores são salvos.

Você também pode atualizar os valores de e-mail. Por exemplo, para atualizar o valor do e-mail para alice1@myservice.invalid, informe o atributo replaceExistingMultiValuedValues ao programar um job de Importação.

Exemplo de payload 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"
    }
  ]
}

Exibindo um Relatório de Job de Importação de Usuário

Esta seção fornece exemplos de solicitações e respostas quando você deseja exibir um relatório de job de importação do usuário ao importar usuários para seu ambiente usando a API REST dos domínios de identidades.

Exemplo de Solicitação

Para revisar o job de importação do usuário, envie uma solicitação GET para o ponto final /job/v1/UserImportJobReports usando historyId como identificador.

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

Exemplo de Resposta

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

Exibindo Relatórios de Jobs de Importação de Grupo

Esta seção fornece exemplos de solicitações e respostas quando você deseja exibir um relatório de job de resumo de importação de grupo e um relatório de job detalhado de importação de grupo quando você importa grupos para seu ambiente usando a API REST de domínios de identidade.

Exemplo de solicitação de tarefa de resumo de importação

Para revisar o job de resumo de importação do grupo, envie uma solicitação GET para o ponto final /job/v1/GroupImportSummaryJobReports usando historyId como identificador.

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

Exemplo de Resposta do Job de Resumo de Importação

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

Exemplo de Solicitação de Tarefa Detalhada de Importação

Para revisar o job detalhado de importação do grupo, envie uma solicitação GET para o ponto final /job/v1/GroupImportDetailedJobReports usando historyId como identificador.

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

Exemplo de Resposta Detalhada do Job de Importação

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

Exibindo Relatórios de Jobs de Importação de Associação do AppRole

Esta seção fornece exemplos de solicitações e respostas quando você deseja exibir um relatório de job de resumo de importação de associação AppRole e um relatório de job detalhado de importação de associação AppRole quando você importa associações AppRole para seu ambiente usando a API REST de domínios de identidade.

Exemplo de solicitação de tarefa de resumo de importação

Para revisar o job de resumo de importação de associação ao AppRole, envie uma solicitação GET para o ponto final /job/v1/AppRoleMembershipImportSummaryJobReports usando historyId como identificador.

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

Exemplo de Resposta do Job de Resumo de Importação

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

Exemplo de Solicitação de Tarefa Detalhada de Importação

Para revisar o job detalhado de importação de associação ao AppRole, envie uma solicitação GET para o ponto final /job/v1/AppRoleMembershipImportDetailedJobReports usando historyId como identificador.

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

Exemplo de Resposta Detalhada do Job de Importação

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

Documentação do Oracle Cloud Infrastructure

Importando com a API REST

Importar o Arquivo CSV para o Armazenamento

Programar o Job para Importar o Arquivo CSV para o Seu Ambiente

Verifique se o Job foi Bem-sucedido

Verificar o Relatório de Jobs

Quando há erros

Substituindo Valores Existentes por Atributos Complexos de Vários Valores (CMVA)

Exibindo um Relatório de Job de Importação de Usuário

Exemplo de Solicitação

Exemplo de Resposta

Exibindo Relatórios de Jobs de Importação de Grupo

Exemplo de solicitação de tarefa de resumo de importação

Exemplo de Resposta do Job de Resumo de Importação

Exemplo de Solicitação de Tarefa Detalhada de Importação

Exemplo de Resposta Detalhada do Job de Importação

Exibindo Relatórios de Jobs de Importação de Associação do AppRole

Exemplo de solicitação de tarefa de resumo de importação

Exemplo de Resposta do Job de Resumo de Importação

Exemplo de Solicitação de Tarefa Detalhada de Importação

Exemplo de Resposta Detalhada do Job de Importação