다음을 통해 공유

프록시 업데이트를 가져오기 위한 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’)이 업로드에 포함됩니다. 이 파일을 삭제하고 다시 시도합니다. 프록시 업데이트에는 부모 가져오기 매니페스트와 일부 자식 가져오기 매니페스트가 포함될 수 있습니다. 부모 가져오기 매니페스트에는 업데이트의 모든 자식 가져오기 매니페스트에 대한 참조가 포함됩니다. 이 오류가 표시되는 경우 나열된 각 매니페스트는 업데이트에 있지만 부모 가져오기 매니페스트에서 참조되지 않는 자식 가져오기 매니페스트입니다.

이 문제를 해결하려면 해당 자식 가져오기 매니페스트를 제거해야 합니다. 또는 부모 가져오기 매니페스트에서 자식에 대한 참조를 추가할 수 있습니다. 가져오기 매니페스트에 관해 자세히 알아봅니다.
일부 필수 업데이트 파일이 누락되었습니다. 이 파일을 포함하고 업로드를 다시 시도합니다. 프록시 업데이트에는 각각 여러 업데이트 파일을 참조하는 여러 가져오기 매니페스트가 포함될 수 있습니다. 업데이트를 가져올 때 참조되는 파일이 포함되지 않은 경우 이 오류가 표시됩니다.

이 문제를 해결하려면 누락된 파일을 추가하거나 해당 파일을 포함하는 가져오기 매니페스트에서 해당 파일에 대한 참조를 제거해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다.
매니페스트에 나열되지 않은 파일이 업로드에 하나 이상 포함됩니다. 추가 파일을 삭제하고 업로드를 다시 시도합니다. 프록시 업데이트에는 각각 여러 업데이트 파일을 참조하는 여러 가져오기 매니페스트가 포함될 수 있습니다. 가져오기 매니페스트에서 참조되지 않는 업데이트 파일을 가져오려고 하면 이 오류가 표시됩니다.

이 문제를 해결하려면 오류 메시지에 나열된 파일을 제거합니다. 또는 가져오기 매니페스트 중 하나에 각 파일의 참조를 추가합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다.
업로드에 중복된 파일 이름이 포함됩니다. 각 이름이 고유하도록 파일을 삭제하거나 파일 이름을 바꿉니다. 업데이트에는 여러 파일이 포함될 수 있지만 각 파일에는 고유한 파일 이름이 있어야 합니다. 이름이 같은 업데이트 파일을 가져오려고 하면 이 오류가 표시됩니다.

이 문제를 해결하려면 오류 메시지에 나열된 파일을 제거하거나 파일 이름을 바꿉니다. 파일 이름을 바꾸는 경우 해당하는 가져오기 매니페스트에서 각 파일의 연결된 참조도 변경해야 합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다.
하나 이상 가져오기 매니페스트의 형식이 올바르게 지정되지 않았습니다. 파일을 삭제하거나 해당 구문을 조정하고 다시 시도합니다. 이 오류가 표시되면 가져오기 매니페스트를 만든 방법과 관련된 문제가 있습니다. 이 문제를 해결하려면 나열된 각 가져오기 매니페스트를 검토하고 스키마 문제가 없는지 확인합니다. 가져오기 매니페스트에 관해 자세히 알아봅니다.

다음 단계