Cloud Storage 참조에 파일을 업로드한 후 예를 들어 콘텐츠 유형을 업데이트하기 위해 파일 메타데이터를 업데이트합니다. 또한 추가 파일 메타데이터로 커스텀 키-값 쌍을 저장할 수 있습니다.
파일 메타데이터 가져오기
파일 메타데이터는 Name
, SizeBytes
, ContentType
(통칭 MIME 형식) 등의 일반적인 속성뿐 아니라 ContentDisposition
, CreationTimeMillis
등의 비일반적 속성도 포함합니다. GetMetadataAsync
메서드를 사용하여 Cloud Storage 참조에서 이러한 메타데이터를 가져올 수 있습니다.
// Create reference to the file whose metadata we want to retrieve StorageReference forestRef = storageRef.Child("images/forest.jpg"); // Get metadata properties forestRef.GetMetadataAsync().ContinueWithOnMainThread(task => { if (!task.IsFaulted && !task.IsCanceled) { StorageMetadata meta = task.Result; // do stuff with meta } });
파일 메타데이터 업데이트
파일 업로드가 완료된 후 언제든지 MetadataChange
객체를 취하는 UpdateMetadataAsync
메서드를 사용하여 파일 메타데이터를 업데이트할 수 있습니다.
업데이트할 수 있는 속성에 대한 자세한 내용은 전체 목록을 참조하세요. 메타데이터에 지정된 속성만 업데이트되며 나머지 속성은
그대로 유지됩니다.
// Create reference to the file whose metadata we want to change StorageReference forestRef = storageRef.Child("images/forest.jpg"); // Create file metadata to update var newMetadata = new MetadataChange(); newMetadata.CacheControl = "public,max-age=300"; newMetadata.ContentType = "image/jpeg"; // Update metadata properties forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => { if (!task.IsFaulted && !task.IsCanceled) { // access the updated meta data StorageMetadata meta = task.Result; } });
쓰기 가능한 메타데이터 속성에 빈 문자열을 전달하여 삭제할 수 있습니다.
// Create file metadata to update var newMetadata = new MetadataChange(); newMetadata.ContentType = ""; // Update metadata properties forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => { if (!task.IsFaulted && !task.IsCanceled) { StorageMetadata meta = task.Result; // meta.ContentType should be an empty string now } });
오류 처리
메타데이터를 가져오거나 업데이트할 때 오류가 발생하는 데에는 파일이 없거나 파일에 대한 액세스 권한이 없는 경우 등 다양한 이유가 있습니다. 오류에 대한 자세한 내용은 문서의 오류 처리 섹션을 참조하세요.
커스텀 메타데이터
커스텀 메타데이터를 Dictionary<string, string>
으로 지정할 수 있습니다.
var newMetadata = new MetadataChange { CustomMetadata = new Dictionary<string, string> { {"location", "Yosemite, CA, USA"}, {"activity", "Hiking"} } }; // UpdateMetadataAsync
커스텀 메타데이터에 각 파일의 앱별 데이터를 저장할 수 있지만 데이터베이스 (예: Firebase Realtime Database)을 사용하여 이러한 유형의 형식을 저장하고 동기화할 수 있습니다. 데이터입니다.
파일 메타데이터 속성
파일 메타데이터 속성의 전체 목록은 다음과 같습니다.
속성 | 유형 | MetadataChange에서 수정 가능 |
---|---|---|
Bucket |
string |
아니요 |
Generation |
string |
아니요 |
MetadataGeneration |
string |
아니요 |
Path |
string |
아니요 |
Name |
string |
아니요 |
SizeBytes |
long |
아니요 |
CreationTimeMillis |
long |
아니요 |
UpdatedTimeMillis |
long |
아니요 |
CacheControl |
string |
예 |
ContentDisposition |
string |
예 |
ContentEncoding |
string |
예 |
ContentLanguage |
string |
예 |
ContentType |
string |
예 |
DownloadUrl |
Uri |
아니요 |
DownloadUrls |
IList<Uri> |
아니요 |
CustomMetadataKeys |
IEnumerable<string> |
예 |
다음 단계
파일 업로드, 다운로드 및 업데이트도 중요하지만 파일을 삭제할 수도 있어야 합니다. Kubernetes에서 파일 삭제 최저가 Cloud Storage.