browserSiteList: publish

[アーティクル]
10/30/2023

名前空間: microsoft.graph

デバイスがダウンロードできるように、指定した browserSiteList を発行します。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	❌	❌	❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、アクセス許可のリファレンスを参照してください。

アクセス許可の種類	最小特権アクセス許可	特権の高いアクセス許可
委任 (職場または学校のアカウント)	BrowserSiteLists.ReadWrite.All	注意事項なし。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	BrowserSiteLists.ReadWrite.All	注意事項なし。

HTTP 要求

POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/publish

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。認証と承認の詳細については、こちらをご覧ください。
Content-Type	application/json. 必須です。

要求本文

要求本文で、サイトと共有 Cookie の両方を省略して、サイトリスト全体を公開します。必要に応じて、ID のコレクションを指定することで、特定のサイトと共有 Cookie を発行できます。

プロパティ	型	説明
リビジョン	String	発行するサイトリストのリビジョン。必須です。
sharedCookies	browserSharedCookie コレクション	発行する共有 Cookie のコレクション。オプション。共有 Cookie ID のみが必要です。その他のフィールドはすべて無視されます。
sites	browserSite コレクション	発行するサイトのコレクション。省略可能です。サイト ID のみが必要です。その他のフィールドはすべて無視されます。

応答

成功した場合、このアクションは 200 OK 応答コードと、応答本文に browserSiteList を返します。

例

例 1: すべてのサイトと共有 Cookie を発行する

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish
Content-Type: application/json

{
    "revision": "1.0"
}


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

// Dependencies
using Microsoft.Graph.Admin.Edge.InternetExplorerMode.SiteLists.Item.Publish;

var requestBody = new PublishPostRequestBody
{
	Revision = "1.0",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.Edge.InternetExplorerMode.SiteLists["{browserSiteList-id}"].Publish.PostAsync(requestBody);



mgc admin edge internet-explorer-mode site-lists publish post --browser-site-list-id {browserSiteList-id} --body '{\
    "revision": "1.0"\
}\
'



// 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"
	  graphadmin "github.com/microsoftgraph/msgraph-sdk-go/admin"
	  //other-imports
)

