Creación de externalItem

Espacio de nombres: microsoft.graph.externalConnectors

Cree un nuevo objeto externalItem .

Permisos

Se requiere uno de los permisos siguientes 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)	ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitido
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	Portador {token}. Obligatorio.
Content-Type	application/json. Obligatorio.

Cuerpo de 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 objeto deben usar especificadores de tipo en la carga útil 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

HTTP

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

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var requestBody = new Microsoft.Graph.Models.ExternalConnectors.ExternalItem
{
	Acl = new List<Microsoft.Graph.Models.ExternalConnectors.Acl>
	{
		new Microsoft.Graph.Models.ExternalConnectors.Acl
		{
			Type = Microsoft.Graph.Models.ExternalConnectors.AclType.User,
			Value = "e811976d-83df-4cbd-8b9b-5215b18aa874",
			AccessType = Microsoft.Graph.Models.ExternalConnectors.AccessType.Grant,
		},
		new Microsoft.Graph.Models.ExternalConnectors.Acl
		{
			Type = Microsoft.Graph.Models.ExternalConnectors.AclType.ExternalGroup,
			Value = "14m1b9c38qe647f6a",
			AccessType = Microsoft.Graph.Models.ExternalConnectors.AccessType.Deny,
		},
	},
	Properties = new Microsoft.Graph.Models.ExternalConnectors.Properties
	{
		AdditionalData = new Dictionary<string, object>
		{
			{
				"title" , "Error in the payment gateway"
			},
			{
				"priority" , 1
			},
			{
				"assignee" , "john@contoso.com"
			},
		},
	},
	Content = new Microsoft.Graph.Models.ExternalConnectors.ExternalItemContent
	{
		Value = "Error in payment gateway...",
		Type = Microsoft.Graph.Models.ExternalConnectors.ExternalItemContentType.Text,
	},
};
var result = await graphClient.External.Connections["{externalConnection-id}"].Items["{externalItem-id}"].PutAsync(requestBody);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK.

Ir

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models//externalConnectors"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewExternalItem()


acl := graphmodels.NewAcl()
type := graphmodels.USER_ACLTYPE 
acl.SetType(&type) 
value := "e811976d-83df-4cbd-8b9b-5215b18aa874"
acl.SetValue(&value) 
accessType := graphmodels.GRANT_ACCESSTYPE 
acl.SetAccessType(&accessType) 
acl1 := graphmodels.NewAcl()
type := graphmodels.EXTERNALGROUP_ACLTYPE 
acl1.SetType(&type) 
value := "14m1b9c38qe647f6a"
acl1.SetValue(&value) 
accessType := graphmodels.DENY_ACCESSTYPE 
acl1.SetAccessType(&accessType) 

acl := []graphmodels.Aclable {
	acl,
	acl1,

}
requestBody.SetAcl(acl)
properties := graphmodels.NewProperties()
additionalData := map[string]interface{}{
	"title" : "Error in the payment gateway", 
	"priority" : int32(1) , 
	"assignee" : "john@contoso.com", 
}
properties.SetAdditionalData(additionalData)
requestBody.SetProperties(properties)
content := graphmodels.NewExternalItemContent()
value := "Error in payment gateway..."
content.SetValue(&value) 
type := graphmodels.TEXT_EXTERNALITEMCONTENTTYPE 
content.SetType(&type) 
requestBody.SetContent(content)

result, err := graphClient.External().Connections().ByConnectionId("externalConnection-id").Items().ByItemId("externalItem-id").Put(context.Background(), requestBody, nil)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const externalItem = {
  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'
  }
};

await client.api('/external/connections/contosohr/items/TSP228082938')
	.put(externalItem);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);

$requestBody = new ExternalItem();
$aclAcl1 = new Acl();
$aclAcl1->setType(new AclType('user'));

$aclAcl1->setValue('e811976d-83df-4cbd-8b9b-5215b18aa874');

$aclAcl1->setAccessType(new AccessType('grant'));


$aclArray []= $aclAcl1;
$aclAcl2 = new Acl();
$aclAcl2->setType(new AclType('externalgroup'));

$aclAcl2->setValue('14m1b9c38qe647f6a');

$aclAcl2->setAccessType(new AccessType('deny'));


$aclArray []= $aclAcl2;
$requestBody->setAcl($aclArray);


$properties = new Properties();
$additionalData = [
	'title' => 'Error in the payment gateway', 
	'priority' => 1,
	'assignee' => 'john@contoso.com', 
];
$properties->setAdditionalData($additionalData);



$requestBody->setProperties($properties);
$content = new ExternalItemContent();
$content->setValue('Error in payment gateway...');

$content->setType(new ExternalItemContentType('text'));


$requestBody->setContent($content);


$result = $graphServiceClient->external()->connections()->byConnectionId('externalConnection-id')->items()->byItemId('externalItem-id')->put($requestBody);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK.

PowerShell

Import-Module Microsoft.Graph.Search

$params = @{
	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 = 
		assignee = "john@contoso.com"
	}
	content = @{
		value = "Error in payment gateway..."
		type = "text"
	}
}

Set-MgExternalConnectionItem -ExternalConnectionId $externalConnectionId -ExternalItemId $externalItemId -BodyParameter $params

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK.

Respuesta

Este es un ejemplo de la respuesta.

HTTP/1.1 200 OK