Crear externalItem

Espacio de nombres: microsoft.graph.externalConnectors

Cree un nuevo objeto externalItem.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) No aplicable
Delegado (cuenta personal de Microsoft) No aplicable
Aplicación ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All

Solicitud HTTP

POST /connections/{connectionsId}/items

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto externalItem.

Puede especificar las siguientes propiedades al crear un externalItem.

Propiedad Tipo Descripción
id Cadena El identificador del elemento. Necesario.
properties microsoft.graph.externalConnectors.properties Las propiedades del elemento. El properties objeto debe contener al menos una propiedad. Todas DateTime las propiedades de tipo deben tener el formato ISO 8601. Necesario.
contenido microsoft.graph.externalConnectors.externalItemContent El contenido del elemento externo. Opcional.
acl colección microsoft.graph.externalConnectors.acl La lista de control de acceso. Necesario.

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

  • 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 de tipo Collection(DateTimeOffset) .

Respuesta

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

Ejemplos

Ejemplo: Crear un elemento personalizado

Solicitud

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

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

Respuesta

Este es un ejemplo de la respuesta.

HTTP/1.1 200 OK