프록시 업데이트를 가져오기 위한 Device Update for IoT 문제 해결 가이드
이 문서에서는 프록시 업데이트를 Device Update for IoT Hub로 가져올 때 발생할 수 있는 문제 해결 단계 및 오류 메시지 표를 제공합니다.
오류 메시지
| 오류 메시지 | 문제 해결 방법 |
|---|---|
| 이 업로드에서 가져오기 매니페스트를 찾을 수 없습니다. 가져오기 매니페스트의 파일 확장명은 .importmanifest.json입니다. | 모든 업데이트를 Device Update for IoT Hub로 가져오려면 하나 이상의 가져오기 매니페스트가 필요합니다. 프록시 업데이트에는 부모 가져오기 매니페스트와 부모에서 참조되는 일부 자식 가져오기 매니페스트가 모두 포함될 수 있습니다. 이 오류의 가능한 이유는 유효한 가져오기 매니페스트가 있지만 파일 이름 끝에 .importmanifest.json 확장명이 없기 때문입니다. Azure Portal의 가져오기 프로세스가 가져오기 매니페스트를 인식하려면 이 확장명이 필요합니다. 확장명이 올바른 경우 업데이트에 있는 각 가져오기 매니페스트의 스키마에서 문제가 있는지 검토해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 이 업로드에 필요한 부모 매니페스트가 없습니다. 가져오기 매니페스트의 파일 확장명은 .importmanifest.json입니다. | 프록시 업데이트에는 부모 가져오기 매니페스트와 부모에서 참조되는 일부 자식 가져오기 매니페스트가 포함될 수 있습니다. 부모 매니페스트는 자식 업데이트에 대한 필수 정보를 포함하므로 모든 자식 업데이트를 가져오는 동안 포함되어야 합니다. 이 오류의 가능한 이유는 유효한 부모 가져오기 매니페스트가 있지만 파일 이름 끝에 .importmanifest.json 확장명이 없기 때문입니다. Azure Portal의 가져오기 프로세스가 가져오기 매니페스트를 인식하려면 이 확장명이 필요합니다. 확장명이 올바른 경우 부모 가져오기 매니페스트의 스키마에서 문제가 있는지 검토해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 이 업로드에는 [n] 부모 매니페스트가 포함됩니다. 하나만 사용할 수 있습니다. 사용하지 않으려는 매니페스트를 삭제하고 다시 업로드해 봅니다. | 프록시 업데이트에는 부모 가져오기 매니페스트와 부모에서 참조되는 일부 자식 가져오기 매니페스트가 포함될 수 있습니다. 자식 가져오기 매니페스트는 여러 개 있을 수 있지만 지정된 업데이트에 대한 부모 매니페스트는 하나만 포함할 수 있습니다. 가져오기 매니페스트 파일 목록과 함께 이 오류가 표시되면 각 해당 파일에는 부모 가져오기 매니페스트임을 나타내는 정보가 포함됩니다. 이 문제를 해결하려면 먼저 가져올 업데이트와 일치하는 부모 가져오기 매니페스트를 확인한 다음, 하나의 부모 가져오기 매니페스트만 있도록 다른 부모 매니페스트를 제거합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 업로드에 부모 매니페스트에 나열된 자식 매니페스트 중 하나 이상이 없습니다(‘parentimportfile.importmanifest.json’). 이러한 업데이트 ID에 필요한 자식 매니페스트를 추가합니다. | 프록시 업데이트에는 부모 가져오기 매니페스트와 일부 자식 가져오기 매니페스트가 포함될 수 있습니다. 부모 가져오기 매니페스트에는 업데이트의 모든 자식 가져오기 매니페스트에 대한 참조가 포함됩니다. 이 오류가 표시되면 부모 가져오기 매니페스트는 나열된 각 업데이트 ID에 대한 자식 가져오기 매니페스트를 참조하지만 해당 자식 가져오기 매니페스트는 업데이트에 포함되지 않습니다. 이 문제를 해결하려면 각 해당 자식 가져오기 매니페스트를 업데이트에 추가하거나 부모 가져오기 매니페스트에서 참조를 제거해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 부모에 나열되지 않은 자식 매니페스트 파일(‘childmanifest.importmanifest.json’)이 업로드에 포함됩니다. 이 파일을 삭제하고 다시 시도합니다. | 프록시 업데이트에는 부모 가져오기 매니페스트와 일부 자식 가져오기 매니페스트가 포함될 수 있습니다. 부모 가져오기 매니페스트에는 업데이트의 모든 자식 가져오기 매니페스트에 대한 참조가 포함됩니다. 이 오류가 표시되는 경우 나열된 각 매니페스트는 업데이트에 있지만 부모 가져오기 매니페스트에서 참조되지 않는 자식 가져오기 매니페스트입니다. 이 문제를 해결하려면 해당 자식 가져오기 매니페스트를 제거해야 합니다. 또는 부모 가져오기 매니페스트에서 자식에 대한 참조를 추가할 수 있습니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 일부 필수 업데이트 파일이 누락되었습니다. 이 파일을 포함하고 업로드를 다시 시도합니다. | 프록시 업데이트에는 각각 여러 업데이트 파일을 참조하는 여러 가져오기 매니페스트가 포함될 수 있습니다. 업데이트를 가져올 때 참조되는 파일이 포함되지 않은 경우 이 오류가 표시됩니다. 이 문제를 해결하려면 누락된 파일을 추가하거나 해당 파일을 포함하는 가져오기 매니페스트에서 해당 파일에 대한 참조를 제거해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 매니페스트에 나열되지 않은 파일이 업로드에 하나 이상 포함됩니다. 추가 파일을 삭제하고 업로드를 다시 시도합니다. | 프록시 업데이트에는 각각 여러 업데이트 파일을 참조하는 여러 가져오기 매니페스트가 포함될 수 있습니다. 가져오기 매니페스트에서 참조되지 않는 업데이트 파일을 가져오려고 하면 이 오류가 표시됩니다. 이 문제를 해결하려면 오류 메시지에 나열된 파일을 제거합니다. 또는 가져오기 매니페스트 중 하나에 각 파일의 참조를 추가합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 업로드에 중복된 파일 이름이 포함됩니다. 각 이름이 고유하도록 파일을 삭제하거나 파일 이름을 바꿉니다. | 업데이트에는 여러 파일이 포함될 수 있지만 각 파일에는 고유한 파일 이름이 있어야 합니다. 이름이 같은 업데이트 파일을 가져오려고 하면 이 오류가 표시됩니다. 이 문제를 해결하려면 오류 메시지에 나열된 파일을 제거하거나 파일 이름을 바꿉니다. 파일 이름을 바꾸는 경우 해당하는 가져오기 매니페스트에서 각 파일의 연결된 참조도 변경해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |
| 하나 이상 가져오기 매니페스트의 형식이 올바르게 지정되지 않았습니다. 파일을 삭제하거나 해당 구문을 조정하고 다시 시도합니다. | 이 오류가 표시되면 가져오기 매니페스트를 만든 방법과 관련된 문제가 있습니다. 이 문제를 해결하려면 나열된 각 가져오기 매니페스트를 검토하고 스키마 문제가 없는지 확인합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다. |