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

  • Статья
  • Чтение занимает 2 мин

Следующие сведения относятся ко всем операциям, которые можно выполнять для ресурсов 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, полученного из Azure Active Directory (AAD), в качестве заголовка авторизации. Дополнительные сведения см. в статье Authentication, requests and responses (Аутентификация, запросы и ответы).

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

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

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

См. также:

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