Обновление branchSite (не рекомендуется)
Пространство имен: microsoft.graph.networkaccess
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Важно!
Не рекомендуется и скоро будет выведен из эксплуатации. Вместо этого используйте тип ресурса remoteNetwork и связанные с ним методы.
Обновите конфигурацию или свойства определенной ветви.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | NetworkAccess.ReadWrite.All | Недоступно. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | NetworkAccess.ReadWrite.All | Недоступно. |
В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.
- Глобальный администратор безопасного доступа
- Администратор безопасности
HTTP-запрос
PATCH /networkAccess/connectivity/branches/{branchSiteId}
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
Укажите в тексте запроса только значения обновляемых свойств. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
Свойство | Тип | Описание |
---|---|---|
name | String | Имя ветви. Обязательно. |
country | String | Страна, в которую создается ветвь. Обязательно. |
область | String | Расположение, в которое создается ветвь. Обязательно. |
bandwidthCapacity | Int64 | Максимальная допустимая пропускная способность Мбит/с (мегабит в секунду) для ветви. Обязательно. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и объект microsoft.graph.networkaccess.branchSite в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branchSiteId}
Content-Type: application/json
{
"name": "My updated branch"
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/connectivity/branches/$entity",
"id": "88e5a488-92c3-45d6-ba56-e5cfa63677e8",
"name": "test branch - 11:50",
"country": "United States",
"region": "East US",
"version": "1.0.0",
"bandwidthCapacity": 500,
"lastModifiedDateTime": "2023-05-24T08:22:02Z"
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по