Compartilhar via


impressora: criar

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Crie (registe) uma impressora com o serviço Impressão Universal. Esta é uma operação de execução prolongada e, como tal, devolve uma impressoraCriateOperation que pode ser utilizada para controlar e verificar o registo da impressora.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Printer.Create Printer.FullControl.All, Printer.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /print/printers/create

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça um objeto JSON com as seguintes propriedades.

Parâmetro Tipo Descrição Obrigatório?
displayName Cadeia de caracteres O nome a apresentar a atribuir à impressora. Sim
fabricante Cadeia de caracteres O fabricante da impressora. Sim
modelo Cadeia de caracteres O modelo da impressora. Sim
physicalDeviceId Cadeia de caracteres O UUID do dispositivo físico da impressora. Necessário se a hasPhysicalDevice propriedade for verdadeira. Não
hasPhysicalDevice Booliano Verdadeiro se a impressora tiver um dispositivo de saída físico, caso contrário, falso. Se for omitido, o valor predefinido é verdadeiro. Não
certificateSigningRequest printCertificateSigningRequest O Pedido de Assinatura de Certificado X.509 (CSR) para o certificado criado e utilizado pela impressora para se identificar. Sim
connectorId Cadeia de caracteres ID do Conector que funciona como proxy para a impressora. Não

Resposta

Se for bem-sucedido, este método devolve um 202 Accepted código de resposta e uma ligação para a impressora associadaCreateOperation no Operation-Location cabeçalho.

Fazer um pedido GET para o URL ligado pode ser utilizado para obter o status de um registo de impressora em curso. Assim que o registo da impressora for concluído com êxito, um pedido GET para o URL ligado irá conter o objeto de impressora criado e o certificado registado.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/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
}

Resposta

O exemplo a seguir mostra a resposta.

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