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

관리형 통합 허브 오프보드

Hub SDK 오프보드 프로세스 개요

허브 오프보딩 프로세스는 AWS 클라우드 관리 시스템에서 허브를 제거합니다. 클라우드가 DeleteManagedThing 요청을 보내면 프로세스는 두 가지 기본 목표를 달성합니다.

디바이스 측 작업:

클라우드 측 작업:

고객은 일반적으로 다음과 같은 경우 허브 오프보딩을 시작합니다.

이 프로세스는 허브 구성 간에 깔끔하고 안전한 전환을 보장하여 원활한 디바이스 관리와 계정 유연성을 제공합니다.

사전 조건

Hub SDK 오프보드 프로세스

다음 단계에 따라 허브를 오프보드합니다.

hub_managed_thing ID 검색

iotmi_config.json 파일은 관리형 통합 허브의 관리형 사물 ID를 저장하는 데 사용됩니다. 이 식별자는 허브가 AWS IoT 관리형 통합 서비스와 통신할 수 있도록 하는 중요한 정보입니다. 관리형 사물 ID는 JSON 파일의 rw(읽기-쓰기) 섹션 내 managed_thing_id 필드 아래에 저장됩니다. 이는 다음 샘플 구성에서 볼 수 있습니다.

{
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "PATH",
          "iot_claim_pk_path": "PATH",
          "UPC": "UPC",
          "sh_endpoint_url": "ENDPOINT_URL",
          "SN": "SN",
          "fp_template_name": "TEMPLATENAME"
      },
      "rw": {
          "iot_provisioning_state": "PROVISIONED",
          "client_id": "ID",
          "managed_thing_id": "ID",
          "iot_permanent_cert_path": "CERT_PATH",
          "iot_permanent_pk_path": "KEY",
          "metadata": {
              "last_updated_epoch_time": 1747766125
          }
      }
}

오프보드 허브로 명령 전송

계정 자격 증명을 사용하고 이전 섹션에서 managed_thing_id 검색된 로 명령을 실행합니다.

aws iot-managed-integrations delete-managed-thing \
    --identifier HUB_MANAGED_THING_ID

허브가 오프보딩되었는지 확인

계정 자격 증명을 사용하고 이전 섹션에서 managed_thing_id 검색된 로 명령을 실행합니다.

aws iot-managed-integrations get-managed-thing \
    --identifier HUB_MANAGED_THING_ID

성공 및 실패 시나리오

성공 시나리오

허브 오프보드 명령이 성공하면 다음 샘플 응답이 예상됩니다.

{
      "Message" : "Managed Thing resource not found."   
}

또한 허브 오프보딩 명령이 성공하면 다음 샘플이 관찰iotmi_config.json됩니다. rw 섹션에 iot_provisioning_state 및 선택적으로 메타데이터만 포함되어 있는지 확인합니다. 메타데이터의 부재는 허용됩니다.는 NOT_PROVISIONED여야 iot_provisioning_state 합니다.

{
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "PATH",
          "iot_claim_pk_path": "PATH",
          "UPC": "1234567890101",
          "sh_endpoint_url": "ENDPOINT_URL",
          "SN": "1234567890101",
          "fp_template_name": "test-template"
      },
      "rw": {
          "iot_provisioning_state": "NOT_PROVISIONED",
          "metadata": {
              "last_updated_epoch_time": 1747766125
          }
      }
}

실패 시나리오

허브 오프보드 명령이 실패한 경우 다음 샘플 응답이 예상됩니다.

{
      "Arn" : "ARN",
      "CreatedAt" : 1.748968266655E9,
      "Id" : "ID",
      "ProvisioningStatus" : "DELETE_IN_PROGRESS",
      "Role" : "CONTROLLER",
      "SerialNumber" : "SERIAL_NO",
      "Tags" : { },
      "UniversalProductCode" : "UPC",
      "UpdatedAt" : 1.748968272107E9
}

{
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "PATH",
          "iot_claim_pk_path": "PATH",
          "UPC": "123456789101",
          "sh_endpoint_url": "ENDPOINT_URL",
          "SN": "123456789101",
          "fp_template_name": "test-template"
      },
      "rw": {
          "iot_provisioning_state": "PROVISIONED",
          "client_id": "ID",
          "managed_thing_id": "ID",
          "iot_permanent_cert_path": "PATH",
          "iot_permanent_pk_path": "PATH",
          "metadata": {
              "last_updated_epoch_time": 1747766125
          }
      }
}

(선택 사항) 오프보딩 후 Hub SDK