Creación de externalItem

  • Artículo

Espacio de nombres: microsoft.graph.externalConnectors

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.

Cree un nuevo externalItem.

Esta API se puede usar para crear un elemento personalizado. El objeto que contiene externalConnection debe tener un esquema registrado del tipo correspondiente.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) ExternalItem.ReadWrite.OwnedBy ExternalItem.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación ExternalItem.ReadWrite.OwnedBy ExternalItem.ReadWrite.All

Solicitud HTTP

PUT /external/connections/{connection-id}/items/{item-id}

Parámetros de ruta de acceso

Parameter Tipo Descripción
connection-id string Propiedad id de la clase que contiene externalConnection
item-id string Propiedad proporcionada por id el desarrollador de externalItem. Si ya no existe ningún elemento con este id, se crea un nuevo elemento. Si ya existe un elemento con este id, el objeto enviado en el cuerpo lo sobrescribe.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de un objeto externalItem . La carga está limitada a 4 MB.

Creación de un objeto externalItem

Al crear un externalItem, se requieren los siguientes campos: acl, y properties. El properties objeto debe contener al menos una propiedad.

Todas las DateTime propiedades de tipo deben estar en formato ISO 8601.

Las propiedades de un externalItem elemento deben usar especificadores de tipo en la carga en los escenarios siguientes:

  • Para String las propiedades de tipo, si el valor contiene caracteres que no son ASCII.

    "description@odata.type": "String",
"description": "Kandierte Äpfel"

  • Para todos los tipos de colección.

    "categories@odata.type": "Collection(String)"
"categories": [
  "red",
  "blue"
]

    Importante

    Al incluir una propiedad de tipo Collection(DateTime), debe usar el especificador Collection(DateTimeOffset)de tipo .

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 200 OK.

Ejemplos

Ejemplo: Creación de un elemento personalizado

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PUT https://graph.microsoft.com/beta/external/connections/contosohr/items/TSP228082938
Content-type: application/json

{
  "acl": [
    {
      "type": "user",
      "value": "e811976d-83df-4cbd-8b9b-5215b18aa874",
      "accessType": "grant",
      "identitySource": "azureActiveDirectory"
    },
    {
      "type": "group",
      "value": "14m1b9c38qe647f6a",
      "accessType": "deny",
      "identitySource": "external"
    }
  ],
  "properties": {
    "title": "Error in the payment gateway",
    "priority": 1,
    "assignee": "john@contoso.com"
  },
  "content": {
    "value": "Error in payment gateway...",
    "type": "text"
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK