Распространенные параметры и заголовки

  • Статья

Следующие сведения являются общими для всех операций, которые могут выполняться в ресурсах Key Vault:

  • Заголовок HTTP Host должен всегда присутствовать и содержать имя узла хранилища. Например, Host: contoso.vault.azure.net. Обратите внимание, что большинство клиентских технологий заполняют заголовок Host из строки URI. Например, GET https://contoso.vault.azure.net/secrets/mysecret{...} задаст для Host значение contoso.vault.azure.net. Если вы обращаетесь к Key Vault с помощью необработанного IP-адреса GET https://10.0.0.23/secrets/mysecret{...}, автоматическое значение заголовка Host будет неправильно, и вам придется вручную убедиться, что Host заголовок содержит имя узла хранилища.
  • Замена {api-version} на api-version в универсальном коде ресурса (URI).
  • Замена {subscription-id} на идентификатор подписки в URI.
  • Замена {resource-group-name} на группу ресурсов. Дополнительные сведения см. в статье об использовании групп ресурсов для управления ресурсами Azure.
  • Замена {vault-name} на имя хранилища ключей в URI.
  • Установка значения application/json в качестве заголовка Content-Type.
  • Задайте заголовок авторизации на веб-токен JSON, полученный из идентификатора Microsoft Entra. Дополнительные сведения см. в статье Authentication, requests and responses (Аутентификация, запросы и ответы).

Распространенное сообщение об ошибке

Служба будет использовать коды состояния HTTP для указания успеха или сбоя. Кроме того, ошибки содержат ответ в следующем формате:

   {  
     "error": {  
     "code": "BadRequest",  
     "message": "The key vault sku is invalid."  
     }  
   }
Имя элемента Тип Описание
кодом строка Тип возникшей ошибки.
message строка Описание причины ошибки.

См. также

Azure Key Vault REST API reference (Справочник по REST API для Azure Key Vault)