Compartir a través de


Creación de externalItem

Espacio de nombres: microsoft.graph.externalConnectors

Cree un nuevo objeto externalItem .

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}

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 del objeto externalItem .

Puede especificar las siguientes propiedades al crear un externalItem.

Propiedad Tipo Descripción
id Cadena Identificador del elemento. Obligatorio.
properties microsoft.graph.externalConnectors.properties Propiedades del elemento. El properties objeto debe contener al menos una propiedad. Todas las DateTime propiedades de tipo deben estar en formato ISO 8601. Obligatorio.
contenido microsoft.graph.externalConnectors.externalItemContent Contenido del elemento externo. Opcional.
Acl Colección microsoft.graph.externalConnectors.acl Lista de control de acceso. Obligatorio.

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

PUT https://graph.microsoft.com/v1.0/external/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

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK