기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

디바이스 프로비저닝 MQTT API

플릿 프로비저닝 서비스는 다음과 같은 MQTT API 작업을 지원합니다.

이 API는 주제의 payload-format에 따라 Concise Binary Object Representation(CBOR) 형식 및 JavaScript Object Notation(JSON) 형식의 응답 버퍼를 지원합니다. 명확성을 위해 이 섹션의 응답 및 요청 예제는 JSON 형식으로 표시됩니다.

CreateCertificateFromCsr

인증서 서명 요청(CSR)에서 인증서를 생성합니다. AWS IoT는 Amazon Root 인증 기관(CA)에서 서명한 클라이언트 인증서를 제공합니다. 새 인증서의 상태는 PENDING_ACTIVATION입니다. 이 인증서로 사물을 프로비저닝하도록 RegisterThing를 호출하면 템플릿에 설명된 대로 인증서 상태가 ACTIVE 또는 INACTIVE로 변경됩니다.

인증 기관 인증서 및 인증서 서명 요청을 사용하여 클라이언트 인증서를 생성하는 방법에 대한 자세한 내용은 CA 인증서를 사용하여 클라이언트 인증서 생성 섹션을 참조하세요.

CreateCertificateFromCsr 요청

$aws/certificates/create-from-csr/payload-format 주제와 함께 메시지를 게시합니다.

CreateCertificateFromCsr 요청 페이로드

{
    "certificateSigningRequest": "string"
}

CreateCertificateFromCsr 응답

$aws/certificates/create-from-csr/payload-format/accepted을 구독합니다.

CreateCertificateFromCsr 응답 페이로드

{
    "certificateOwnershipToken": "string",
    "certificateId": "string",
    "certificatePem": "string"
}

CreateCertificateFromCsr 오류

오류 응답을 수신하려면 $aws/certificates/create-from-csr/payload-format/rejected를 구독합니다.

CreateCertificateFromCsr 오류 페이로드

{
    "statusCode": int,
    "errorCode": "string",
    "errorMessage": "string"
}

CreateKeysAndCertificate

새 키와 인증서를 생성합니다. AWS IoT는 Amazon Root 인증 기관(CA)에서 서명한 클라이언트 인증서를 제공합니다. 새 인증서의 상태는 PENDING_ACTIVATION입니다. 이 인증서로 사물을 프로비저닝하도록 RegisterThing를 호출하면 템플릿에 설명된 대로 인증서 상태가 ACTIVE 또는 INACTIVE로 변경됩니다.

CreateKeysAndCertificate 요청

빈 메시지 페이로드와 함께 $aws/certificates/create/payload-format에 메시지를 게시합니다.

CreateKeysAndCertificate 응답

$aws/certificates/create/payload-format/accepted을 구독합니다.

CreateKeysAndCertificate 응답

{
    "certificateId": "string",
    "certificatePem": "string",
    "privateKey": "string",
    "certificateOwnershipToken": "string"
}

CreateKeysAndCertificate 오류

오류 응답을 수신하려면 $aws/certificates/create/payload-format/rejected를 구독합니다.

CreateKeysAndCertificate 오류 페이로드

{
    "statusCode": int,
    "errorCode": "string",
    "errorMessage": "string"
}

RegisterThing

미리 정의된 템플릿을 사용하여 사물을 프로비저닝합니다.

RegisterThing 요청

$aws/provisioning-templates/templateName/provision/payload-format에 메시지를 게시합니다.

RegisterThing request 페이로드

{
    "certificateOwnershipToken": "string",
    "parameters": {
        "string": "string",
        ...
    }
}

RegisterThing 응답

$aws/provisioning-templates/templateName/provision/payload-format/accepted을 구독합니다.

RegisterThing 응답 페이로드

{
    "deviceConfiguration": {
        "string": "string",
        ...
    },
    "thingName": "string"
}

RegisterThing 오류 응답

오류 응답을 수신하려면 $aws/provisioning-templates/templateName/provision/payload-format/rejected를 구독합니다.

RegisterThing 오류 응답 페이로드

{
    "statusCode": int,
    "errorCode": "string",
    "errorMessage": "string"
}