디렉터리 속성 가져오기
Get Directory Properties 작업은 지정된 디렉터리에 대한 모든 시스템 속성을 반환하며 디렉터리의 존재를 확인하는 데 사용할 수도 있습니다. 반환된 데이터에는 디렉터리 또는 하위 디렉터리의 파일이 포함되지 않습니다. 이 작업은 NFS 프로토콜이 설정된 파일 공유에 대해 버전 2025-05-05 이상에서 지원됩니다.
프로토콜 가용성
| 파일 공유 프로토콜 사용 | 이용할 수 있는 |
|---|---|
| SMB |
|
| NFS |
|
요청
Get Directory Properties 요청은 다음과 같이 생성됩니다. HTTPS를 사용하는 것이 좋습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
요청 URI에 표시된 경로 구성 요소를 다음과 같이 사용자 고유의 경로 구성 요소로 바꿉니다.
| 경로 구성 요소 | 묘사 |
|---|---|
myaccount |
스토리지 계정의 이름입니다. |
myshare |
파일 공유의 이름입니다. |
myparentdirectorypath |
선택적. 부모 디렉터리의 경로입니다. |
mydirectory |
디렉터리의 이름입니다. |
경로 명명 제한에 대한 자세한 내용은 이름 및 참조 공유, 디렉터리, 파일 및 메타데이터참조하세요.
URI 매개 변수
요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.
| 매개 변수 | 묘사 |
|---|---|
sharesnapshot |
선택적. 버전 2017-04-17 이상.
sharesnapshot 매개 변수는 디렉터리 속성을 쿼리할 공유 스냅샷을 지정하는 불투명 DateTime 값입니다. |
timeout |
선택적.
timeout 매개 변수는 초 단위로 표현됩니다. 자세한 내용은 Azure Files 작업대한 시간 제한 설정을 참조하세요. |
요청 헤더
필수 및 선택적 요청 헤더는 다음 표에 설명되어 있습니다.
일반적인 요청 헤더
| 요청 헤더 | 묘사 |
|---|---|
Authorization |
필수. 권한 부여 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure Storage대한 요청 권한 부여를 참조하세요. |
Date 또는 x-ms-date |
필수. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage대한 요청 권한 부여를 참조하세요. |
x-ms-version |
모든 권한 있는 요청에 필요합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 작업은 NFS 프로토콜이 설정된 파일 공유에 대해 버전 2025-05-05 이상에서 지원됩니다. 자세한 내용은 Azure Storage 서비스 대한버전 관리를 참조하세요. |
x-ms-client-request-id |
선택적. 로깅이 구성될 때 로그에 기록되는 1kibibyte(KiB) 문자 제한으로 클라이언트에서 생성된 불투명 값을 제공합니다. 이 헤더를 사용하여 클라이언트 쪽 활동과 서버가 수신하는 요청의 상관 관계를 지정하는 것이 좋습니다. 자세한 내용은 Azure Files모니터링을 참조하세요. |
x-ms-file-request-intent |
Authorization 헤더가 OAuth 토큰을 지정하는 경우 필수입니다. 허용되는 값은 backup. 이 헤더는 Authorization 헤더를 사용하여 권한이 부여된 ID에 할당된 RBAC 정책에 포함된 경우 Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action 또는 Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action 부여하도록 지정합니다. 버전 2022-11-02 이상에서 사용할 수 있습니다. |
x-ms-allow-trailing-dot: { <Boolean> } |
선택적. 버전 2022-11-02 이상. 부울 값은 요청 URL에 있는 후행 점이 잘려야 하는지 여부를 지정합니다. 대상이 NFS 프로토콜을 사용하도록 설정된 파일 공유에 있는 경우 이 헤더는 무시됩니다. 이 헤더는 기본적으로 후행 점을 지원합니다. 자세한 내용은 공유, 디렉터리, 파일 및 메타데이터 명명 및 참조를 참조하세요. |
SMB 전용 요청 헤더
없음.
NFS만 요청 헤더
없음.
요청 본문
없음.
샘플 요청
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
응답
응답에는 HTTP 상태 코드와 응답 헤더 집합이 포함됩니다.
상태 코드
작업이 성공하면 상태 코드 200(확인)이 반환됩니다. 상태 코드에 대한 자세한 내용은 상태 및 오류 코드참조하세요.
응답 헤더
이 작업에 대한 응답에는 다음 표의 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더도 포함될 수 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양준수합니다.
일반적인 응답 헤더
| 응답 헤더 | 묘사 |
|---|---|
ETag |
ETag에는 조건부로 작업을 수행하는 데 사용할 수 있는 값이 포함되어 있습니다. 값은 따옴표로 묶입니다. |
Last-Modified |
디렉터리가 마지막으로 수정된 날짜와 시간을 반환합니다. 날짜 형식은 RFC 1123을 따릅니다. 자세한 내용은 헤더날짜/시간 값을 나타냅니다. 디렉터리 내의 파일에 대한 작업은 디렉터리의 마지막으로 수정된 시간에 영향을 주지 않습니다. |
x-ms-meta-name:value |
디렉터리에 대한 메타데이터를 포함하는 이름-값 쌍 집합입니다. |
x-ms-request-id |
요청 문제를 해결하는 데 도움이 되는 요청의 고유 식별자를 반환합니다. 자세한 내용은 API 작업문제 해결을 참조하세요. |
x-ms-version |
요청을 실행하는 데 사용된 서비스 버전을 나타냅니다. |
Date |
서비스에서 생성되는 UTC 날짜/시간 값으로, 응답이 시작된 시간을 나타냅니다. |
x-ms-server-encrypted: true/false |
버전 2017-04-17 이상. 디렉터리 메타데이터가 지정된 알고리즘을 사용하여 완전히 암호화된 경우 이 헤더의 값은 true 설정됩니다. 메타데이터가 암호화되지 않으면 값이 false. |
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-client-request-id |
요청 및 해당 응답의 문제를 해결하는 데 사용할 수 있습니다. 이 헤더의 값은 요청에 있고 값에 표시되는 ASCII 문자가 1,024자 이하인 경우 x-ms-client-request-id 헤더의 값과 같습니다.
x-ms-client-request-id 헤더가 요청에 없으면 응답에 표시되지 않습니다. |
SMB 전용 응답 헤더
| 응답 헤더 | 묘사 |
|---|---|
x-ms-file-permission-key |
버전 2019-02-02 이상. 디렉터리 권한의 키입니다. |
x-ms-file-attributes |
버전 2019-02-02 이상. 디렉터리의 파일 시스템 특성입니다. 자세한 내용은 사용 가능한 특성 목록을 참조하세요. |
NFS만 응답 헤더
| 응답 헤더 | 묘사 |
|---|---|
x-ms-mode |
버전 2025-05-05 이상. 디렉터리의 모드입니다. POSIX 파일 사용 권한(모드)참조하세요. |
x-ms-owner |
버전 2025-05-05 이상. 디렉터리 소유자의 UID(사용자 식별자)입니다. |
x-ms-group |
버전 2025-05-05 이상. 디렉터리 소유자의 GID(그룹 식별자)입니다. |
x-ms-file-file-type |
버전 2025-05-05 이상. 파일의 형식이며 가능한 값은 Directory. |
응답 본문
없음.
샘플 응답
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
권한 부여
계정 소유자만 이 작업을 호출할 수 있습니다.
파일 시스템 특성
| 속성 | Win32 파일 특성 | 정의 |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | 읽기 전용인 파일입니다. 애플리케이션은 파일을 읽을 수 있지만 파일을 쓰거나 삭제할 수는 없습니다. |
| 숨겨진 | FILE_ATTRIBUTE_HIDDEN | 파일이 숨겨져 있습니다. 일반 디렉터리 목록에는 포함되지 않습니다. |
| 체계 | FILE_ATTRIBUTE_SYSTEM | 운영 체제에서 일부 또는 단독으로 사용하는 파일입니다. |
| 없음 | FILE_ATTRIBUTE_NORMAL | 다른 특성이 설정되지 않은 파일입니다. 이 특성은 단독으로 사용되는 경우에만 유효합니다. |
| 보관 | FILE_ATTRIBUTE_ARCHIVE | 보관 파일인 파일입니다. 애플리케이션은 일반적으로 이 특성을 사용하여 백업 또는 제거를 위해 파일을 표시합니다. |
| 일시적인 | FILE_ATTRIBUTE_TEMPORARY | 임시 스토리지에 사용되는 파일입니다. |
| 오프 라인 | FILE_ATTRIBUTE_OFFLINE | 파일의 데이터는 즉시 사용할 수 없습니다. 이 파일 시스템 특성은 Windows와의 호환성을 제공하기 위해 주로 제공됩니다. Azure Files는 오프라인 스토리지 옵션을 지원하지 않습니다. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | 파일은 콘텐츠 인덱싱 서비스에서 인덱싱할 수 없습니다. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | 사용자 데이터 스트림은 백그라운드 데이터 무결성 스캐너에서 읽을 수 없습니다. 이 파일 시스템 특성은 Windows와의 호환성을 제공하기 위해 주로 제공됩니다. |
POSIX 파일 권한(모드)
POSIX 파일 사용 권한은 숫자로 12비트 숫자 8진수 형식 또는 기호화된 "rwx" 형식으로 지정할 수 있습니다. 예제:
- "0644" 또는 "rw-r--r--": 사용자(파일 소유자)에게 읽기, 쓰기 권한이 있습니다. 그룹에 읽기 권한이 있습니다. 다른 사용자에게는 읽기 권한이 있습니다.
- "0755" 또는 "rwxr-xr-x": 사용자(파일 소유자)에게 읽기, 쓰기 및 실행 권한이 있습니다. 그룹에 읽기 및 실행 권한이 있습니다. 다른 사용자에게는 읽기 및 실행 권한이 있습니다.
숫자 8진수 형식
3개의 가장 낮은 순서 8진수는 소유자/사용자, 그룹 등에 대한 사용 권한을 나타내며 8진수(0-7)를 사용하여 '4'(읽기), '2'(쓰기), '1'(실행)의 비트 조합을 사용하여 구성됩니다. 가장 높은 순서의 8진수(0-7)는 '4'(SetUID), '2'(SetGID), '1'(StickyBit) 권한의 조합을 나타내는 데 사용됩니다.
| 판 | 허가 |
|---|---|
| 0700 | 사용자(파일 소유자)에게 읽기, 쓰기 및 실행 권한이 있습니다. |
| 0400 | 사용자에게 읽기 권한이 있습니다. |
| 0200 | 사용자에게 쓰기 권한이 있습니다. |
| 0100 | 사용자에게 실행 권한이 있습니다. |
| 0070 | 그룹에 읽기, 쓰기 및 실행 권한이 있습니다. |
| 0040 | 그룹에 읽기 권한이 있습니다. |
| 0020 | 그룹에 쓰기 권한이 있습니다. |
| 0010 | 그룹에 실행 권한이 있습니다. |
| 0007 | 다른 사용자에게는 읽기, 쓰기 및 실행 권한이 있습니다. |
| 0004 | 다른 사용자에게는 읽기 권한이 있습니다. |
| 0002 | 다른 사용자에게는 쓰기 권한이 있습니다. |
| 0001 | 다른 사용자에게는 실행 권한이 있습니다. |
| 4000 | 파일에 유효한 사용자 ID를 설정합니다. |
| 2000 | 파일에 유효 그룹 ID를 설정합니다. |
| 1000 | 파일 소유자, 디렉터리 소유자 또는 루트 사용자만 파일을 삭제하거나 이름을 바꿀 수 있음을 나타내도록 설정합니다. |
기호화된 "rwx" 형식
소유자/사용자, 그룹 등에 대한 사용 권한은 'r'(읽기), 'w'(쓰기) 및 'x'(실행) 문자의 조합을 사용하여 표시됩니다.
| 판 | 허가 |
|---|---|
| rwx------ | 사용자(파일 소유자)에게 읽기, 쓰기 및 실행 권한이 있습니다. |
| r-------- | 사용자에게 읽기 권한이 있습니다. |
| -w------- | 사용자에게 쓰기 권한이 있습니다. |
| --x------ | 사용자에게 실행 권한이 있습니다. |
| ---rwx--- | 그룹에 읽기, 쓰기 및 실행 권한이 있습니다. |
| ---r----- | 그룹에 읽기 권한이 있습니다. |
| ----w---- | 그룹에 쓰기 권한이 있습니다. |
| -----x--- | 그룹에 실행 권한이 있습니다. |
| ------rwx | 다른 사용자에게는 읽기, 쓰기 및 실행 권한이 있습니다. |
| ------r-- | 다른 사용자에게는 읽기 권한이 있습니다. |
| -------w- | 다른 사용자에게는 쓰기 권한이 있습니다. |
| --------x | 다른 사용자에게는 실행 권한이 있습니다. |
발언
지정된 디렉터리 경로가 없으면 상태 코드 404(찾을 수 없음)로 요청이 실패합니다.