Создание externalItem

Статья
04/20/2023

Пространство имен: microsoft.graph.externalConnectors

Создайте новый объект externalItem .

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается
Приложение	ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All

HTTP-запрос

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

Заголовки запросов

Имя	Описание
Авторизация	Носитель {token}. Обязательно.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление объекта externalItem в формате JSON.

При создании externalItem можно указать следующие свойства.

Свойство	Тип	Описание
id	Строка	Идентификатор элемента. Обязательно.
properties	microsoft.graph.externalConnectors.properties	Свойства элемента. Объект `properties` должен содержать по крайней мере одно свойство. Все `DateTime` свойства типов должны иметь формат ISO 8601. Обязательно.
содержимое	microsoft.graph.externalConnectors.externalItemContent	Содержимое внешнего элемента. Необязательный параметр.
Acl	Коллекция microsoft.graph.externalConnectors.acl	Список управления доступом. Обязательно.

Свойства в externalItem должны использовать описатели типов в полезных данных в следующих сценариях:

Для String свойств типа , если значение содержит символы, отличные от ASCII.
```
"description@odata.type": "String",
"description": "Kandierte Äpfel"
```
Для всех типов коллекций.
```
"categories@odata.type": "Collection(String)"
"categories": [
  "red",
  "blue"
]
```
Важно!

При включении свойства типа Collection(DateTime)необходимо использовать описатель Collection(DateTimeOffset)типа .

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK.

Примеры

Пример. Создание пользовательского элемента

Запрос

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


// 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);

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.



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)

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.


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);

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.


<?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);

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.


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

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

Отклик

Ниже приведен пример отклика.

HTTP/1.1 200 OK

Создание externalItem

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Отклик

Примеры

Пример. Создание пользовательского элемента

Запрос

Отклик

Дополнительные ресурсы

Дополнительные ресурсы