Compartir a través de

Crear windowsQualityUpdateCatalogItem

Espacio de nombres: microsoft.graph

Importante: Microsoft admite Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Cree un nuevo objeto windowsQualityUpdateCatalogItem .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

POST /deviceManagement/windowsUpdateCatalogItems

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto windowsQualityUpdateCatalogItem.

En la tabla siguiente se muestran las propiedades necesarias al crear windowsQualityUpdateCatalogItem.

Propiedad Tipo Descripción
id Cadena Identificador del elemento de catálogo. Heredado de windowsUpdateCatalogItem
displayName Cadena Nombre para mostrar del elemento de catálogo. Heredado de windowsUpdateCatalogItem
releaseDateTime DateTimeOffset La fecha en que se publicó el elemento de catálogo Heredado de windowsUpdateCatalogItem
endOfSupportDate DateTimeOffset La última fecha admitida para un elemento de catálogo heredado de windowsUpdateCatalogItem
kbArticleId Cadena Identifica el artículo knowledge base asociado al elemento de catálogo de actualización de calidad de Windows. Solo lectura
classification windowsQualityUpdateCategory Categoría de la actualización de calidad de Windows. Los valores posibles son: all, security, nonSecurity. Solo lectura. Los valores posibles son: all, security, nonSecurity, unknownFutureValue, quickMachineRecovery.
qualityUpdateCadence windowsQualityUpdateCadence Cadencia de publicación de la actualización de calidad. Los valores posibles son: monthly, outOfBand. Esta propiedad no se puede modificar y se rellena automáticamente cuando se crea el catálogo. Solo lectura. Los valores posibles son: monthly, outOfBand, unknownFutureValue.
isExpeditable Booleano Cuando es TRUE, indica que las actualizaciones de calidad son aptas para expedición. Cuando es FALSE, indica que las actualizaciones de calidad no son de calidad para la expedición. El valor predeterminado es FALSE. Solo lectura
productRevisions colección windowsQualityUpdateCatalogProductRevision Las revisiones del producto del sistema operativo que se publican como parte de esta actualización de calidad. Solo lectura.
cveSeverityInformation windowsQualityUpdateCveSeverityInformation Información de CVE para elementos de catálogo

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto windowsQualityUpdateCatalogItem en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/deviceManagement/windowsUpdateCatalogItems
Content-type: application/json
Content-length: 1595

{
  "@odata.type": "#microsoft.graph.windowsQualityUpdateCatalogItem",
  "displayName": "Display Name value",
  "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
  "endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
  "kbArticleId": "Kb Article Id value",
  "classification": "security",
  "qualityUpdateCadence": "outOfBand",
  "isExpeditable": true,
  "productRevisions": [
    {
      "@odata.type": "microsoft.graph.windowsQualityUpdateCatalogProductRevision",
      "displayName": "Display Name value",
      "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
      "versionName": "Version Name value",
      "productName": "Product Name value",
      "osBuild": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductBuildVersionDetail",
        "majorVersionNumber": 2,
        "minorVersionNumber": 2,
        "buildNumber": 11,
        "updateBuildRevision": 3
      },
      "knowledgeBaseArticle": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductKnowledgeBaseArticle",
        "articleId": "Article Id value",
        "articleUrl": "https://example.com/articleUrl/"
      }
    }
  ],
  "cveSeverityInformation": {
    "@odata.type": "microsoft.graph.windowsQualityUpdateCveSeverityInformation",
    "maxSeverityLevel": "important",
    "maxBaseScore": 4.0,
    "exploitedCves": [
      {
        "@odata.type": "microsoft.graph.windowsQualityUpdateCveDetail",
        "cveNumber": "Cve Number value",
        "cveInformationUrl": "https://example.com/cveInformationUrl/"
      }
    ]
  }
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1644

{
  "@odata.type": "#microsoft.graph.windowsQualityUpdateCatalogItem",
  "id": "8eb831ba-31ba-8eb8-ba31-b88eba31b88e",
  "displayName": "Display Name value",
  "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
  "endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
  "kbArticleId": "Kb Article Id value",
  "classification": "security",
  "qualityUpdateCadence": "outOfBand",
  "isExpeditable": true,
  "productRevisions": [
    {
      "@odata.type": "microsoft.graph.windowsQualityUpdateCatalogProductRevision",
      "displayName": "Display Name value",
      "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
      "versionName": "Version Name value",
      "productName": "Product Name value",
      "osBuild": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductBuildVersionDetail",
        "majorVersionNumber": 2,
        "minorVersionNumber": 2,
        "buildNumber": 11,
        "updateBuildRevision": 3
      },
      "knowledgeBaseArticle": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductKnowledgeBaseArticle",
        "articleId": "Article Id value",
        "articleUrl": "https://example.com/articleUrl/"
      }
    }
  ],
  "cveSeverityInformation": {
    "@odata.type": "microsoft.graph.windowsQualityUpdateCveSeverityInformation",
    "maxSeverityLevel": "important",
    "maxBaseScore": 4.0,
    "exploitedCves": [
      {
        "@odata.type": "microsoft.graph.windowsQualityUpdateCveDetail",
        "cveNumber": "Cve Number value",
        "cveInformationUrl": "https://example.com/cveInformationUrl/"
      }
    ]
  }
}
  • Last updated on