다음을 통해 공유


파일 속성 가져오기

Get File Properties 작업은 파일에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. 파일의 콘텐츠는 반환되지 않습니다.

프로토콜 가용성

활성화된 파일 공유 프로토콜 사용 가능
SMB Yes
NFS 아니요

요청

다음과 같이 Get File Properties 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다.

메서드 요청 URI HTTP 버전
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile HTTP/1.1
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime> HTTP/1.1

다음과 같이 요청 URI에 표시된 경로 구성 요소를 사용자 고유의 경로 구성 요소로 바꿉니다.

경로 구성 요소 Description
myaccount 사용자 스토리지 계정의 이름입니다.
myshare 파일 공유 이름입니다.
mydirectorypath 선택 사항입니다. 부모 디렉터리 경로입니다.
myfile 파일 이름입니다.

경로 명명 제한에 대한 자세한 내용은 이름 및 참조 공유, 디렉터리, 파일 및 메타데이터를 참조하세요.

URI 매개 변수

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.

매개 변수 Description
sharesnapshot 선택 사항입니다. 버전 2017-04-17 이상. 매개 변수는 sharesnapshot 파일 속성을 쿼리할 공유 스냅샷 지정하는 불투명 DateTime 값입니다.
timeout 선택 사항입니다. timeout 매개 변수는 초 단위로 표시됩니다. 자세한 내용은 Azure Files 작업에 대한 시간 제한 설정을 참조하세요.

요청 헤더

필수 및 선택적 요청 헤더는 다음 표에 설명되어 있습니다.

요청 헤더 Description
권한 부여 필수 사항입니다. 권한 부여 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요.
Date 또는 x-ms-date 필수 사항입니다. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요.
x-ms-version 모든 권한 있는 요청에 필요합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage 서비스에 대한 버전 관리를 참조하세요.
x-ms-lease-id:<ID> 선택 사항입니다. 버전 2019-02-02 이상. 헤더를 지정하면 파일의 임대가 현재 활성화되어 있고 요청에 지정된 임대 ID가 파일의 임대 ID와 일치하는 경우에만 작업이 수행됩니다. 일치하지 않으면 상태 코드 412(사전 조건 실패)로 인해 작업이 실패합니다.
x-ms-client-request-id 선택 사항입니다. Azure 스토리지 분석 로깅을 사용하도록 설정할 때 분석 로그에 기록되는 1키비바이트(KiB) 문자 제한을 사용하여 클라이언트에서 생성된 불투명 값을 제공합니다. 클라이언트 쪽 활동과 서버에서 수신한 요청의 상관 관계를 지정할 때 이 헤더를 사용하는 것이 좋습니다. 자세한 내용은 Azure Blob Storage 모니터링을 참조하세요.
x-ms-file-request-intent 헤더가 OAuth 토큰을 지정하는 경우 Authorization 필요합니다. 허용되는 값은 입니다 backup. 이 헤더는 헤더를 Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action 사용하여 Authorization 권한이 부여된 ID에 할당된 RBAC 정책에 포함되는 경우 또는 Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action 를 부여하도록 지정합니다. 버전 2022-11-02 이상에 사용할 수 있습니다.
x-ms-allow-trailing-dot: { <Boolean> } 선택 사항입니다. 버전 2022-11-02 이상. 부울 값은 요청 URL에 있는 후행 점을 잘라내야 하는지 여부를 지정합니다. 자세한 내용은 공유, 디렉터리, 파일 및 메타데이터 이름 지정 및 참조를 참조하세요.

요청 본문

없음

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

상태 코드

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.

응답 헤더

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.

