Compartir a través de

Actualización de openShift

  • Artículo

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto openShift .

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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) Schedule.ReadWrite.All Group.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Schedule.ReadWrite.All No disponible.

Nota: esta API admite permisos de administrador. Los usuarios con roles de administrador pueden acceder a grupos de los que no son miembros.

Solicitud HTTP

PUT /teams/{id}/schedule/openShifts/{openShiftId}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Tipo de contenido application/json. Obligatorio.
MS-APP-ACTS-AS Un identificador de usuario (GUID). Solo se requiere si el token de autorización es un token de aplicación; De lo contrario, es opcional.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen 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.

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

Propiedad Tipo Descripción
draftOpenShift openShiftItem Los cambios de borrador en openShift solo son visibles para los administradores hasta que se comparten. DraftOpenShift o sharedOpenShift deben ser null.
isStagedForDeletion Booleano OpenShift está marcado para su eliminación, un proceso que se finaliza cuando se comparte la programación. Opcional.
schedulingGroupId Cadena Identificador del schedulingGroup que contiene openShift.
sharedOpenShift openShiftItem La versión compartida de este openShift que pueden ver tanto los empleados como los administradores. DraftOpenShift o sharedOpenShift deben ser null.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de 204 No Content respuesta y contenido vacío. Si la solicitud especifica el Prefer encabezado con return=representation preferencia, este método devuelve un 200 OK código de respuesta y un objeto openShift actualizado en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PUT https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8
Content-Type: application/json

{
  "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a",
  "sharedOpenShift": {
    "displayName": null,
    "startDateTime": "2024-11-04T20:00:00Z",
    "endDateTime": "2024-11-04T21:00:00Z",
    "theme": "blue",
    "notes": null,
    "openSlotCount": 1,
    "activities": []
  },
  "draftTimeOff": null,
  "isStagedForDeletion": false
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content