Поделиться через


printer: create

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

Создайте (зарегистрируйте) принтер с помощью службы универсальной печати. Это длительная операция, поэтому она возвращает объект printerCreateOperation , который можно использовать для отслеживания и проверки регистрации принтера.

Сведения о создании необходимого запроса подписи сертификата (CSR) для создания принтера см. в примере кода создания CSR.

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

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

Разрешения

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

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

HTTP-запрос

POST /print/printers/create

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

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

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

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

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

Параметр Тип Описание Обязательный?
displayName String Отображаемое имя, присваиваемое принтеру. Да
manufacturer String Производитель принтера. Да
model String Модель принтера. Да
physicalDeviceId String UUID физического устройства принтера. Требуется, hasPhysicalDevice если свойство имеет значение true. Нет
hasPhysicalDevice Логический Значение true, если принтер имеет физическое устройство вывода, в противном случае — значение false. Если этот параметр опущен, значение по умолчанию — true. Нет
certificateSigningRequest printCertificateSigningRequest Запрос на подпись сертификата X.509 (CSR) для сертификата, созданного и используемого принтером для идентификации себя. Да
connectorId String Идентификатор соединителя, выступающего в качестве прокси-сервера для принтера. Нет

Отклик

В случае успешного 202 Accepted выполнения этот метод возвращает код ответа и ссылку на связанный принтерCreateOperation в заголовке Operation-Location .

Вы делаете запрос GET на связанный URL-адрес, чтобы получить состояние текущей регистрации принтера. После успешной регистрации принтера запрос GET на связанный URL-адрес будет содержать созданный объект принтера и зарегистрированный сертификат.

Примеры

Запрос

POST https://graph.microsoft.com/v1.0/print/printers/create
Content-Type: application/json

{
  "displayName": "Test Printer",
  "manufacturer": "Test Printer Manufacturer",
  "model": "Test Printer Model",
  "physicalDeviceId": null,
  "hasPhysicalDevice": false,
  "certificateSigningRequest": { 
    "content": "{content}",
    "transportKey": "{sampleTransportKey}"
  },
  "connectorId": null
}

Отклик

HTTP/1.1 202 Accepted
Operation-Location: https://graph.microsoft.com/v1.0/print/operations/f221760a-52e8-4c11-b8c5-5dfaef3a49db
Retry-After: 5