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

AWS.DiscoverDevices 작업 구현

디바이스 검색은 최종 사용자가 소유한 물리적 디바이스의 목록을 관리형 통합에서 유지 관리하는 최종 사용자 디바이스의 디지털 표현과 일치시킵니다 AWS IoT Device Management. 최종 사용자가 소유한 디바이스에서 AWS 고객이 수행합니다. OAuth 2.0의 경우 계정 연결이 완료된 후 발생합니다. 일반 권한 부여의 경우 계정 연결이 생성된 후 발생할 수 있습니다.

디바이스 검색은 용 Managed Integrations AWS IoT Device Management 가 커넥터를 호출하여 디바이스 검색 요청을 시작하는 비동기 프로세스입니다. C2C 커넥터는 Managed Integrations에서 생성한 참조 식별자(라고 함deviceDiscoveryId)와 함께 검색된 최종 사용자 디바이스 목록을 비동기적으로 반환합니다 AWS IoT Device Management.

AWS.DiscoverDevices 워크플로

다음 다이어그램은 최종 사용자와 관리형 통합 간의 디바이스 검색 워크플로를 보여줍니다 AWS IoT Device Management.

워크플로우 단계

디바이스 검색을 위한 C2C 커넥터 요구 사항

다음 목록은 성공적인 디바이스 검색을 용이하게 하기 위한 C2C 커넥터의 요구 사항을 간략하게 설명합니다.

디바이스 검색 프로세스

1단계: 관리형 통합으로 디바이스 검색 트리거

권한 부여 유형에 따라 다음 JSON 페이로드 중 하나를 DiscoverDevices 사용하여에 POST 요청을 보냅니다.

OAuth 2.0 요청:

/DiscoverDevices
{
   "header": {
        "auth": {                 
            "token": "ashriu32yr97feqy7afsaf",  
            "type": "OAuth2.0"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

일반 권한 부여 요청:

/DiscoverDevices
{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

일반 권한 부여 요청:

/DiscoverDevices
{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

2단계: 커넥터에서 검색 승인

커넥터는 다음 JSON 응답과 함께 승인을 전송합니다.

{
     "header": {
          "responseCode":200
     },
     "payload": {
          "responseMessage": "Discovering devices for discovery-job-id '12345678' with connector-id `Your-Connector-Id`"
     }
}

3단계: 커넥터가 디바이스 검색 이벤트 전송

다음 JSON 페이로드를 /connector-event/{your_connector_id} 사용하여에 POST 요청을 보냅니다.

AWS API - /SendConnectorEvent
URI – POST /connector-event/{your_connector_id}
{
   "UserId": "6109342",
   "Operation": "DEVICE_DISCOVERY",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "DeviceDiscoveryId": "12345678",
   "ConnectorId": "Your_connector_Id",
   "Message": "Device discovery for discovery-job-id '12345678' successful",
   "Devices": [
        {
            "ConnectorDeviceId": "Your_Device_Id_1",
            "ConnectorDeviceName": "Your-Device-Name",
            "CapabilityReport": {
 	      		"nodeId":"1",
 			"version":"1.0.0",
  			"endpoints":[{
 				"id":"1",
 				"deviceTypes":["Camera"],
 				"clusters":[{
 					"id":"0x0006",
 					"revision":1,
 					"attributes":[{
 						"id":"0x0000",
 					}],
 					"commands":["0x00","0x01"],
 					"events":["0x00"]
 				}]
 			}]
 		}
        }
    ]
}

검색된 디바이스에 브랜드 및 모델 채우기

C2C 커넥터는 선택적으로 DEVICE_DISCOVERY 이벤트의 각 디바이스에 대한 DeviceMetadata 객체를 포함하여 디바이스의 브랜드와 모델을 보고할 수 있습니다. 그러면 이러한 값이 ListDiscoveredDevices 및 ListManagedThings 응답에 반환됩니다.

각 디바이스 항목 및 맵에 DeviceMetadata 객체를 포함합니다.

다음 예제에서는가 DeviceMetadata 포함된 디바이스 항목을 보여줍니다.

{
    "ConnectorDeviceId": "Your_Device_Id_1",
    "ConnectorDeviceName": "Your-Device-Name",
    "CapabilityReport": { ... },
    "DeviceMetadata": {
        "Brand": "ExampleBrand",
        "Model": "ExampleModel-X1"
    }
}

두 키 모두 대/소문자를 구분하는 문자열입니다. 를 생략하거나DeviceMetadata, 개별 키를 생략하거나, 문자열이 아닌 값을 제공하는 경우 디바이스를 검색할 때 해당 필드를 사용할 수 없습니다.

DISCOVER_DEVICES 이벤트에 대한 CapabilityReport 구성

위에 정의된 이벤트 구조에서 볼 수 있듯이 AWS.DiscoverDevices 작업에 대한 응답으로 사용되는 DISCOVER_DEVICES 이벤트에서 보고된 모든 디바이스에는 해당 디바이스의 기능을 설명하는 CapbilityReport가 필요합니다. 'CapabilityReport'는 AWS IoT Device Management 디바이스 기능에 대한 관리형 통합을 Matter 준수 형식으로 알려줍니다.

CapabilityReport의 필수 필드

지원되는 기능의 현재 목록과 AWS Matter Data Model의 해당 구현은 Data Model 설명서의 최신 릴리스를 참조하세요.