Storage 생성과 조회
이 예제에서는 Metadata API를 이용할 때 KAS Console에서 storage를 생성하고 조회하는 방법을 설명하겠습니다.
Storage 생성하기
1. KAS Console에 접속하여 로그인합니다.
2. KAS Console > Service > Metadata > Storage 메뉴를 클릭합니다.
이미 생성한 storage가 있다면 Storages에서 목록을 확인할 수 있습니다.
메타데이터 혹은 에셋을 업로드할 때 별도의 storage를 지정해주지 않는다면 default storage에 저장됩니다.
3. [Storage 생성]을 클릭하면 Storage 생성 화면으로 이동합니다. Storage 이름을 입력한 후 [생성]을 클릭합니다.
4. 가장 최근에 생성한 storage는 목록 맨 윗부분에 나타납니다.
Storage 이름을 클릭하면 각 storage에 관한 상세한 내용을 확인할 수 있습니다.
특정 Storage에 에셋 업로드하기
1. 에셋 혹은 메타데이터를 저장하고 싶은 Storage 이름을 클릭하여 Storage 상세정보로 이동합니다.
Storage 상세정보에서 KRN을 복사합니다.
2. 복사한 KRN을 x-krn 헤더에 입력한 후 API를 호출합니다.
info
Metadata API에서는 체인 ID(네트워크)별로 다른 storage가 생성됩니다.
API 요청을 보내기 전에 x-krn과 x-chain-id 헤더값이 정확한지 꼭 확인하세요.
예시에서는 kas-storage에 에셋을 업로드하기 위해
krn:1001:metadata:5366c4a0-84cc-420f-80fe-9efc85b50996:metadata-storage:kas-storage 입력 후 API를 호출했습니다.
API 응답값은 다음과 같습니다.
{
"contentType": "image/jpeg",
"filename": "9bd24b2f-1667-5684-0b3c-6fb4ab679458.jpeg",
"uri": "https://metadata-store.klaytnapi.com/58fea9c4-ea7c-722c-7498-aa0a3aa1937c/9bd24b2f-1667-5684-0b3c-6fb4ab679458.jpeg"
}에셋이 저장된 외부 접근 가능 URI는 https://example.com/{storage-ID}/{asset-ID}.png 형식으로 구성됩니다. URI path는 항상 Storage ID를 포함합니다. 만약 같은 storage에 에셋을 업로드하면 URI path는 동일한 {storage-ID}를 갖게 됩니다. Storage ID는 Storage 상세정보에서 확인할 수 있습니다.
important
KRN과 StorageId는 메타데이터 서비스 내에서 매핑된 관계입니다. 즉, KRN당 하나의 Storage ID가 부여되며, 이 Storage ID는 path에 포함됩니다. KRN을 노출하면 카스 계정 정보가 유출될 수 있으니 주의해 주세요.
3. KAS Console로 다시 이동하여 Storage 상세정보에서 Asset 탭을 클릭합니다.
kas-storage에 에셋이 업로드된 것을 확인할 수 있습니다.
