Dps Certificate - Create Or Update

참조

Service:: IoT Hub Device Provisioning Service

API Version:: 2018-01-22

프로비저닝 서비스에 인증서를 업로드합니다.
새 인증서를 추가하거나 기존 인증서를 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2018-01-22

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
certificateName	path	True	string	인증서 만들기 또는 업데이트의 이름입니다.
provisioningServiceName	path	True	string	프로비저닝 서비스의 이름입니다.
resourceGroupName	path	True	string	리소스 그룹 식별자입니다.
subscriptionId	path	True	string	구독 식별자입니다.
api-version	query	True	string	API 버전입니다.

요청 헤더

Name	필수	형식	Description
If-Match		string	인증서의 ETag입니다. 기존 인증서를 업데이트하는 데 필요하며 새 인증서를 만드는 동안 무시됩니다.

요청 본문

Name	형식	Description
certificate	string	X509 리프 인증서 .cer 파일 또는 .pem 파일 콘텐츠의 Base-64 표현입니다.

응답

Name	형식	Description
200 OK	CertificateResponse	인증서가 이미 있고 업데이트에 성공한 경우 작업은 HTTP 상태 코드 201(OK)을 반환합니다.
Other Status Codes	ErrorDetails	기본 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

DPSCreateOrUpdateCertificate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?api-version=2018-01-22

{
  "certificate": "############################################"
}

Sample Response

Status code:: 200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpNs="
}

정의

Name	Description
CertificateBodyDescription	JSON 직렬화된 X509 인증서입니다.
CertificateProperties	X509 CA 인증서에 대한 설명입니다.
CertificateResponse	X509 인증서입니다.
ErrorDetails	오류 세부 정보입니다.

CertificateBodyDescription

JSON 직렬화된 X509 인증서입니다.

Name	형식	Description
certificate	string	X509 리프 인증서 .cer 파일 또는 .pem 파일 콘텐츠의 Base-64 표현입니다.

CertificateProperties

X509 CA 인증서에 대한 설명입니다.

Name	형식	Description
created	string	인증서의 생성 날짜 및 시간입니다.
expiry	string	인증서의 만료 날짜 및 시간입니다.
isVerified	boolean	인증서가 확인되었는지 여부를 확인합니다.
subject	string	인증서의 주체 이름입니다.
thumbprint	string	인증서의 지문입니다.
updated	string	인증서의 마지막 업데이트 날짜 및 시간입니다.

CertificateResponse

X509 인증서입니다.

Name	형식	Description
etag	string	엔터티 태그입니다.
id	string	리소스 식별자입니다.
name	string	인증서 이름입니다.
properties	CertificateProperties	인증서의 속성
type	string	리소스 종류입니다.

ErrorDetails

오류 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	string	오류 세부 정보입니다.
httpStatusCode	string	HTTP 상태 코드입니다.
message	string	오류 메시지입니다.