Criar printerShare
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 uma nova impressoraShare para a impressora especificada.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | PrinterShare.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
POST /print/shares
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 da solicitação, forneça uma representação JSON do objeto printerShare .
A tabela a seguir mostra as propriedades que podem ser fornecidas ao criar o printerShare.
Propriedade | Tipo | Descrição | Obrigatório? |
---|---|---|---|
Impressora | microsoft.graph.printer | A impressora à qual esse compartilhamento de impressora está relacionada. Use a printer@odata.bind sintaxe conforme mostrado no exemplo a seguir. |
Sim |
displayName | Cadeia de caracteres | O nome do compartilhamento de impressora que imprime clientes deve ser exibido. O comprimento máximo permitido é de 50 caracteres. | Sim |
allowAllUsers | Booliano | Se for verdade, todos os usuários e grupos terão acesso a esse compartilhamento de impressora. Isso substitui as listas de permissões definidas pelas propriedades de navegação allowedUsers e allowedGroups. | Não |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto printerShare no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/print/shares
Content-type: application/json
{
"name": "name-value",
"printer@odata.bind": "https://graph.microsoft.com/beta/print/printers/{id}"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#print/shares/$entity",
"id": "7361c7c1-ff07-4565-9897-bef6895a7d04",
"displayName": "ShareName",
"createdDateTime": "2020-02-04T00:00:00.0000000Z"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de