Certificate - Add

Service:

Batch Service

API Version:

2023-11-01.18.0

지정된 계정에 인증서를 추가합니다.
경고: 이 작업은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.

POST {batchUrl}/certificates?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/certificates?timeout={timeout}&api-version=2023-11-01.18.0

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
api-version	query	True	string	클라이언트 API 버전.
timeout	query		integer int32	서버가 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다.

요청 헤더

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

Name	필수	형식	Description
client-request-id		string uuid	9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같은 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id		boolean	서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date		string date-time-rfc1123	요청이 실행된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name	필수	형식	Description
data	True	string	인증서의 base64로 인코딩된 콘텐츠입니다. 최대 크기는 10KB입니다.
thumbprint	True	string	인증서의 X.509 지문입니다. 최대 4016자리 숫자의 시퀀스입니다(공백을 포함할 수 있지만 제거됨).
thumbprintAlgorithm	True	string	지문을 파생하는 데 사용되는 알고리즘입니다. sha1이어야 합니다.
certificateFormat		CertificateFormat	인증서 데이터의 형식입니다.
password		string	인증서의 프라이빗 키에 액세스하기 위한 암호입니다. 인증서 형식이 cer인 경우 생략해야 합니다.

응답

Name	형식	Description
201 Created		Batch 서비스에 대한 요청이 성공했습니다. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

보안

azure_auth

OAuth 2.0 인증 코드 흐름 Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	사용자 계정 가장

Authorization

Type: apiKey
In: header

예제

Certificate add

Sample Request

HTTP

POST account.region.batch.azure.com/certificates?api-version=2023-11-01.18.0



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

Sample Response

Status code:

201

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
CertificateAddParameter	컴퓨팅 노드에 설치할 수 있고 컴퓨터에서 작업을 인증하는 데 사용할 수 있는 인증서입니다.
CertificateFormat	인증서 데이터의 형식입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.

BatchError

Azure Batch 서비스에서 받은 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
message	ErrorMessage	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values	BatchErrorDetail[]	오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.

Name	형식	Description
key	string	Value 속성의 의미를 지정하는 식별자입니다.
value	string	오류 응답에 포함된 추가 정보입니다.

CertificateAddParameter

컴퓨팅 노드에 설치할 수 있고 컴퓨터에서 작업을 인증하는 데 사용할 수 있는 인증서입니다.

Name	형식	Description
certificateFormat	CertificateFormat	인증서 데이터의 형식입니다.
data	string	인증서의 base64로 인코딩된 콘텐츠입니다. 최대 크기는 10KB입니다.
password	string	인증서의 프라이빗 키에 액세스하기 위한 암호입니다. 인증서 형식이 cer인 경우 생략해야 합니다.
thumbprint	string	인증서의 X.509 지문입니다. 최대 4016자리 숫자의 시퀀스입니다(공백을 포함할 수 있지만 제거됨).
thumbprintAlgorithm	string	지문을 파생하는 데 사용되는 알고리즘입니다. sha1이어야 합니다.

CertificateFormat

인증서 데이터의 형식입니다.

Name	형식	Description
cer	string	인증서는 base64로 인코딩된 X.509 인증서입니다.
pfx	string	인증서는 PFX(PKCS#12) 형식의 인증서 또는 인증서 체인입니다.

ErrorMessage

Azure Batch 오류 응답에서 받은 오류 메시지입니다.

Name	형식	Description
lang	string	오류 메시지의 언어 코드
value	string	메시지의 텍스트입니다.