externalItem を更新する
-
[アーティクル]
-
-
名前空間: microsoft.graph.externalConnectors
externalItem オブジェクトのプロパティを更新します。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 |
アクセス許可 (特権の小さいものから大きいものへ) |
| 委任 (職場または学校のアカウント) |
ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません |
| アプリケーション |
ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All |
HTTP 要求
PATCH /external/connections/{connection-id}/items/{item-id}
パス パラメーター
| 名前 |
説明 |
| Authorization |
ベアラー {token}。必須。 |
| Content-Type |
application/json. Required. |
要求本文
要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれていない既存のプロパティ (オブジェクト内の properties プロパティを除く) は、以前の値を保持するか、他のプロパティ値の変更に基づいて再計算されます。 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。 次のプロパティを更新できます。
acl コレクションの更新
プロパティが acl 更新要求に含まれている場合、既存の ACL コレクションは、要求に含まれるコレクションで上書きされます。
properties オブジェクトの更新
プロパティが properties 更新要求に含まれている場合、既存のプロパティ バッグは要求に含まれる値で上書きされます。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された externalItem オブジェクトを返します。
例
要求
PATCH https://graph.microsoft.com/v1.0/external/connections/contosohr/items/TSP228082938
Content-Type: application/json
{
"acl": [
{
"type": "everyone",
"value": "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
"accessType": "grant"
}
]
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var externalItem = new Microsoft.Graph.ExternalConnectors.ExternalItem
{
Acl = new List<Microsoft.Graph.ExternalConnectors.Acl>()
{
new Microsoft.Graph.ExternalConnectors.Acl
{
Type = Microsoft.Graph.ExternalConnectors.AclType.Everyone,
Value = "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
AccessType = Microsoft.Graph.ExternalConnectors.AccessType.Grant
}
}
};
await graphClient.External.Connections["{externalConnectors.externalConnection-id}"].Items["{externalConnectors.externalItem-id}"]
.Request()
.UpdateAsync(externalItem);
SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
const externalItem = {
acl: [
{
type: 'everyone',
value: '67a141d8-cf4e-4528-ba07-bed21bfacd2d',
accessType: 'grant'
}
]
};
await client.api('/external/connections/contosohr/items/TSP228082938')
.update(externalItem);
SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/external/connections/contosohr/items/TSP228082938"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
MSGraphExternalConnectorsExternalItem *externalItem = [[MSGraphExternalConnectorsExternalItem alloc] init];
NSMutableArray *aclList = [[NSMutableArray alloc] init];
MSGraphExternalConnectorsAcl *acl = [[MSGraphExternalConnectorsAcl alloc] init];
[acl setType: [MSGraphExternalConnectorsAclType everyone]];
[acl setValue:@"67a141d8-cf4e-4528-ba07-bed21bfacd2d"];
[acl setAccessType: [MSGraphExternalConnectorsAccessType grant]];
[aclList addObject: acl];
[externalItem setAcl:aclList];
NSError *error;
NSData *externalItemData = [externalItem getSerializedDataWithError:&error];
[urlRequest setHTTPBody:externalItemData];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
ExternalItem externalItem = new ExternalItem();
LinkedList<Acl> aclList = new LinkedList<Acl>();
Acl acl = new Acl();
acl.type = AclType.EVERYONE;
acl.value = "67a141d8-cf4e-4528-ba07-bed21bfacd2d";
acl.accessType = AccessType.GRANT;
aclList.add(acl);
externalItem.acl = aclList;
graphClient.external().connections("contosohr").items("TSP228082938")
.buildRequest()
.patch(externalItem);
SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewExternalItem()
requestBody.SetAcl( []Acl {
msgraphsdk.NewAcl(),
type := "everyone"
SetType(&type)
value := "67a141d8-cf4e-4528-ba07-bed21bfacd2d"
SetValue(&value)
accessType := "grant"
SetAccessType(&accessType)
}
externalConnectionId := "externalConnection-id"
externalItemId := "externalItem-id"
graphClient.External().ConnectionsById(&externalConnectionId).ItemsById(&externalItemId).Patch(requestBody)
SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
Import-Module Microsoft.Graph.Search
$params = @{
Acl = @(
@{
Type = "everyone"
Value = "67a141d8-cf4e-4528-ba07-bed21bfacd2d"
AccessType = "grant"
}
)
}
Update-MgExternalConnectionItem -ExternalConnectionId $externalConnectionId -ExternalItemId $externalItemId -BodyParameter $params
SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
応答
応答の例を次に示します。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "TSP228082938",
"acl": [
{
"type": "everyone",
"value": "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
"accessType": "grant"
}
],
"properties": {
"title": "Error in the payment gateway",
"priority": 1,
"assignee": "john@contoso.com"
},
"content": {
"@odata.type": "microsoft.graph.externalConnectors.externalItemContent",
"value": "<h1>Error in payment gateway</h1><p>Error details...</p>",
"type": "html"
}
}