Actualizar paquete de Copilot

Importante

Las API de la /beta versión están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.

Actualizar un objeto copilotPackageDetail .

Importante

El acceso a la API de administración de paquetes requiere una licencia de Microsoft Agent 365.

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) CopilotPackages.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No disponible. No disponible.

Solicitud HTTP

PATCH https://graph.microsoft.com/beta/copilot/admin/catalog/packages/{id}

Encabezados de solicitud

Nombre Descripción
Authorization Bearer {token}. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de un objeto copilotPackageDetail .

Se pueden actualizar las siguientes propiedades.

Propiedad Tipo Description
allowedUsersAndGroups colección packageAccessEntity Usuarios o grupos para los que está disponible el paquete.
acquireUsersAndGroups colección packageAccessEntity Usuarios o grupos para los que se implementa el paquete.
availableTo packageAllowStatus Valor enumerado que especifica qué usuarios o grupos del inquilino pueden acceder a este paquete. Necesario si se está actualizando allowedUsersAndGroups
deployedTo packageAcquireStatus Valor enumerado que indica el ámbito de implementación del paquete. Necesario si se está actualizando acquireUsersAndGroups

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/copilot/admin/catalog/packages/P_19ae1zz1-56bc-505a-3d42-156df75a4xxy
Content-Type: application/json

{
  "allowedUsersAndGroups": [
    {
      "resourceType": "user",
      "resourceId": "5d9fa31e-626e-45fb-b6e7-d8f1f11933a9"
    },
    {
      "resourceType": "group",
      "resourceId": "65d7d8fb-1e24-4ba8-92cd-8c502d830113"
    }
  ],
  "acquireUsersAndGroups": [
    {
      "resourceType": "user",
      "resourceId": "5d9fa31e-626e-45fb-b6e7-d8f1f11933a9"
    },
    {
      "resourceType": "group",
      "resourceId": "65d7d8fb-1e24-4ba8-92cd-8c502d830113"
    }
  ],
  "availableTo": "allowedForSome",
  "deployedTo" : "acquiredForSome"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content