응답 헤더 Description
Last-Modified 파일이 마지막으로 수정된 날짜와 시간을 반환합니다. 날짜 형식은 RFC 1123을 따릅니다. 자세한 내용은 머리글의 날짜/시간 값 표시를 참조하세요. 파일 또는 해당 속성을 수정하는 모든 작업은 마지막으로 수정된 시간을 업데이트합니다.
x-ms-meta-name:value 이 파일과 사용자 정의 메타데이터로 연결된 이름-값 쌍 집합입니다.
x-ms-type: <File> File 형식을 반환합니다. 다음에 사용하도록 예약됩니다.
Content-Length 파일의 크기(바이트)입니다. 이 헤더는 파일과 함께 저장된 헤더의 x-ms-content-length 값을 반환합니다.
Content-Type 파일에 대해 지정된 콘텐츠 형식입니다. 콘텐츠 형식을 지정하지 않으면 기본 콘텐츠 형식은 입니다 application/octet-stream.
ETag ETag에는 조건에 따라 작업을 수행하는 데 사용할 수 있는 값이 포함됩니다. 값은 따옴표로 묶입니다.
Content-MD5 Content-MD5 헤더가 파일에 대해 설정된 경우 Content-MD5 응답 헤더가 반환되어 클라이언트가 메시지 콘텐츠의 무결성을 확인할 수 있습니다.
Content-Encoding Content-Encoding 요청 헤더가 파일에 대해 이전에 설정된 경우 Content-Encoding 값이 이 헤더에 반환됩니다.
Content-Language Content-Language 요청 헤더가 파일에 대해 이전에 설정된 경우 Content-Language 값이 이 헤더에 반환됩니다.
Cache-Control Cache-Control 요청 헤더가 파일에 대해 이전에 설정된 경우 Cache-Control 값이 이 헤더에 반환됩니다.
Content-Disposition x-ms-content-disposition 헤더에 대해 지정된 값을 반환하고 응답 처리 방법을 지정합니다.

Content-Disposition 응답 헤더 필드는 응답 페이로드를 처리하는 방법에 대한 추가 정보를 전달하며 이를 사용하여 추가 메타데이터를 연결할 수 있습니다. 예를 들어 로 설정된 attachmentContent-Disposition 경우 사용자 에이전트가 응답을 표시해서는 안 되지만 다른 이름으로 저장 창이 대신 표시되어야 했음을 나타냅니다.
x-ms-request-id 만들어진 요청을 고유하게 식별하며 요청 문제를 해결하는 데 사용할 수 있습니다. 자세한 내용은 API 작업 문제 해결을 참조하세요.
x-ms-version 요청을 실행하는 데 사용된 서비스 버전을 나타냅니다.
Date 서비스에서 생성된 UTC 날짜/시간 값으로, 응답이 시작된 시간을 나타냅니다.
x-ms-copy-completion-time:<datetime> 버전 2015-02-21 이상. 이 파일이 대상 파일이었던 마지막으로 시도한 파일 복사 작업의 결론 시간입니다. 이 값은 완료, 중단 또는 실패한 복사 시도의 시간을 지정할 수 있습니다. 복사본이 보류 중인 경우, 이 파일이 파일 복사 작업의 대상이 아니었거나 파일 속성 설정 또는 파일 만들기를 사용하여 파일 복사 작업이 끝난 후 이 파일이 수정된 경우에는 이 헤더가 표시되지 않습니다.
x-ms-copy-status-description: <error string> 버전 2015-02-21 이상. 가 실패했거나 보류 중인 경우에만 x-ms-copy-status 나타납니다. 치명적이거나 치명적이 아닌 복사 작업 실패의 원인을 설명합니다. 복사본이 보류 중인 경우, 이 파일이 파일 복사 작업의 대상이 아니었거나 파일 속성 설정 또는 파일 만들기를 사용하여 파일 복사 작업이 끝난 후 이 파일이 수정된 경우에는 이 헤더가 표시되지 않습니다.
x-ms-copy-id: <id> 버전 2015-02-21 이상. 이 파일이 대상 파일인 마지막으로 시도한 파일 복사 작업의 문자열 식별자입니다. 파일 복사 작업에서 이 파일이 대상이 되지 않았거나 파일 속성 설정 또는 파일만들기를 사용하여 파일 복사 작업이 끝난 후 이 파일이 수정된 경우에는 이 헤더가 표시되지 않습니다.
x-ms-copy-progress: <bytes copied/bytes total> 버전 2015-02-21 이상. 복사된 바이트 수와 이 파일이 대상 파일이었던 마지막으로 시도한 파일 복사 작업에서 원본의 총 바이트를 포함합니다. 0과 복사된 바이트 수를 Content-Length 표시할 수 있습니다. 파일 복사 작업에서 이 파일이 대상이 되지 않았거나 파일 속성 설정 또는 파일만들기를 사용하여 파일 복사 작업이 끝난 후 이 파일이 수정된 경우에는 이 헤더가 표시되지 않습니다.
x-ms-copy-source: url 버전 2015-02-21 이상. 이 파일이 대상 파일이었던 마지막 시도 파일 복사 작업에서 사용된 원본 파일을 지정하는 최대 2KB 문자의 URL입니다. 파일 복사 작업에서 이 파일이 대상이 되지 않았거나 파일 속성 설정 또는 파일만들기를 사용하여 파일 복사 작업이 끝난 후 이 파일이 수정된 경우에는 이 헤더가 표시되지 않습니다.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> 버전 2015-02-21 이상. 다음 값을 사용하여 로 식별되는 x-ms-copy-id복사 작업의 상태입니다.

