Path - Create
파일 만들기 | 디렉터리 만들기 | 파일 이름 바꾸기 | 디렉터리 이름 바꾸기
파일 또는 디렉터리를 만들거나 이름을 바꿉니다. 기본적으로 대상은 덮어쓰여지고 대상이 이미 있고 임대가 있는 경우 임대가 끊어집니다. 원본 컨테이너에 일치하는 강제 컨테이너 암호화 정책도 없으면 파일 또는 디렉터리의 이름을 컨테이너에 적용된 컨테이너 암호화 정책으로 바꾸는 것은 허용되지 않습니다. 이 작업은 조건부 HTTP 요청을 지원합니다. 자세한 내용은 Blob Service 작업대한 조건부 헤더 지정을 참조하세요. 대상이 이미 있는 경우 실패하려면 If-None-Match: "*"와 함께 조건부 요청을 사용합니다.
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
Azure Storage 계정 이름입니다. |
dns
|
path | True |
string |
Azure Data Lake Storage 엔드포인트에 대한 DNS 접미사입니다. |
filesystem
|
path | True |
string |
파일 시스템 식별자입니다. regex 패턴: |
path
|
path | True |
string |
파일 또는 디렉터리 경로입니다. |
continuation
|
query |
string |
선택적. 디렉터리의 이름을 바꿀 때 각 호출로 이름이 바뀐 경로 수는 제한됩니다. 이름을 바꿀 경로 수가 이 제한을 초과하면 이 응답 헤더에 연속 토큰이 반환됩니다. 응답에서 연속 토큰이 반환되는 경우 디렉터리 이름을 계속 바꾸려면 이름 바꾸기 작업의 후속 호출에서 지정해야 합니다. |
|
mode
|
query |
선택적. 네임스페이스를 사용하는 경우에만 유효합니다. 이 매개 변수는 이름 바꾸기 작업의 동작을 결정합니다. 값은 "legacy" 또는 "posix"여야 하며 기본값은 "posix"여야 합니다. |
||
resource
|
query |
파일 만들기 및 디렉터리 만들기에만 필요합니다. 값은 "file" 또는 "directory"여야 합니다. |
||
timeout
|
query |
integer int32 |
선택적 작업 시간 제한 값(초)입니다. 이 기간은 서비스에서 요청을 수신할 때 시작됩니다. 작업이 완료되기 전에 시간 제한 값이 경과하면 작업이 실패합니다. |
요청 헤더
Media Types: "application/octet-stream"
Name | 필수 | 형식 | Description |
---|---|---|---|
Cache-Control |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "파일 읽기" 작업의 "Cache-Control" 응답 헤더에 포함합니다. |
|
Content-Encoding |
string |
선택적. 파일에 적용된 콘텐츠 인코딩을 지정합니다. 이 값은 "파일 읽기" 작업이 수행될 때 클라이언트에 반환됩니다. |
|
Content-Language |
string |
선택적. 파일에 대해 의도한 대상 그룹에 사용되는 자연어를 지정합니다. |
|
Content-Disposition |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "콘텐츠 처리" 응답 헤더에 포함합니다. |
|
x-ms-cache-control |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "Cache-Control" 응답 헤더에 포함합니다. |
|
x-ms-content-type |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "Content-Type" 응답 헤더에 포함합니다. |
|
x-ms-content-encoding |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "콘텐츠 인코딩" 응답 헤더에 포함합니다. |
|
x-ms-content-language |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "Content-Language" 응답 헤더에 포함합니다. |
|
x-ms-content-disposition |
string |
선택적. 서비스는 이 값을 저장하고 "파일 읽기" 작업에 대한 "콘텐츠 처리" 응답 헤더에 포함합니다. |
|
x-ms-rename-source |
string |
이름을 바꿀 선택적 파일 또는 디렉터리입니다. SAS 토큰을 사용할 때 값은 "/{filesystem}/{path}" 또는 "/{filesystem}/{path}?sastoken" 형식이어야 합니다. "x-ms-properties"를 지정하면 속성이 기존 속성을 덮어씁니다. 그렇지 않으면 기존 속성이 유지됩니다. 이 값은 URL 백분율로 인코딩된 문자열이어야 합니다. 문자열은 ISO-8859-1 문자 집합에 ASCII 문자만 포함할 수 있습니다. |
|
x-ms-lease-id |
string |
선택적. URI에 지정된 경로의 임대 ID입니다. 덮어쓸 경로에는 활성 임대가 있어야 하며 임대 ID는 일치해야 합니다. regex 패턴: |
|
x-ms-source-lease-id |
string |
이름 바꾸기 작업에 대한 선택 사항입니다. 원본 경로에 대한 임대 ID입니다. 원본 경로에는 활성 임대가 있어야 하며 임대 ID는 일치해야 합니다. regex 패턴: |
|
x-ms-properties |
string |
선택적. 이름 및 값 쌍의 쉼표로 구분된 목록 형식으로 파일 또는 디렉터리와 함께 저장할 사용자 정의 속성 "n1=v1, n2=v2, ...", 여기서 각 값은 base64로 인코딩된 문자열입니다. 문자열은 ISO-8859-1 문자 집합에 ASCII 문자만 포함할 수 있습니다. |
|
x-ms-permissions |
string |
선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기(4), 쓰기(2) 또는 실행(1) 권한이 부여될 수 있습니다. 기호(rwxrw-rw-) 및 4자리 8진수 표기법(예: 0766)이 모두 지원됩니다. 또한 고정 비트는 지원되며 기호화된 표기법에서 다른 범주의 실행 비트가 각각 설정되었는지 여부에 따라 최종 문자 위치의 t 또는 T로 표현됩니다(예: 고정 비트가 있는 rwxrw-rw-rw-는 rwxrw-rwT로 표현됨). 고정 비트가 있는 rwxrw-rwx는 rwxrw-rwt로 표시되며, t 또는 T가 없는 경우 고정 비트가 설정되지 않음을 나타냅니다. 4자리 8진수 표기법에서 첫 번째 숫자로 표시되는 표기법입니다(예: 1766은 rwxrw-rw를 나타내고 0766은 고정 비트가 없는 rwxrw-rw를 나타낸다). x-ms-acl과 함께 잘못되었습니다. |
|
x-ms-umask |
string |
선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 또는 디렉터리를 만들 때 부모 폴더에 기본 ACL이 없는 경우 umask는 만들 파일 또는 디렉터리의 권한을 제한합니다. 결과 권한은 p & ^u에서 부여됩니다. 여기서 p는 사용 권한이며 사용자는 umask입니다. 예를 들어 p가 0777이고 0057인 경우 결과 권한은 0720입니다. 기본 사용 권한은 디렉터리의 경우 0777이고 파일의 경우 0666입니다. 기본 umask는 0027입니다. umask는 4자리 8진수 표기법(예: 0766)으로 지정해야 합니다. |
|
x-ms-owner |
string |
선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 또는 디렉터리의 소유자를 설정합니다. |
|
x-ms-group |
string |
선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 또는 디렉터리의 소유 그룹을 설정합니다. |
|
x-ms-acl |
string |
선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 및 디렉터리에 대한 POSIX 액세스 제어 권한을 설정합니다. ACE(각 액세스 제어 항목)는 범위, 형식, 사용자 또는 그룹 식별자 및 "[scope:][type]:[id]:[permissions]" 형식의 권한으로 구성됩니다. ACE가 디렉터리의 기본 ACL에 속함을 나타내려면 범위가 "기본값"이어야 합니다. 그렇지 않으면 범위가 암시적이고 ACE가 액세스 ACL에 속합니다. "user"는 소유자 또는 명명된 사용자에게 권한을 부여하고, "group"은 소유 그룹 또는 명명된 그룹에 대한 권한을 부여하고, "mask"는 명명된 사용자 및 그룹 구성원에게 부여된 권한을 제한하고, "기타"는 다른 항목에서 찾을 수 없는 모든 사용자에게 권한을 부여합니다. 사용자 또는 그룹 식별자는 "mask" 및 "other" 형식의 항목에 대해 생략됩니다. 소유자 및 소유 그룹에 대한 사용자 또는 그룹 식별자도 생략됩니다. 사용 권한 필드는 첫 번째 문자가 읽기 권한을 부여하는 'r'이고, 두 번째 문자는 쓰기 액세스 권한을 부여하는 'w'이고, 세 번째 문자는 실행 권한을 부여하는 'x'인 3자 시퀀스입니다. 액세스 권한이 부여되지 않은 경우 '-' 문자는 사용 권한이 거부되었음을 나타내는 데 사용됩니다. 예를 들어 다음 ACL은 파일 소유자 및 john.doe@contoso 읽기 권한, 소유 그룹에 대한 읽기 권한 및 다른 모든 사람에게 읽기, 쓰기 및 실행 권한을 부여합니다. "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". x-ms-permissions와 함께 잘못되었습니다. |
|
x-ms-proposed-lease-id |
string |
선택적. 파일 또는 디렉터리를 만드는 동안 임대를 획득하려는 경우 제안된 임대 ID를 지정합니다. 임대를 성공적으로 만들면 이 임대 ID를 사용하여 임대를 획득합니다. regex 패턴: |
|
x-ms-expiry-option |
string |
선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정되어 있고 파일에서만 지원되는 경우에만 유효합니다. 파일을 만드는 동안 만료 시간을 설정하려면 다음 만료 옵션 중 하나를 지정합니다. "RelativeToNow" 현재 시간을 기준으로 만료를 설정합니다. 사용자는 지금부터 경과된 시간(밀리초)을 전달합니다. RFC 1123 형식의 "절대" 절대 시간입니다. "Neverexpire" 파일을 만료되지 않도록 설정합니다. 만료 시간을 이 옵션으로 지정할 필요가 없습니다. |
|
x-ms-expiry-time |
string |
선택 사항이며 계층 구조 네임스페이스가 계정에 대해 사용하도록 설정되어 있고 파일에서만 지원되는 경우에만 유효합니다. 파일을 만료할 만료 시간을 지정합니다. RFC 1123 HTTP 시간 문자열 또는 만료 옵션에 따른 밀리초 수로 지정됩니다. |
|
If-Match |
string |
선택적. ETag 값입니다. 이 헤더를 지정하여 리소스의 ETag가 지정된 값과 일치하는 경우에만 작업을 수행합니다. ETag는 따옴표로 지정해야 합니다. |
|
If-None-Match |
string |
선택적. ETag 값 또는 특수 와일드카드("*") 값입니다. 리소스의 ETag가 지정된 값과 일치하지 않는 경우에만 이 헤더를 지정하여 작업을 수행합니다. ETag는 따옴표로 지정해야 합니다. |
|
If-Modified-Since |
string |
선택적. 날짜 및 시간 값입니다. 지정된 날짜 및 시간 이후 리소스가 수정된 경우에만 작업을 수행하도록 이 헤더를 지정합니다. |
|
If-Unmodified-Since |
string |
선택적. 날짜 및 시간 값입니다. 지정된 날짜 및 시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하도록 이 헤더를 지정합니다. |
|
x-ms-source-if-match |
string |
선택적. ETag 값입니다. 원본의 ETag가 지정된 값과 일치하는 경우에만 이름 바꾸기 작업을 수행하려면 이 헤더를 지정합니다. ETag는 따옴표로 지정해야 합니다. |
|
x-ms-source-if-none-match |
string |
선택적. ETag 값 또는 특수 와일드카드("*") 값입니다. 원본의 ETag가 지정된 값과 일치하지 않는 경우에만 이름 바꾸기 작업을 수행하려면 이 헤더를 지정합니다. ETag는 따옴표로 지정해야 합니다. |
|
x-ms-source-if-modified-since |
string |
선택적. 날짜 및 시간 값입니다. 지정된 날짜 및 시간 이후 원본이 수정된 경우에만 이름 바꾸기 작업을 수행하려면 이 헤더를 지정합니다. |
|
x-ms-source-if-unmodified-since |
string |
선택적. 날짜 및 시간 값입니다. 지정된 날짜 및 시간 이후 원본이 수정되지 않은 경우에만 이름 바꾸기 작업을 수행하도록 이 헤더를 지정합니다. |
|
x-ms-encryption-key |
string |
선택적. Base64로 인코딩된 AES-256 암호화 키입니다. |
|
x-ms-encryption-key-sha256 |
string |
선택적. 암호화 키의 Base64로 인코딩된 SHA256 해시입니다. |
|
x-ms-encryption-algorithm: AES256 |
string |
선택적. 암호화에 사용할 알고리즘을 지정합니다. 이 헤더의 값은 AES256이어야 합니다. |
|
x-ms-encryption-context |
string |
선택적. 기본값은 "Empty"입니다. 값을 설정하면 Blob/파일 시스템 메타데이터가 설정됩니다. 최대 길이- 1024 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. |
|
x-ms-client-transaction-id |
string |
선택적. 기본값은 "Empty"입니다. 값을 설정하면 파일 만들기 또는 이름 바꾸기에 Blob 메타데이터가 설정됩니다. 클라이언트에 대한 요청 시간이 초과된 경우 속성 가져오기 호출을 사용하여 이 값을 가져와서 서비스 종료 시 시간 초과 요청이 성공했는지 여부를 확인할 수 있습니다. 최대 길이- 36. 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. |
|
x-ms-client-request-id |
string |
문제 해결 및 상관 관계를 위해 분석 로그에 기록된 UUID입니다. regex 패턴: |
|
x-ms-date |
string |
요청에 대한 UTC(협정 세계시)를 지정합니다. 공유 키 권한 부여를 사용할 때 필요합니다. |
|
x-ms-version |
string |
요청을 처리하는 데 사용되는 REST 프로토콜의 버전을 지정합니다. 공유 키 권한 부여를 사용할 때 필요합니다. |
응답
Name | 형식 | Description |
---|---|---|
201 Created |
파일 또는 디렉터리가 만들어졌습니다. 헤더
|
|
Other Status Codes |
오류가 발생했습니다. 가능한 HTTP 상태, 코드 및 메시지 문자열은 다음과 같습니다.
헤더
|
정의
Name | Description |
---|---|
Data |
|
Error |
서비스 오류 응답 개체입니다. |
Path |
선택적. 네임스페이스를 사용하는 경우에만 유효합니다. 이 매개 변수는 이름 바꾸기 작업의 동작을 결정합니다. 값은 "legacy" 또는 "posix"여야 하며 기본값은 "posix"여야 합니다. |
Path |
파일 만들기 및 디렉터리 만들기에만 필요합니다. 값은 "file" 또는 "directory"여야 합니다. |
DataLakeStorageError
Name | 형식 | Description |
---|---|---|
error |
서비스 오류 응답 개체입니다. |
Error
서비스 오류 응답 개체입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
서비스 오류 코드입니다. |
message |
string |
서비스 오류 메시지입니다. |
PathRenameMode
선택적. 네임스페이스를 사용하는 경우에만 유효합니다. 이 매개 변수는 이름 바꾸기 작업의 동작을 결정합니다. 값은 "legacy" 또는 "posix"여야 하며 기본값은 "posix"여야 합니다.
Name | 형식 | Description |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
파일 만들기 및 디렉터리 만들기에만 필요합니다. 값은 "file" 또는 "directory"여야 합니다.
Name | 형식 | Description |
---|---|---|
directory |
string |
|
file |
string |