Set Certificate Issuer - Set Certificate Issuer

Служба:

Key Vault

Версия API:

2025-07-01

Задает указанного издателя сертификата.
Операция SetCertificateIssuer добавляет или обновляет указанного издателя сертификата. Для этой операции требуется разрешение certificates/setissuers.

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=2025-07-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
issuer-name	path	True	string	Наименование эмитента. Предоставленное вами значение может быть скопировано глобально с целью запуска службы. Предоставляемая стоимость не должна включать личную или конфиденциальную информацию.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
provider	True	string	Поставщик издателя.
attributes		IssuerAttributes	Атрибуты объекта-издателя.
credentials		IssuerCredentials	Учетные данные, которые будут использоваться для эмитента.
org_details		OrganizationDetails	Реквизиты организации предоставляются эмитенту.

Ответы

Имя	Тип	Описание
200 OK	IssuerBundle	Запрос выполнен успешно.
Other Status Codes	KeyVaultError	Непредвиденное сообщение об ошибке.

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://vault.azure.net/.default

Примеры

SetCertificateIssuer

Образец запроса

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=2025-07-01

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

Пример ответа

Код состояния:

200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

Определения

Имя	Описание
AdministratorDetails	Реквизиты администратора организации эмитента сертификата.
CertificateIssuerSetParameters	Издатель сертификата задает параметры.
Error
IssuerAttributes	Атрибуты издателя, управляемого службой Key Vault.
IssuerBundle	Издатель сертификата Key Vault.
IssuerCredentials	Учетные данные, которые будут использоваться для издателя сертификата.
KeyVaultError	Исключение ошибки хранилища ключей.
OrganizationDetails	Реквизиты организации эмитента сертификата.

AdministratorDetails

Object

Реквизиты администратора организации эмитента сертификата.

Имя	Тип	Описание
email	string	Адрес электронной почты.
first_name	string	Имя.
last_name	string	Фамилия.
phone	string	Номер телефона.

CertificateIssuerSetParameters

Object

Издатель сертификата задает параметры.

Имя	Тип	Описание
attributes	IssuerAttributes	Атрибуты объекта-издателя.
credentials	IssuerCredentials	Учетные данные, которые будут использоваться для эмитента.
org_details	OrganizationDetails	Реквизиты организации предоставляются эмитенту.
provider	string	Поставщик издателя.

Error

Object

Имя	Тип	Описание
code	string	Код ошибки.
innererror	Error	Ошибка сервера хранилища ключей.
message	string	Сообщение об ошибке.

IssuerAttributes

Object

Атрибуты издателя, управляемого службой Key Vault.

Имя	Тип	Описание
created	integer (unixtime)	Время создания в UTC.
enabled	boolean	Определяет, включен ли издатель.
updated	integer (unixtime)	Последнее обновление времени в UTC.

IssuerBundle

Object

Издатель сертификата Key Vault.

Имя	Тип	Описание
attributes	IssuerAttributes	Атрибуты объекта-издателя.
credentials	IssuerCredentials	Учетные данные, которые будут использоваться для эмитента.
id	string	Идентификатор объекта издателя.
org_details	OrganizationDetails	Реквизиты организации предоставляются эмитенту.
provider	string	Поставщик издателя.

IssuerCredentials

Object

Учетные данные, которые будут использоваться для издателя сертификата.

Имя	Тип	Описание
account_id	string	Имя пользователя/имя учетной записи/идентификатор учетной записи.
pwd	string	Пароль/секрет/ключ учетной записи.

KeyVaultError

Object

Исключение ошибки хранилища ключей.

Имя	Тип	Описание
error	Error	Ошибка сервера хранилища ключей.

OrganizationDetails

Object

Реквизиты организации эмитента сертификата.

Имя	Тип	Описание
admin_details	AdministratorDetails[]	Реквизиты администратора организации.
id	string	Идентификатор организации.