Azure Storage Mover 에이전트는 최종 사용자에게 전달되는 상태에 대해 문자열 상태 코드를 사용합니다. 모든 상태 코드에는 접두사 AZSM 뒤에 4개의 소수 자릿수가 있습니다. 첫 번째 소수 자릿수는 상태의 상위 수준 범위를 나타냅니다. 각 상태 코드는 다음 범위 중 하나에 속해야 합니다.
- 전체 에이전트에 적용되는 상태입니다.
이러한 코드는 범위 숫자0를 사용하므로 접두사AZSM0가 있습니다. - 에이전트가 실행하는 특정 작업에 적용되는 상태입니다.
이러한 코드는 범위 숫자1를 사용하므로 접두사AZSM1가 있습니다. - 에이전트가 실행하는 작업에 의해 전송되는 특정 파일 또는 디렉터리의 에이전트에서 설정할 수 있는 상태입니다.
이러한 코드는 범위 숫자2를 사용하므로 접두사AZSM2가 있습니다.
이러한 각 범위는 상태를 범주와 하위 범주로 나눕니다. 각 하위 범주에는 일반적으로 향후 확장을 수용하기 위해 20개의 상태 코드가 예약되어 있습니다.
팁
AZSM0000 성공한 작업을 나타내는 특수 범위 중립적 상태 코드이며 모든 범위/수준에서 성공적인 작업을 나타내는 데 사용해야 합니다.
| 오류 코드 | 오류 메시지 | 세부 정보/문제 해결 단계/완화 |
|---|---|---|
| AZSM1001 | 원본 경로를 탑재하지 못함 | 제공된 서버 이름이나 IP 주소가 유효한지 또는 원본 위치가 올바른지 확인합니다. SMB를 사용하는 경우 제공된 사용자 이름과 암호가 올바른지 확인합니다. |
| AZSM1002 | 원본을 검사하는 동안 오류가 발생함 | 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM1003 | 권한 문제로 인해 원본 폴더에 액세스하지 못함 | 에이전트에 원본 파일 공유에 대한 권한이 부여되었는지 확인합니다. |
| AZSM1004 | 제공된 원본 경로가 잘못되었습니다. | 유효한 원본 공유 경로를 사용하여 새 엔드포인트를 만들고 작업 정의를 업데이트하고 다시 시도합니다. |
| AZSM1020 | 원본에 액세스하는 동안 기타 오류가 발생함 | 이 오류는 소스 파일/폴더 읽기 실패를 일으키는 모든 이유로 보고됩니다. 일부 오류는 "이러한 파일 또는 디렉터리 없음", "사용 권한 거부됨", "입력/출력 오류" 등일 수 있습니다. 에이전트와 원본 공유 간의 네트워크 연결이 잘 작동하는지 확인합니다. 원본 공유/폴더/파일이 있어야 하며 에이전트에 원본 공유에 대한 읽기 권한이 있어야 합니다. |
| AZSM1021 | 권한 문제로 인해 대상 폴더에 액세스하지 못함 | 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM1022 | 제공된 대상 경로가 잘못되었습니다. | 유효한 대상 컨테이너 및 경로를 사용하여 새 엔드포인트를 만들고 작업 정의를 업데이트하고 다시 시도합니다. |
| AZSM1023 | 대상 컨테이너에서 이 에이전트에 대한 임대가 만료됨 | 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM1024 | 대상 위치에 액세스하는 권한 부여 실패 | 에이전트에 대상 위치에 액세스할 수 있는 충분한 권한이 없습니다. RBAC(역할 기반 액세스 제어) 역할 할당은 Azure Portal을 사용하여 리소스를 만들 때 자동으로 수행됩니다. API, PowerShell cmdlet 또는 SDK를 사용하는 경우 에이전트의 관리 ID에 대한 역할 할당을 수동으로 만들어 대상 위치에 액세스합니다. Storage Blob 컨테이너 대상의 경우 Storage Blob 데이터 기여자 역할 할당을 사용합니다. Azure 파일 공유를 대상으로 사용하려면 스토리지 파일 데이터 권한 있는 참가자를 사용합니다. 예를 들어 RBAC 역할을 할당하려면 Blob 데이터 문서에 액세스하기 위해 Azure 역할 할당을 참조하세요. |
| AZSM1025 | 원본 위치에 액세스하는 중 인증 실패 | 에이전트에 원본 위치에 대한 권한이 있는지 확인합니다. |
| AZSM1026 | 대상 유형은 에이전트에서 지원되지 않습니다. | 이 대상 형식은 현재 Storage Mover 에이전트에서 지원되지 않습니다. |
| AZSM1027 | 대상 위치가 사용 중입니다. | 활성 임대가 존재하기 때문에 에이전트가 대상 공유 또는 컨테이너를 클레임할 수 없습니다. 임대는 다른 마이그레이션 작업 또는 이전에 중단된 작업으로 인해 "AZURE_STORAGE_MOVER_MARKER" 파일에 대한 클레임을 보유하고 있을 수 있습니다. 이 대상에 대해 다른 작업이 실행되고 있지 않은지 확인합니다. 실행 중인 항목이 없는 경우 에이전트를 다시 시작하고 다시 시도합니다. 문제가 계속되면 지원에 문의하세요. |
| AZSM1028 | Key Vault 액세스 실패 | 이 오류는 에이전트의 관리 ID에 "Key Vault 비밀 사용자" RBAC 액세스 권한이 없거나, 방화벽 또는 네트워크 ACL이 키 자격 증명 모음 엔드포인트에 대한 연결을 차단하거나, 비밀이 누락된 경우에 발생할 수 있습니다. "RESPONSE 403" 오류의 경우 트래픽을 제한할 수 있는 키 자격 증명 모음의 역할 할당 및 방화벽 규칙을 확인합니다. 다른 오류의 경우 "2) 네트워크 구성"에서 xdmsh 메뉴 옵션 "5) 단일 엔드포인트 연결 테스트"를 사용하여 엔드포인트 연결 가능성을 확인합니다. |
| AZSM1029 | 이 에이전트 버전에서 지원되지 않는 원본 엔드포인트 유형 | 이 원본 유형은 현재 Storage Mover 에이전트에서 지원되지 않습니다. |
| AZSM1030 | 스토리지 계정 유형을 확인할 수 없음 | 스토리지 계정과 컨테이너가 있는지, 에이전트에 사용 권한이 부여되었는지 확인합니다. |
| AZSM1031 | 대상 호스트를 해결하지 못함 | 네트워크 구성을 확인하여 방화벽 또는 ACL이 스토리지 계정 엔드포인트에 대한 액세스를 차단하지 않는지 확인합니다. "2) 네트워크 구성"에서 xdmsh 메뉴 옵션 "5) 단일 엔드포인트 연결 테스트"를 사용하여 엔드포인트 연결 가능성을 확인합니다. |
| AZSM1040 | 대상에 액세스하는 동안 기타 오류가 발생함 | 이 오류는 일시적일 수 있습니다. 마이그레이션 작업을 다시 시도합니다. 문제가 지속되면 추가 지원을 위해 지원 티켓을 만듭니다. |
| AZSM1041 | 작업 진행률을 보내지 못함 | 이 오류는 일시적일 수 있습니다. 마이그레이션 작업을 다시 시도합니다. 문제가 지속되면 추가 지원을 위해 지원 티켓을 만듭니다. |
| AZSM1042 | 작업을 만들지 못함 | 이 오류는 에이전트가 연결을 차단하는 스토리지 계정 엔드포인트, 방화벽 또는 네트워크 ACL에 연결할 수 없거나, 프라이빗 엔드포인트가 스토리지 계정에 구성된 경우 공용 IP를 통해 라우팅되는 에이전트의 트래픽 또는 인증서를 수정하는 프록시와 같은 다양한 이유로 인해 발생할 수 있습니다. 스토리지 계정 엔드포인트 연결 가능성을 확인하려면 "5) "2) 네트워크 구성"에서 xdmsh 메뉴 옵션 "2) 단일 엔드포인트 연결 테스트"를 사용합니다. 보고된 오류가 "x509: 알 수 없는 기관에서 서명한 인증서"인 경우 온-프레미스 네트워크가 필요한 엔드포인트로의 트래픽에 대한 SSL 인증서(SSL 인터셉션)를 가로채고 변경하여 에이전트가 수신된 인증서를 인식하지 못했음을 나타냅니다. 에이전트에 인증서를 추가하면 일반적으로 이 문제가 해결되지만 이 기능은 현재 지원되지 않습니다. 에이전트가 이러한 엔드포인트에 액세스할 수 있도록 하려면 허용 목록에 추가하여 SSL 인터셉션을 우회하는 것이 좋습니다. |
| AZSM1043 | 작업을 다시 시작하지 못함 | 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM1044 | 작업을 완료하지 못했습니다. | 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM1045 | 작업이 실행 중인 동안 중단되었습니다. | 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM1060 | 작업 실행 중 기타 오류입니다. | 이 오류는 여러 가지 이유로 인해 발생할 수 있습니다. 보고된 오류를 검토하고 아래에 설명된 세부 정보에 따라 수정 작업을 수행합니다. 오류가 다음을 나타내는 경우: 1) "InvalidResourceName": 해당 폴더 및 파일 이름이 지원되는 명명 규칙을 따르는지 확인합니다. 예를 들어 "con"은 유효한 디렉터리 이름이 아닙니다. 2) "지정된 공유가 가득 찼습니다": 대상 공유의 용량을 확인합니다. 3) "잘못된 파일 설명자": 에이전트와 원본 간의 SMB 네트워크 연결이 제대로 작동하고 SMB 서버가 읽기 요청에 응답하고 있는지 확인합니다. 4) "403 이 요청은 이 작업을 수행할 권한이 없습니다.": 대상 스토리지 계정에 대해 프라이빗 엔드포인트가 구성된 경우 DNS가 올바르게 구성되어 있는지 확인하고 잘못된 IP 확인을 유발하는 DNS 잘못된 경로 지정 또는 부하 분산 장치 구성이 없는지 확인합니다. 5) 다른 오류의 경우 작업을 다시 시도하십시오. 문제가 계속되면 지원 티켓을 만듭니다. |
| AZSM2021 | 대상에서 지원되지 않는 파일 형식입니다. | 이 대상 형식은 이 형식의 파일을 지원하지 않습니다. 추가 정보는 Azure Files 및 Azure Blob Storage에 대한 확장성 및 성능 목표를 참조합니다. |
| AZSM2024 | 원본 경로 길이가 대상에서 지원하는 최대 길이보다 깁니다. | 공유, 디렉터리, 파일 및 메타데이터 이름 지정 및 참조 문서 내의 지침을 참조하세요. |
| AZSM2026 | 원본 파일의 크기가 대상에서 지원하는 최대 크기보다 큽니다. | 공유, 디렉터리, 파일 및 메타데이터 이름 지정 및 참조 문서 내의 지침을 참조하세요. |
| AZSM2027 | 원본 파일 보안 설명자에 지원되지 않는 속성이 있습니다. | 파일 또는 폴더의 사용 권한을 검토합니다. |
| AZSM2061 | 원본을 검색할 때 알 수 없는 오류가 발생했습니다. | 일시적인 오류일 수 있습니다. 마이그레이션 작업을 다시 실행합니다. |
| AZSM2062 | 권한 문제로 인해 원본 파일을 읽지 못했습니다. | 에이전트에 원본 위치에 대한 권한이 있는지 확인합니다. |
| AZSM2063 | 원본 파일을 읽는 동안 I/O 오류가 발생했습니다. | 이 오류는 일시적일 수 있습니다. 마이그레이션 작업을 다시 시도합니다. 문제가 지속되면 추가 지원을 위해 지원 티켓을 만듭니다. |
| AZSM2069 | 권한 문제로 인해 대상 파일을 읽지 못했습니다. | 에이전트에 대상 위치에 대한 권한이 부여되었는지 확인합니다. |
| AZSM2070 | 활성 임대가 있으므로 Blob을 쓸 수 없습니다. | 이 오류는 다른 에이전트가 해당 위치에 쓰기 때문에 발생할 수 있습니다. 대상에 대해 다른 작업이 실행되고 있지 않은지 확인합니다. 지원 티켓을 다시 시도하거나 만듭니다. |
| AZSM2071 | 전송 중에 원본 파일이 수정되었습니다. | 이 오류는 일시적일 수 있습니다. 마이그레이션 작업을 다시 시도합니다. 문제가 지속되면 추가 지원을 위해 지원 티켓을 만듭니다. |
| AZSM2080 | 알 수 없는 오류로 인해 복사에 실패했습니다. | 이 오류는 일시적일 수 있습니다. 마이그레이션 작업을 다시 시도합니다. 문제가 지속되면 추가 지원을 위해 지원 티켓을 만듭니다. |
Storage Mover RBAC 문제 해결
작업을 실행하는 동안 자동 RBAC 할당이 발생합니다. 할당에 오류가 있는 경우 필요한 역할 할당을 수동으로 추가합니다.
- Key Vault, 파일 공유 또는 Blob 컨테이너와 같은 적절한 리소스로 이동합니다.
- 액세스 제어(IAM)로 이동합니다.
- 새 역할 할당 추가: Azure Portal을 사용하여 Azure 역할 할당 - Azure RBAC | Microsoft Learn.
- 역할 할당 추가 마법사에서 아래 표에서 1단계에서 선택한 리소스 종류에 대한 적절한 역할을 검색합니다. 아래 예제에서 리소스는 Key Vault입니다.
| 리소스 종류 | 필요한 역할 |
|---|---|
| Key Vault | Key Vault 비밀 사용자 |
| 파일 공유 | 스토리지 파일 데이터 권한이 있는 기여자 |
| Blob 컨테이너 | 저장소 Blob 데이터 특권 기여자 |
i. "관리 ID"에 대한 액세스 권한을 할당해야 합니다.
ii. 오른쪽 창에서 관리 ID 유형을 컴퓨터 - Azure Arc로 선택합니다.
iii. 목록에서 컴퓨터 ARC를 선택합니다. 에이전트와 동일한 이름입니다.
iv. 과제를 완료합니다.