tipo de recurso bulkUpload

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa la funcionalidad del servicio de sincronización Microsoft Entra para procesar cargas masivas. Para obtener más información, consulte Conceptos de aprovisionamiento de entrada controlados por API.

Métodos

Método	Tipo devuelto	Descripción
Realizar la carga masiva	Ninguno	Realice una nueva carga masiva mediante el trabajo de sincronización.

Propiedades

El tipo de recurso bulkUpload acepta las siguientes propiedades en la carga:

• Parámetro de esquemas en el nivel raíz que debe establecerse en urn:ietf:params:scim:api:messages:2.0:BulkRequest. Obligatorio. El siguiente bloque JSON muestra una representación del parámetro schemas .

  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
  ]
  

• El parámetro Operations contiene una matriz de pares clave-valor. Cada solicitud puede contener un máximo de 50 operaciones de usuario en este parámetro. Los siguientes pares clave-valor son necesarios en cada objeto de la matriz.

  • clave de método debe establecerse en POST

  Nota:

  Cuando la clave del método se establece POSTen , el servicio de aprovisionamiento determinará la operación correcta que se debe realizar en el destino (create/update/enable/disable) en función de la configuración de asignación de atributos. Por ejemplo, si ha establecido {externalId,employeeId} como el par de identificadores coincidentes, el servicio de aprovisionamiento comprobará si existe un usuario con el employeeId en Microsoft Entra ID. Si no existe, el servicio de aprovisionamiento creará el usuario. Si existe, el servicio de aprovisionamiento actualizará el registro de usuario.

  • la clave de ruta de acceso siempre se establece en el valor /Users
  • bulkId clave establecida en un valor de identificador único. Por ejemplo, si los datos proceden de un origen de RR. HH., puede establecer este valor employeeId en el que se garantiza que sea único en el sistema de RR. HH.
  • objeto data . Obligatorio. El objeto de datos debe tener los siguientes objetos:
  • La schemas matriz del data objeto debe tener los esquemas y urn:ietf:params:scim:schemas:core:2.0:Userurn:ietf:params:scim:schemas:extension:enterprise:2.0:User representar el URI del esquema SCIM para el recurso de usuario principal y la extensión de usuario empresarial, respectivamente. Puede incluir nombres de esquema SCIM personalizados adicionales en caso de extensiones de atributo.
  • clave externalId establecida en un identificador único en el sistema de origen. Por ejemplo, employeeId o personId .studentId

  En el ejemplo JSON siguiente se muestra un ejemplo de un objeto Operations .

  {
      "method": "POST",
      "bulkId": "d63f4f30-a198-43db-a34d-f72bfa1f551e",
      "path": "/Users",
      "data": {
        "schemas": [
          "urn:ietf:params:scim:schemas:core:2.0:User",
          "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
        ],
        "externalId": "EMP1830"
    ... [You may include other SCIM attributes and extensions under the data object.]
      }
    }    
  
  

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.bulkUpload"
}