Обновление метки доставки

Используйте этот метод в API оборудования Майкрософт для обновления метки доставки. Прежде чем использовать этот метод, убедитесь, что вы уже создали метку доставки. Дополнительные сведения о создании метки доставки см. в статье "Создание новой метки доставки".

Предпосылки

Если это еще не сделано, выполните все предварительные требования для API оборудования Майкрософт, прежде чем использовать любой из этих методов.

Просьба

Этот метод имеет следующий синтаксис. В других разделах этого раздела приведены примеры использования и описания текста заголовка и запроса.

Метод Запрос URI
патч https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}

Идентификаторы продукта, отправки и этикетки доставки в методе представляют продукт, отправку и транспортировочную этикетку, которые необходимо обновить.

Заголовок запроса

Заголовок Тип Описание
Авторизация Струна Обязательное. Идентификатор доступа Microsoft Entra в формате Bearer<token>.
Принять Струна Необязательно. Указывает тип содержимого. Допустимое значение — application/json

Параметры запроса

Не предоставляйте параметры запроса для этого метода.

Основное содержание запроса

В следующем примере показан текст запроса JSON для метки доставки. В метку доставки можно вносить только следующие типы изменений:

  • Добавление идентификаторов оборудования
  • Удаление и истечение срока действия идентификаторов оборудования
  • Добавление ЧИД
  • Удаление CHIDs
  • Добавление аудитории
  • Обновление и удаление аудитории
  • Предоставление бизнес-обоснования изменений
{
  "targeting": {
    "chids": [
      {
        "action": "add",
        "chid": "812fac65-9c26-473c-b3a9-1eb3803ac22c"
      },
      {
        "action": "remove",
        "chid": "aed6336d-0958-444c-89b6-bf471191d6f0"
      }
    ],
    "hardwareIds": [
      {
        "action": "remove",
        "bundleId": "a2dfbcd8-1d4a-4885-90a3-2ac8360542da",
        "infId": "foo.inf",
        "operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
        "pnpString": "pci\\ven_8086&dev_5a85"
      },
      {
        "action": "add",
        "bundleId": "48140805-45a3-4a76-8818-e75c117adba9",
        "infId": "foo.inf",
        "operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
        "pnpString": "pci\\ven_8086&dev_5a85"
      }
    ],
    "restrictedToAudiences": [
      "00000000-0000-0000-0000-000000000000",
      "00000000-0000-0000-0000-000000000001"
    ],
    "inServicePublishInfo": {
      "flooring": "RS1",
      "ceiling": "RS3"
    },
    "businessJustification": "Business justification for updating shipping label"
  }
}

Дополнительные сведения о полях в запросе см. в ресурсе ShippingLabel.

Примечания:

  • Необходимо указать значение для действия при обновлении ЧИД или аппаратных идентификаторов.

  • Аудитория — это поле только для обновления. При предоставлении значения в этом поле перезаписывается любое предыдущее значение. Если оставить значение пустым, удаляет предыдущее значение.

  • Чтобы узнать, как получить список аудиторий для вашей организации, см. статью "Получить аудиторию".

  • Объект идентификатора оборудования должен содержать допустимое сочетание идентификатора пакета, идентификатора PNP, кода операционной системы и имени INF, когда обновляется метка доставки. Чтобы получить допустимые сочетания этих атрибутов для отправки (пакета), скачайте файл метаданных драйвера (предоставленную в качестве ссылки) при получении сведений о отправке. Дополнительные сведения см. в разделе метаданных пакета Driver.

Примеры запросов

В следующем примере показано, как обновить метку доставки.

PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>

Ответ

Ответ будет пустым с состоянием HTTP 204.

После этого шага используйте метод в Получение транспортировочного ярлыка, чтобы получить обновленные сведения о транспортировочном ярлыке.

Коды ошибок

Коды ошибок: дополнительные сведения см. в .

См. также

  • Last updated on