이 주제에서는 가져온 키 버전의 상태가 IMPORT_FAILED인 이유를 파악하는 데 도움이 되는 정보를 제공합니다.
Cloud Key Management Service를 사용하면 사용자가 제공한 암호화 키를 새 키 버전으로 가져올 수 있습니다. 가져온 키 버전의 초기 상태는 PENDING_IMPORT입니다.
키 자료를 성공적으로 가져오면 가져온 키 버전의 상태가 ENABLED로 업데이트됩니다. 키 자료를 가져오지 못하면 키 버전의 상태가 IMPORT_FAILED로 업데이트됩니다.
키 형식 관련 문제
형식 지정 문제는 가져오기가 실패하는 일반적인 원인입니다. 다음 오류 메시지는 일반적으로 키 형식이 잘못 지정된 경우에 표시됩니다.
An argument to the import operation was malformed
The key material in the import request couldn't be unwrapped or wasn't
formatted correctly
길이 오류는 Cloud KMS에서 키 자료를 래핑 해제하기 전에 감지할 수 있는 특정한 형식 오류입니다. 다음 길이 오류 메시지는 일반적으로 키 형식이 잘못 지정된 경우에 표시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["# Troubleshooting failed imports\n\nThis topic provides information to help you determine why the state of an\nimported key version is `IMPORT_FAILED`.\n\nCloud Key Management Service allows you to import user-provided cryptographic keys as new\nkey versions. The initial state for an imported key version is `PENDING_IMPORT`.\nIf the key material is imported successfully, the state of the imported key\nversion is updated to `ENABLED`. If key material isn't imported successfully,\nthe state of the key version is updated to `IMPORT_FAILED`.\n\nProblems with the key's format\n------------------------------\n\nFormatting issues are a common cause of import failures. The following error\nmessages are typically caused by incorrectly formatted keys:\n\n- `An argument to the import operation was malformed`\n\n- `The key material in the import request couldn't be unwrapped or wasn't\n formatted correctly`\n\nLength errors are a specific variety of formatting error that\nCloud KMS can detect before it attempts to unwrap your key\nmaterial. The following length error messages are typically caused by\nincorrectly formatted keys:\n\n- `Wrapped ECDSA key has invalid length of (length)`\n\n- `Wrapped key is too short`\n\n- `Wrapped key does not consist of 64-bit blocks`\n\n- `Wrapped key has invalid length`\n\nYou can learn more about [formatting keys for import](/kms/docs/formatting-keys-for-import).\n\nProblems wrapping a key\n-----------------------\n\nThe following errors indicate a problem when manually wrapping keys for import.\n\n- `An argument to the import operation was malformed`\n\n- `The key material in the import request couldn't be unwrapped or wasn't\n formatted correctly`\n\nUsing automatic key wrapping is recommended. If you cannot use automatic key\nwrapping, verify that you are using the wrapping key from the correct import job\nand try to [wrap the key](/kms/docs/wrapping-a-key) again."]]