requestBody := graphadmin.NewPublishPostRequestBody()
revision := "1.0"
requestBody.SetRevision(&revision) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
publish, err := graphClient.Admin().Edge().InternetExplorerMode().SiteLists().ByBrowserSiteListId("browserSiteList-id").Publish().Post(context.Background(), requestBody, nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.admin.edge.internetexplorermode.sitelists.item.publish.PublishPostRequestBody publishPostRequestBody = new com.microsoft.graph.admin.edge.internetexplorermode.sitelists.item.publish.PublishPostRequestBody();
publishPostRequestBody.setRevision("1.0");
var result = graphClient.admin().edge().internetExplorerMode().siteLists().byBrowserSiteListId("{browserSiteList-id}").publish().post(publishPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const browserSiteList = {
    revision: '1.0'
};

await client.api('/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish')
	.post(browserSiteList);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Admin\Edge\InternetExplorerMode\SiteLists\Item\Publish\PublishPostRequestBody;


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

$requestBody = new PublishPostRequestBody();
$requestBody->setRevision('1.0');

$result = $graphServiceClient->admin()->edge()->internetExplorerMode()->siteLists()->byBrowserSiteListId('browserSiteList-id')->publish()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.admin.edge.internetexplorermode.sitelists.item.publish.publish_post_request_body import PublishPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = PublishPostRequestBody(
	revision = "1.0",
)

result = await graph_client.admin.edge.internet_explorer_mode.site_lists.by_browser_site_list_id('browserSiteList-id').publish.post(request_body)

応答

次の例は応答を示しています。

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

{
    "@odata.type": "#microsoft.graph.browserSiteList",
    "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69",
    "revision": "1.0",
    "displayName": "Product Site List A",
    "description": "A production site list for team A",
    "lastModifiedDateTime": "2022-06-28T19:29:52.8752365Z",
    "publishedDateTime": "2022-06-28T19:29:52.8752365Z",
    "status": "published",
    "lastModifiedBy": {
        "user": {
            "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
            "displayName": "Joe Smith"
        },
        "application": null
    },
    "publishedBy": {
        "user": {
            "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
            "displayName": "Joe Smith"
        },
        "application": null
    }
}

例 2: 特定のサイトと共有 Cookie を発行する

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish
Content-Type: application/json

{
    "revision": "1.0",
    "sites": [
        {
            "id": "53e5f971-fc7b-4cd3-a1bf-34d7c0416882"
        },
        {
            "id": "2e27cc86-3662-447e-b751-274fb9f869ea"
        }
    ],
    "sharedCookies": [
        {
            "id": "7f639835-23ab-4793-b1e6-1a06fad127a2"
        }
    ]
}


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

// Dependencies
using Microsoft.Graph.Admin.Edge.InternetExplorerMode.SiteLists.Item.Publish;
using Microsoft.Graph.Models;

var requestBody = new PublishPostRequestBody
{
	Revision = "1.0",
	Sites = new List<BrowserSite>
	{
		new BrowserSite
		{
			Id = "53e5f971-fc7b-4cd3-a1bf-34d7c0416882",
		},
		new BrowserSite
		{
			Id = "2e27cc86-3662-447e-b751-274fb9f869ea",
		},
	},
	SharedCookies = new List<BrowserSharedCookie>
	{
		new BrowserSharedCookie
		{
			Id = "7f639835-23ab-4793-b1e6-1a06fad127a2",
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.Edge.InternetExplorerMode.SiteLists["{browserSiteList-id}"].Publish.PostAsync(requestBody);



mgc admin edge internet-explorer-mode site-lists publish post --browser-site-list-id {browserSiteList-id} --body '{\
    "revision": "1.0",\
    "sites": [\
        {\
            "id": "53e5f971-fc7b-4cd3-a1bf-34d7c0416882"\
        },\
        {\
            "id": "2e27cc86-3662-447e-b751-274fb9f869ea"\
        }\
    ],\
    "sharedCookies": [\
        {\
            "id": "7f639835-23ab-4793-b1e6-1a06fad127a2"\
        }\
    ]\
}\
'



// 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"
	  graphadmin "github.com/microsoftgraph/msgraph-sdk-go/admin"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphadmin.NewPublishPostRequestBody()
revision := "1.0"
requestBody.SetRevision(&revision) 


browserSite := graphmodels.NewBrowserSite()
id := "53e5f971-fc7b-4cd3-a1bf-34d7c0416882"
browserSite.SetId(&id) 
browserSite1 := graphmodels.NewBrowserSite()
id := "2e27cc86-3662-447e-b751-274fb9f869ea"
browserSite1.SetId(&id) 

sites := []graphmodels.BrowserSiteable {
	browserSite,
	browserSite1,
}
requestBody.SetSites(sites)


browserSharedCookie := graphmodels.NewBrowserSharedCookie()
id := "7f639835-23ab-4793-b1e6-1a06fad127a2"
browserSharedCookie.SetId(&id) 

sharedCookies := []graphmodels.BrowserSharedCookieable {
	browserSharedCookie,
}
requestBody.SetSharedCookies(sharedCookies)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
publish, err := graphClient.Admin().Edge().InternetExplorerMode().SiteLists().ByBrowserSiteListId("browserSiteList-id").Publish().Post(context.Background(), requestBody, nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.admin.edge.internetexplorermode.sitelists.item.publish.PublishPostRequestBody publishPostRequestBody = new com.microsoft.graph.admin.edge.internetexplorermode.sitelists.item.publish.PublishPostRequestBody();
publishPostRequestBody.setRevision("1.0");
LinkedList<BrowserSite> sites = new LinkedList<BrowserSite>();
BrowserSite browserSite = new BrowserSite();
browserSite.setId("53e5f971-fc7b-4cd3-a1bf-34d7c0416882");
sites.add(browserSite);
BrowserSite browserSite1 = new BrowserSite();
browserSite1.setId("2e27cc86-3662-447e-b751-274fb9f869ea");
sites.add(browserSite1);
publishPostRequestBody.setSites(sites);
LinkedList<BrowserSharedCookie> sharedCookies = new LinkedList<BrowserSharedCookie>();
BrowserSharedCookie browserSharedCookie = new BrowserSharedCookie();
browserSharedCookie.setId("7f639835-23ab-4793-b1e6-1a06fad127a2");
sharedCookies.add(browserSharedCookie);
publishPostRequestBody.setSharedCookies(sharedCookies);
var result = graphClient.admin().edge().internetExplorerMode().siteLists().byBrowserSiteListId("{browserSiteList-id}").publish().post(publishPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const browserSiteList = {
    revision: '1.0',
    sites: [
        {
            id: '53e5f971-fc7b-4cd3-a1bf-34d7c0416882'
        },
        {
            id: '2e27cc86-3662-447e-b751-274fb9f869ea'
        }
    ],
    sharedCookies: [
        {
            id: '7f639835-23ab-4793-b1e6-1a06fad127a2'
        }
    ]
};

await client.api('/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish')
	.post(browserSiteList);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Admin\Edge\InternetExplorerMode\SiteLists\Item\Publish\PublishPostRequestBody;
use Microsoft\Graph\Generated\Models\BrowserSite;
use Microsoft\Graph\Generated\Models\BrowserSharedCookie;


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

$requestBody = new PublishPostRequestBody();
$requestBody->setRevision('1.0');
$sitesBrowserSite1 = new BrowserSite();
$sitesBrowserSite1->setId('53e5f971-fc7b-4cd3-a1bf-34d7c0416882');
$sitesArray []= $sitesBrowserSite1;
$sitesBrowserSite2 = new BrowserSite();
$sitesBrowserSite2->setId('2e27cc86-3662-447e-b751-274fb9f869ea');
$sitesArray []= $sitesBrowserSite2;
$requestBody->setSites($sitesArray);

$sharedCookiesBrowserSharedCookie1 = new BrowserSharedCookie();
$sharedCookiesBrowserSharedCookie1->setId('7f639835-23ab-4793-b1e6-1a06fad127a2');
$sharedCookiesArray []= $sharedCookiesBrowserSharedCookie1;
$requestBody->setSharedCookies($sharedCookiesArray);


$result = $graphServiceClient->admin()->edge()->internetExplorerMode()->siteLists()->byBrowserSiteListId('browserSiteList-id')->publish()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.admin.edge.internetexplorermode.sitelists.item.publish.publish_post_request_body import PublishPostRequestBody
from msgraph.generated.models.browser_site import BrowserSite
from msgraph.generated.models.browser_shared_cookie import BrowserSharedCookie
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = PublishPostRequestBody(
	revision = "1.0",
	sites = [
		BrowserSite(
			id = "53e5f971-fc7b-4cd3-a1bf-34d7c0416882",
		),
		BrowserSite(
			id = "2e27cc86-3662-447e-b751-274fb9f869ea",
		),
	],
	shared_cookies = [
		BrowserSharedCookie(
			id = "7f639835-23ab-4793-b1e6-1a06fad127a2",
		),
	],
)

result = await graph_client.admin.edge.internet_explorer_mode.site_lists.by_browser_site_list_id('browserSiteList-id').publish.post(request_body)

応答

次の例は応答を示しています。要求に、まだ公開していないサイトまたは共有 Cookie が含まれている場合、状態が表示 pending されます。

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

{
    "@odata.type": "#microsoft.graph.browserSiteList",
    "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69",
    "revision": "1.0",
    "displayName": "Product Site List A",
    "description": "A production site list for team A",
    "lastModifiedDateTime": "2022-06-28T19:29:52.8752365Z",
    "publishedDateTime": "2022-06-28T19:29:52.8752365Z",
    "status": "pending",
    "lastModifiedBy": {
        "user": {
            "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
            "displayName": "Joe Smith"
        },
        "application": null
    },
    "publishedBy": {
        "user": {
            "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
            "displayName": "Joe Smith"
        },
        "application": null
    }
}

次の方法で共有