Actualizar recurso compartido con impresora

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Actualizar las propiedades de un recurso compartido de impresora. Este método se puede usar para intercambiar impresoras.

Por ejemplo, si un dispositivo de impresora física se interrumpe, un administrador puede registrar un nuevo dispositivo de impresora y actualizar este recurso compartido de impresora para que apunte a la nueva impresora sin necesidad de que los usuarios realicen ninguna acción.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) PrinterShare.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

PATCH /print/shares/{id}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Tipo de contenido application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos printerShare relevantes que se actualizarán. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad. Para obtener el mejor rendimiento, no incluya valores existentes que no hayan cambiado.

En la tabla siguiente se enumeran las propiedades que se pueden actualizar.

Propiedad Tipo Descripción
impresora microsoft.graph.printer Impresora con la que está relacionada esta impresora. Use la printer@odata.bind sintaxis que se muestra en el ejemplo siguiente para actualizar la impresora a la que está asociado este recurso compartido de impresora.
displayName Cadena Nombre del recurso compartido de impresora que deben mostrar los clientes de impresión.
allowAllUsers Booleano Si true, a todos los usuarios y grupos se les concede acceso a este recurso compartido de impresora. Esta propiedad reemplaza las listas de permitidos definidas por las propiedades de navegación allowedUsers y allowedGroups .

Nota:

Si se actualiza la propiedad de impresora , no se podrán actualizar otras propiedades en la misma solicitud.

Respuesta

Si se realiza correctamente, este método devuelve un 200 OK código de respuesta y un objeto printerShare actualizado en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/print/shares/{id}
Content-type: application/json

{
  "displayName": "ShareName",
  "allowAllUsers": true,
  "printer@odata.bind": "https://graph.microsoft.com/beta/print/printers/{id}"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#print/shares/$entity",
  "id": "d837c17b-3296-4384-a053-828d56e10f50",
  "displayName": "ShareName",
  "createdDateTime": "2020-02-04T00:00:00.0000000Z",
  "isAcceptingJobs": true,
  "allowAllUsers": true,
  "status": {
    "state": "stopped",
    "details": ["disconnected"],
    "description": ""
  }
}