Update termsAndConditions

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

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновление свойств объекта termsAndConditions.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/termsAndConditions/{termsAndConditionsId}
PATCH /deviceManagement/termsAndConditions/{termsAndConditionsId}/acceptanceStatuses/{termsAndConditionsAcceptanceStatusId}/termsAndConditions

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

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

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

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

В таблице ниже приведены свойства, которые необходимо указывать при создании объекта termsAndConditions.

Свойство	Тип	Описание
id	String	Уникальный идентификатор политики использования.
createdDateTime	DateTimeOffset	Дата и время создания объекта.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего изменения объекта.
displayName	String	Имя политики использования, указанное администратором.
description	String	Описание политики использования, указанное администратором.
title	String	Название условий, указанное администратором. Показывается пользователю при запросе на принятие политики использования.
bodyText	String	Основной текст условий, заданный администратором (как правило, сами условия). Показывается пользователю при запросе на принятие политики использования.
acceptanceStatement	String	Указанное администратором объяснение условий. Как правило, пользователю объясняется, с чем связано принятие условий, изложенных в соответствующей политике. Показывается пользователю при запросе на принятие политики использования.
version	Int32	Целое число, указывающее текущую версию условий. Увеличивается, когда администратор вносит изменения в условия и хочет, чтобы пользователи повторно приняли измененную политику.

Ответ

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

Пример

Запрос

Ниже приведен пример запроса.

HTTP

PATCH https://graph.microsoft.com/v1.0/deviceManagement/termsAndConditions/{termsAndConditionsId}
Content-type: application/json
Content-length: 273

{
  "@odata.type": "#microsoft.graph.termsAndConditions",
  "displayName": "Display Name value",
  "description": "Description value",
  "title": "Title value",
  "bodyText": "Body Text value",
  "acceptanceStatement": "Acceptance Statement value",
  "version": 7
}

C#

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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new TermsAndConditions
{
	OdataType = "#microsoft.graph.termsAndConditions",
	DisplayName = "Display Name value",
	Description = "Description value",
	Title = "Title value",
	BodyText = "Body Text value",
	AcceptanceStatement = "Acceptance Statement value",
	Version = 7,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.TermsAndConditions["{termsAndConditions-id}"].PatchAsync(requestBody);

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

CLI

mgc device-management terms-and-conditions patch --terms-and-conditions-id {termsAndConditions-id} --body '{\
  "@odata.type": "#microsoft.graph.termsAndConditions",\
  "displayName": "Display Name value",\
  "description": "Description value",\
  "title": "Title value",\
  "bodyText": "Body Text value",\
  "acceptanceStatement": "Acceptance Statement value",\
  "version": 7\
}\
'

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

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

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

requestBody := graphmodels.NewTermsAndConditions()
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
description := "Description value"
requestBody.SetDescription(&description) 
title := "Title value"
requestBody.SetTitle(&title) 
bodyText := "Body Text value"
requestBody.SetBodyText(&bodyText) 
acceptanceStatement := "Acceptance Statement value"
requestBody.SetAcceptanceStatement(&acceptanceStatement) 
version := int32(7)
requestBody.SetVersion(&version) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
termsAndConditions, err := graphClient.DeviceManagement().TermsAndConditions().ByTermsAndConditionsId("termsAndConditions-id").Patch(context.Background(), requestBody, nil)

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

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

TermsAndConditions termsAndConditions = new TermsAndConditions();
termsAndConditions.setOdataType("#microsoft.graph.termsAndConditions");
termsAndConditions.setDisplayName("Display Name value");
termsAndConditions.setDescription("Description value");
termsAndConditions.setTitle("Title value");
termsAndConditions.setBodyText("Body Text value");
termsAndConditions.setAcceptanceStatement("Acceptance Statement value");
termsAndConditions.setVersion(7);
TermsAndConditions result = graphClient.deviceManagement().termsAndConditions().byTermsAndConditionsId("{termsAndConditions-id}").patch(termsAndConditions);

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

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const termsAndConditions = {
  '@odata.type': '#microsoft.graph.termsAndConditions',
  displayName: 'Display Name value',
  description: 'Description value',
  title: 'Title value',
  bodyText: 'Body Text value',
  acceptanceStatement: 'Acceptance Statement value',
  version: 7
};

await client.api('/deviceManagement/termsAndConditions/{termsAndConditionsId}')
	.update(termsAndConditions);

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

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\TermsAndConditions;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new TermsAndConditions();
$requestBody->setOdataType('#microsoft.graph.termsAndConditions');
$requestBody->setDisplayName('Display Name value');
$requestBody->setDescription('Description value');
$requestBody->setTitle('Title value');
$requestBody->setBodyText('Body Text value');
$requestBody->setAcceptanceStatement('Acceptance Statement value');
$requestBody->setVersion(7);

$result = $graphServiceClient->deviceManagement()->termsAndConditions()->byTermsAndConditionsId('termsAndConditions-id')->patch($requestBody)->wait();

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

PowerShell

Import-Module Microsoft.Graph.DeviceManagement.Administration

$params = @{
	"@odata.type" = "#microsoft.graph.termsAndConditions"
	displayName = "Display Name value"
	description = "Description value"
	title = "Title value"
	bodyText = "Body Text value"
	acceptanceStatement = "Acceptance Statement value"
	version = 7
}

Update-MgDeviceManagementTermAndCondition -TermsAndConditionsId $termsAndConditionsId -BodyParameter $params

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

Python

from msgraph import GraphServiceClient
from msgraph.generated.models.terms_and_conditions import TermsAndConditions

graph_client = GraphServiceClient(credentials, scopes)

request_body = TermsAndConditions(
	odata_type = "#microsoft.graph.termsAndConditions",
	display_name = "Display Name value",
	description = "Description value",
	title = "Title value",
	body_text = "Body Text value",
	acceptance_statement = "Acceptance Statement value",
	version = 7,
)

result = await graph_client.device_management.terms_and_conditions.by_terms_and_conditions_id('termsAndConditions-id').patch(request_body)

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

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 445

{
  "@odata.type": "#microsoft.graph.termsAndConditions",
  "id": "eefc80cf-80cf-eefc-cf80-fceecf80fcee",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "description": "Description value",
  "title": "Title value",
  "bodyText": "Body Text value",
  "acceptanceStatement": "Acceptance Statement value",
  "version": 7
}