- 성공: 복사가 성공적으로 완료되었습니다.
- 보류 중인: 복사가 진행 중입니다. 일시적인 치명적이 아닌 오류가 복사 진행을 방해하지만 실패를 일으키지 않는지 확인 x-ms-copy-status-description 합니다.
- 중단: 복사가 파일 복사 중단으로 종료되었습니다.
- 실패: 복사에 실패했습니다. 자세한 내용은 x-ms-copy-status-description을 참조하십시오.

파일 복사 작업에서 이 파일이 대상이 되지 않았거나 파일 속성 설정 또는 파일만들기를 사용하여 파일 복사 작업이 끝난 후 이 파일이 수정된 경우에는 이 헤더가 표시되지 않습니다.
x-ms-server-encrypted: true/false 버전 2017-04-17 이상. 이 헤더의 값은 지정된 알고리즘을 true 사용하여 파일 데이터 및 애플리케이션 메타데이터를 완전히 암호화하는 경우 로 설정됩니다. 파일이 암호화되지 않은 경우 또는 파일 또는 애플리케이션 메타데이터의 일부만 암호화되는 경우 값이 로 설정 false 됩니다.
x-ms-file-permission-key 버전 2019-02-02 이상. 파일 사용 권한의 키입니다.
x-ms-file-attributes 버전 2019-02-02 이상. 파일의 파일 시스템 특성입니다. 자세한 내용은 사용 가능한 특성 목록을 참조하세요.
x-ms-file-creation-time 버전 2019-02-02 이상. 파일의 생성 시간 속성을 나타내는 UTC 날짜/시간 값입니다.
x-ms-file-last-write-time 버전 2019-02-02 이상. 파일의 마지막 쓰기 시간 속성을 나타내는 UTC 날짜/시간 값입니다.
x-ms-file-change-time 버전 2019-02-02 이상. 파일의 변경 시간 속성을 나타내는 UTC 날짜/시간 값입니다.
x-ms-file-file-id 버전 2019-02-02 이상. 파일의 파일 ID입니다.
x-ms-file-parent-id 버전 2019-02-02 이상. 파일의 부모 파일 ID입니다.
x-ms-lease-duration:infinite 버전 2019-02-02 이상. 파일이 임대되면 임대 기간이 무한임을 지정합니다.
x-ms-lease-state:<available;leased;broken> 버전 2019-02-02 이상. 파일이 임대되면 파일의 임대 상태를 지정합니다.
x-ms-lease-status:<locked;unlocked> 버전 2019-02-02 이상. 파일이 임대되면 파일의 임대 상태 지정합니다.
x-ms-client-request-id 요청 및 해당 응답 문제를 해결하는 데 사용할 수 있습니다. 이 헤더의 값 x-ms-client-request-id 은 요청에 있고 값에 표시되는 ASCII 문자가 1,024자 이하인 경우 헤더 값과 같습니다. 헤더가 x-ms-client-request-id 요청에 없으면 응답에 표시되지 않습니다.

응답 본문

없음

샘플 응답

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-type: File  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-version: 2019-02-02  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
x-ms-lease-duration: infinite   
x-ms-lease-state: leased 
x-ms-lease-status: locked   
  

권한 부여

계정 소유자만 이 작업을 호출할 수 있습니다.

추가 정보

Azure Files 작업