Поделиться через

Certificate - Add

  • Ссылка
Служба:
Batch Service
Версия API:
2024-07-01.20.0

Добавляет сертификат в указанную учетную запись.
Предупреждение. Эта операция устарела и будет удалена после февраля 2024 года. Вместо этого используйте расширения Azure KeyVault .

POST {batchUrl}/certificates?api-version=2024-07-01.20.0
С использованием необязательных параметров: 
POST {batchUrl}/certificates?timeout={timeout}&api-version=2024-07-01.20.0

Параметры URI

Имя В Обязательно Тип Описание
batchUrl
 path True

string

Базовый URL-адрес для всех запросов пакетной службы Azure.
api-version
 query True

string

Версия КЛИЕНТСКОго API.
timeout
 query

integer

int32

Максимальное время, которое сервер может тратить на обработку запроса в секундах. Значение по умолчанию — 30 секунд. Если значение больше 30, вместо этого будет использоваться значение по умолчанию.

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

Media Types: "application/json; odata=minimalmetadata"

Имя Обязательно Тип Описание
client-request-id

string

uuid

Удостоверение запроса, созданное вызывающим пользователем, в виде GUID без украшений, таких как фигурные скобки, например 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Должен ли сервер возвращать идентификатор client-request-id в ответе.
ocp-date

string

date-time-rfc1123

Время выдачи запроса. Клиентские библиотеки обычно задают это в текущее время системных часов; задайте его явным образом, если вы вызываете REST API напрямую.

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

Media Types: "application/json; odata=minimalmetadata"

Имя Обязательно Тип Описание
data True

string

Содержимое сертификата в кодировке Base64. Максимальный размер — 10 КБ.
thumbprint True

string

Отпечаток сертификата X.509. Это последовательность до 40 шестнадцатеричных цифр (она может включать пробелы, но они удаляются).
thumbprintAlgorithm True

string

Алгоритм, используемый для наследоваемого отпечатка. Это должно быть sha1.
certificateFormat

CertificateFormat

Формат данных сертификата.
password

string

Пароль для доступа к закрытому ключу сертификата.
Это должно быть опущено, если формат сертификата является cer.

Ответы

Имя Тип Описание
201 Created

Запрос к пакетной службе выполнен успешно.

Заголовки

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Ошибка из пакетной службы.

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

azure_auth

Поток кода проверки подлинности Microsoft Entra OAuth 2.0

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

Области

Имя Описание
user_impersonation Олицетворения учетной записи пользователя

Authorization

Тип: apiKey
В: header

Примеры

Certificate add

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

POST account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0



{
  "thumbprintAlgorithm": "sha1",
  "thumbprint": "0123456789abcdef0123456789abcdef01234567",
  "data": "#####...",
  "certificateFormat": "pfx",
  "password": "<ExamplePassword>"
}

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

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

Определения

Имя Описание
BatchError

Ответ об ошибке, полученный из пакетной службы Azure.
BatchErrorDetail

Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.
CertificateAddParameter

Сертификат, который можно установить на вычислительных узлах и может использоваться для проверки подлинности операций на компьютере.
CertificateFormat

Формат данных сертификата.
ErrorMessage

Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

BatchError

Ответ об ошибке, полученный из пакетной службы Azure.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
message

ErrorMessage

Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
values

BatchErrorDetail[]

Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке.

BatchErrorDetail

Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.

Имя Тип Описание
key

string

Идентификатор, указывающий значение свойства Value.
value

string

Дополнительные сведения, включенные в ответ на ошибку.

CertificateAddParameter

Сертификат, который можно установить на вычислительных узлах и может использоваться для проверки подлинности операций на компьютере.

Имя Тип Описание
certificateFormat

CertificateFormat

Формат данных сертификата.
data

string

Содержимое сертификата в кодировке Base64. Максимальный размер — 10 КБ.
password

string

Пароль для доступа к закрытому ключу сертификата.
Это должно быть опущено, если формат сертификата является cer.
thumbprint

string

Отпечаток сертификата X.509. Это последовательность до 40 шестнадцатеричных цифр (она может включать пробелы, но они удаляются).
thumbprintAlgorithm

string

Алгоритм, используемый для наследоваемого отпечатка. Это должно быть sha1.

CertificateFormat

Формат данных сертификата.

Имя Тип Описание
cer

string

Сертификат является сертификатом в кодировке Base64 X.509.
pfx

string

Сертификат — это форматированная цепочка сертификатов или сертификатов PFX (PKCS#12).

ErrorMessage

Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

Имя Тип Описание
lang

string

Языковой код сообщения об ошибке
value

string

Текст сообщения.